액션 규칙과 값 매핑

규칙(Rule)은 액션 유형(Action type)의 입력을 온톨로지 편집이나 다른 효과로 바꿉니다. 객체(Object)와 링크(Link)를 편집하는 규칙, 알림이나 외부 요청 및 빌드를 시작하는 규칙을 구분합니다.

온톨로지 규칙

규칙	동작과 조건
Create object	미리 정의한 유형의 객체를 만듭니다. 기본 키(Primary key)는 필수이고 다른 속성은 추가할 수 있습니다.
Modify object(s)	객체 참조 입력이 가리키는 기존 객체를 수정합니다. 같은 액션에서 만든 새 객체를 입력으로 가리킬 수 없습니다.
Create or modify object(s)	객체 참조가 있으면 수정합니다. 없으면 자동 고유 ID 또는 사용자 제공 키로 생성합니다.
Delete object(s)	객체 참조의 기존 객체를 삭제합니다. 같은 액션에서 만든 새 객체를 가리킬 수 없습니다.
Create link(s)	객체 참조 입력으로 전달한 두 객체 사이에 다대다 링크를 만듭니다.
Delete link	두 기존 객체의 다대다 링크를 제거합니다.
Function rule, Run function	온톨로지 편집 함수(Ontology edit function)를 호출하고 액션 입력을 함수 입력에 연결합니다. 다른 온톨로지 편집 규칙과 함께 구성할 수 없습니다.
Create object(s) of interface	인터페이스(Interface)를 구현한 유형의 객체를 만듭니다.
Modify object(s) of interface	인터페이스 구현 객체를 수정합니다.
Delete object(s) of interface	인터페이스 구현 객체를 삭제합니다.
Create link(s) on object(s) of interface	인터페이스 구현 객체의 링크를 만듭니다.
Delete link(s) on object(s) of interface	인터페이스 구현 객체의 링크를 제거합니다.

일대일과 일대다 관계는 별도 링크 규칙 대신 객체의 외래 키(Foreign key) 속성을 Modify object로 설정하거나 지웁니다.

값과 매개변수

객체 생성과 수정 규칙에는 어떤 속성을 어떤 값으로 바꿀지 매핑합니다. 링크 규칙은 객체 참조 매개변수(Parameter)를 사용합니다.

값 원천	동작
From parameter	속성과 자료형이 맞는 매개변수입니다. 새 속성을 규칙에 추가하면 기본적으로 같은 이름의 매개변수를 만들고 연결합니다.
Object parameter property	기존 객체 참조 매개변수의 속성을 사용합니다. 자료형이 맞아야 합니다.
Static value	규칙에 저장한 고정값입니다. Workshop, Slate나 객체 뷰에서 제출하는 사용자가 바꾸지 못합니다.
Current User/Time	문자열의 현재 사용자 또는 타임스탬프의 실행 시작 시각 같은 맥락 값을 씁니다. 제출 폼에서 바꾸거나 액션의 다른 부분에서 매개변수처럼 재사용하지 않습니다.

실행 시작 시각은 실행 내내 고정되며 액션 로그(Action log)와 편집 이력의 커밋 시각과 다를 수 있습니다.

객체와 다대다 링크를 함께 생성

Create object에서 다대다 링크 유형(Link type)이 있는 객체 유형(Object type)을 선택하고 Add property 아래의 Add link로 연결을 구성할 수 있습니다. 단독 Create link 규칙이 기존 양쪽 객체를 요구하는 것과 구분합니다.

규칙 순서와 금지 조합

백엔드는 같은 객체에 대한 규칙들을 편집 하나로 합칩니다. 같은 속성을 먼저 A로, 나중에 B로 정하면 최종 편집은 B를 기록합니다. 순서가 결과에 영향을 주며 다음 조합은 지원하지 않습니다.

객체 삭제 뒤에 같은 객체를 생성하거나 수정
객체 수정 뒤에 같은 객체를 생성
한 제출에서 같은 객체를 두 번 생성

이 금지 목록의 순서만 뒤집으면 모든 조합이 허용되는 것은 아닙니다. 기존 객체 참조가 필요한 수정 및 삭제 규칙과 새 객체 생성의 매핑 조건도 함께 충족해야 합니다.

알림, 웹훅과 일정

Notification은 매개변수로 내용과 수신자를 구성합니다. 수신자는 설정에 따라 플랫폼 푸시, 이메일 또는 둘 다를 받을 수 있습니다. 알림은 모든 편집 후 보내지만 내용은 편집 전 온톨로지 상태로 만듭니다.

Webhook은 외부 시스템 요청을 구성하며 규칙 종류에 따라 편집 전 또는 후에 실행합니다. 입력 매개변수를 요청에 연결할 수 있습니다. 규칙 선택에서 두 실행 시점을 구분합니다.

Schedule은 일정의 빌드를 시작하고 매개변수를 하위 매개변수화 변환에 전달할 수 있습니다. 온톨로지 편집은 빌드가 시작된 뒤 적용합니다. 외부 효과와 편집의 트랜잭션 범위를 구분합니다.