Skip to main content
Skip table of contents

Create Outbound Integration Setting


Administrators can create outbound integration settings so developers can query records from Nimble AMS.

Create Outbound Integration Setting

  1. In the tab bar, click 
    App Launcher, or in Salesforce Classic, click 
    Nimble AMS, Staff View, Button, All Tabs.
  2. Click Integration Settings.
  3. Click New.
  4. In Record Type, select Outbound Data.

  5. In Name, enter the name the developer will use to identify the integration to execute. 
  6. In Description, enter a description you can reference to understand the purpose of the integration setting.
  7. In Authentication Key, enter a secure authentication key. 

    We recommend using a unique 256-bit WEP authentication key for each integration setting. You can generate a random key, using a random key generator such as Random Key Generator (external).

  8. In Query, enter the SOQL query to execute. 

    If you want to parameterize the query, put parameters within << and >> so the developer can pass in parameters at run time.

    Here is an example of a query which selects products with a given event code. When executed, the web service expects a parameter named “event_code” with a value.

    SQL
     SELECT Id, Name, NU__Status__c FROM NU__Product__c WHERE Event_Code__c = '<<event_code>>'
  9. In Sharing Mode, select:
    • With Sharing—Query executes based on the executing user's security permissions
    • Without Sharing—Query executes without regard for the executing user's security permissions
  10. If you need to query records using complex logic, in Class, enter the name of the Apex class that implements the IIntegrationOutboundDataProvider interface.

    If more complex logic is needed than is possible within a single SOQL query, an Apex class can be created to do the more complex query logic. Creating an Apex class requires development effort.

  11. Status is populated.

  12. If you want to record log detail for the integration setting, in Logging Level, select the log detail level. More information about the level of detail stored can be found on the Understanding Logging Level page.

  13. Click Save.

Preview Outbound Integration Setting

Administrators can preview an outbound integration setting and change the Query as needed. This is useful to ensure the Query is returning the expected results before sharing the integration with the external app.

  1. In the tab bar, click 
    App Launcher, or in Salesforce Classic, click 
    Nimble AMS, Staff View, Button, All Tabs.
  2. Click Integration Settings.
  3. Select a list view—like All Outbound Integrations—and click Go!
  4. Click the name of the integration setting you want to preview.
  5. Click Preview.
  6. The JSON result that is passed back through the Nimble Fuse API displays.




JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.