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 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에 종료되는 모든 기간의 데이터를 로드합니다.{Jan#FY21}{Mar#FY21}
형식으로 지정하여 Jan-21에 시작되어 Mar-21에 종료되는 모든 기간의 데이터를 로드할 수 있습니다.
기간 이름은 중괄호로 묶어야 합니다.
{Month-Year}{Month-Year}
형식으로 지정됩니다. 예를 들어 {Jan-20}{Mar-20}은 Jan-20부터 Mar-20까지의 복수 기간 로드입니다.{Month#Year}
형식(예: {Jan#FY20}{Mar#FY20})의 Planning 기간 이름을 나타냅니다. 이 규칙을 사용하면 Data Integration 기간 이름을 지정할 필요가 없습니다. 대신, 연도 및 시나리오 차원의 멤버 이름을 지정합니다.
이 매개변수는 Planning, Tax Reporting, Financial Consolidation and Close 비즈니스 프로세스에서 지원됩니다. 온-프레미스 데이터 소스에서 파생된 서비스 애플리케이션 및 클라우드 배포에 모두 적용됩니다.
연도 및 기간 멤버 이름을 캡처하여 EPM Cloud Groovy 스크립트에서 명령이 트리거되는 경우 이 규칙을 사용하면 유용합니다. 기간 매핑의 타겟 값에 연도와 월이 포함된 애플리케이션 기간 매핑 또는 글로벌 기간 매핑이 있어야 합니다.
{Month#&CurYr}{&FcstMonth#&CurYr}
형식(예: {Jan#&CurYr}{&FcstMonth#&CurYr}
)으로 지정할 수 있습니다.
실제 멤버 이름과 대체 변수를 조합할 수 있습니다.
이 형식은 Planning, Tax Reporting, Financial Consolidation and Close 비즈니스 프로세스에서 지원됩니다.
기간 매핑의 타겟 값에 연도 및 월 값이 제공된 애플리케이션 기간 매핑 또는 글로벌 기간 매핑이 명령이 실행된 환경의 Data Integration에 있어야 합니다. 이 경우, 연도와 월은 실행 중 대체 변수의 현재 값을 나타냅니다.
{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에서 이 명령을 실행하는 경우 연도 및 월 멤버 이름 대신 대체 변수를 지정할 수 있습니다. 멤버 이름과 대체 변수를 조합할 수도 있습니다.
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