runIntegration

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

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

적용 대상

Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Account Reconciliation, Profitability and Cost Management, Enterprise Profitability and Cost Management, Sales Planning 및 Strategic 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_NAME은 Data Integration에서 정의된 통합 작업의 이름입니다.
  • importMode는 데이터를 Data Integration으로 임포트하는 방법을 결정합니다. 사용가능한 임포트 모드는 다음과 같습니다.
    • Append - Data Integration의 기존 POV 데이터에 추가합니다.
    • Replace - POV 데이터를 삭제하고 파일의 데이터로 바꿉니다.
    • Map and Validate - 데이터 임포트를 건너뛰지만 업데이트된 매핑 및 논리 계정을 사용하여 데이터를 재처리합니다.
    • No Import - Data Integration 스테이지 테이블로의 데이터 임포트를 건너뜁니다.
  • exportMode는 데이터를 타겟 애플리케이션에 로드하는 방법을 결정합니다. 빠른 모드 통합의 경우 exportMode 매개변수 값으로 Check 및 No 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 Management 및 Enterprise Profitability and Cost Management에 적용됩니다.

      빠른 모드 통합의 경우:

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

      • Planning, Planning Modules 및 Financial Consolidation and Close의 경우 유일한 적합한 값은 Replace, Merge 및 Accumulate입니다.

    • 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 비즈니스 프로세스에서 지원됩니다. 온-프레미스 데이터 소스에서 파생된 서비스 애플리케이션 및 클라우드 배포에 모두 적용됩니다.

        연도 및 기간 멤버 이름을 캡처하여 Cloud EPM 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 오류 메시지가 표시됩니다.
    • {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 periodName="{Mar-15}"

  • 복수 기간 임포트:

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

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

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