Create an External Data Group in an Intrexx Application

The following section describes how to create an external data group that references the Intrexx DRACOON Connector.

Step-by-Step

To create an external data group in an Intrexx application, follow these steps:

1. Start the application in which you want to create the external data group.

2. Select the application and right-click.

3. From the context menu, select "External Data Group."

   The "Properties - External Data Group" dialog box, "General" tab, appears.

   

   Title

   Enter the title of the external data group here.

   Database Connection

   Select "dracoon_<connector name>dracoon" here (e.g., "dracoon_dracoon").

   Data Handler

   Select "Connector API - Data Handler" here.

   Table / View

   1. Click the " " icon.

      The "Find Tables / Views" dialog box appears.

      

   2. Click Search.

      The data groups available in the " Intrexx DRACOON Connector " are displayed.

      

      For detailed information on the standard data groups, see the " Standard Data Groups in the Intrexx DRACOON Connector" section .

   3. Select the desired table or data group.

      (In this guide, the "CONNECTOR_API.DracoonDataSpace" table is selected as an example.)

   4. Click "OK."

4. Switch to the "Data Fields" tab.

   

5. Click the " " icon.

   The "Select Data Field" dialog box appears.

   

   (The screenshot shows the data fields available in the "CONNECTOR_API.DracoonDataSpace" table.)

6. Select the data fields you want to add to the external data group.

   Data groups "PublicShareDownload" and "PublicShareUpload" - Data type "file"

   If you use the data groups "PublicShareDownload" and "PublicShareUpload," you must ensure that the key "dracoon.service.isShare" is added to the expert settings of the "file" field and set to "true."

   

7. Click "OK."

   You will be taken back to the "Data Fields" tab.

   The data fields are displayed.

   

8. Switch to the "Expert" tab.

   The following keys and values are displayed:

   Attribute	Value
   connector.dataGroup.adapter.class	de.uplanet.lucy.server.odata.consumer.dracoon.DracoonDataSpaceDataGroupAdapter
   dracoon.dataspace.id	4711 (Example)

   Customize Data Room ID, Folder ID

   The value of the "dracoon.dataspace.id" attribute is derived from the corresponding setting in the Intrexx Connector for DRACOON. For more information , see the section "Specifying the Data Room ID and Folder ID."

   The data space ID and folder ID are required in Intrexx for the "dracoon.dataspace.id" and the "parentId" parameter, respectively.
   

   You can edit the data room ID or folder ID here.

   In the next steps, you'll need to add additional attributes and values.

9. Click on " Settings " ().

   

10. Click the - icon ().

    The "Edit Settings" dialog box appears.

    

11. In the "Key" field, enter the value "dracoon.service.root.uri".

12. In the "Value" field, enter your DRACOON service URI, e.g., https://example.dracoon.software.

    If you want to access DRACOON using a service account, you must also add the following key or value:

    Attribute	Value
    connector.impersonation.user	The GUID of the Intrexx user you want to use as a service user in the Intrexx Connector for DRACOON.

    For detailed information on this topic, see the section Assign a Service User to an External Data Group."

13. Click "OK."

More Information

For more information on external data groups in Intrexx, see the following section, "External Data External Data Group."