Subscriptions (Studios)
In a coming release, to streamline your asset management, subscriptions (studios) are going away. Assets will be associated with users rather than a given subscription (studio). If you have assets in your private studio these will be associated with your user instead.
If you are using subscriptions (studios) to share assets, we recommend that you migrate shared assets to Collections to prepare for this improvement. Go to Migrate Subscriptions to Collections for more info.
A subscription allows Designer users to publish and share workflows privately within your organization. Server admins can create subscriptions and manage the users and workflows assigned to them. Subscriptions are also known as studios.
A private studio (in other words, subscription) is automatically created for each Server user. When a user creates a workflow in Designer and publishes it to the Server, the workflow is added to the user's private studio (subscription). Workflows published to the private studio are private. Only other users assigned to the private studio (subscription) can see the workflows.
To manage subscriptions, go to the Subscriptions page of the Server Admin interface.
Create a New Subscription
- On the Subscriptions page, select + New.
- Enter a Name for the subscription.
- To allow users to view and edit the schedules and job results for workflows published by all users in the subscription, check the Shared Schedules Enabled box.
- (Optional) To add Default Workflow Credentials...
- Select a saved credential in the Workflow Credentials dropdown.
- Select OK. Go to Credentials for more info.
- Select Create.
The new subscription is added to the Subscriptions page.
Add a User to a Subscription
- On the Subscriptions page, select a subscription. Then select the Users tab.
- To add a user, enter the username in the Search users field and select the user when it appears. Then select + Add. Note, this changes the user's private studio (subscription) and removes their access to the workflows in their existing subscription.
Remove a User from a Subscription
Users can only have one subscription. So, you have to add a user to a new subscription to remove them from their existing subscription. There are 2 methods for moving a user from one subscription to another.
- Copy the Subscription Id of the new subscription and paste it in the Private Studio Subscription Key field in the user's profile.
OR
- Go to the new subscription you want to add the user to. Select Users. To add a user, enter the username in the Search users field and select the user when it appears. Then select + Add. Note, this changes the user's private studio (subscription) and removes their access to the workflows in their existing subscription.
Edit a Subscription
- On the Subscriptions page, select a subscription. Then select the Details tab.
- Enter a new Private Studio Name.
- To allow users to view and edit the schedules and job results for workflows published by all users in the subscription, check the Shared Schedules Enabled box. If unchecked, users won’t be able to view and edit the schedules and job results for workflows published by all users in the subscription.
- To change Default Workflow Credentials, select the credentials you want to change in the Default Workflow Credentials dropdown. Go to Credentials for more info. To confirm your changes, select Save.
- To add a user to the subscription, select the Users tab. enter the username in the Search users field and select the user when it appears. Then select + Add. Note, this changes the user's private studio (subscription) and removes their access to the workflows in their existing subscription.
- Select Save.
Delete a Subscription
Before you delete a subscription (studio), you have to remove all users from it. To do so, add the users to another subscription.
To delete a subscription, find the subscription and select the three-dot menu next to the subscription name, then select Delete. Note, deleting a subscription also deletes the workflows in that subscription.
No Name Subscription
If your Server is using Integrated Windows Authentication, a subscription named No Name was created and listed on the Subscriptions page in versions prior to 2020.1. This can be deleted in version 2020.1+ without causing Server access problems for new users.
Default Workflow Credential Workaround
Admins can no longer set a default workflow credential (Run As Credential) for a Studio. This previously worked as the default workflow credential if the user never changed the workflow credential in their profile.
Workaround
- As an user, you can choose to use any workflow credential that has been shared with you, or set a custom credential (typically your own) via your profile.
- As an admin, you can set the Run As Credential for a user via the Server API.
- You can either do this on account creation via the POST /v3/users endpoint or when you update an existing user with the PUT /v3/users/{id} endpoint.
- To set a credential via these API endpoints, you need to set the defaultCredentialId to the Id of a workflow credential that exists in the Server environment. You can only choose credentials that have been shared with the user. To find a credential Id or to share it with the user, you can use the various credentials endpoints /v3/credentials. For more information about the credential endpoints, visit the Credential Endpoints help page.