Share

Share lets you share a workflow, a file, a database, expressions, or a Python script with another user at your organization. Note that using Share is different from using the Collaborate to work on a workflow with a different user at the same time. Sharing a workflow with another user simply lets that user replay the workflow without making changes to it. Collaborating on a workflow lets the other user make changes to the workflow.

Note that you can only share a snapshot or workflow with one user at a time.

Format

Share has two utterances you can use to share workflows:

• Share the workflow <workflow name> with <user emails>.
• Share the workflow <workflow name> with all users in my organization. Note that you must be a level three user to share a workflow with all of the users in your organization.

Share has a single utterance you can use to share a file with another user: Share the file <file name> with <user emails>.

Share has a single utterance you can use to share a saved database with another user: Share the database <database name> with <user emails> calling the shared database <shared database name>.

Share has a single utterance you can use to share a connection to a database with another user: Share the connection <connection name> (<with/without credential data>) with <user emails>.

Share has a two utterances you can use to share a Python script with another user:

• Share the script <script name> with <user emails>.
• Share the script <script name> with all users in my organization. Note that you must be at least a level 2 user to share a script with all of the users in your organization.

Share has a single utterance you can use to share a group of expressions with another user: Share the definition file <file> with <user emails>.

Parameters

Share uses the following parameters:

• workflow name (required). The name of the workflow file to load. 
• user emails (required). A comma-separated list of emails for the users with whom you're sharing the workflow, file, or database.
• file name (required). The name of the file you want to share.
• database name (required). The name of the database to share.
• shared database name (optional). The name the database should appear with for the other users.
• connection name (required). The name of the database connection to share.
• with/without credential data (required). Whether to send credential information (such as user names and passwords) along with the rest of the database connection information.
• script name (required). The name of the script you want to share.
• file (required). The name of the saved expression file in the database you want to share.

Output

If the workflow is shared successfully, the platform returns a success message.

If the workflow is not shared successfully, the platform returns an error message.

Examples

To share a workflow named "calculate_average_sales" with Mark, enter Share the workflow calculate_average_sales with mark@yourorg.com.

To share a file called "Q1_Sales.csv" with Mark and Raj, enter Share the file Q1_Sales.csv with mark@yourorg.com, raj@yourorg.com.

To share a database called "SalesDB" with Mark and Raj, and to have it appear to them as "Q1SalesDB," enter Share the database SalesDB with mark@yourorg.com, raj@yourorg.com calling the shared database Q1SalesDB.

To share a connection (including the credential information) called "Inventory" with Beth and Tina, enter Share the connection Inventory with credential data with beth@yourorg.com, tina@yourorg.com.

To share a script called "data_cleaner" with Mark and Raj, enter Share the script data_cleaner with mark@yourorg.com, raj@yourorg.com.