범용 액세스에서 원격 시스템이 호출한 인바운드 웹 서비스입니다. 시민 계정에 로그인할 때 사용자 홈 페이지에 표시되는 시민 메시지를 보내는 데 사용됩니다. 이 유형의 웹 서비스 요청 페이로드의 스키마는 <CURAM_DIR>\EJBServer\components\WorkspaceServices\webservices\ExternalCitizenMessage.xsd에 있습니다. 이 웹 서비스의 샘플 SOAP 요청은 부록 A에 게재되어 있습니다.
이 웹 서비스 요청에는 다음 정보가 포함되어 있습니다.
- sourceSystem – 요청을 보내는 원격 시스템의 이름입니다.
- citizenWorkspaceAccountID – 고유한 시민 작업공간 계정 ID입니다.
- cityIndustryType – 메시지와 연관된 업계 유형을 표시합니다. 이 요소의 값은 CityIndustry 코드 테이블의 코드와 일치해야 합니다.
- relatedID – 메시지가 참조하는 원격 시스템에 있는 기본 항목의 ID를 나타냅니다. 예를 들어, 메시지가 지급에 관한 경우 관련 ID가 원격 시스템에 있는 지급 ID를 식별합니다.
- externalCitizenMessageType – ExternalCitizenMessageType 코드 테이블에서 가져온 외부 시민 메시지 유형입니다.
- messageTitle – 메시지의 제목입니다. 원격 시스템이 이 제목을 일반 사용자의 로케일로 현지화해야 합니다.
- messageBody – 메시지의 본문입니다. 원격 시스템이 이 제목을 일반 사용자의 로케일로 현지화해야 합니다.
- effectiveDate – 선택사항입니다. 메시지가 유효하게 되는 시작 날짜입니다. 이 날짜 이후로만 계속 표시됩니다. 날짜 형식은 "YYYY-MM-DD"이어야 합니다. 유효 날짜가 제공되지 않으면 현재 날짜를 유효 날짜로 사용합니다.
- expiryDate – 메시지가 만기되도록 설정된 날짜입니다. 이 날짜 이후에는 메시지가 사용자에게 표시되지 않습니다. 날짜 형식은 "YYYY-MM-DD"이어야 합니다.
- priority – 이 메시지의 우선순위가 높은지를 표시하는 부울 값입니다.
일부 메시지의 경우 새로운 메시지가 이전 메시지를 대체할 수 있도록 디자인되었습니다. 예를 들어, 회의에 관한 메시지를 보냅니다. 회의 시간이 변경되었으므로 업데이트된 회의 시간이 포함된 새 메시지가 전송됩니다. 클라이언트에게 두 메시지가 모두 표시되지는 않습니다. 두 번째 메시지가 첫 번째 메시지를 대체하므로 두 번째 메시지만 표시됩니다. sourceSystem, externalCitizenMessageType 및 relatedID 필드가 기존 메시지의 필드와 일치하는 경우 한 외부 메시지가 다른 외부 메시지를 자동으로 대체합니다.