이벤트 트리거

웹후크를 생성할 때 웹후크를 호출하고 페이로드를 통해 이벤트 정보를 전달하는 API 작업에 연결된 특정 이벤트 트리거를 구독하도록 선택할 수 있습니다. 아래 섹션에는 사용 가능한 이벤트 트리거 및 관련 URI 또는 기관 및 피처 서비스 웹후크에 대한 변경 유형 값이 나와 있습니다.

비고:

기관 및 피처 서비스 웹후크와 달리 지오프로세싱 서비스 웹후크에는 사용자 정의 이벤트 트리거가 없습니다. 지오프로세싱 서비스 웹후크는 지오프로세싱 작업이 완료되면 페이로드를 전달합니다. 지오프로세싱 서비스를 위해 전달되는 페이로드에 대한 자세한 내용은 페이로드 항목을 참고하세요.

기관 항목 이벤트

다음 테이블에는 웹 맵, 웹 앱, 레이어, 패키지, PDF를 포함하는 기관 항목에 대한 이벤트 트리거가 나와 있습니다.

이벤트 트리거	URI
모든 항목에 대한 모든 트리거 이벤트	/items
항목이 포털에 추가됨	/items/add
항목이 삭제됨	/items/delete
항목이 업데이트됨	/items/update
항목이 이동되거나 소유권이 변경됨	/items/move
항목이 발행됨	/items/publish
항목이 공유됨	/items/share
항목이 공유 해제됨	/items/unshare
항목 소유권이 다시 할당됨	/items/reassign
의견이 항목에 추가됨	/items/addComment
의견이 항목에서 삭제됨	/items/deleteComment
항목에 대한 의견이 업데이트됨	/items/updateComment
특정 항목에 대한 모든 트리거 이벤트	/items/<itemID>
특정 항목이 삭제됨	/items/<itemID>/delete
특정 항목의 등록정보가 업데이트됨 비고: 업데이트할 수 있는 항목 등록정보는 항목 유형에 따라 다르며 Update 작업을 트리거하는 고유한 작업이 있습니다. 예를 들어 항목이 웹 맵인 경우 태그 업데이트, 팝업 구성 또는 베이스맵 변경은 모두 웹후크를 트리거할 업데이트 이벤트입니다.	/items/<itemID>/update
특정 항목이 이동되거나 소유권이 변경됨	/items/<itemID>/move
특정 항목이 발행됨	/items/<itemID>/publish
특정 항목이 공유됨	/items/<itemID>/share
특정 항목이 공유 해제됨	/items/<itemID>/unshare
특정 항목의 소유권이 다시 할당됨	/items/<itemID>/reassign
의견이 특정 항목에 추가됨	/items/<itemId>/addComment
의견이 특정 항목에서 삭제됨	/items/<itemId>/deleteComment
특정 항목에 대한 의견이 업데이트됨	/items/<itemId>/updateComment

항목 이벤트 트리거 등록정보

기관 항목에 대한 일부 이벤트 트리거는 페이로드에서 추가 등록정보를 반환합니다. 이러한 트리거에 대한 추가 페이로드 등록정보는 다음 섹션에 나와 있습니다.

특정 항목이 공유됨

/items/<itemID>/share 이벤트 트리거를 구독하는 웹후크에는 해당 페이로드에 포함된 sharedToGroups 등록정보가 있습니다. sharedToGroups 등록정보는 항목 공유 방식을 지정합니다. 항목이 그룹과 공유된 경우 properties JSON 객체에는 항목이 공유된 각 그룹의 ID가 포함됩니다. 항목이 기관 전체와 공유된 경우 객체에는 Organization이 포함됩니다. 항목이 공개적으로 공유된 경우 객체에는 Everyone이 포함됩니다. 아래 예시에서는 항목을 특정 그룹에 공유하는 방법과 항목을 공개적으로 및 특정 그룹에 공유하는 방법을 보여줍니다.

예시

//groupIDs
"properties": {
  "sharedToGroups": [
    "ecd6646698b24180904e4888d5eaede3",
    "2dff15c514ad4f04b291e304e24a524b"
  ]
}

//Everyone and groupIDs
"properties": {
  "sharedToGroups": [
    "Everyone",
    "4adc30bb03054812a846fa592de105de",
    "a4e6e37e2f7d4bb5b64d587c91d39a2c"
  ]
}

항목 소유권이 다시 할당됨

/items/reassign 이벤트 트리거를 구독하는 웹후크에는 해당 페이로드에 포함된 reassignedTo 등록정보가 있습니다. reassignedTo 등록정보는 항목 또는 그룹이 다시 할당되는 새 사용자를 지정하고 properties JSON 객체에서 새 소유자의 사용자 이름을 반환합니다.

예시

"properties": {
  "reassignedTo": ["newOwner"]
}

특정 항목이 공유 해제됨

/items/<itemID>/unshare 이벤트 트리거를 구독하는 웹후크에는 해당 페이로드에 포함된 unsharedFromGroups 등록정보가 있습니다. unsharedFromGroups 등록정보는 항목 공유가 해제되는 방식을 지정합니다. 항목이 그룹과 공유 해제된 경우 properties JSON 객체에는 항목 공유가 해제된 각 그룹의 ID가 포함됩니다. 항목이 기관 전체와 공유 해제된 경우 객체에는 Organization이 포함됩니다. 항목이 모든 사용자와 공유 해제된 경우 객체에는 Everyone이 포함됩니다. 아래의 예시 등록정보에서는 모든 사용자와 항목을 공유 해제하는 방법 및 특정 그룹과 항목을 공유 해제하는 방법을 보여줍니다.

예시

//Everyone
"properties": {
  "unsharedFromGroups": ["Everyone"]
}

//groupID
"properties": {
  "unsharedFromGroups": [
    "4adc30bb03054812a846fa592de105de"
  ]
}

특정 항목의 소유권이 다시 할당됨

/items/<itemID>/reassign 이벤트 트리거를 구독하는 웹후크에는 해당 페이로드에 포함된 reassignedTo 등록정보가 있습니다. reassignedTo 등록정보는 항목 또는 그룹이 할당되는 새 사용자를 지정하고 properties JSON 객체에서 새 소유자의 사용자 이름을 반환합니다.

예시

"properties": {
  "reassignedTo": ["newOwner"]
}

기관 그룹 이벤트

다음 테이블에는 기관 그룹에 대한 이벤트 트리거가 나와 있습니다.

이벤트 트리거	URI
모든 그룹에 대한 모든 트리거 이벤트	/groups
그룹이 추가됨	/groups/add
그룹이 업데이트됨	/groups/update
그룹이 삭제됨	/groups/delete
그룹에 대해 삭제 방지가 활성화됨	/groups/protect
그룹에 대해 삭제 방지가 비활성화됨	/groups/unprotect
사용자가 그룹에 초대됨	/groups/invite
사용자가 그룹에 추가됨	/groups/addUsers
사용자가 그룹에서 제거됨	/groups/removeUsers
그룹에서 사용자 역할이 업데이트됨	/groups/updateUsers
그룹 소유권이 다시 할당됨	/groups/reassign
항목이 모든 그룹과 공유됨	/groups/itemShare
항목이 모든 그룹에서 공유 해제됨	/groups/itemUnshare
사용자가 그룹 가입 요청을 제출함	/groups/requestJoin
특정 그룹에 대한 모든 트리거 이벤트	/groups/<groupID>
특정 그룹이 업데이트됨 비고: 그룹 설정에 적용된 일반적인 변경 사항은 업데이트를 구성합니다. 예를 들어 그룹의 접근을 변경하면 업데이트 이벤트가 트리거됩니다.	/groups/<groupID>/update
특정 그룹이 삭제됨	/groups/<groupID>/delete
특정 그룹에 대해 삭제 방지가 활성화됨	/groups/<groupID>/protect
특정 그룹에 대해 삭제 방지가 비활성화됨	/groups/<groupID>/unprotect
사용자가 특정 그룹에 초대됨	/groups/<groupID>/invite
사용자가 특정 그룹에 추가됨	/groups/<groupID>/addUsers
사용자가 특정 그룹에서 제거됨	/groups/<groupID>/removeUsers
특정 그룹에서 사용자 역할이 업데이트됨	/groups/<groupID>/updateUsers
특정 그룹의 소유권이 다시 할당됨	/groups/<groupID>/reassign
항목이 그룹에 공유됨	/groups/<groupID>/itemShare
항목이 특정 그룹에서 공유 해제됨	/groups/<groupID>/itemUnshare
사용자가 특정 그룹 가입을 요청함	/groups/<groupId>/requestJoin

그룹 이벤트 트리거 등록정보

기관 그룹에 대한 일부 이벤트 트리거는 페이로드에서 추가 등록정보를 반환합니다. 이러한 트리거에 대한 추가 페이로드 등록정보는 다음 섹션에 나와 있습니다.

사용자가 특정 그룹에 초대됨

/groups/<groupID>/invite 이벤트 트리거를 구독하는 웹후크에는 해당 페이로드에 포함된 invitedUserNames 등록정보가 있습니다. invitedUserNames 등록정보는 그룹에 초대된 사용자의 사용자 이름을 지정하고 properties JSON 객체의 사용자 이름 목록을 반환합니다.

예시

"properties": {
  "invitedUserNames": [
    "u1TestUser",
    "u2TestUser"
  ]
}

사용자가 특정 그룹에 추가됨

/groups/<groupID>/addUsers 이벤트 트리거를 구독하는 웹후크에는 해당 페이로드에 포함된 addedUserNames 등록정보가 있습니다. addedUserNames 등록정보는 그룹에 추가된 사용자의 사용자 이름을 지정하고 properties JSON 객체의 사용자 이름 목록을 반환합니다.

예시

"properties": {
  "addedUserNames": [
    "u1TestUser",
    "u2TestUser"
  ]
}

사용자가 특정 그룹에서 제거됨

/groups/<groupID>/removeUsers을(를) 구독하는 웹후크에는 해당 페이로드에 포함된 removeUserNames 등록정보가 있습니다. removeUserNames 등록정보는 그룹에서 제거된 사용자의 사용자 이름을 지정하고 properties JSON 객체의 사용자 이름 목록을 반환합니다.

예시

"properties": {
  "removedUserNames": [
    "u1TestUser",
    "u2TestUser"
  ]
}

특정 그룹에서 사용자 역할이 업데이트됨

/groups/<groupID>/updateUsers을(를) 구독하는 웹후크에는 해당 페이로드에 포함된 updateUserNames 등록정보가 있습니다. updateUserNames 등록정보는 그룹 역할이 업데이트된 사용자의 사용자 이름을 지정하고 properties JSON 객체의 사용자 이름 목록을 반환합니다.

예시

"properties": {
  "updatedUserNames": [
    "u1TestUser",
    "u2TestUser"
  ]
}

항목이 그룹에 공유됨

/groups/<groupID>/itemShare을(를) 구독하는 웹후크에는 해당 페이로드에 포함된 sharedItems 등록정보가 있습니다. sharedItems 등록정보는 그룹에 공유되는 항목의 itemID 및 항목 유형을 지정하고 properties JSON 객체에서 해당 정보를 반환합니다.

예시

"properties": {
  "sharedItems": [
    {
      "itemId": "6cd80cb32d4a4b4d858a020e57fba7b1",
      "itemType": "Map Package"
    }
  ]
}

항목이 특정 그룹에서 공유 해제됨

/groups/<groupID>/itemUnshare을(를) 구독하는 웹후크에는 해당 페이로드에 포함된 unsharedItems 등록정보가 있습니다. unsharedItems 등록정보는 그룹에서 공유 해제되는 항목의 itemID 및 항목 유형을 지정하고 properties JSON 객체에서 해당 정보를 반환합니다.

예시

"properties": {
  "unsharedItems": [
    {
      "itemId": "7dd95fadaec84859ab8ed1059e675e0c",
      "itemType": "Image"
    }
  ]
}

기관 사용자 이벤트

다음 테이블에는 기관 사용자에 대한 이벤트 트리거가 나와 있습니다.

이벤트 트리거	URI
포털의 모든 사용자에 대한 모든 트리거 이벤트	/users
사용자가 기관에 추가됨	/users/add
사용자가 포털에 로그인함	/users/signin
사용자가 포털에서 로그아웃함	/users/signout
사용자가 삭제됨	/users/delete
사용자 프로필이 업데이트됨 비고: 업데이트 이벤트는 사용자 프로필이 변경될 때마다 트리거됩니다. 그러나 사용자의 역할, 사용자 유형, 라이선스에 대한 변경 사항은 사용자 프로필에 대한 업데이트로 간주되지 않습니다.	/users/update
사용자 계정이 비활성화됨	/users/disable
사용자 계정이 활성화됨	/users/enable
사용자에게 새 역할이 할당됨	/users/updateUserRole
사용자에게 새 사용자 유형이 할당됨	/users/updateUserLicenseType
사용자 계정 목록이 활성화됨	/users/bulkEnable
사용자 계정 목록이 비활성화됨	/users/bulkDisable
특정 사용자와 관련된 모든 트리거 이벤트	/users/<username>
지정된 사용자가 포털에 로그인했음	/users/<username>/signIn
지정된 사용자가 포털에서 로그아웃했음	/users/<username>/signOut
특정 사용자가 삭제됨	/users/<username>/delete
특정 사용자의 프로필이 업데이트됨 비고: 업데이트 이벤트는 사용자 프로필이 변경될 때마다 트리거됩니다. 그러나 사용자의 역할, 사용자 유형, 라이선스에 대한 변경 사항은 사용자 프로필에 대한 업데이트로 간주되지 않습니다.	/users/<username>/update
특정 사용자의 계정이 비활성화됨	/users/<username>/disable
특정 사용자의 계정이 활성화됨	/users/<username>/enable
특정 사용자에게 새 역할이 할당됨	/users/<username>/updateUserRole
특정 사용자에게 새 사용자 유형이 할당됨	/users/<username>/updateUserLicenseType

사용자 이벤트 트리거 등록정보

기관 사용자에 대한 일부 이벤트 트리거는 페이로드에서 추가 등록정보를 반환합니다. 이러한 트리거에 대한 추가 페이로드 등록정보는 다음 섹션에 나와 있습니다.

특정 사용자에게 새 역할이 할당됨

/users/<username>/updateUserRole을(를) 구독하는 웹후크에는 해당 페이로드에 포함된 userRoleUpdatedTo 등록정보가 있습니다. userRoleUpdatedTo 등록정보는 사용자에게 할당된 새 역할을 지정하고 properties JSON 객체에서 새 역할을 반환합니다.

"properties": {
  "userRoleUpdatedTo": ["New role"]
}

특정 사용자에게 새 사용자 유형이 할당됨

/users/<username>/updateUserLicenseType을(를) 구독하는 웹후크에는 해당 페이로드에 포함된 userLicenseTypeUpdatedTo 등록정보가 있습니다. userLicenseTypeUpdatedTo 등록정보는 사용자에게 할당된 새 사용자 유형을 지정하고 properties JSON 객체에서 새 사용자 유형을 반환합니다.

"properties": {
  "userLicenseTypeUpdatedTo": ["Editor"]
}

기관 역할 이벤트

다음 테이블에는 기관 사용자 역할에 대한 이벤트 트리거가 나와 있습니다.

이벤트 트리거	URI
포털의 모든 역할에 대한 모든 트리거 이벤트	/roles
새 역할이 생성됨	/roles/add
기존 역할이 업데이트됨 비고: 업데이트 이벤트는 기관의 역할이 변경될 때마다 트리거됩니다.	/roles/update
기존 역할이 삭제됨	/roles/delete

역할 이벤트 트리거 등록정보

기관 역할에 대한 일부 이벤트 트리거는 페이로드에서 추가 등록정보를 반환합니다. 이러한 트리거에 대한 추가 페이로드 등록정보는 다음 섹션에 나와 있습니다.

새 역할이 생성됨

/roles/add 이벤트 트리거를 구독하는 웹후크에는 해당 페이로드에 포함된 name 등록정보가 있습니다. name 등록정보는 생성된 역할 이름을 지정하고 properties JSON 객체에서 역할 이름을 반환합니다.

예시

"properties": {
  "name": ["New role"]
}

피처 서비스 이벤트

다음 테이블에는 피처 서비스 웹후크에 대한 이벤트 트리거가 나와 있습니다.

이벤트 트리거	값
모든 이벤트가 트리거됨	*
새 피처가 생성됨	FeaturesCreated
피처가 업데이트됨	FeaturesUpdated
피처가 삭제됨	FeaturesDeleted
피처가 편집됨(예시: 삽입, 업데이트 또는 삭제)	FeaturesEdited
피처에 새 첨부 파일이 추가됨	AttachmentsCreated
피처 첨부 파일이 업데이트됨	AttachmentsUpdated
피처 첨부 파일이 삭제됨	AttachmentsDeleted
피처 레이어 스키마가 변경됨	LayerSchemaChanged
피처 레이어 정의가 변경됨	LayerDefinitionChanged
피처 서비스 정의가 변경됨	FeatureServiceDefinitionChanged
post 작업은 피처 서비스에서 수행됩니다. 비고: 이 이벤트 트리거를 사용하여 웹후크를 예약하려면 피처 서비스에 버전 관리 기능이 활성화되어 있어야 합니다. 자세한 내용은 웹후크 생성 문서를 참고하세요.	FeaturesPosted