Connectors / Service / Sedna

Artisan IMG > Sedna (sedna)

Sedna

Sedna simplifies complex business transactions.

Overview

Sedna consolidates information regarding transactions. It brings together messages, documents and other data from disparate sources, making transaction management easier.

Authentication

When using the Sedna connector, the first thing you will need to do is go to your Tray.io account page, and select the workflow you wish to work on. Once in the workflow dashboard itself, search and drag the Sedna connector from the connectors panel (on the left hand side) onto your workflow.

With the new Sedna connector step highlighted, in the properties panel on the right, click on 'New Authentication' which is located under the 'Settings' heading.

sedna-auth

This will result in a Tray.io authentication pop-up window, that should look like this:

sedna-popup-1

You will first need to name your authentication, and proceed by clicking 'Next Step'. The next page that appears should look like this:

sedna-popup-2

As you can see, you will need the subdomain for your Sedna account, along with your username and password. Fill these out, and then click 'Add authentication'.

Once you have clicked the 'Add authentication' button, go to back to your authentication field (within the workflow dashboard properties panel from earlier), and select the recently added authentication from the dropdown options now available.

Your connector authentication setup should now be complete.

Available Operations

The examples below show one or two of the available connector operations in use.

Please see the Full Operations Reference at the end of this page for details on all available operations for this connector.

Using the Raw HTTP Request ('Universal Operation')

As of version 1.0, it is now possible to effectively create your own operations.

This is a very powerful feature which you can put to use when there is an endpoint in Sedna which is not used by any of our operations.

To use this you will first of all need to research the endpoint in the Sedna API documentation, to find the exact format that Sedna will be expecting the endpoint to be passed in.

Note that you will only need to add the suffix to the endpoint, as the base url will be automatically set (the base url is picked up from the value you entered when you created your authentication).

The base url is in the format of https://<YOUR_SUBDOMAIN>.sednanetwork.com/platform/2019-01-01

For example, say that the 'Sedna' operation did not exist in our Sedna connector, and you wanted to use this endpoint, you would use the Sedna API docs to find that the 'Sedna' endpoint is a get request at the following url:

sedna-get-url

The endpoint you would need to provide for this operation is /team. (Note you do not need to include /2019-01-01, since that is configured as part of the connector's base url.)

The step configuration should look like this:

sedna-raw-http

When run, this will return details about the teams in your Sedna account.

Example usage

TRAY POTENTIAL: Tray.io is extremely flexible. By design there is no fixed way of working with it - you can pull whatever data you need from other services and work with it using our core and helper connectors. This demo which follows shows only one possible way of working with Tray.io and the Sedna connector. Once you've finished working through this example please see our Introduction to working with data and jsonpaths page and Data Guide for more details.

Below is an example of a way in which you could potentially use the Sedna connector, to list all of the job references associated with each user in your account.

The steps will be as follows:

  1. Add 'List users' step

  2. Add Loop collection

  3. Add 'List user job references' step

The final outcome should look like this:

sedna-complete-workflow

1 - Setup trigger & add 'List users' step

Once you have clicked 'Create new workflow' on your main Tray.io dashboard (and named said new workflow), select the Manual trigger from the trigger options available:

sedna-manual-trigger

Once you have been redirected to the Tray.io workflow dashboard, from the connectors panel on the left, add a Sedna connector to your second step. Set the operation to 'List users'.

sedna-workflow-step-1

Feel free to re-name your steps as you go along to make things clearer for yourself and other users.

When run, this workflow will list all users in your Sedna account.

2 - Add Loop Collection

The Loop Collection allows you to iterate through a list of results. In this example, we will use it to iterate through each user that was returned by the previous step.

Search 'loop collection' and drag it into your workflow as the next step:

sedna-workflow-step-2

JSONPATHS: For more information on what jsonpaths are and how to use jsonpaths with Tray.io, please see our Intro page and Data Guide for more details.

CONNECTOR-SNAKE: The simplest and easiest way to generate your jsonpaths is to use our feature called the Connector-snake. Please see the main page for more details.

You can specify the list you want to loop through using the 'List' input field. Use the connector-snake to assign this field to the 'data' array that is produced by the 'List users' step:

sedna-workflow-step-2-2

When run, this workflow will iterate through the list of users provided. However, at the moment it doesn't do anything with that list.

3 - List user job references

We are now going to use the Loop Collection to list the job references associated with each user.

First, add a new Sedna connector step inside the Loop Collection:

sedna-workflow-step-3

Next, configure it with the right user ID. Use the connector-snake to assign the 'User ID' field to the id value output by the Loop Collection:

sedna-workflow-step-3-2

Now, when this workflow is run, it will first list every user, and then for each individual user, it will list the job references they are associated with.

BEST PRACTICES: Whenever you do decide to create your own workflow, please make sure you take a look at our managing data best practices guide.

All Operations

Latest version:

1.3

Get event message relationship

Retrieves the relationship between the specified event and its message.

List category tag team relationships

Retrieves a list of relationships between teams and a specified category tag.

List message documents

Retrieves the documents attached to a message.

List message job reference relationships

Retrieves a list of relationships between job references and a specified message.

Get event job reference relationship

Retrieves the relationship between the specified event and its job reference.

Add job references to user

Adds job references to a user.

Add teams to category tag

Adds a team to a specific category tag.

Add category tags to message

Adds category tags to a message.

Add contact to group

Adds contact(s) to a group.

Add job references to message

Assigns job references to a message.

Create category tag

Creates a category tag.

Create contact

Creates a new contact.

Create contact group

Creates a new contact group.

Create job reference

Create a job reference.

Get event message

Retrieves the message associated with an event.

Create team

Creates a new team.

Delete category tag

Deletes a category tag by its ID.

Delete contact

Deletes a contact by its ID.

Delete contact group

Deletes a contact group by its ID.

Delete job reference

Deletes a job reference.

Get category tag

Retrieves a category tag by its ID.

Get contact

Retrieves a contact by its ID.

Get contact group

Retrieves a contact group by its ID.

Get document

Retrieves a document by its ID.

Get event

Retrieves an event by its ID.

Get event category tag

Retrieves the category tag that belongs to the specified event.

Get event category tag relationship

Retrieves the relationship between the specified event and its category tag.

Get event job reference

Retrieves the job reference that belongs to the specified event.

Get job reference

Retrieves a job reference by its ID.

Get message

Retrieves a message by its ID.

Get team

Retrieves a team by its ID.

Get user

Retrieves a user by its ID.

Get user company

Retrieves the company that the user belongs to.

List category tag teams

Retrieves a list of teams associated with a given category tag.

List category tags

Retrieves a list of category tags.

List contact groups

Retrieves all contact groups.

List contact team relationships

Retrieves a list of contact-team relationships.

List contacts

Retrieves all contacts.

List events

Retrieves a list of events.

List job reference team relationships

Retrieves a list of relationships between teams and the specified job reference.

List job references

Retrieves a list of job references.

List message category tag relationships

Retrieves a list of relationships between category tags and a specified message.

List message category tags

Retrieves the category tags associated with a message.

List message document relationships

Retrieves a list of relationships between documents and a specified message.

List message job references

Retrieves the job references associated with a message.

List message team relationships

Retrieves a list of relationships between teams and a specified message.

List message teams

Retrieves the teams associated with a message.

List teams

Retrieve all teams.

List user job references

Retrieves a list of job references associated with a specific user.

List users

Retrieves a list of users.

Raw HTTP Request (Advanced)

Perform a raw HTTP request with some pre-configuration and processing by the connector, such as authentication.

Remove category tag from teams

Deletes relationships between a category tag and various teams.

Remove category tags from message

Remove category tags from a message.

Remove contact from group

Remove contact(s) from a group.

Remove job references from message

Removes job references from a message.

Update contact group

Updates a contact group by its ID.

Remove job references from user

Removes job references from a user.

Update category tag

Update a category tag.

Update category tag relationships

Update teams in a category tag's team relationships.

Update contact

Updates a contact.

Update job reference

Update a job reference.

Update team

Updates team.