Chat now with support
Chat with Support

Identity Manager 8.2 - API Designer User and Development Guide

API Designer Basic principles of API development Examples and help – Software Development Kit Quick start – Creating an API Working with the API Designer
Starting the API Designer Project types User interface Global settings Database objects Labeling changes Find and replace Multilingual captions Managing database queries Managing tabs Managing layouts Displaying the change history (command list) Bookmarks Compiling an API Managing versions (compilation branches) Testing an API Linking C# projects to the API Designer
API projects API methods API Server ImxClient command line program

Configuring the compilation

Use the Compilation settings node in the definition tree view to configure the settings for compiling the API.

If you want to use code from other DLLs in your API code (for example, API files from other projects), you need to create an assembly reference so that the compiler recognizes these DLLs.

To create an assembly reference

  1. In the menu bar, click View > Navigation.

  2. Click API projects in the navigation.

  3. In the tree structure, double-click the API project to be edited.

  4. In the definition tree view, right-click the Compilation settings node.

  5. In the context menu, click Assembly reference.

    The Assembly reference node is added under this node.

  6. In the definition tree view, click Assembly reference.

  7. Click View > Node editor on the menu bar.

  8. In the node editor view, enter the name of the assembly you wish to reference into the Referenced assembly field.

  9. On the menu bar, click (Save).

Related topics

Assigning API files to an API project

In order for the API files you have created to be used practically, they must be assigned to an API project.

To assign API files to an API project

  1. In the menu bar, click View > Navigation.

  2. Click API projects in the navigation.

  3. In the tree structure, double-click the API project to be edited.

  4. In the definition tree view, right-click the topmost node.

  5. In the context menu, click API file reference.

    The new API file reference node is added.

  6. In the definition tree view, click API file reference.

  7. Click View > Node editor on the menu bar.

  8. In the node editor view, enter a unique ID for the node into the Control ID field.

  9. Select the required file in the Name list.

    TIP: To skip directly to the file definition, click (Show definition object).

  10. On the toolbar, click (Save).

Related topics

Importing API projects

You can import API projects into the API Designer. The API Designer independently detects whether the projects are API projects, and imports them as such.

To import an API project

  1. In the menu bar, click Edit > Import object.

  2. In the file browser, select the required API project and click Open.

    The API project is imported.

Related topics

API methods

You can use an API method to create a call for exchanging data with the server (or database) relating to a specific application scenario. An API method can belong to more than one project. In an API method, you can define an API method, for example.

NOTE: If you create a new API method to provide a new API method, you must name the API method the same as the class. Ensure you use the correct case.

Using the API Designer, you can define the following types of API methods in API methods

Entity methods

Entity methods work with small parts of the object model in order to read data from the database or write data to the database. When you create an entity method, you only need to enter the table and column name and, if required, a filter condition (WHERE clause). Internal processing is handled by the API Server. The data schema for the input and output also has a specific format.

For examples for the definition of entity methods, see the SDK under Sdk01_Basics\01-BasicQueryMethod.cs.

User-defined methods

User-defined methods are methods for which you fully define the processing, input, and output data in code. This type therefore offers the greatest flexibility.

For examples for the user-defined methods, see the SDK under Sdk01_Basics\03-CustomMethod.cs.

SQL methods

SQL methods are methods that provide data from a predefined SQL query through the API. Create the parameters of a query as SQL parameters.

For examples for the definition of SQL methods, see the SDK under Sdk01_Basics\02-BasicSqlMethod.cs.

Related topics
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating