Compiling a Database with the Database Compiler

Compiling a Database with the Database Compiler

To compile a database, use the Database Compiler You start the Database Compiler in the Designer.

To compile a database

1. Select Database | Compile database... in the Designer.
2. Enter which parts of the database should be recompiled.

   TIP: Hide the other options using the arrow next to the option.

   1. To compile web services, select the Web Services option.

      The One Identity Manager offers the option of linking in data that comes from different web service interfaces. The web service proxy code is stored in the database. The Database Compiler compiles the proxy code for all web services of a DLL and saves it in the database. When changes are made to proxy code the database needs to be compiled.

   2. To create type-safe classes for the data model, select the option Typed wrappers.

      Type-safe classes are created from table and column definition that you can use in scripts. This checks whether the classes used in writing and compiling scripts are correct.

      TIP: Use this option to compile the database after extending the schema.

   3. To compile scripts from the script library, select the following items:

      Table 34: Options for Compiling Scripts

      Option	Description
      Do not compile scripts	Scripts from the script library are not compiled.
      Script without dependencies	Changes to scripts do not become active until the One Identity Manager tool is restarted.
      Scripts including all dependencies	Recompiles the scripts and all dependencies (templates, methods, processes). This guarantees that the script changes are loaded and become effective immediately. One Identity Manager tools do not need to be restarted.

   4. To compile additional script expressions, select the options Templates, methods, etc. and specify which script expressions to compile in the options underneath. You can select from templates and formatting scripts, scripts for selecting tables, view and objects, task definitions, insert values and parameter scripts.

   5. To compile processes, select the option Processes and specify which processes to compile in the options underneath.

      Table 35: Options for Compiling Scripts

      Option	Description
      All processes	All processes are compiled.
      Changed processes	All processes hat have changed since the previous compilation are compiled.
      Selected processes...	Only processes for the selected objects are compiled. To select objects separately Click [...]. Select changed processes, all processes or only selected processes (user defined). You can limit the preselection more. Click OK.

   6. Set the option Extract language dependent strings if you want text from scripts to be translated.

      This creates templates for translation. Use the Language Editor to translate.

3. To start compiling, click Next. Compiling may take some time.
4. Click Next.
5. Click Finish to quit the program.

Logging Compiler Errors and Warnings

To display messaging during compilation and saving

• Select Display to display a message. This opens an error message window.

  In addition, a more detailed description of the error is displayed. Configure the amount of information to be displayed using the options in the error message window. Open the configuration with the button and enable or disable the options you want.

  Table 36: Options for Displaying Error Messages

  Option	Meaning
  Show previous errors	Specifies whether all previous errors that lead to the current error, should also be shown.
  Show One Identity error numbers	Specifies whether internal error numbers are shown.
  Show error positions	Specifies whether error position are also shown in the program code.
  Wrap long lines	Specifies whether long error messages are wrapped.
  Show only user relevant	Specifies whether all error messages or only message classified as "user relevant" are shown.
  Show asynchronous calls	Specifies whether error messages in asynchronous method calls are shown.
  Show crash report	Specifies whether error messages from the crash recorder are shown.

  NOTE: The button Send as mail creates a new email message in the default mail program and copies over the error text.

• To save all the messages in a file, select the entry and select Save log to file... from the context menu.
• To add a message to the clipboard, select the entry and user CTRL + C.

If errors occur, these are shown immediately in a separate log window during compilation.

• If you double click on the error message with the mouse you jump to the corresponding line in the source code view (upper part of the window). You can only view the source code you cannot edit it.
• Use the Save button to save the error messages to file.
• Use the Close button to close the error log. Then the compilation continues.

Figure 12: Error Message Log

Working with Change Labels

Define change labels under which changes are grouped together in order to swap data between development and test databases as well as the productive database.

You can create and edit change labels in different One Identity Manager tools. The method is similar in all tools. Change labels are allocated using different methods depending on the One Identity Manager tool. Changes are normally allocated before or on saving the changes in the database.

Change labels are available in the program "Database Transporter" as export criteria for creating custom configuration packages.

Change labels can contain:

• Changes to single object properties at a specific point in time

  When you create a custom configuration package, single object properties are added to the transport package. The properties contain the values given at the time they were added.

  IMPORTANT: This is the default process when applying changes in the Designer. If you apply this method, be consistent in booking all changes to the change label when the object is saved. It is not possible to add changes of individual properties to the change label at a later date.

• Snapshots of an object at a specific point in time, optionally with dependent objects

  When you create a custom configuration package, the object is added to the transport package with all its properties. The properties contain the values given at the time they were added.

• Reference to an object, optionally with dependent objects

  When you create a custom configuration package, the object is added to the transport package with all its properties. The properties are determined at the time of export.

  IMPORTANT: Object references cannot be grouped together with changes to single properties and snapshots of objects in the same change label. Book object references to their own change labels.

Detailed information about this topic

• Creating Change Labels
• Displaying Contents of a Change Label
• Booking Changes to a Change Label Retrospectively
• Making and Committing Changes to Objects
• Transport by Change Label

Creating Change Labels

You can create and edit change labels in different One Identity Manager tools. The method is similar in all tools and is explained in the following example from the Designer.

To create or edit change labels

1. in the Designer menu, click Database | Change management....
2. In the dialog box "Edit change labels...", select the icon next to the list Change labels.

   A dialog box for editing change labels is opened.

3. Create a new change label with the button.

   - OR -

   Select a change label and open the edit view with the button.

4. Enter the change label data.

   Table 37: Properties of change labels

   Property	Meaning
   Change label	Change label name. This name is used to select the change label for allocating the changes or creating a customer transport package.
   Description	Detailed description of the change label.
   Parent change label	Option to enter a specific parent change label.
   Status	Status of object changes, for example: development, test, production.
   Status comments	Additional status comments
   Comment	Additional information about changes made to a change label.
   Label type	Label type for further classification. Label type "Change" is used by default.
   Locked	Indicates if the change label is locked. If a change label is locked, you can no longer make changes to it.

5. Click the button.
6. Click OK.

   This closes the dialog box. The change label is preselected in the Change label.

To delete a change label

1. In the Manager menu, select Database | Edit change labels...
2. Click the button next to the Change labels list.

   A dialog box for creating and editing change labels opens.

3. Select the change label you want to delete and click the button.
4. Confirm the security prompt with Yes.
5. To close the dialog box, click Cancel.
6. To close the dialog box, "Edit change labels..." click OK.

Related Topics

• Displaying Contents of a Change Label
• Booking Changes to a Change Label Retrospectively