V1 액션 유형 API

액션 유형(ActionType)은 온톨로지에 적용할 변경과 로직의 정의입니다. Ontology Manager에서 구성하며, 실제 액션(Action)은 이 정의를 매개변수와 함께 한 번 적용하는 실행입니다.

ActionType

필드	자료형	필수 여부	의미
`apiName`	string	필수	액션 유형의 API 이름
`description`	string	선택	설명
`displayName`	string	선택	표시 이름
`status`	enum	필수	ACTIVE, ENDORSED, EXPERIMENTAL, DEPRECATED
`parameters`	`map<ParameterId, Parameter>`	선택	입력 매개변수 정의
`rid`	string	필수	액션 유형 RID
`operations`	`list<LogicRule>`	선택	액션의 변경 규칙 목록

Parameter에는 필수 baseType 문자열과 required 불리언, 선택적인 description 및 구조화된 dataType이 있습니다. 모든 중첩 유형과 값 표현은 매개변수 자료형을 따릅니다.

각 규칙은 type으로 구분합니다. 다음 필드는 해당 변형에서 필수 문자열입니다.

type	필드	의미
`createObject`	`objectTypeApiName`	생성할 객체 유형
`modifyObject`	`objectTypeApiName`	수정할 객체 유형
`deleteObject`	`objectTypeApiName`	삭제할 객체 유형
`createInterfaceObject`	`interfaceTypeApiName`	생성할 인터페이스 유형
`modifyInterfaceObject`	`interfaceTypeApiName`	수정할 인터페이스 유형
`deleteInterfaceObject`	`interfaceTypeApiName`	삭제할 인터페이스 유형
`createLink`	`linkTypeApiNameAtoB`, `linkTypeApiNameBtoA`, `aSideObjectTypeApiName`, `bSideObjectTypeApiName`	양방향 링크 API 이름과 A/B 쪽 객체 유형
`deleteLink`	`linkTypeApiNameAtoB`, `linkTypeApiNameBtoA`, `aSideObjectTypeApiName`, `bSideObjectTypeApiName`	삭제할 링크와 양쪽 객체 유형

인터페이스 API 이름은 UpperCamelCase 형식이며 Ontology Manager 또는 인터페이스 유형 목록에서 확인합니다. 객체와 링크 API 이름도 표시 이름과 구분하여 실제 정의의 값을 사용합니다.

applyScenario는 참조한 시나리오에 쌓인 편집을 액션이 적용되는 데이터 맥락에 반영합니다. 액션을 기본 온톨로지 맥락에서 적용하면 그 데이터에, 다른 시나리오 맥락에서 적용하면 그 시나리오에 반영합니다.

필드	자료형	필수 여부	의미
`scenarioParameter`	ParameterId string	필수	원본 시나리오를 전달하는 scenarioReference 유형의 매개변수 ID
`objectTypeApiNames`	`list<string>`	선택	영향을 받는 객체 유형 API 이름 목록
`linkTypes`	`list<ObjectTypeLinkTypeApiNameMapping>`	선택	영향을 받는 링크의 범위

ObjectTypeLinkTypeApiNameMapping에는 필수 문자열 objectTypeApiName과 선택적인 linkTypes 문자열 목록이 있습니다. 링크 API 이름은 객체 유형 안에서만 고유하므로 객체 유형과 함께 지정하여 구분합니다.

이 규칙의 메타데이터와 개별 액션 적용 엔드포인트의 입력은 별도 계약입니다. 실제 호출에는 해당 엔드포인트가 제공하는 매개변수만 사용합니다.