구형 온톨로지 역할로 이전

이 절차는 데이터소스(Datasource)에서 파생한 권한을 구형 온톨로지 역할(Ontology roles)로 옮기는 경로입니다. 현재 권장 경로는 프로젝트 권한으로 이전이며 구형 역할 단계를 먼저 거쳐야 하는 것은 아닙니다.

온톨로지 역할은 2023년 9월 이후 새 플랫폼 인스턴스(Enrollment)의 기본 권한 방식으로 도입되었습니다. 기존 데이터소스 파생 권한과 달리 정의에 직접 역할을 부여하여 공유 속성(Shared property)과 인터페이스(Interface) 등의 기능을 사용할 수 있게 한 모델입니다.

메타데이터와 데이터 분리

Aircraft 객체 유형(Object type)의 이름과 스키마를 편집할 권한과 실제 항공기 객체(Object)를 읽을 권한을 분리합니다. 메타데이터 역할은 Ontology Manager에서 관리하고 객체 및 링크(Link) 데이터는 입력 데이터소스의 권한을 계속 따릅니다.

이전한 객체 유형, 링크 유형(Link type)과 액션 유형(Action type)은 해당 온톨로지에 접근하는 모든 사용자에게 정의의 열람 권한을 부여합니다. 원래 입력 데이터소스를 볼 수 없던 사람도 정의를 볼 수 있게 될 수 있으므로 이전 전에 이 노출 범위를 검토합니다.

정해진 이전 순서는 없으며 두 권한 모델의 리소스가 함께 존재할 수 있습니다. 리소스 편집 조건은 현재 모델에 따라 다릅니다.

위 조건은 이 이전 절차에서 개별 객체 유형을 편집할 수 있는지를 구분하는 기준입니다. 온톨로지 자체를 변경할 권한도 필요합니다.

대상 찾기와 사전 권한

역할 기능을 사용할 수 있지만 자신이 소유한 리소스를 아직 이전하지 않았다면 Ontology Manager에 배너가 표시됩니다. 목록에서 Same permissions as backing datasource로 필터링하여 대상을 찾을 수도 있습니다. 이 구형 기능을 사용할 수 없다면 Palantir Support에 확인합니다.

이전을 수행할 사용자는 온톨로지를 변경할 권한과 다음 리소스별 권한을 갖춰야 합니다.

액션 유형을 이전한 뒤에는 액션 자체와 실제로 편집하는 객체 유형에 필요한 권한이 있어야 액션 정의를 수정할 수 있습니다. 이전을 수행할 권한과 이후 액션을 수정할 권한을 구분합니다.

Upgrade Assistant와 Security

Upgrade Assistant의 전용 작업은 이전 대상과 수행 권한이 있는 담당자를 보여 줍니다. 여기에서 리소스를 열면 Ontology Manager의 Security로 이동합니다.

역할을 설정할 권한이 있는 사용자에게는 처음 역할을 지정하는 이전 화면이 표시됩니다. 이전 후에는 Security에 역할 선택기가 나타나며 Ontology Owners가 갱신할 수 있습니다.

일괄 이전

한 번에 최대 500개 리소스를 이전합니다. Ontology Manager의 Advanced에서 Migrations 아래 continue with migration assistant를 선택합니다.

1. Choose resources에서 같은 역할을 적용할 객체 유형, 링크 유형과 액션 유형을 선택합니다.

2. 이전 가능한 관련 링크나 액션이 있으면 Related resources 단계가 표시됩니다.
3. Assign roles에서 그룹, 사용자와 기본 역할을 직접 지정합니다. 일괄 이전에서는 역할을 자동 추천하지 않습니다. 개별 사용자보다 사용자 그룹으로 권한을 관리하는 방식을 권장합니다.
4. Summary에서 결과와 영향을 확인하고 이전을 완료합니다.

액션 권한은 참조한 객체 유형과 그 액션이 배포된 업무 활용 사례를 이해하는 사람에게 부여합니다. 완료하면 이전에 기반 데이터소스에서 파생하던 권한을 새 역할 부여로 덮어쓰며 되돌릴 수 없습니다.

한 리소스씩 이전

홈의 리소스 목록에서 Security setup을 Same permissions as backing datasource, permissions를 owner로 필터링합니다. 리소스를 열고 헤더의 Migrate to roles 또는 Security의 Start using roles를 선택합니다.

단일 리소스 이전에서는 두 추천 방식을 선택할 수 있습니다.

두 번째 방식은 관리자 그룹과 데이터소스 권한의 교집합입니다. 둘 중 하나만 만족하는 사람을 모두 더하는 방식이 아닙니다.

선택한 추천으로 목록을 채운 뒤 실제 온톨로지 역할과 기본 역할을 검토하고 필요한 항목을 수정합니다. Summary에서 영향을 확인하고 완료합니다.

액션 이전이 차단되는 경우

일괄 또는 단일 이전 모두 다음 조건을 먼저 해결해야 합니다.

일괄 이전 뒤 남은 액션은 Action Types에서 Same permissions as backing datasource로 다시 찾습니다. 차단 원인을 해결한 뒤 나머지 대상으로 이전을 진행합니다.

함수 기반 액션의 사후 실패

Foundry는 함수의 이전을 자동으로 시도하지만 편집할 객체 유형을 정적 분석으로 찾지 못하는 경우 수동 선언이 필요합니다. 액션을 제출한 뒤 다음 오류가 나타날 수 있습니다.

The Function backed action does not register which object types it edits.

TypeScript v1의 온톨로지 편집 함수(Ontology edit function)에 실제 편집 대상 객체 유형을 @Edits로 선언하고 함수를 다시 게시합니다. 이어서 액션 유형이 새 함수 버전을 사용하도록 갱신합니다. 함수 코드는 코드 저장소에서 수정합니다.

앱의 권한 변화

이전 후 사용자에게 유형의 메타데이터가 더 넓게 보일 수 있지만 입력 데이터소스의 자료를 읽을 권한을 얻는 것은 아닙니다. 보이는 메타데이터 범위는 온톨로지 역할을 따릅니다.

Object Explorer의 객체 뷰(Object view) 편집 조건도 바뀝니다. 이전 전에는 Object View Administrators 그룹과 입력 데이터소스의 Editor 권한이 필요했습니다. 온톨로지 역할로 이전한 뒤에는 객체 유형 자체의 Ontology Editor 권한을 확인합니다.

더 이상 필요 없는 리소스는 Ontology cleanup에서 사용량, 데이터소스 상태, 지원 종료일과 인덱싱 등의 후보 신호를 검토할 수 있습니다. 역할 이전 대신 삭제를 선택할 때에도 의존 앱과 사용자 편집의 영향을 확인합니다.