Alteryx Server Knowledge Base
Definitive answers from Server experts.Alteryx Gallery Series - The Lay of the Land 101: Gallery Admin Edition
This is Part 1 of the Alteryx Gallery Series - The Gallery Series only refers to the Alteryx Server where you can host your Private Alteryx Gallery. This Article with refer to 'Alteryx Gallery' as a privately hosted Gallery on the Alteryx Server.
Part 2 Alteryx Gallery Series - The Lay of the Land 101: User Edition
Part 3 Alteryx Gallery Series: App Publishing & Version Control 101 - Alteryx Community
Part 4 Alteryx Gallery Series: How to make the most of your Alteryx Gallery – Use Cases
The Lay of the Land 101: Gallery Admin Edition
The Gallery Admin is the Godfather of a Alteryx Gallery. The Admin is less involved with the workflow content of the site and more involved with management of users and their overall experience on the Gallery. This article will help the Gallery Admin navigate the Admin settings within the Private Alteryx Gallery.
Each section of the Admin interface is outlined and described below:
Subscriptions
- A Subscription is another name for a Studio. A Studio allows Alteryx Designer users to publish and share workflows privately within their organization.
- Each user that creates a Gallery account is automatically given their own subscription which can become a Private Studio if the user permission level is designated an Artisan. As a Gallery Admin you will have to make this user an Artisan, take a look at the ‘users’ section below which details how to do this.
- Each Studio includes a limited number of artisans and members – assigned by the Gallery Admin.
- Once a subscription has been created, it can be deactivated but not deleted. Gallery Admins are the only ones with permissions to create subscriptions.
Subscription Management
Permission levels
Creating and adding users to Private Studios
- To create a studio (subscription) click on ‘subscription tab’ and click on ‘Add New Subscription’. You will now have the ability to create a studio (subscription)
Subscription Screen
This will be the subscription screen below:
- Gallery Admin can create studios as well as manage the users and workflows assigned to them.
- There are numerous options when creating a Subscription or Studio:
- Private Studio Name: The name for the studio, which displays at the top of the page when the user clicks “Private Studio” on the left menu of the Gallery page.
- Contact Name: The person who owns and manages the studio.
- Subscription Type
- Free: Artisans and Members who are part of the studio can run workflows in the Public Gallery
- Paid: Artisans who are part of the studio can publish and run workflows in that studio and Members can run workflows
- Artist Seats: The number of Artisan seats available in the studio. Artisans can publish, run, and share workflows.
- Member Passes: The number of Member seats available in the studio. Members can run workflows in studios for which they have been assigned.
- Expiration Date: The date the Paid subscription expires. When a paid subscription expires it is downgraded to a Free subscription.
- API Enabled: Access to the Private Server Gallery API is enabled by default. The Gallery API supports the ability to authenticate, list apps, run apps, and retrieve app results using an API Key and Secret which are accessible via Gallery Settings.
Users
- Disable user sign-ups: Limits who can sign up for your Gallery. Forces users to be “invited” to join the Gallery.
- Allow anyone to run public workflows without singing in: If this option is selected, anyone with access to your Gallery URL may run workflows that are available on the Home Page.
- This is how to add a user to a studio (Subscription). You need to take the subscription key from the ‘subscription’ section (above screenshot) and add this into the studio key within the User profile below.
- When a user now publishes from there Alteryx Designer to the Alteryx Gallery they will see the studio name they are associated with. This is linked by the same subscription and studio key.
- Users can only be part of one Studio at a time.
Gallery Users
- Gallery Admins can add users directly to the Gallery or they can send an email inviting user to log in and add themselves via the Join now form on the main page of the Gallery.
- User permissions are managed in the users profile (or in “Permissions” if using Windows Auth) as well as in their assigned studio.
- The new user is added to the Users page. The users name, email (for Built-In Auth), and name of their studio display in the user box as well as icons that represent their permissions.
- When using Built-In Authentication, the Gallery Admin can designate the permission level of users before they sign up to Alteryx Gallery on the users tab
Built-in Permissions Screen (Users permission level for the whole Alteryx Gallery)
Windows Auth Permissions screen (Users permission level for the whole Alteryx Gallery)
- Gallery Admins can manage user permissions in the Permissions page when using Windows Authentication only.
- A default permission level (No Access, Viewer, Artisan, Curator) can be set for any new or existing user who joins the Gallery.
- Admin Tip: Set the default permission to No Access or Viewer if Content Security is of chief concern. This will require users to be invited to run workflows on the Gallery
- Once a user has been created, it can be deactivated but not deleted.
Workflows
- Gallery Admins can add workflows, apps, and macros to the Gallery and manage their icon, description, Run Mode settings, and exemptions.
- Admins can also create “tags” and associate them to workflows so searches within the Gallery return better results.
- Run Mode: Determines the level that workflows are permitted to run in the Gallery. Workflows that contain certain tools or access may need to be blocked. The default Run Mode is selected when the server is configured.
- Unrestricted: Any workflow can be run.
- Semi-Safe: Workflows using Run Command, Download, Email, “R”, or Events will be blocked.
- Safe: Workflows using above tools or accessing/storing data on non-local drives will be blocked.
- Requires Private Data: Indicates if the workflow requires licensed data to run.
- Private Data Exemption: An exemption can be given to a workflow with private data so that it can be run.
Districts
- Gallery Admins can create new districts and modify the district name, description, and icon image. Once the District has been created, it will be displayed below the “Home Page” menu option on the Gallery.
Data Connections
- This tab within the Gallery Admin section is only available for Alteryx Server Version 11.0 and above
- This tab will give you the option to pre-define credentials that can be sent down to designer users
- This will help when managing access and Alias creation on both Designer & Server
- DSN-less connections will run straight away. DSN connections will need to be set up on the location machine and server machine
Workflow Credentials
- Set workflow credentials which can be use when running a workflow from the server. These will also appear in the designer when uploading/scheduling a workflow
- Click on 'change; and you get the following options
Use Default Credentials
- This will use the server service account details to run workflows if nothing has been set in the 'Run As' section of the Server System Settings
Require User Credentials
- When running the application from the Alteryx Gallery the users will have to enter in credentials
Allow users to set options for credentials option
- The best practice would be to ask users for their credentials so they can only access the data they have privileges for within your internal IT environment.
- The interface will look like the screenshot below. When uploading an App from your Alteryx Designer (File>>Save as>>>My Company's Gallery) you can click on 'Workflow Options' & 'Set Workflow Credentials'.
- This will give the user three options
- 'User is not required to specify credentials' - The application/workflow will run as the default Alteryx Server user account (Run As settings in system settings on server config).
- 'Always run this workflow with these credentials' - The user can enter the credentials at this point, however preset credentials can be added within the Alteryx Gallery Admin section ("Workflow Credentials")
Jobs
- This is where you can give users permission to schedule workflows they upload to the Alteryx Gallery. This will allow all artisans to schedule workflows.
Notifications
- The server can send email notifications for various events. The SMTP server information is entered when the server is configured. Gallery Admins can manage the types of notifications and the message text.
- Admin Tip: Disable notifications so your users don't get spammed by the Gallery.
Customize your Alteryx Gallery!
- Banner Ads can be added to be displayed below the search bar on the Home page. Uploaded Files can be added to the site to which Gallery Users can access via Links.
- You have the ability to change the Gallery Name, Logo and Color Scheme within the web Browser.
- This is often used to house FAQs, Help & Links
- Add link to your Page or URL in the Header or Footers.
If you have any outstanding questions please reach out to our Alteryx Support
Best,
Jordan Barker
Solutions Consultant
OK, I'm super confused about collections. I have a scenario where workflows are published and managed by two users. There's me, and there is robot.
I have 2 items in my gallery right now. This is the Private Studio view:
I want to publish these to a collection. So, I click the report item and I get:
When I click 'sharing', I don't have the option to choose an existing collection. This confuses me greatly.
So, I click to Collections... and there is a collection there. The one I was expecting to see.
Robot created that collection. But I have access to it.
So, what gives?! Why can't I publish into that collection??
Thanks for your help,
Cedric
Thanks for these guidelines, it's really useful to help get my head around the terminology.
Can you please clarify if the Permission Level = admin in this picture is referring to Gallery Admin or a different type of Admin?
I'm referring to the System icon in the gallery.
I'm using windows authentication.
Hi @brad_j_crep,
It was updated to a different area -> Workflow Credentials -> Credentials setting for workflows ->
