Sample Application as a Template

The sample application, along with the configuration file, is designed to help you get started with creating your own DRACOON application. You'll find that many of the features offered by Intrexx DRACOON Connector are already implemented there.

To ensure a successful start with the sample application, you'll need to make a few adjustments. The goal here is to connect to your DRACOON account, or to create your DRACOON Web App.

You'll need the following information to set up the sample application:

  • Authorization URI

  • Dracoon Root URI

  • Client ID

  • Client Secret

  • Redirect URI

  • Token URI

  • Data Room ID, Folder ID

  • GUID of the sample application: F100FE46C809B95A41977D74DBEAB1B0BF03B604

To perform the action described here, you need the appropriate permissions on the Intrexx server.

You can find the DRACOON sample application and the DRACOON configuration file in the following directory:

<intrexx-installation-directory>\adapter\dracoon

 

To perform the action described here, you need the appropriate permissions on the Intrexx server.

Copy the file "dracoon_dracoon.xml".

Place the file in the following directory:

<intrexx-installation-directory>\org\<portal-directory>\internal\cfg\odata\connector

 

Step-by-Step

To create the " Intrexx DRACOON Connector," follow these steps:

  1. Launch the "Integration" module.

  2. Under "Consume Data," select "Connector for Connector API."

  3. Right-click.

    A dialog box appears.

  4. Click "Refresh."

    " Intrexx DRACOON Connector " is displayed.

Requirements

To set up the Intrexx DRACOON Connector, you'll need the following information from your DRACOON data room or DRACOON Web App:

  • Data Room ID, Folder ID

  • Dracoon Root URI

  • Client ID

  • Client Secret

You will also need the GUID of the imported sample application. It reads as follows:

F100FE46C809B95A41977D74DBEAB1B0BF03B604

Step-by-Step

To set up the Intrexx DRACOON Connector, follow these steps:

  1. Double-click the DRACOON Connector.

    The "General" dialog box appears.

  2. Enter a descriptive description in the "Description" field.

  3. In the left pane, click "Data Groups."

    The "Data Groups" dialog box appears.

    For detailed information on the individual data groups and their use, see the " Standard Data Groups in the Intrexx DRACOON Connector" section .

    Enter the data room ID and folder ID

    You will need to make adjustments to the "DracoonDataSpace" data group, as it refers to your data rooms or folders on DRACOON.

  4. Select the "DracoonDataSpace" data group.

  5. Click the " " icon.

    The "Data Groups" dialog box appears.

  6. In the data group settings, enter your data room ID or folder ID for the "dracoon.dataspace.id" attribute.

    The value specified here serves as a fallback value. You can adjust the fallback value in the external data group in the Intrexx application. See the section " Adjusting the Fallback Value for the Data Room ID" for more information .

    If you do not enter a value here, the contents of the top-level data room will be loaded.

  7. Click "Finish."

  8. In the left pane, click "Authentication."

    The "Authentication" dialog box appears.

  9. You must enter the appropriate values in the following fields.

    Authorization URI

    The authorization URI is structured as follows:

    <DracoonRootURI>/services/oauth/authorize

    Example

    https://example.dracoon.software.com/services/oauth/authorize

    Token URI

    The token URI is structured as follows:

    <DracoonRootURI>/services/oauth/token

    Example

    https://example.dracoon.software.com/services/oauth/token

    Redirect URI (Redirect URL)

    For the Redirect URI, you must replace "dracoon_dracoon" with the GUID of the sample application.

    It reads as follows: F100FE46C809B95A41977D74DBEAB1B0BF03B604

    Example

    https://exampleportal/oauth2/token/F100FE46C809B95A41977D74DBEAB1B0BF03B604

    Base URL You can find the base URL in the main menu under "Portal > Portal Properties > Frontend Web Server."

    Client ID

    Static: Enter the client ID from the portal registration in DRACOON here (see " Register the Intrexx Portal as an app in DRACOON").

    Client Secret

    Static: Enter the client secret and client ID from the portal registration in DRACOON here (see " Register the Intrexx Portal as an app in DRACOON").

  10. In the left pane, click "Service Users."

    The "Service Users" dialog box appears.

  11. Delete the service user shown.

    Create a New Service User

    1. Click the " " icon.

      The "User Selection" dialog box (1) appears.

    2. Click the " " icon.

      The "User Selection" dialog box (2) appears.

    3. Select "Administrator."

    4. Click "OK."

      You will return to the "User Selection" dialog box (1)

      Client ID

      Enter the username (!) of the DRACOON user who is to be used as the service user here.

      Client Secret

      Enter the password (!) here for the DRACOON user who is to be used as the service user.

      Scope

      Enter the value "all" here.

    5. Click "Finish."

  12. In the left pane, click "Expert Settings."

    The "Expert Settings" dialog box appears.

  13. Select the "dracoon.service.root.uri" attribute.

  14. Double-click in the "Value" column.

  15. Replace "xxxxxxx" with the value that applies to you, or enter your Dracoon Root URI.

  16. Click "OK."

The DRACOON sample application is imported in the same way as other applications.

You can find the DRACOON sample application in the following directory:

<intrexx-installation-directory>\adapter\dracoon

Step-by-Step

To import the DRACOON sample application, follow these steps:

  1. Launch the "Applications" module.

  2. Click "File > Import Application."

    The "File Selection" dialog box appears.

  3. Click the - icon.

    File Explorer appears.

  4. Navigate to the following directory:

    <intrexx-installation-directory>\adapter\dracoon

  5. Select the "DracoonBeispielApp.zip" file.

    The "File Selection" dialog box appears.

  6. Click "Next."

    The "Import" dialog box appears.

  7. Click "Next."

    The "File Locations" dialog box appears.

  8. Click "Next."

    The "Import" dialog box appears.

  9. Click "Import."

    The import process is running.

  10. Click "Finish."

    You will be taken back to the "Applications" module.

Requirements

To configure the DRACOON sample application, you'll need the following information from your DRACOON data room or DRACOON Web App:

  • Data Room ID, Folder ID

  • Dracoon Root URI

Overview

In all external data groups, you must enter your Dracoon Root URI on the "Expert" tab.

In the "DracoonDataSpace" external data group, you must also enter your data room ID or folder ID on the "Expert" tab and in the "file" data field.

The following section describes the configuration for the external data group "DracoonDataSpace" as an example.

Step-by-Step

To configure the "DracoonDataSpace" external data group in the sample application, follow these steps:

  1. Launch the DRACOON sample application you imported earlier.

    After the import, it looks like this:

  2. Double-click the external data group "DracoonDataSpace."

    The properties of the external data group are displayed.

    Configure the "file" data field

  3. Switch to the "Data Fields" tab.

  4. Select the "file" data field.

  5. Click the " " icon.

    The "Data Field Properties dialogg box appears.

  6. Switch to the "Expert" tab.

  7. For the "dracoon.dataspace.id" key, enter your DRACOON data room ID or the desired DRACOON folder ID.

    Set your Dracoon root URI for the "dracoon.service.root.uri" key.

  8. Click "OK."

    You will return to the "Properties - Data Group" dialog box.

  9. Switch to the "Expert" tab.

  10. For the "dracoon.dataspace.id" key, enter your DRACOON data room ID or the desired DRACOON folder ID.

    Set your Dracoon root URI for the "dracoon.service.root.uri" key.

  11. Click "OK."

  1. Save the sample application (publish the application in full).

  2. Open the portal in your browser.

    You will be prompted to log in to your DRACOON account.

    After logging in, the DRACOON sample application will be displayed.

    The menu items in the sample application represent DRACOON's core functionalities.