Workflow Management
As part of workflow management, you can save the workflows you build in Designer for reuse or for sharing with other users in the Alteryx Gallery or your company's private Gallery (available to Alteryx Server users).
You can also manage existing workflows in the Gallery by opening them in Designer. From Designer, you can edit, save, and share these workflows back to the Gallery. The Gallery maintains previous versions of a workflow, so saving the revised workflow to the Gallery does not replace the previous version.
If you want to save and share a workflow along with its dependencies, such as files and connections, you can export them together as a .yxzp file. Like single file workflows, you can share exported workflows with others in the Gallery, and open them in Designer.
In addition to saving single workflows, you can save multiple workflows as a workflow group, which can then be opened as one workflow group file (.yxwg). You can only create workflow groups of existing, locally saved workflows.
![Closed](Skins/Default/Stylesheets/Images/transparent.gif)
- With the workflow open, click File > Save As.
- Select the location where you want to save the workflow:
- Click Browse.
- In Windows Explorer, go to the location where you want to save the workflow.
- In File Name, enter a name for the workflow.
- Click Save.
- Click Alteryx Gallery or private Gallery.
- Log in with your user name and password.
- In the Save Workflow window, enter a Workflow Name.
- In Worker Tag, select an option to assign a specific worker to run the workflow.
- (Optional) In Details, enter any helpful comments.
- (Optional) Click Workflow Options to select one of the following:
- View app details and click Version # to view available versions.
- Select a version and click Make Published Version.
- Select the Group assets by toolto display all of the workflow's assets or file dependencies.
- You can also select the option to display all of the assets that are grouped together with the tool they are connected to.
- Deselect an asset to omit it from the workflow package.
- Assets that include a constant in the input path display in the list of assets, but are not included in the workflow package.
- Select Restrict use to specific serial numbers to limit access to the encrypted workflow to only the specified serial numbers. Each unique serial number displays on its own line.
- Select Set expiration for encrypted workflow to set the encrypted workflow to expire on the selected date. When the expiration date is reached, the workflow cannot be run or used.
- User is not required to specify credentials: Run the workflow using the default server or studio credentials.
- User must specify their own credentials: Prompt a user to enter their own credentials to run the workflow.
- Always run this workflow with these credentials: Enter credentials to always use when the workflow is run.
- Click Save.
See Save to Gallery Messages, for more on errors and warnings you may receive when trying to save a workflow to a Gallery.
- Click Add Gallery.
- In URL, type the URL path to your company's Gallery.
- Click Connect.
- Based on the Gallery configuration, authentication steps vary:
- In Email and Password, enter your Gallery email and password.
- Select Keep me logged in, if desired.
- Click Connect.
- A user name displays.
- Click Continue to log in.
- Click the Gallery in the list and follow the steps to save the workflow to the Alteryx Gallery or a private Gallery.
![Closed](Skins/Default/Stylesheets/Images/transparent.gif)
![Closed](Skins/Default/Stylesheets/Images/transparent.gif)
Additional Considerations
To save a workflow to the Alteryx Public Gallery (gallery.alteryx.com) or to your company's private Gallery, you must have a user account. You can sign up for an Alteryx Public Gallery (gallery.alteryx.com) account at https://gallery.alteryx.com.
By default, workflows you own are saved to your private studio. Workflows that were shared with you in a collection are saved in the collection.
Select Keep me logged to keep your session active, as desired.
By default, Location displays the Gallery studio where the workflow will be saved. If the workflow has been shared with you in a collection, Location displays the Gallery collection.
Workflow Option |
Description |
---|---|
Publish this version of the workflow |
Publishes this version of the workflow as the available version in the Gallery. This option is only available if the workflow has been to the Gallery before. Do not select this option if you do not want other users to use this version of the workflow. To update the workflow version in the Gallery: |
Validate workflow then save |
(Default option) Validates that there are not any Alteryx Public Gallery (gallery.alteryx.com)-prohibited tools or commands in the workflow. If validation fails, the workflow requires an exemption to run in the Alteryx Public Gallery (gallery.alteryx.com). The following require exemptions to be run in the Alteryx public gallery: R Tool, Run Command Tool, Python Tool, Email Tool, and Download Tool. A Gallery does not allow event or chained app execution. See Workflow Configuration and Interface Designer Window. See Save to Gallery Messages for additional information about applying for an exemption. |
Manage workflow assets |
View and manage the assets associated with the workflow. |
Enable workflow encryption |
View encryption options for the workflow. See Lock Your Workflow. |
Set workflow credentials |
Select the credentials for running the workflow. |
![Closed](Skins/Default/Stylesheets/Images/transparent.gif)
Configuration Type |
Authentication Steps |
---|---|
Built-in authentication |
|
Windows authentication |
|
![Closed](Skins/Default/Stylesheets/Images/transparent.gif)
Export a workflow and its dependencies as a .yxzp package file. You must save workflow before it can be exported.
Dependency file packaging
The following assets are automatically included with an exported workflow:
- Input files
- Output references
- Macros
- Chained apps
- User-added files
The following files are not included with an exported workflow:
- Missing files
- Files identified as being part of the Alteryx installation
- Files referenced by a network path
- Input paths that contain a constant
When you export and workflow and its dependencies, Designer maintains the original file format of each file. The folder structure of the assets included in the workflow is maintained as long as the files included are children of, or siblings to, the workflow file. All other files are considered external, and, if included with the package, will be placed in an _externals folder.
Use the Workflow Dependencies, to ensure that no paths will be broken when referencing missing files.
![Closed](Skins/Default/Stylesheets/Images/transparent.gif)
- Click Options > Export Workflow to display the Export Workflow window.
- Complete any of the available configuration options:
- Click Save.
Workflow displays the name of workflow and its file extension.
See Lock Your Workflow.
![Closed](Skins/Default/Stylesheets/Images/transparent.gif)
Additional Considerations
- You can only create a workflow group of existing, locally saved workflows. If you try to create a workflow group from workflows saved in the Gallery, you must first save each workflow individually on your local drive.
- If you move or delete a workflow that is part of the workflow group, Designer displays an error when you try to open the workflow group.
- Open all locally-saved workflows to include in the group.
- Click File > Create Workflow Group.
- In Windows Explorer, go to the location where you want to save the workflow group.
- In File Name, enter a name for the workflow.
- Click Save to save the individual workflows as one workflow group file (.yxwg).
The Start Here.yxmd is not saved with a workflow group.
![Closed](Skins/Default/Stylesheets/Images/transparent.gif)
Open workflows from a file directory, the Alteryx Gallery, or from your company's private Gallery.
![Closed](Skins/Default/Stylesheets/Images/transparent.gif)
- Click File > Open Workflow.
- Click Browse, and go to the location where the workflow is saved.
- Double-click the file name to open it in Designer.
- In the Package Import message, click Yes to import the workflow.
- On the Import Workflow Package window, verify the following information:
- Package File Name: Displays the complete path to the file.
- Workflow: Displays the workflow name. The assets in the package display in the box.
- Destination Directory: Displays the location where the package will be saved. To change the location, click
and select a new location.
- Click Import.
- In the Workflow Import Progress window, click Yes to load the workflow. If the workflow failed to load properly try importing it again.
![Closed](Skins/Default/Stylesheets/Images/transparent.gif)
If the workflow is an exported (.yxzp) file, do the following:
![Closed](Skins/Default/Stylesheets/Images/transparent.gif)
- Click File > Open Workflow Group.
- Navigate to the location where the workflow group file has been saved.
- Double-click the .yxwg file to open. Each workflow within the group opens on a separate tab.
![Closed](Skins/Default/Stylesheets/Images/transparent.gif)
Additional Considerations
To open a workflow to the Alteryx Gallery or to your company's private Gallery, you must have a user account. You can sign up for an Alteryx Gallery account at https://gallery.alteryx.com.
- Click File > Open Workflow.
- Click Alteryx Gallery or private Gallery.
- Log in with your user name and password.
- In the Gallery window, locate the workflow using Search, filters, and sorts.
- Click the Versions icon to the right of a workflow to view previous versions, as needed.
- Select the workflow and click Open.
Select Keep me logged in to keep your session active, as desired.
This option must be enabled in Gallery to be visible in Designer.
See Save to Gallery Messages, for more on errors and warnings you may receive when trying to save a workflow to a Gallery.
![Closed](Skins/Default/Stylesheets/Images/transparent.gif)
- Click File > Open Workflow.
- Click Add Gallery.
- In URL, type the URL path to your company's Gallery.
- Click Connect.
- Based on the Gallery configuration, authentication steps vary:
- In Email and Password, enter your Gallery email and password.
- Select Keep me logged in, if desired.
- Click Connect.
- A user name displays.
- Click Continue to log in.
- Click the Gallery in the list and follow the steps to open a workflow saved to the Alteryx Gallery or a private Gallery.
Configuration Type |
Authentication Steps |
---|---|
Built-in authentication |
|
Windows authentication |
|