NerdGraph 튜토리얼: 팀 설정

UI 에서 뉴렐릭 팀을 설정하는 것의 대안으로, NerdGraph API 사용하여 프로그래밍 방식으로 팀을 설정할 수 있습니다.

쉽게 시작하려면, NerdGraph API 탐색기 를 사용하여 팀 정보를 생성하고 편집하세요. 아래 예제의 각 필드에 대한 정의는 NerdGraph에서 확인할 수 있습니다. GraphiQL IDE를 사용하는 데 도움이 필요하면 NerdGraph API 탐색기 튜토리얼을 참조하십시오. 팀 관리를 위한 사용자 지정 권한을 설정해야 하는 경우 팀용 사용자 지정 역할 생성을 참조하십시오.

팀을 만드세요

다음은 entityManagementCreateTeam 돌연변이 쿼리를 사용하여 팀을 만드는 NerdGraph 호출의 예입니다.

mutation {
  entityManagementCreateTeam(
    teamEntity: {
      name: "INSERT_YOUR_TEAM_NAME"
      description: "this is a description of a team"
      aliases: ["tn", "tName"]
      externalIntegration: {
        externalId: "INSERT_THE_EXTERNAL_ID"
        type: IAM_GROUP
      }
      resources: [
        { content: "email@mail.com", title: "email", type: "EMAIL" }
        {
          content: "https://slack.com/channels/team"
          title: "Team slack"
          type: "SLACK"
        }
      ]
      scope: { id: "INSERT_YOUR_ORGANIZATION_ID", type: ORGANIZATION }
      parentId: "INSERT_PARENT_TEAM_ID"
    }
  ) {
    entity {
      id
      ownership {
        id
      }
      membership {
        id
      }
    }
  }
}

이 돌연변이를 사용할 때 다음 사항을 기억하세요.

필수 필드는 teamName 과 scope 뿐입니다.
organizationID) 알아내는 데 도움이 필요하면 아래의 조직 ID 정보 검색을 참조하세요.
externalIntegration 팀의 동기화를 유지하기 위해 외부 시스템과 연결하는 것을 말합니다.
- externalId: 외부 시스템의 ID
- type: 외부 시스템의 유형
팀을 생성하면 두 개의 컬렉션이 자동으로 생성되어 해당 팀에 연결됩니다. 참고사항 추가에 대한 자세한 내용은 컬렉션 관리를 참조하세요.
- ownership: 이 컬렉션은 팀이 소유한 정보를 관리합니다.
- membership: 이 컬렉션은 팀 멤버를 관리합니다. userID 에 대한 자세한 내용은 사용자 ID 검색을 참조하세요.
parentId 계층 구조 트리에서 상위 팀 ID를 나타냅니다.

조직 검색 `id`

팀을 만들려면 범위에 조직 ID를 제공해야 합니다.

{
  actor {
    organization {
      name
      id
    }
  }
}

컬렉션 관리

팀에 사용자 또는 항목을 추가하려면 팀과 관련된 컬렉션에 구성원을 추가해야 합니다. 각 컬렉션 ID에 맞는 적절한 변형을 사용하세요. 사용자에는 membership 컬렉션을 사용하고 파티션에는 ownership 컬렉션을 사용합니다. 요청당 최대 100개의 지침을 컬렉션에 추가할 수 있습니다.

mutation {
  entityManagementAddCollectionMembers(
    collectionId: "INSERT_YOUR_COLLECTION_ID"
    ids: ["ENTITY_ID"]
  )
}

팀에서 사용자 또는 상태를 제거하려면 다음 쿼리를 사용하여 팀에 연결된 상태 컬렉션에서 구성원을 제거해야 합니다.

mutation {
  entityManagementRemoveCollectionMembers(
    collectionId: "INSERT_YOUR_COLLECTION_ID"
    ids: ["ENTITY_ID"]
  )
}

사용자를 검색합니다 `id`

사용자를 팀에 추가하려면 사용자 분리에 대한 고유한 분리(GUID라고도 함)가 필요합니다.

GUID를 찾는 데 도움이 되는 여러 가지 쿼리를 사용할 수 있습니다.

팁

아래 예에서 모든 유형은 대소문자를 구분한다는 점을 기억하세요. 예를 들어, USER 및 TEAM 사용해야 합니다.

사용자 도메인 찾기 `id`

먼저, 사용자 도메인 ID를 찾아야 합니다. 사용자 이름이나 이메일로 쿼리하고 필터링하면 됩니다.

{
  actor {
    users {
      userSearch(query: { scope: { email: "INSERT_PARTIAL_EMAIL" } }) {
        users {
          userId
        }
      }
    }
  }
}

{
  actor {
    users {
      userSearch(query: { scope: { name: "INSERT_PARTIAL_NAME" } }) {
        users {
          userId
        }
      }
    }
  }
}

도메인을 가지고 있는 ID를 찾으세요 `id`

id 도메인을 확보하면 다음 쿼리를 사용하여 GUID를 검색할 수 있습니다.

{
  actor {
    entitySearch(query: "type='USER' AND tags.userId = 'INSERT_DOMAIN_ID'") {
      results {
        entities {
          guid
        }
      }
    }
  }
}

이러한 유형의 쿼리의 경우 in 연산자도 유효합니다. 예:

...
     entitySearch(query: "type = 'USER' AND tags.userId IN ('domainId1', 'domainId2')") {
...

팀 정보 검색

팀 정보를 검색하는 데에는 몇 가지 옵션이 있습니다.

팀별로 `id`

id 팀이 있는 경우 다음 쿼리를 사용하여 팀에 대한 정보를 검색합니다.

{
  actor {
    entityManagement {
      entity(id: "INSERT_TEAM_ENTITY_ID") {
        ... on EntityManagementTeamEntity {
          id
          name
          hierarchyLevelId
          managers
          parentId
        }
      }
    }
  }
}

모든 팀

team id 없으면 기존 팀을 모두 확인할 수도 있습니다.

{
  actor {
    entityManagement {
      entitySearch(query: "type = 'TEAM'") {
        entities {
          ... on EntityManagementTeamEntity {
            id
            name
            description
            aliases
            hierarchyLevelId
            managers
            parentId
          }
        }
      }
    }
  }
}

이 쿼리를 사용할 때 다음 사항에 유의하세요.

hierarchyLevelId: 조직 설정(조직 설정 참조)을 통해 구성되는 계층 구조에서 이 팀의 위치를 나타내는 TeamsHierarchyLevelEntity 의 ID입니다.
managers이 팀의 관리자 또는 주요 연락 담당자인 사용자 엔티티 GUID 목록입니다. 관리자는 반드시 팀의 일원이어야 합니다. 사용자 GUID를 찾으려면 사용자 ID 검색을 참조하세요.
parentId계층 구조에서 상위 팀의 ID입니다.

팀 업데이트

entityManagementUpdateTeam 변형을 사용하여 팀을 업데이트합니다. 위의 쿼리를 사용하여 팀의 id 찾으세요.

mutation {
  entityManagementUpdateTeam(
    id: "INSERT_YOUR_TEAM_ID"
    teamEntity: {
      name: "UPDATED_TEAM_NAME"
      description: "updated description"
      managers: ["INSERT_USER_GUID_1", "INSERT_USER_GUID_2"]
    }
  ) {
    entity {
      id
    }
  }
}

이 쿼리를 사용할 때 다음 사항에 유의하세요.

managers 사용자 엔티티 GUID 목록을 허용합니다. 사용자 GUID를 찾으려면 사용자 ID 검색을 참조하세요.

계층 수준 업데이트

계층 레벨의 이름을 업데이트하려면 entityManagementUpdateTeamsHierarchyLevel 뮤테이션을 사용하십시오. 조직 설정 쿼리 의 hierarchyLevelOrder 필드에서 계층 수준 ID를 찾을 수 있습니다.

mutation {
  entityManagementUpdateTeamsHierarchyLevel(
    id: "INSERT_HIERARCHY_LEVEL_ID"
    teamsHierarchyLevelEntity: { name: "UPDATED_LEVEL_NAME" }
  ) {
    entity {
      id
      name
    }
  }
}

이 돌연변이를 사용할 때 다음 사항을 기억하세요.

name 계층 수준에서 유일하게 업데이트 가능한 속성입니다.
id 은 업데이트할 TeamsHierarchyLevelEntity 의 ID입니다. 조직 설정 쿼리 에서 반환된 hierarchyLevelOrder 개에서 이러한 ID를 찾을 수 있습니다.

컬렉션의 요소 보기

collectionElements 쿼리를 사용하여 멤버십 컬렉션에서 사용자를 보거나 소유권 컬렉션에서 이미지를 확인하세요.

{
  actor {
    entityManagement {
      collectionElements(
        filter: { collectionId: { eq: "INSERT_YOUR_COLLECTION_ID" } }
      ) {
        items {
          id
          name
          type
        }
        nextCursor
      }
    }
  }
}

팀 조직 설정 보기 및 업데이트

팀은 조직 범위에 속하므로 조직 수준에서 적용되는 일부 설정이 있습니다. 조직의 설정을 쿼리하려면 다음을 사용할 수 있습니다.

{
  actor {
    entityManagement {
      entity(id: “INSERT_TEAMS_SETTINGS_ID”) {
        ... on EntityManagementTeamsOrganizationSettingsEntity {
          discovery {
            enabled
            tagKeys
          }
          syncGroups {
            rules {
              conditions {
                value
                type
              }
            }
            enabled
          }
          hierarchyLevelOrder
        }
      }
    }
  }
}

이 쿼리를 사용할 때 다음 사항에 유의하세요.

discovery: 이 기능은 태그를 통해 엔티티를 팀에 할당할 수 있게 해줍니다.
enabled: 이는 discovery 기능이 조직에 대해 활성화되어 있는지 여부를 지정합니다.
tagKeys: 팀 이름과 별칭을 찾는 데 사용되는 태그 키입니다. 기본값은 Team 입니다. 따라서 태그 Team: teamName 있는 모든 문은 해당 이름이나 해당 이름과 일치하는 별칭을 가진 팀에 할당됩니다.
syncGroups: 이 기능을 사용하면 사용자 그룹을 인식하기 위한 규칙을 정의하고, ID 공급자(IdP)의 팀에 대한 CRUD 작업을 완전히 자동화할 수 있습니다. 이를 통해 수동 개입 없이도 팀 생성, 업데이트 및 멤버십 관리가 항상 최신 상태로 유지됩니다.
enabled: 이는 조직에 대해 syncGroups 기능이 활성화되어 있는지 여부를 지정합니다.
rules: conditions 의 목록입니다.
conditions: value 및 type 의 목록입니다.
value: 공급자 그룹 이름을 식별하는 데 사용할 문자열입니다.
type: 그룹 이름과 일치해야 하는 값 유형입니다. 가능한 값은 STARTS_WITH, CONTAINS 및 ENDS_WITH 입니다.
hierarchyLevelOrder계층 구조의 순서를 내림차순으로 정의하는 것으로, 첫 번째 요소가 가장 높은 수준이고 마지막 요소가 가장 낮은 수준입니다. 각 요소는 TeamsHierarchyLevelEntity 의 id 입니다.

조직의 특정 구성원만 조직 설정을 편집할 수 있습니다. 다음 쿼리를 사용하면 됩니다.

mutation {
  entityManagementUpdateTeamsOrganizationSettings(
    id: "0bf6d7b0-e1f3-4172-a26a-6e4e0asample"
    teamsOrganizationSettingsEntity: {
      discovery: { enabled: true, tagKeys: ["Owner", "OwningTeam"] }
      syncGroups: {
        enabled: true
        rules: [{ conditions: [{ type: "STARTS_WITH", value: "testing" }] }]
      }
    }
  )
}

팀 UI 설정으로 돌아가기

뉴렐릭 팀 소개

사용자의 편의를 위해 제공되는 기계 번역입니다.

팀을 만드세요 .css-21sua1{background:none;border:none;width:0;padding:0;}

조직 검색 id

컬렉션 관리

사용자를 검색합니다 id

팁

사용자 도메인 찾기 id

도메인을 가지고 있는 ID를 찾으세요 id

팀 정보 검색

팀별로 id

모든 팀

팀 업데이트

계층 수준 업데이트

컬렉션의 요소 보기

팀 조직 설정 보기 및 업데이트

팀 UI 설정으로 돌아가기

팀을 만드세요

조직 검색 `id`

사용자를 검색합니다 `id`

사용자 도메인 찾기 `id`

도메인을 가지고 있는 ID를 찾으세요 `id`

팀별로 `id`