Documentation

Custom Connectors

Build Your Own Writeback Connector (Beta)

You can build your own Writeback connector in Domo in the Connector Dev Studio >> Let’s Build! section.

You need to complete the following steps when building a custom Writeback connector:

  1. Create a new Writeback connector
  2. Upload connector icon images
  3. Configure user authentication
  4. Configure selectable reports
  5. Define how the data is processed

After you have completed these steps, you can submit the connector for publishing. Domo developers will review the connector, perform some engineering magic, and notify you when your connector is available for use.

You can build your own Writeback connector only when it is enabled  for you.

Create a new Writeback connector

  • Click the Build Now button at the bottom of the screen to create a new connector.
  • My Connector Developer page will appear. Here, you will need to fill up the Custom Connector User Agreement.
  • After accepting the agreement, click on the Create New  button.

  • Click on the Writeback Connector tile.

  • Name your connector screen will appear. Provide a name for your Writeback connector and click Create button.

Upload Connector Icon images

  • Once you have created your Writeback connector, you need to upload the connector icon.

  • Select the desired icon image for your connector and click Upload.

Configure Domo authentication

You need to configure the Domo authentication after uploading the icon image for your Writeback connector.

  • Specify your Domo Client Key and Domo Client Secret, and click Next.

Configure authentication to third party API

Configure authentication to third party API

Define how data is processed

Define how data is processed

Submit for publishing

After you have written and tested your connector, you are ready for publishing! You can choose to make the connector only available to your private company or available to any Domo user. Follow the guide below to submit the connector for approval. Once approved, your connector is ready to go!

  • Click Submit for Publishing.

Writeback Methods


DOMO.listDatasets();

Returns:
a list of all DOMO dataset IDs


DOMO.getDataset(datasetId);

datasetId = ID of dataset within DOMO that you’d like to pull data from.
Example:

id = 'cd64fdef-6106-48c2-948a-2b5e160cad2d'; 

Returns:
a full dataset object


DOMO.queryData(datasetId, query);

datasetId = ID of dataset within DOMO that you’d like to pull data from.
query = the sql command you’d like to perform on returned data
Example:


query = "select * from tbl where action = 'open'";

Best practices:
- let id = 'cd64fdef-6106-48c2-948a-2b5e160cad2d'; 
- let query = "select * from tbl where action = 'open'"; 
- let data = DOMO.getDataset(id).queryData(query);

Where can I find the DataSet ID?

  • You can find the DataSet ID in the URL of the dataset.