Skip To Content

이벤트 트리거

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

비고:

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

기관 항목 이벤트

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

이벤트 트리거URI

모든 항목에 대한 모든 트리거 이벤트

/items

항목이 포털에 추가됨

/items/add

항목이 삭제됨

/items/delete

항목이 업데이트됨

/items/update

항목이 이동되거나 소유권이 변경됨

/items/move

항목이 발행됨

/items/publish

항목이 공유됨

/items/share

항목이 공유 해제됨

/items/unshare

항목 소유권이 다시 할당됨

/items/reassign

특정 항목에 대한 모든 트리거 이벤트

/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>/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/<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>/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