Versions Compared

Key

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

In this article

...

Parameter NameData TypeDescriptionDefault ValueExample 
LabelString
Insert excerpt
File Writer
File Writer
nopaneltrue
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 Image Modified 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.

Info
titleNote

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 Image Modified icon to fetch a list of member IDs within the organization. You 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. 

Info
titleTo avoid 502 Bad 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.

Info
titleTo avoid 502 Bad 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

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

...

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

Mapper Snap

Image Modified

Output
Image Modified

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

Image Modified

Image Modified

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

Image Modified

Image Modified

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

Image Modified

Image Modified

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

...

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

Image Modified

Output

Image Modified

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

Image Modified

Output
Image Modified

Download this Pipeline.

Downloads

...

excerpt
Attachments
patterns*.slp, *.zip

Snap Pack History

Expand

Multiexcerpt-include-macro

...

nameTeams_SPH
templateData[]
pageTeams Snap Pack

...

addpanel

...

false

...

See Also

...