속성 선언¶

관리 > 속성 선언 페이지에서 워크스페이스의 속성 정보를 확인하고 편집할 수 있습니다. 속성은 JSON 형식으로 저장되며, 워크스페이스 목록에서 필터링하거나 이벤트 알림에 메타데이터를 전달하는 데 사용됩니다.

Guance는 organization, business 두 개의 고정 속성 필드를 사전 설정하며, 사용자 정의 속성 선언을 추가할 수 있습니다.

사전 설정 속성¶

시스템에서 다음 두 가지 속성을 사전 설정하며, 삭제할 수 없습니다.

organization: 조직 ID로, 시스템이 자동으로 입력합니다. 워크스페이스에 연결된 청구 센터 계정의 조직 ID에 해당하며, 동일한 요금 계정의 워크스페이스는 동일한 organization 값을 가집니다(❗️ 배포 플랜 사용자의 경우 이 값은 고정된 단일 ID입니다).

business: 비즈니스 속성으로, 워크스페이스 목록에서 비즈니스 차원으로 필터링하는 데 사용할 수 있습니다. 오른쪽에 있는 편집 버튼을 클릭하면 속성 값을 수정할 수 있으며, 값이 비어 있으면 "속성 값"이라는 플레이스홀더 텍스트가 표시됩니다.

사용자 정의 속성¶

오른쪽에 있는 편집 버튼을 클릭하여 속성을 사용자 정의할 수 있습니다. 속성 이름(key)과 속성 값(value)은 모두 필수 입력 항목입니다. 사용자 정의 속성은 언제든지 편집하거나 삭제할 수 있습니다.

사용 사례¶

속성 선언의 필드는 외부로 전송되는 이벤트 알림에 함께 포함됩니다. 이벤트 상세 페이지의 이벤트 내용 영역에서 df_workspace_declaration 필드를 통해 전체 속성 선언 정보를 확인할 수 있으며, 외부 시스템에서 이벤트를 수신할 때 분류, 라우팅 또는 연동 처리에 활용할 수 있습니다.