Tchater maintenant avec le support
Tchattez avec un ingénieur du support

Identity Manager 8.1.4 - 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 files 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. On 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. Click Save on the toolbar.

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. On the menu bar, click View | Navigation.

  2. In the navigation, click API projects.

  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. Click Edit | Import object on the menu bar.

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

    The API project is imported.

Related topics

API files

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

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

You can use the API Designer to create the following API files.

Entity files

Entity files 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 file, 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 files, see the SDK under Sdk01_Basics\01-BasicQueryMethod.cs.

C# files

C# files are files for which you fully define the processing, input, and output data in code. This type therefore offers the greatest flexibility.

For examples for the definition C# files, see the SDK under Sdk01_Basics\03-CustomMethod.cs.

SQL files

SQL files are files 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 files, see the SDK under Sdk01_Basics\02-BasicSqlMethod.cs.

Related topics
Documents connexes

The document was helpful.

Sélectionner une évaluation

I easily found the information I needed.

Sélectionner une évaluation