인터페이스 정의 수정
인터페이스(Interface)의 API 이름과 필수 계약은 이를 사용하는 앱 및 객체 유형(Object type)에 영향을 줍니다. 새 필수 속성(Property), 링크 유형 제약 또는 액션 유형 제약을 추가하면 해당 인터페이스를 구현한 모든 유형의 매핑도 같은 온톨로지 변경에서 함께 갱신해야 합니다. 속성 자료형을 바꾸는 경우에도 모든 구현 유형을 맞춥니다.
소비 앱과 정의는 함께 갱신하는 방식을 권장합니다. 동시에 바꿀 수 없으면 새 인터페이스를 확장 형태나 독립 정의로 만들어 새 계약으로 이전할 수 있습니다. 선택 요소는 구현에서 매핑을 생략할 수 있으므로 필수 계약 추가와 구분합니다.
새 속성과 메타데이터
인터페이스 구성의 Properties에서 New property를 선택하면 속성 구성 패널이 열립니다.
| 설정 | 동작과 영향 |
|---|---|
| Display name, Description | 현재 텍스트를 선택하여 표시 이름과 설명을 바꿉니다. |
| API name | 코드에서 참조할 이름을 바꿉니다. 사용하는 앱의 참조도 함께 검토합니다. |
| Property base type | 기본 자료형(Base type)을 선택합니다. 가능한 연산과 표시 방식에 영향을 줍니다. timestamp는 Object Explorer의 타임라인 표현에 사용할 수 있습니다. |
| Primary key constraint | 매핑 대상이 기본 키(Primary key)여야 하는지 또는 기본 키일 수 없는지를 지정합니다. |
| Type classes | 앱이 해석할 추가 메타데이터를 적용합니다. |
| Render hints | 속성값의 표시와 구형 Object Storage V1 색인에 사용하는 힌트를 선택합니다. |
| Visibility | prominent는 앱에서 먼저 표시하는 속성이고 hidden은 사용자 앱의 기본 표시에서 숨기는 속성입니다. 접근 권한과는 별도입니다. |
기존 공유 속성(Shared property)을 추가하려면 Properties의 Add shared properties에서 선택합니다.
제약 추가
Link type constraints에서 Create new link type constraint를 선택하고 링크 제약의 대상과 카디널리티 및 필수 여부를 정합니다.
Action type constraints에서는 Create new action type constraint로 액션 제약의 메타데이터와 매개변수 제약을 구성합니다.
속성 제거
Properties에서 대상 속성 옆의 점 세 개 메뉴를 선택하거나 속성 패널 오른쪽 위의 휴지통 아이콘으로 제거합니다.
링크 및 액션 제약 수정과 제거
Link type constraint 목록의 점 세 개 메뉴에서 제약을 수정하거나 제거합니다. 수정할 때에는 새로 만들 때와 같은 메타데이터를 갱신합니다.
Action type constraints의 점 세 개 메뉴에서도 제약을 수정하거나 제거합니다. 액션 제약의 메타데이터와 매개변수 구성을 함께 검토합니다.
필수 요소를 없애거나 바꾸어 기존 매핑이 유효하지 않게 되면 구현 매핑도 갱신합니다. 모든 변경은 저장 절차를 거쳐 반영합니다.