How to set Team Field in Xurrent

    This article describes how to set team field of Xurrent.

    As described in How to sync User Fields in Xurrent , to set member field, team field is required to set as well.
    There are 2 ways to set team field:

    1. By providing team id: Provide internal id of the team, may be you can contact your admin to provide the id

    2. By searching team name when you do not have internal id: Provide team name to nodeHelper's getTeamIdByName method. For this the proxy user Personal Access Token should have Team - Read permission/scope. 

    Read here  more about required permissions or scopes: Xurrent Personal Access Required Token Permissions or Scopes

    Incoming sync (Remote system → Xurrent)

    // OPTION 1: By providing direct team id
    entity.teamId = 12345
    // OPTION 2: By providing team name
    entity.teamId = nodeHelper.getTeamIdByName("team name")
    // for member use any of the way
    // entity.memberId = 12345
    // entity.assignee=nodeHelper.getUserByEmail("abc@demo.com")
    Important: You need to make sure the provided member/user is member of provided team. Based on the token's scopes Exalate will check if member is part of the given team.
    1. If token contains Team - Read permission/scope and member is not part of the team , proper exception message you will get during sync
    2. If token does not contain Team - Read permission/scope and member is not part of the team , Exalate will ignore the validation initially but later you will see error regarding wrong team id. 

    More information

    Have more questions? Ask the community