importSnapshot

스냅샷의 콘텐츠를 환경으로 임포트합니다. 가져오는 스냅샷은 기본 업로드 위치에 있어야 합니다.

서비스 관리자는 uploadFile 명령을 사용하여 스냅샷을 업로드하거나 copySnapshotFromInstance 명령을 사용하여 다른 인스턴스에서 스냅샷을 복사합니다.

  • 다음은 Planning, Planning 모듈, 무형식 애플리케이션 스냅샷에 포함되지 않습니다.
    • 감사 데이터
    • 작업 콘솔 데이터
    감사 및 작업 콘솔 데이터를 타겟 환경에 복사하려는 경우 cloneEnvironment 명령이나 환경 복제 기능을 사용합니다.

    Planning 비즈니스 프로세스에 사용자정의 기간 멤버로 대체된 이름이 변경된 시드된 기간 멤버가 포함된 경우 스냅샷 임포트가 실패할 수 있습니다. 예를 들어, 시드된 YearTotal 기간 멤버를 unused_YearTotal로 이름을 변경한 다음 대체 유형 기간 멤버를 원래 시드된 멤버 이름(이 예에서 YearTotal )로 추가했습니다. 이 시나리오에서는 스냅샷 임포트가 실패할 수 있습니다.

  • 스냅샷에는 Data Management 스테이지 테이블 데이터가 포함되지 않습니다. 이 데이터를 임포트하려면 exportDataManagement 및 importDataManagement 명령이나 Data Management 시스템 유지관리 스크립트 인터페이스를 사용합니다. cloneEnvironment 명령이나 환경 복제 기능을 사용하여 Data Management 스테이지 테이블 데이터를 비롯한 환경의 동일한 복사본을 생성할 수 있습니다.

이 명령을 사용하여 완료할 수 있는 작업은 역할에 따라 달라집니다.

  • 서비스 관리자는 애플리케이션 아티팩트만 서비스 환경으로 임포트할 수 있습니다.
  • 애플리케이션 콘텐츠를 서비스 환경으로 임포트하고 ID 도메인 아티팩트(사용자 및 사전 정의된 역할 지정)를 환경의 ID 도메인으로 임포트하려면 서비스 관리자 및 ID 도메인 관리자 역할이 둘 다 필요합니다.

    임포트되는 스냅샷에서 ID 도메인에 없는 사용자가 참조되는 경우 EPM Automate는 ID 도메인에 사용자를 생성하고 명령에 지정된 기본 비밀번호를 지정합니다. 명령에 비밀번호가 지정되지 않은 경우 각 사용자에게 고유한 비밀번호를 지정합니다. 기본적으로 사용자는 처음 사인인할 때 비밀번호를 재설정해야 합니다.

주:

  • Account Reconciliation, Profitability and Cost Management, Oracle Enterprise Data Management Cloud 이외의 비즈니스 프로세스: 아웃라인에서 공유 멤버가 기준 멤버 앞에 표시되므로 이전 시도에서 거부된 레코드가 발생한 경우 Oracle Enterprise Performance Management Cloud에서 메타데이터를 로드하는 동안 로드 통과를 여러 번 수행할 수 있습니다. 이러한 시도로 인해 명령 처리 시간이 증가할 수 있습니다.
  • 액세스 제어에서 그룹의 멤버인 사용자는 사전 정의된 역할에 지정되어야 합니다. 사전 정의된 역할에 지정되지 않은 사용자는 그룹에 지정할 수 없습니다.

적용 대상

Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Account Reconciliation, Profitability and Cost Management, Enterprise Profitability and Cost Management, Oracle Enterprise Data Management Cloud, Sales Planning 및 Strategic Workforce Planning.

필수 역할

  • 서비스 관리자
  • 고급 사용자 및 마이그레이션 - 애플리케이션 역할 관리(Oracle Enterprise Data Management Cloud 및 Profitability and Cost Management)
사용자 및 사전 정의된 역할 지정을 임포트하려면 ID 도메인 관리자 역할이 필요합니다.

사용법

epmautomate importSnapshot SNAPSHOT_NAME [importUsers=true|false] [userPassword=DEFAULT_PASSWORD] [resetPassword=true|false] 설명:
  • SNAPSHOT_NAME은 기본 업로드 위치에 있는 스냅샷의 이름입니다.
  • importUsers는 선택사항으로, 스냅샷에서 사용자 및 사전 정의된 역할 지정을 임포트할 것인지 지정합니다. 기본값은 false입니다. 소스 스냅샷에 새 사용자에 대한 데이터가 포함된 경우 또는 현재 사용자에게 새 역할이 지정된 경우 importUsers=true를 사용하여 사용자 및 사전 정의된 역할 지정을 ID 도메인으로 임포트합니다.

    사용자 로그인 값은 대소문자를 구분하지 않습니다. 예를 들어 사용자 로그인 값 jane.doe@example.com은 Jane.Doe@Example.com 또는 대소문자의 모든 변형과 동일한 것으로 처리됩니다. 변형이 ID 도메인에 있는 사용자 로그인과 일치하는 경우 이 명령은 스냅샷에서 사용자를 임포트하지 않습니다.

    주:

    • ID 도메인 관리자가 아닌 사용자가 임포트 작업을 수행하면 사용자 및 사전 정의된 역할 임포트가 실패합니다. 마이그레이션 상태 보고서에 다음 오류가 기록됨: 외부 디렉토리 아티팩트 ARTIFACT_NAME 임포트 실패. USER_NAME 사용자는 이 작업을 수행할 수 있는 권한이 없습니다. 이 작업을 수행하려면 사용자에게 ID 도메인 관리자 역할이 있어야 합니다.
    • 사용자를 임포트하지 않고 소스 스냅샷의 사용자가 타겟 환경의 사전 정의된 역할에 지정되지 않은 경우 오류(EPMIE-00070: 지정된 역할 임포트 중 사용자를 찾지 못했습니다.)가 표시됩니다.
    • 사용자의 사전 정의된 역할 변경사항은 소스 스냅샷에서 지정된 역할에 따라 업데이트됩니다. 그러나 타겟의 역할 지정이 소스 스냅샷의 역할 지정과 일치하도록 제거되지는 않습니다. 예를 들어 jdoe가 타겟 환경에서는 고급 사용자 사전 정의된 역할에 지정되었지만 소스 스냅샷에서는 사용자 역할만 있다고 가정합니다. 이런 상황에서 이 명령은 사용자 역할에 jdoe를 지정하고 타겟 환경의 고급 사용자 역할 지정을 제거하지 않습니다.
    • 이 명령은 소스 스냅샷에 없는 경우에도 타겟 환경의 기존 사용자를 삭제하지 않습니다. 예를 들어 jdoe는 타겟 환경에 계정이 있지만 소스 스냅샷에는 이 계정이 없습니다. 이런 상황에서 타겟 환경의 jdoe 계정은 삭제되지 않습니다.
    • 이 명령은 타겟 환경에 없는 사용자를 추가합니다. 소스 스냅샷과 다른 경우에도 타겟 환경의 현재 사용자 등록정보를 업데이트하지 않습니다. 예를 들어 소스 스냅샷에 있는 jdoe의 성 철자가 타겟 환경과 다른 경우에도 타겟 환경에서 변경되지 않습니다.
    • 이 명령은 소스 스냅샷과 다른 경우에도 타겟 환경의 기존 사용자 비밀번호를 변경하지 않습니다.
  • userPassword는 선택사항으로, ID 도메인에 생성된 새 사용자에게 지정하는 기본 비밀번호를 나타냅니다. 지정한 비밀번호가 최소 비밀번호 요구사항을 충족해야 합니다. 이 매개변수 값을 지정하지 않으면 각 사용자에게 고유한 임시 비밀번호가 지정됩니다.
  • resetPassword는 선택사항으로, 새 사용자가 처음 로그인 시 비밀번호를 변경해야 하는지 여부를 나타냅니다. 기본값은 true이며, 새 사용자가 처음 로그인 시 비밀번호를 변경해야 합니다. 이 값을 true로 설정하면 새 사용자는 비밀번호를 변경하도록 요청하는 계정 활성화 전자메일을 받게 됩니다.

예

  • 애플리케이션 아티팩트 임포트만 해당: epmautomate importSnapshot April16FullApp
  • 애플리케이션 및 ID 도메인 아티팩트 임포트(Service Administrator 및 Identity Domain Administrator 역할 필요):
    • 각각의 새 사용자에게 고유한 임시 비밀번호를 지정하고, 사용자가 처음 로그인한 후 비밀번호를 재설정하도록 강제 적용합니다.

      epmautomate importSnapshot April16FullApp importUsers=true

    • 특정 비밀번호를 지정하고 사용자가 선택하는 경우 이 비밀번호를 변경하지 않을 수 있도록 합니다. 프로덕션 환경으로 임포트하는 데는 사용하지 않는 것이 좋습니다.

      epmautomate importSnapshot April16FullApp importUsers=true userPassword=P@ssw0rd1 resetPassword=false