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

Menu bar

You can use the menus on the menu bar to access submenus and to access and run many functions in API Designer quickly. The following table provides you with information about each menu.

Table 1: Menus and menu items on the menu bar.
Menu Menu item Description

Connection

 

Settings

Opens the Global settings dialog. You can configure the basic settings for API Designer here.

For more information, see Global settings.

 

Exit

Closes the program.

Edit

 

Set project type

Opens the Select the project type dialog. Select whether the project should be saved as a database or solution project here.

For more information, see Project types and Changing the project type.

 

Import objects into database

Opens the Import objects into database dialog.

From here you can import new and modified objects from your solution project into your One Identity Manager database.

For more information, see Importing solution project changes into a database.

 

Change standard project file

From here you can change the solution project that is to be used here.

 

Find and replace

Opens the Find and replace dialog. You can search through documents using certain terms or strings and replace where necessary here.

For more information, see Find and replace.

 

Find next

Performs the search with the search parameters specified in the Find and replace dialog.

The search continues without reopening the dialog.

 

Captions

Opens the Multilingual captions dialog. You can create and edit multilingual captions here.

For more information, see Multilingual captions.

 

Import object

You can use this menu item to import API projects and API files into the API Designer.

For more information, see Importing API projects and Importing API files.

 

Edit database queries

Opens the Edit database queries dialog. You can add, change, or delete database queries here.

For more information, see Managing database queries.

View

 

Tabs

Opens the Tabs dialog. You can manage open tabs here. For more information, see Managing tabs.

 

Restore standard layout

Restores the default layout. For more information, see Managing layouts.

 

Restore standard layout (including size)

Restores the default layout and the default window size. For more information, see Managing layouts.

 

 

Restore saved layout

Restores the layout that you saved earlier (see Save layout on the menu). For more information, see Managing layouts.

 

Save layout

After you have customized the layout of the API Designer to suit your needs, you can save it and restore it at any time. For more information, see Managing layouts.

 

Start page

Opens the start page.

For more information, see Start page.

 

Solution

Opens the Solution window. The solution can be used to display and manage any objects in the API Designer that can be opened from the navigation menu.

For more information, see Managing objects in a project (solution).

 

Node editor

Opens the Node editor view. You can edit a node’s properties here.

For more information, see Node editor view.

 

Tasks

Opens the Tasks view. Compilation errors and warnings can be viewed here.

For more information, see Managing compilation errors and warnings (task window).

 

Command List

Opens the Command list window. You can view the change history of the selected database object here and undo any changes where necessary.

For more information, see Displaying the change history (command list).

 

Compilation

Opens the Compiling window. You can view the compilation log here.

For more information, see Opening the compiling log.

 

Bookmarks

Opens the Bookmarks window. Bookmarks can be managed here.

For more information, see Bookmarks.

 

Navigation

Opens the navigation view. This can be used to manage (create, open, delete) API files, and API projects. You can also access the most recently edited file here.

For more information, see Navigation.

Help

 

Community

Opens the One Identity forum.

 

Support portal

Opens the support portal website.

 

Training

Opens the training website.

 

Online documentation

Opens One Identity‘s documentation website.

 

Info

Opens a dialog. Detailed information on the API Designer is available here (system information, version number, information about the software producer, installed modules etc.).

Related topics

Toolbar

The toolbar contains different icons that you can click to access other functions.

Table 2: Toolbar functions
Icon Description

Change Label:

 

In the list, select the label under which changes made to the One Identity Manager database are to be saved. Use the label to make it easier to identify and assign changes to the database. For more information, see Labeling changes.

Managing change labels

Opens the Change label dialog. You can select, add, change, or delete change labels here. For more information, see Labeling changes.

Use the current change label as default

Specify that the current change label see Change label) is to be used as the default change label. This change label will automatically be selected upon API Designer startup. This setting is bound to the client and does not affect other users of the One Identity Manager database. For more information, see Using change labels.

Captions

Opens the Multilingual captions dialog. Here you can create and edit multilingual captions. For more information, see Multilingual captions.

Testing a compilation

Tests the compilation for either the Debug or Release version. For more information, see Testing a compilation.

Save

Saves changes to the object currently being edited. If you want to save changes to other database objects, select the corresponding tab in the definition tree view and click the button.

Save all

Saves changes to all objects currently being edited.

Previous/next node

Navigates backwards and forwards within the history of the selected objects. This displays the selected database object in the definition tree view.

If an object or node has been deleted, the next object is shown. If an object that no longer exists is selected in the history, the previous object is shown.

TIP: In the menu bar under Connection | Settings, you can specify the number of database objects shown in the history. The history can be deleted in the context menu using Clear history.

Related topics

Status bar

The status bar displays different status data. Some status data is shown by way of icons. Which icons are displayed is partially dependent on the program settings selected. The status bar comes in different colors.

Table 3: Meaning of the colors
Color Meaning

none

Development environment database is connected.

Red

Simulation mode is enabled.

Green

Test environment database is connected.

Yellow

Productive environment database is connected.

Table 4: Status bar icons
Icon Meaning

Shows the current user.

Shows information about the project.

The database is connected.

Shows database access.

The database must be compiled.

The program is in simulation mode.

On the status bar, the database is also shown in the following format:

<Server>/<Database (description)>

TIP: To copy the database path into the clipboard, double-click the database name in the status bar.

To see more information about the current user, double-click the user name in the status bar.

Related topics

Navigation

Open the navigation using View > Navigation (see Opening the navigation).

Use the navigation to manage (create, open, delete) API files and API projects. You can also access the most recently edited file here.

At the bottom of the navigation view, you can select whether you would like to manage API files or API projects.

The following table provides an overview of the various features available within the navigation.

Table 5: Navigation features

Control

Description

Add

Adds a new database object. The type of database object changes according to the pane you are in (API files or API projects). For detailed information, see the following sections:

Delete

Deletes a database object. For detailed information, see the following sections:

Reload data

Refreshes the view/reloads the data.

Properties

Opens the Object properties dialog. Allows you to view the properties for the selected database object. For more information, see Object properties.

Searching

Uses the search feature to find specific database objects. Enter the required search term and then press Enter.

Related topics
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating