Skip to main content

Symon.AI Help Center

Importing from Incentives

Abstract

Use Incentives as a data source to import or export data for Symon.AI.

Integrate with Incentives using your Symon.AI API keys. Do this step before you configure Incentives as a connector.

Before you add and configure Incentives as a connector in Symon.AI , you must integrate the connection with your Symon.AI API keys first.

Setting up the Symon.AI and Incentives integration
  1. Go to Symon.AI.

  2. Click your username.

  3. Click Account.

  4. Click Generate API keys.

  5. Click Generate key. Copy and save the key you generate.

  6. Go to Incentives.

  7. Click the Model settings menu.

  8. Go to the Integrations tab.

  9. Enter your Incentives credentials and paste the Symon.AI API key.

  10. Click Save.

For more information about setting up the Incentives integration, see: Setting up the Varicent ELT integration.

Set up the connection between Symon.AI and Incentives as a source to import or export data.

In Symon.AI, you can add Incentives as a connector for imports and exports. You can use this connection to import data from Incentives objects like tables, calculations, and data stores. You can also export your Symon.AI results to a new table in Incentives or update an existing one.

Note

Ensure all data is within a date range between 1677-09-21 00:12:43.145224193 and 2262-04-11 23:47:16.854775807. Symon.AI doesn't support dates outside of the date range. If the dates are outside of the date range, you could see the following behaviour:

  • The date range will show the wrong dates if you don't drop or obfuscate columns.

  • The date range will show blank dates if you drop or obfuscate columns.

  1. From the Data tab, click Import data.

  2. Select Incentives as a third party source.

  3. Click + New connection.

  4. Enter your API key.

    Tip

    To get your API key, go to your Symon.AI username, click User options, and then click Generate API key or Rotate API key.

  5. Enter your model name.

  6. Select your admin client Domain Name.

  7. Click Next.

  8. From the Directory drop-down menu, select an object to import into Symon.AI.

  9. Click Next.

  10. Review the data source. You can also rename the data source from this page.

  11. Click Import data.

The imported data source is now available from the Data tab.

Before you set up the data source connection between Symon.AI and Incentives, ensure that you know what type of permissions you have. The type of permissions you have will guide how you set up the connection.

Creating a successful connection relies on the type of permissions that a user has in Varicent Incentives.

Users with specific Data Stores and Data Tables permissions:

If you are a user with permissions only to specific Data Stores or Data Tables, choose Data Stores or Data Tables in the Directory drop-down during the connector configuration. All Data Stores and Data Tables available to you will appear.

Users with Calculation and View permissions:

If you are a user with Calculate and View permissions, and choose Calculations in the Directory drop-down menu during the connector configuration. All calculations available to you for the assigned Data Stores or Data Tables will appear.

Users without permissions:

If you are a user without permissions in Varicent Incentives, you will not be able to set up the connection between Symon.AI and Varicent Incentives.

If you've already set up the integration and the connector to Incentives, you can add Incentives as data source.

  1. From the Data tab, click Import data.

  2. In the Connectors section, select Incentives.

  3. Select a connection, or create a new connection.

    For more information on creating a new import connection, see: Incentives.

  4. Select a model to connect to.

  5. From the Directory drop-down menu, select an object to import into Symon.AI.

    Note

    The options available in the Directory drop-down menu depends on the permissions you have in Incentives. For more information, see Varicent Incentives permissions.

  6. Click Next.

  7. Configure the data obfuscation as needed.

  8. Click Next.

  9. Review the data source. You can also rename the data source from this page.

  10. Click Import data.

The imported data source is now available from the Data tab.