온톨로지 역할 마이그레이션

온톨로지 역할이란 무엇인가요?

• 온톨로지 역할은 온톨로지 리소스를 인증하는 업데이트된 솔루션입니다. 온톨로지 역할은 2024년에 기본 인증 모델로 데이터소스 기반 권한을 대체합니다.
• 온톨로지 역할은 오브젝트 유형, 링크 유형, 액션 유형에 적용되며, 이들은 "온톨로지 리소스"로 불립니다. 기본적으로, 온톨로지 역할 인증 모델은 2023년 9월 이후에 생성된 모든 새로운 등록에 적용됩니다; 이러한 역할을 적용하여 온톨로지의 가장 최근 기능, 즉 공유 속성 유형, 인터페이스 등을 사용해야 합니다.
• 온톨로지 역할은 각 온톨로지 리소스와 그들의 메타데이터에 직접 역할을 부여할 수 있게 해줍니다. 모든 메타데이터 권한은 Ontology Manager에서 관리됩니다.
• 데이터 권한은 항상 데이터소스 권한에 의해 관리됩니다. 온톨로지 역할은 이러한 리소스의 _데이터_에서 온톨로지 리소스를 분리할 수 있게 해줍니다. 이들에는 입력 데이터소스 권한에 의해 관리되는 오브젝트 인스턴스와 링크 인스턴스가 포함됩니다. 온톨로지 권한에 대해 더 자세히 알아보세요.

정의

온톨로지 역할은 온톨로지 리소스를 인증하는 업데이트된 솔루션으로, 곧 기본 인증 모델로 데이터소스 기반 권한을 대체할 예정입니다. 온톨로지 역할은 오브젝트 유형, 링크 유형, 액션 유형 등 각 온톨로지 리소스 및 그들의 메타데이터에 직접 역할을 부여할 수 있게 해줍니다. 이 기능은 오브젝트 인스턴스와 링크 인스턴스 자체와 같은 이러한 리소스의 _데이터_로부터 온톨로지 리소스를 분리합니다. 이들은 입력 데이터소스 권한에 의해 계속 관리됩니다.

각 온톨로지는 하나 이상의 Foundry 그룹에 연결됩니다.

역할 권한은 온톨로지 역할 문서에서 자세히 설명됩니다.

예시

온톨로지 리소스를 온톨로지 역할로 마이그레이션하는 데 명확한 순서가 필요하지 않아, 데이터소스 기반 권한을 사용하는 오브젝트 유형과 온톨로지 역할을 사용하는 다른 오브젝트 유형이 혼합될 수 있습니다. 따라서 이 마이그레이션을 위해 오브젝트 유형을 편집할 수 있는을 다음과 같이 정의합니다:

• 데이터소스 기반 권한을 사용하는 오브젝트 유형: 사용자는 해당 오브젝트 유형의 입력 데이터소스에 에디터 권한을 가지고 있습니다.
• 온톨로지 역할을 사용하는 오브젝트 유형: 사용자는 오브젝트 유형에 온톨로지 에디터 권한을 가지며, 입력 데이터소스에 대한 어떤 권한도 필요하지 않습니다. 사용자는 이것이 오직 온톨로지 리소스와 그들의 메타데이터를 편집하는 것만 허용하며, 데이터/데이터소스 자체에 대한 어떤 권한도 부여하지 않는다는 점을 알아야 합니다. 오브젝트 데이터 (메타데이터가 아님)에 대한 접근은 여전히 입력 데이터소스에 부여된 권한에 의해 관리됩니다.

온톨로지 역할로 마이그레이션하기

등록에서 온톨로지 역할이 활성화되어 있지만, 소유하는 온톨로지 리소스를 아직 역할 인증 모델로 마이그레이션하지 않았다면, Ontology Manager에서 마이그레이션을 요청하는 배너를 볼 수 있습니다. 또는, 온톨로지 리소스 표를 보면서, 여전히 "백업 데이터소스와 동일한 권한"을 사용하는 소유한 리소스를 필터링할 수 있습니다.

사전 준비 사항

마이그레이션을 수행하려면 사용자는 다음 권한이 필요합니다:

1. Foundry 온톨로지에서 변경을 수행할 권한.

2. 각 개별 리소스에 대한 다음 권한:

   • 오브젝트 유형의 경우, 사용자는 입력 데이터소스에 소유자 권한이 있어야 합니다.
   • 일대다 링크 유형의 경우, 추가 권한이 필요하지 않습니다. 링크 유형에서 참조된 두 오브젝트 유형에 대한 뷰어 권한만 있으면 되며, 사용자는 링크 유형 자체 또는 온톨로지 수준에서 소유자여야 합니다.
   • 다대다 링크 유형의 경우, 일대다 링크 유형에 필요한 권한 외에도, 사용자는 링크 유형의 입력 데이터소스에 소유자 권한이 있어야 합니다.
   • 액션 유형에 대해서는 추가 권한이 필요하지 않습니다.

마이그레이션 알림

온톨로지 역할로의 마이그레이션은 Upgrade Assistant을 통해 관리됩니다. 전용 Upgrade Assistant 작업은 마이그레이션이 필요한 온톨로지 리소스 목록과 마이그레이션을 수행할 수 있는 권한이 있는 담당자를 표시합니다. Upgrade Assistant에서 리소스를 열면 사용자는 Ontology Manager 애플리케이션 내에서 마이그레이션을 수행하기 위해 리소스의 보안 탭으로 이동합니다.

온톨로지 역할을 설정할 권한이 있는 사용자의 경우, 아직 마이그레이션되지 않은 온톨로지 리소스는 보안 탭의 마이그레이션 인터페이스에 표시됩니다. 온톨로지 리소스가 마이그레이션되면, 온톨로지 역할 선택기가 보안 탭에 표시되며, 온톨로지 소유자가 업데이트할 수 있습니다.

Ontology Manager 애플리케이션을 사용하여 마이그레이션하기

온톨로지 리소스(오브젝트 유형, 액션 유형, 링크 유형)를 역할로 마이그레이션하는 두 가지 방법이 있습니다: 온톨로지 리소스의 일괄 마이그레이션 또는 모든 온톨로지 리소스에 대한 하나씩 마이그레이션.

온톨로지 리소스의 일괄 마이그레이션

온톨로지 리소스를 일괄적으로 역할로 마이그레이션할 수 있습니다. 진행하기 전에 사전 준비 사항을 참조하십시오. 한 번에 500개의 리소스만 마이그레이션할 수 있습니다.

일괄 마이그레이션을 하려면, Ontology Manager에서 고급으로 이동하고 마이그레이션 섹션에서 마이그레이션 어시스턴트 계속하기를 선택합니다.

마이그레이션 마법사가 다음 단계로 나타납니다.

1. 리소스 선택: 같은 역할을 적용하려는 모든 오브젝트 유형, 링크 유형, 액션 유형을 선택합니다. 아래 이미지는 마이그레이션 마법사에서 리소스를 선택하는 인터페이스를 보여줍니다:

2. 관련 리소스: 이 단계는 마이그레이션할 수 있는 관련 리소스(링크 유형 또는 액션 유형)가 있을 경우에만 표시됩니다.
3. 역할 지정: 그룹/사용자와 기본 역할을 수동으로 설정하고, 이 오브젝트 유형에 지정하려는 역할을 설정할 수 있습니다. 현재로서는 역할 마이그레이터가 일괄적으로 역할을 제안할 수 없습니다. 역할을 부여할 때 사용자 그룹을 사용자보다 사용하는 것을 강력히 권장합니다.
4. 요약: 요약을 확인하고, 마이그레이션의 영향을 인지하고, 역할을 적용하기 위해 마이그레이션을 완료합니다.

일괄 마이그레이션에 대한 예외

일부 액션 유형은 추가 단계 없이는 일괄 마이그레이션할 수 없습니다.

액션 유형이 역할로 마이그레이션되지 못하면:

• 액션 유형에 현재 사용자의 권한을 확인하는 제출 기준이 없습니다.
  • 해결 방법: Ontology Manager에서 액션 유형의 보안 & 제출 기준 탭( 제출 기준 섹션)에 현재 사용자를 기반으로 한 조건을 추가하고, 마이그레이션을 재시도하기 전에 온톨로지에 저장합니다.
• 액션 유형이 함수에 의해 지원되며, 마이그레이션 전에 @edits decorators로 다시 게시해야 합니다.
  • 해결 방법: decorators 문서의 단계를 참조하십시오.

이 문제들을 해결하면, 액션 유형 페이지로 이동하여 백업 데이터소스와 동일한 권한으로 필터링을 하면, 문제 때문에 마이그레이션되지 않은 액션 유형이 표시됩니다. 모든 미해결 문제를 해결한 후, 남은 액션 유형에 대해 다시 일괄 마이그레이션을 진행합니다.

모든 온톨로지 리소스에 대한 하나씩 마이그레이션

Ontology Manager 홈페이지에서 마이그레이션하려는 온톨로지 리소스(오브젝트 유형, 링크 유형, 액션 유형)를 선택하고, 보안 설정을 백업 데이터소스와 동일한 권한으로, 권한을 소유자로 필터링합니다.

마이그레이션하려는 엔티티를 선택한 후, 헤더의 역할로 마이그레이션하기 또는 보안 탭의 역할 사용 시작 중 하나를 선택합니다.

마이그레이션 마법사가 나타나고, 데이터소스 역할과 Ontology Manager & 데이터소스 역할 두 가지 역할 옵션을 제안합니다. 이러한 옵션은 사용자가 기존 온톨로지 설정과 일치하는 역할을 사용하고 구성할 수 있게 해줍니다. 옵션 중 하나를 선택하면, 제안된 역할 목록이 사전 채워집니다; 이러한 역할은 나중에 변경될 수 있습니다.

• 데이터소스 역할: 이 옵션은 입력 데이터소스에 에디터 또는 소유자 역할을 가진 모든 사용자와 사용자 그룹을 추가합니다.
• Ontology Manager & 데이터소스 역할: 이 옵션은 주어진 온톨로지 리소스를 현재 수정할 수 있는 모든 사용자를 추가합니다. 이러한 사용자는 Ontology Manager 사용자 그룹에 속하고 있으며, 입력 데이터소스에 에디터 또는 소유자 역할을 가지고 있습니다.

아래 이미지는 마이그레이션 마법사에서 역할 제안을 보여줍니다:

원하는 역할 제안을 선택하고, 오브젝트 유형에 대한 기본 역할과 제안된 온톨로지 역할을 검토하고 필요한 경우 수정합니다. 다음으로, 요약을 보고, 영향을 인지하고, 역할을 적용하기 위해 마이그레이션을 완료합니다.

아래 이미지는 마이그레이션 마법사에서 역할을 지정하는 방법을 보여줍니다:

예외

다음과 같은 상황에서 액션 유형의 역할로의 마이그레이션을 시도하는 것이 방해받을 수 있습니다:

• 액션 유형에 현재 사용자의 권한을 확인하는 제출 기준이 없습니다.
  • 해결 방법: Ontology Manager에서 액션 유형의 보안 & 제출 기준 탭( 제출 기준 섹션)에 현재 사용자를 기반으로 한 조건을 추가하고, 마이그레이션을 재시도하기 전에 온톨로지에 저장합니다.
• 액션 유형이 함수에 의해 지원되며, 마이그레이션 전에 @edits decorators로 다시 게시해야 합니다.
  • 해결 방법: decorators 문서의 단계를 참조하십시오.

이 문제들이 해결되면, 액션 유형을 역할로 마이그레이션할 수 있습니다.

일부 온톨로지 리소스가 더 이상 필요하지 않은 경우 어떻게 하나요?

더 이상 필요하지 않은 온톨로지 리소스가 액션을 요구하는 경우, 온톨로지 정리 도구를 사용하여 리소스를 삭제할 수 있습니다. 이 도구는 일련의 기준(예: 데이터소스가 휴지통에 있거나, 폐기 날짜가 지났거나, 인덱스가 실패하는 경우, 온톨로지 역할을 사용하고 있는지 등)에 따라 어떤 오브젝트 유형이 안전하게 삭제될 수 있는지 확인하는 데 도움을 줍니다.

함수를 기반으로 하는 액션 유형 마이그레이션

함수를 기반으로 하는 액션 유형은 백업 함수가 마이그레이션되어야 합니다. Foundry는 함수를 자동으로 마이그레이션하려고 시도하며, 이를 통해 액션 유형도 마이그레이션할 수 있게 해줍니다. 그러나 일부 함수는 자동으로 마이그레이션이 되지 않을 수 있으며, 함수 내에서 편집된 오브젝트 유형을 수동으로 선언해야 합니다. 액션 유형을 온톨로지 역할로 마이그레이션한 후에 함수를 기반으로 하는 액션에서 실패가 발생하는 경우 FAQ 섹션을 확인하십시오.

마이그레이션 FAQ

오브젝트를 인식하는 애플리케이션에서 변경 사항이 발생하나요?

사용자는 입력 데이터소스에 뷰어 권한이 없어서 이전에 볼 수 없었던 Ontology Manager에서 오브젝트 유형과 링크 유형에 대한 메타데이터에 접근할 수 있게 될 수 있습니다. 이것은 그들이 입력 데이터소스의 데이터에 접근을 허용받는 것을 의미하지 않으며, 이것은 항상 해당 데이터소스의 역할에 의해 관리됩니다. 그들이 볼 수 있는 메타데이터의 구체적인 내용은 그들의 온톨로지 역할에 따라 결정됩니다.

또한, 오브젝트 유형이 마이그레이션되면, Object Explorer는 Object View를 편집하는 권한 체크를 업데이트합니다. 오브젝트 유형이 마이그레이션되기 전에, 사용자는 Object View를 편집하기 위해 Object View 관리자 그룹에 속해 있고, 입력 데이터소스에 에디터 권한이 필요합니다. 오브젝트 유형이 마이그레이션된 후에는, Object Explorer는 오브젝트 유형 자체에 온톨로지 에디터 권한이 있는 사용자만 체크하게 됩니다.

함수를 기반으로 하는 액션이 마이그레이션 후에 실패하는 경우 어떻게 해결할 수 있나요?

Foundry가 온톨로지 편집 함수가 편집하는 오브젝트 유형을 자동으로 감지하지 못했다면, 제출 후 액션은 다음 오류로 실패합니다.

이 오류를 해결하려면, 함수 문서에서 설명된 단계를 따르십시오.