Versions Compared

Old Version 10

changes.mady.by.user Anand Vedam

Saved on

compared with

New Version 11

changes.mady.by.user Anand Vedam

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this article

Table of Contents
maxLevel2
absoluteUrltrue

...

Any action you want to perform within a Slack Workspace, additionally needs appropriate Scopes assigned to your app. See the Scope and Permissions article in Slack API documentation for the complete list and each Account page under Configuring Slack Accounts (Doc in Progress) for information on defining Scopes for your app.

ToBot Token Accounts
(scope)

User Token Accounts
(user_scope)

Workspace InfoN/Aadmin.teams:read
Create WorkspaceN/Aadmin.teams:write
List WorkspacesN/Aadmin.teams:read
List Channels in a WorkspaceN/Aadmin.usergroups:read 
List Users in a WorkspaceN/Aadmin.users:read
Delete ChannelN/A

admin.usergroups:write OR
admin.conversations:write OR 
admin.users:write 

Support for Ultra Pipelines

...

  • Workspace operations work with User Tokens only. Do not use Bot Token Account with this Snap.
  • Snaps in this Snap Pack use conditional display/hiding of fields. So, ensure that you always use the New Form UI (and not the classic UI) for the Snaps to function as designed/expected.

Known Issues

This Snap is not tested with admin credentials against an Enterprise-oriented Slack installation and this document does not deal with these features in detail.

...

Input/OutputType of ViewNumber of ViewsExamples of Upstream and Downstream SnapsDescription
Input 

Document

  • Min: 0
  • Max: 1
  • Mapper
  • Copy
  • JSON Generator
A document with an input to perform one of the Workspace operations.
Output

Document

  • Min: 1
  • Max: 1
  • Mapper
  • JSON Formatter
  • Filter

A document containing the output records or result (success/failure) based on the operation performed.

...

Parameter NameData TypeDescriptionDefault ValueExample 
LabelString
Insert excerpt
File Writer
File Writer
nopaneltrue
Workspace OperationsWorkspace Operations
OperationDrop-down list

Select an operation from the following list of permitted workspace operations and specify the corresponding details needed:

  • Workspace Info. To fetch information about settings in a workspace.
  • Create Workspace. To create an Enterprise Team/Workspace. Also, specify the details for the new team/workspace. Needs Admin permissions for the Enterprise Grid.
  • List Workspaces. To list all teams/workspaces on an Enterprise/organization. Needs Admin permissions for the Enterprise Grid.
  • List Channels. To list all Channels within the Enterprise/organization
  • List Users. To list all the users in the Enterprise/organization.
  • Delete Channel. To delete a channel in the Enterprise/organization. Needs Admin permissions for the Enterprise Grid.
Workspace InfoCreate Workspace
Snap ExecutionDrop-down list

Select one of the three following modes in which the Snap executes:

  • Validate & Execute. Performs limited execution of the Snap and generates a data preview during Pipeline validation, then performs full execution of the Snap (unlimited records) during Pipeline runtime.
  • Execute only. Performs full execution of the Snap during Pipeline execution without generating preview data.

  • Disabled. Disables the Snap and all Snaps downstream from it.

Execute onlyValidate & Execute

...

Extracting the list of non-Admin users in the Workspace

This example demonstrates how we can use the Workspace Operations Snap to extract/prepare a list of users in the Workspace that do not have admin privileges.

Firstly, we select List Users as the Operation in Workspace Operations Snap. This Snap does not need any other input and generates the list of all users added to the Workspace.

...