테마
트윈 이벤트로 변경 알림 주고받기
이럴 때 씁니다
- 고객에게 보낸 부품 식별 정보나 고객에게서 받은 통지를 원문과 처리 결과까지 확인하고 싶을 때
- 우리 서브모델(여권·PCF 등)을 고쳤다는 사실을 그 부품의 고객에게 알리고 싶을 때(서브모델 변경 알림)
- 서브모델이 바뀔 때마다 고객에게 자동으로 알리고 싶을 때
- 고객이 우리 알림을 제대로 처리했는지(피드백) 보고 싶을 때
메뉴는 제품 관리 → 트윈 이벤트입니다. 구독과 관계없이 모든 조직이 씁니다.
시작하기 전에
- 서브모델 변경 알림과 피드백은 디지털 트윈 이벤트 API 3.0으로만 오갑니다. 상대가 3.0을 제공하지 않으면 보내지 않고 사유를 보여 줍니다.
- 상대와의 채널은 공유 → 디지털 트윈 이벤트 API에서 관계를 맺어 둡니다. → 고객에게 보낼 준비하기
- 알림을 받는 쪽은 그 부품(트윈)의 고객입니다. 설계 데이터는 제품의 공통 고객, 생산 데이터는 인스턴스 고객입니다.
메시지함 보기
- 제품 관리 → 트윈 이벤트 → 메시지함 탭을 엽니다.
- 위쪽 전체 / 보냄 / 받음으로 방향을 고르고, 종류(상위 부품 연결·하위 부품 연결·서브모델 변경 알림·피드백)와 상태로 좁힙니다. 상대 BPNL 16자리를 모두 넣으면 그 상대만 봅니다.
- 행을 누르면 상세가 열립니다. 상세에는 개요, 메시지 헤더, 이벤트(서브모델 변경 알림의 생성·변경·삭제), 항목별 처리 결과, 피드백, 관련 트윈이 있습니다. 원문 보기로 받은 그대로의 본문을 볼 수 있습니다.
| 상태 | 뜻 |
|---|---|
| 전송됨 / 전송 실패 | 우리가 보낸 통지가 상대에게 전달되었는지 |
| 전달 확인 안 됨 | 보냈지만 상대 쪽 게이트웨이 오류·응답 지연으로 전달을 확인하지 못했습니다. 상대가 이미 처리했을 수 있습니다 |
| 기록됨 | 받은 서브모델 변경 알림·피드백을 기록만 했습니다(자동으로 다시 받지 않습니다) |
| 반영됨 / 일부 반영 / 대상 없음 | 받은 연결 통지를 우리 트윈에 반영한 결과 |
서브모델 변경 알림 보내기
- 제품 관리 → 트윈 이벤트에서 서브모델 변경 알림 보내기를 누릅니다.
- 제품을 찾아 고르고, 트윈(설계 데이터 또는 생산 데이터 시리얼)을 고릅니다.
- 알릴 서브모델을 체크하고 이벤트 종류(생성 / 변경 / 삭제)를 고른 뒤 보내기를 누릅니다.
- 결과 창에서 보낸 고객과 보내지 못한 대상의 사유를 확인합니다. 받을 고객은 직접 고르지 않습니다 — 그 트윈의 고객 중 3.0을 제공하는 곳에 보냅니다.
제품 상세의 서브모델 탭(우리 제품)에서 고객에게 알림을 누르면 그 서브모델이 미리 골라진 같은 창이 열립니다. 이벤트 종류만 고르고 보냅니다.
보내기에 실패한 알림은 상세 화면의 재전송으로 같은 고객에게 같은 이벤트를 새 메시지로 다시 보냅니다. 알릴 서브모델은 다시 고릅니다.
전달 확인 안 됨인 알림도 재전송할 수 있지만, 상대가 이미 처리했을 수 있으므로 다시 보내기 전에 상대 측에 받았는지 확인합니다. 그대로 다시 보내면 상대에게 같은 알림이 두 번 갈 수 있습니다.
자동 발신 규칙 정하기
자동 발신 규칙 탭에서 서브모델이 만들어지거나 바뀌거나 삭제될 때 자동으로 알릴지 정합니다. 규칙이 없으면 자동으로 보내지 않습니다. 규칙과 설정은 조직 소유자만 바꿉니다.
- 규칙 추가를 누르고 서브모델 타입(또는 전체 서브모델), 고객(또는 전체 고객), 이벤트 종류를 고른 뒤 저장합니다.
- 표의 사용 스위치로 규칙을 켜고 끕니다.
고객 목록에는 디지털 트윈 이벤트 API 관계를 맺은 상대가 나옵니다. 규칙 추가를 열 때 상대마다 3.0 제공 여부를 확인해, 3.0을 제공하지 않는 고객은 3.0 미지원, 확인하지 못한 고객(주소를 모르거나 상대 커넥터가 응답하지 않음)은 확인 불가로 표시하고 고를 수 없게 합니다. 확인 불가는 규칙 추가를 닫았다가 다시 열면 다시 확인합니다. 전체 고객은 언제든 고를 수 있고, 보낼 때 3.0을 제공하는 고객에게만 보냅니다.
서브모델 타입과 고객 조합마다 가장 구체적인 규칙 하나만 적용합니다(고객+종류 > 고객만 > 종류만 > 전체). 좁은 규칙이 넓은 규칙을 통째로 대신하므로, 예를 들어 전체 규칙을 켜 두고 특정 고객 규칙을 꺼 두면 그 고객에게는 보내지 않습니다.
같은 탭의 피드백 자동 보내기를 켜면, 받은 트윈 이벤트의 처리 결과(정상·오류)를 보낸 곳에 피드백으로 자동으로 보냅니다. 기본은 꺼져 있습니다.
피드백 보기
상대가 우리 알림에 회신하면 원래 보낸 메시지의 상세 피드백에 시간순으로 붙습니다. 항목마다 정상 처리 또는 처리 오류와 상대가 적은 사유가 보입니다. 원 메시지를 찾지 못한 회신도 기록은 남습니다.
받은 통지에 피드백 보내기
자동 회신을 꺼 두었거나 처리 결과를 다시 알리고 싶으면, 받은 메시지 상세에서 피드백 보내기를 누르고 확인 창에서 보내기를 누릅니다. 항목별 처리 결과(반영·기록은 정상, 대상 없음·형식 오류는 오류)를 보낸 곳에 회신합니다. 피드백 자체에는 피드백을 보내지 않습니다.
자동 회신과 수동 피드백은 같은 규칙을 씁니다. 모든 항목을 정상 처리했을 때만 전체를 정상으로 알리고, 한 항목이라도 실패하면 전체를 오류로 알리며 실패 건수와 첫 사유를 함께 보냅니다. Catena-X ID가 없는 항목은 항목 목록에 실을 수 없어 실패 건수에만 포함됩니다.
받은 서브모델 다시 받기
상대가 서브모델 변경을 알려 오면 받은 제품의 그 서브모델 탭에 갱신됨과 다시 받기가 나오고, 메시지 보기로 받은 알림의 상세를 엽니다. 서브모델을 새로 만들었다는 알림이면 제품 개요나 생산 데이터 상세 위쪽에 새 서브모델 있음이 붙고, 누르면 같은 메시지 상세가 열립니다. → 받은 제품 데이터 확인하기
안 될 때
| 증상 | 확인할 것 |
|---|---|
| 보내기 결과에 "상대가 디지털 트윈 이벤트 API 3.0 을 제공하지 않습니다." | 상대가 3.0 자산을 아직 내놓지 않았습니다. 상대에게 3.0 제공을 요청합니다 |
| "받을 기업이 이 부품의 고객사가 아닙니다." | 제품 개요의 공통 고객 또는 인스턴스 고객에 그 고객을 먼저 등록합니다 |
| 규칙 저장이 거절됨 | 고른 고객이 3.0을 제공하지 않거나, 조직 소유자가 아닙니다 |
| 피드백 보내기가 거절됨 | 보낸 곳이 3.0을 제공하지 않습니다. 2.x 에는 피드백이 없습니다 |

