Skip to end of banner
Go to start of banner

Teams - Create Team

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Next »

In this article

Overview

Use this Snap to perform the following operations:

  • Create a new team.
  • Create a new team from an existing group. 

Prerequisites

None.

Support for Ultra Pipelines

Works in Ultra Pipelines

Limitations

None.

Known Issues

None.

Snap Input and Output

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

Document

  • Min: 0
  • Max: 1
  • Mapper Snap
  • Copy Snap
A document containing details of the team to create.
Output

Document

  • Min: 0
  • Max: 1
  • Mapper Snap
  • JSON Formatter + File Writer

A document containing details of the team created.

Snap Settings

Parameter NameData TypeDescriptionDefault ValueExample 
LabelString
Specify a name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.
Create TeamCreate Marketing Team
From Existing GroupCheck box

Select to create a team from an existing group.

Deactivates the Team Name, Team Description, Private Team, and Add Team Owners fields. Activates the Group ID field.

Not selectedSelected
Group IDString/Expression/Suggestion

Activates when you select the From Existing Group check box.

Enter the ID of the group from which to copy the team. Alternatively, click the  icon to fetch a list of group IDs associated with the account. 

N/AAll Company : 12a345c6-78c9-0b1c-b2f3-ab45e678d980
Team NameString/Expression

Activates when you deselect the From Existing Group check box.

Enter the name for the new team.

N/AMarketing Team
Team DescriptionString/Expression

Activates when you deselect the From Existing Group check box.

Enter a brief description about the new team.

N/AMarketing team for the ABC Project
Private TeamCheck box

Activates when you deselect the From Existing Group check box.

Select this check box to create a private team.

Note

Members in the organization cannot locate private teams through search. Only the owners of the private teams can invite them to join. Whereas, any member in the organization can locate and join public teams.



Not selectedSelected
Add Team Owners

Activates when you deselect the From Existing Group check box.

Use this field set to add owners for the team.

This field set consists of the Owner ID field.

Owner IDString/Expression/Suggestion

Enter the ID of the member. Alternatively, click the  icon to fetch a list of member IDs within the organizationYou can use each row to specify an owner or include all the owners in the same row separated by a comma.

N/Ae12b3456-7c89-012b-345f-67c89dca0bcd
Number of RetriesString/Expression

Enter the number of attempts the Snap makes to perform the selected operation in case of connection failure/unsuccessful attempts. 

To avoid 502 Gateway error

Use a higher value (such as 3, 4, or more) in this field to ensure the Snap/Pipeline runs successfully. 

03
Retry Interval (seconds)String/Expression

Enter the time interval in seconds between retry attempts.

To avoid 502 Gateway error

Use a higher value (such as 3, 4, or more) in this field to ensure the Snap/Pipeline runs successfully. 

16
Snap ExecutionDrop-down list

Specifies the execution type:

  • Validate & Execute: Performs limited execution of the Snap (up to 50 records) during Pipeline validation; performs full execution of the Snap (unlimited records) during Pipeline execution.

  • Execute only: Performs full execution of the Snap during Pipeline execution; does not execute the Snap during Pipeline validation.

  • Disabled: Disables the Snap and, by extension, its downstream Snaps.

Execute onlyValidate & Execute

Troubleshooting

ErrorReasonResolution
Team Name field is blankYou have not specified a team name.Verify whether you have specified a team name in the Team Name field. The Team Name field is required when creating a new team. 

Examples

Initiating activity in Microsoft Teams

The following example Pipeline demonstrates how you can use the Create Team Snap and some other Snaps in the Teams Snap Pack to begin team's activity within your Microsoft Teams instance. This example assumes that you have:

This Pipeline uses the OAuth2 user account (authorization code grant type) to create a team on behalf of a signed-in user and to allow begin their collaboration efforts. It demonstrates the following activities:

  • Creating a team
  • Adding members to the new team
  • Creating a public channel within the team
  • Collaboration through the channel

Creating a team

Use the Create Team Snap from the Teams Snap Pack to create the new team, as needed. In this Pipeline, the inputs for creating a team are passed using a Mapper Snap, for demonstration purposes. 

Mapper Snap

Output

The values for Team and Team_Desc are passed to the Create Team Snap. The Snap creates a new team in your Teams instance and returns the team's id and a confirmation message about the operation.

Create Team SnapOutput

Adding members to a team

To add members to the team, connect a Team Operations Snap. Select Add Members as the Operation and provide the user IDs of the members and owners for the team, as needed.

Team Operations Snap to add members to a teamOutput

Creating a channel in the team

Now, let us create a channel within this new team (using Create Channel Snap) and add members to this channel, as necessary.

Create Channel SnapOutput

This Snap creates a new channel under the team and returns the channel details in its output.

Sending a message to a channel

Let us use these details to send our first message in the channel. To do so, we must connect a Send Channel Message Snap and pass the Team ID and Channel ID from the above output as inputs. The Send Channel Message Snap allows you to draft messages to the channel members using HTML markup. See the input for the Message field in the Snap.

Send Channel Message Snap

Output

Replying to a specific message

Similarly, you can use the Send Channel Message Snap to reply to a specific message in the channel (conversation) using its message ID. For demo purposes, the Snap below uses the id of the message sent above to reply to it.

Send Channel Message as a reply

Output

Download this Pipeline.

Downloads

Important Steps to Successfully Reuse Pipelines

  1. Download and import the Pipeline into SnapLogic.
  2. Configure Snap accounts as applicable.
  3. Provide Pipeline parameters as applicable.

  File Modified
No files shared here yet.



See Also


  • No labels