runIntegration

Data Integration 작업을 실행하여 데이터를 Oracle Enterprise Performance Management Cloud 비즈니스 프로세스로 임포트하거나 비즈니스 프로세스의 데이터를 외부 시스템으로 익스포트합니다.

이 명령은 runDataRule 명령을 대체합니다. runDataRule 명령 대신 이 명령을 사용하는 것이 좋습니다.

적용 대상

Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Account Reconciliation, Profitability and Cost Management, Enterprise Profitability and Cost Management, Sales PlanningStrategic Workforce Planning.

필수 역할

서비스 관리자, 고급 사용자

사용법

epmautomate runIntegration JOB_NAME importMode=Append|Replace|"Map and Validate"|"No Import"|Direct exportMode=Merge|Replace|Accumulate|Subtract|"No Export"|Check periodName={PERIOD_NAME} [inputFileName=FILE_NAME] [PARAMETERS]
  • 표준 모드 통합의 경우 importMode, exportMode, periodName 값을 지정해야 합니다.
  • 빠른 모드 통합의 경우 exportMode 값을 지정해야 합니다.
  • 매개변수 이름과 해당 값은 대소문자를 구분합니다.
이 명령에서 각 요소는 다음을 나타냅니다.
  • JOB_NAMEData Integration에서 정의된 통합 작업의 이름입니다.
  • importMode는 데이터를 Data Integration으로 임포트하는 방법을 결정합니다. 사용가능한 임포트 모드는 다음과 같습니다.
    • Append - Data Integration의 기존 POV 데이터에 추가합니다.
    • Replace - POV 데이터를 삭제하고 파일의 데이터로 바꿉니다.
    • Map and Validate - 데이터 임포트를 건너뛰지만 업데이트된 매핑 및 논리 계정을 사용하여 데이터를 재처리합니다.
    • No Import - Data Integration 스테이지 테이블로의 데이터 임포트를 건너뜁니다.
  • exportMode는 데이터를 타겟 애플리케이션에 로드하는 방법을 결정합니다. 빠른 모드 통합의 경우 exportMode 매개변수 값으로 CheckNo Export를 사용할 수 없습니다. 사용가능한 익스포트 모드 값은 다음과 같습니다.
    • Merge - 기존 데이터를 업데이트하고 새 데이터를 추가합니다.
    • Replace - POV의 기존 데이터를 지우고 새 데이터를 로드합니다. 표준 모드의 경우 시나리오, 버전, 연도, 기간, 엔티티 차원의 데이터가 지워집니다. 빠른 모드의 경우 연도, 기간, 엔티티 차원의 데이터가 지워집니다. 두 모드에서 모두 사용자정의 지우기 영역을 정의할 수 있습니다.
    • Accumulate - 기존 데이터에 데이터를 추가합니다. Planning, Planning 모듈, Financial Consolidation and Close, Tax Reporting, Profitability and Cost Management, Enterprise Profitability and Cost Management에 적용할 수 있습니다.
    • Subtract - 기존 잔액에서 데이터를 뺍니다. Profitability and Cost ManagementEnterprise Profitability and Cost Management에 적용됩니다.

      빠른 모드 통합의 경우:

      • CheckNo Export는 이 매개변수의 값으로 사용할 수 없습니다.

      • Planning, Planning ModulesFinancial Consolidation and Close의 경우 유일한 적합한 값은 Replace, MergeAccumulate입니다.

    • No Export - 데이터 익스포트를 건너뜁니다. 타겟 애플리케이션에 로드하기 전에 검토를 위해 스테이지 테이블에 데이터를 로드하려면 이 모드를 사용합니다.
    • Check - 데이터 검증 검사만 수행합니다.

      Oracle Fusion Cloud를 타겟으로 사용하는 경우 다음 익스포트 모드만 지원됩니다.

      • MERGE - Data Integration 스테이지 테이블의 데이터를 기존 데이터와 병합합니다.
      • NONE - Data Integration에서 애플리케이션으로의 데이터 익스포트를 건너뜁니다.
  • periodName은 데이터를 임포트 또는 익스포트할 하나 이상 기간 또는 기간 범위의 이름으로, 각각 중괄호로 묶여 있습니다. 사용가능한 기간 이름 지정 규칙은 다음과 같습니다.
    • 단일 기간 로드의 경우 중괄호로 묶어 기간 이름을 지정합니다(예: {Jan-21}).
    • 복수 기간 로드의 경우 시작 및 종료 기간 이름을 중괄호로 묶습니다. 예를 들어 {Jan-21}{Mar-21}은 Jan-21에 시작되어 Mar-21에 종료되는 모든 기간의 데이터를 로드합니다.
    • Planning, Planning 모듈, Financial Consolidation and Close무형식, Tax Reporting: 비즈니스 프로세스 기간 이름과 연도를 {Jan#FY21}{Mar#FY21} 형식으로 지정하여 Jan-21에 시작되어 Mar-21에 종료되는 모든 기간의 데이터를 로드할 수 있습니다.

      기간 이름은 중괄호로 묶어야 합니다.

      • Single Period - 기간 매핑에서 정의된 단일 기간의 Data Management 기간 이름을 나타냅니다.
      • Multi-Period - 복수 기간 로드를 나타냅니다. 매개변수는 {Month-Year}{Month-Year} 형식으로 지정됩니다. 예를 들어 {Jan-20}{Mar-20}은 Jan-20부터 Mar-20까지의 복수 기간 로드입니다.
      • Planning Period Name - {Month#Year} 형식(예: {Jan#FY20}{Mar#FY20})의 Planning 기간 이름을 나타냅니다. 이 규칙을 사용하면 Data Integration 기간 이름을 지정할 필요가 없습니다. 대신, 연도 및 시나리오 차원의 멤버 이름을 지정합니다.

        이 매개변수는 Planning, Tax Reporting, Financial Consolidation and Close 비즈니스 프로세스에서 지원됩니다. 온-프레미스 데이터 소스에서 파생된 서비스 애플리케이션 및 클라우드 배포에 모두 적용됩니다.

        연도 및 기간 멤버 이름을 캡처하여 EPM Cloud Groovy 스크립트에서 명령이 트리거되는 경우 이 규칙을 사용하면 유용합니다. 기간 매핑의 타겟 값에 연도와 월이 포함된 애플리케이션 기간 매핑 또는 글로벌 기간 매핑이 있어야 합니다.

      • Substitution Variable - 이전 Planning 기간 이름 형식의 확장입니다. 실제 연도 및 월 멤버 이름 대신 대체 변수를 {Month#&CurYr}{&FcstMonth#&CurYr} 형식(예: {Jan#&CurYr}{&FcstMonth#&CurYr})으로 지정할 수 있습니다.

        실제 멤버 이름과 대체 변수를 조합할 수 있습니다.

        이 형식은 Planning, Tax Reporting, Financial Consolidation and Close 비즈니스 프로세스에서 지원됩니다.

        기간 매핑의 타겟 값에 연도 및 월 값이 제공된 애플리케이션 기간 매핑 또는 글로벌 기간 매핑이 명령이 실행된 환경의 Data Integration에 있어야 합니다. 이 경우, 연도와 월은 실행 중 대체 변수의 현재 값을 나타냅니다.

      • GLOBAL POV - 글로벌 POV 기간의 데이터 로드를 실행합니다. {GLOBAL_POV} 형식을 사용합니다.

      Note:

      이 토론에서 설명한 매개변수 이외의 기간 이름 지정 매개변수를 사용하면 부적합한 입력 – HTTP 400 오류 메시지가 표시됩니다.

      REST API 문서에서 periodName 섹션을 복사합니다. 글로벌 POV, Subvar 등의 다양한 형식이 간략하게 설명되어 있습니다.

    • {GLOBAL_POV} - 시스템의 글로벌 POV 또는 Data Integration의 애플리케이션 설정에서 정의된 기간의 데이터 로드를 실행합니다.

      Note:

      {Month#Year} 기간 이름 지정 규칙 형식은 Planning, Planning 모듈, Financial Consolidation and Close, Tax Reporting에서 지원됩니다. 이 규칙에서는 Data Integration 기간 이름 대신 연도 및 시나리오 차원의 멤버 이름을 지정할 수 있습니다. 이 방법은 연도 및 기간 멤버 이름을 캡처하여 Groovy 스크립트에서 명령이 트리거되는 경우에 유용합니다.

      {Jan#&CurYr}{&FcstMonth#&CurYr} 대체 변수 이름 지정 규칙은 이전 기간 이름 지정 규칙의 확장입니다. Planning, Planning 모듈, Financial Consolidation and Close, Tax Reporting에서 이 명령을 실행하는 경우 연도 및 월 멤버 이름 대신 대체 변수를 지정할 수 있습니다. 멤버 이름과 대체 변수를 조합할 수도 있습니다.

      이전 기간 이름 지정 및 대체 변수 이름 지정 규칙은 타겟 값에 연도와 월이 포함된 애플리케이션 기간 매핑 또는 글로벌 기간 매핑이 Data Integration에 이미 있는 경우에만 작동합니다.
  • inputFileName - 파일 기반 데이터 로드의 경우 인박스에서 사용가능한, 데이터를 임포트할 파일의 이름을 지정합니다. 통합 정의에서 디렉토리 이름을 지정하는 경우 파일 이름만 전달합니다. 통합 정의에 디렉토리 이름을 포함하지 않는 경우 inbox/DIR_NAME/FILE_NAME 형식(예: inbox/GLBALANCES.txt 또는 inbox/EBSGL/GLBALANCES.txt)을 사용합니다. 파일이 환경의 기본 위치에 업로드된 경우 #epminbox/FILE_NAME 규칙(예: #epminbox/GLBALANCES.txt)을 사용하여 입력 데이터 파일을 파악합니다.

    이 매개변수는 기본 파일 기반 데이터 로드에만 적용할 수 있습니다. 파일 기반 데이터 로드에 대해 이 매개변수 값을 지정하지 않으면 이 명령은 통합 정의에서 지정된 파일의 데이터를 임포트합니다. 파일 기반이 아닌 데이터 로드에 대해 이 매개변수 값을 지정하면 명령에서 무시합니다.

  • PARAMETERS는 선택사항으로, 런타임 매개변수를 PARAMETER_NAME="PARAMETER" 형식으로 확인합니다. 매개변수에는 소스 필터와 타겟 옵션이 둘 다 포함됩니다.

    Note:

    현재 타겟 애플리케이션의 차원(메타데이터) 유형에 사용할 수 있는 매개변수는 "Refresh Database"=Yes|No뿐입니다.

  • 단일 기간 임포트:

    epmAutomate runIntegration VisionDataLoad importMode=Replace exportMode=Merge period="{Mar-15}"

  • 복수 기간 임포트:

    epmAutomate runIntegration VisionDataLoad importMode=Replace exportMode=Merge period="{Mar-15} {Jun-15}"

  • 증분 파일 기반 데이터 통합:

    epmAutomate runIntegration IncrementalFileLoad importMode=Replace exportMode=Merge period="{Jan-20}{Mar-20}" inputFileName=File1.txt