데이터 규칙 실행

시작 기간 및 종료 기간을 기반으로 Oracle Hyperion Financial Data Quality Management, Enterprise Edition 데이터 로드 규칙을 실행하고 지정한 옵션을 임포트하거나 익스포트합니다.

사전 필수 조건

  • 데이터 규칙: 데이터 로드 규칙은 Integrations에서 파일의 데이터를 로드하는 방법을 정의합니다. 데이터를 로드하려면 사전 정의된 데이터 로드 규칙이 있어야 합니다.

  • 특정 데이터 규칙을 실행하는 데 필요한 권한이 있어야 합니다.

REST 리소스

POST /aif/rest/{api_version}/jobs

요청

지원되는 미디어 유형: application/json

매개변수

다음 표에 클라이언트 요청이 요약되어 있습니다.

표 A-1 매개변수

이름 설명 유형 필수 기본값
api_version 작업 중인 API의 버전(예: V1) 경로 예 없음
jobType "DATARULE"로 설정되어야 함   예 없음
jobName FDMEE에 정의된 데이터 로드 규칙의 이름입니다. 공백이 포함된 규칙 이름은 따옴표로 묶어야 합니다.   예 없음
startPeriod 데이터를 로드할 첫번째 기간입니다. 이 기간 이름은 FDMEE 기간 매핑에 정의되어 있어야 합니다.   예 없음
endPeriod 데이터를 로드할 최종 기간입니다. 이 기간 이름은 FDMEE 기간 매핑에 정의되어 있어야 합니다.   예 없음
importMode 데이터를 FDMEE로 임포트하는 방법을 결정합니다.

허용되는 값은 다음과 같습니다.

  • APPEND - FDMEE의 기존 POV 데이터에 추가합니다.

  • REPLACE - POV 데이터를 삭제하고 파일의 데이터로 바꿉니다.

  • RECALCULATE - 데이터 임포트를 건너뛰고 업데이트된 매핑 및 논리 계정으로 데이터를 재처리합니다.

  • NONE - FDMEE 스테이지 테이블로의 데이터 임포트를 건너뜁니다.

   예 없음
exportMode 데이터를 FDMEE로 익스포트하는 방법을 결정합니다.

Oracle Hyperion Planning 애플리케이션에 허용되는 값은 다음과 같습니다.

  • STORE_DATA - FDMEE 스테이지 테이블의 데이터를 기존 Planning 데이터와 병합합니다.

  • ADD_DATA - FDMEE 스테이지 테이블의 데이터를 Planning에 추가합니다.

  • SUBTRACT_DATA - 기존 Planning 데이터에서 FDMEE 스테이지 테이블의 데이터를 뺍니다.

  • REPLACE_DATA - POV 데이터를 지우고 FDMEE 스테이지 테이블의 데이터로 바꿉니다. 시나리오, 버전, 연도, 기간 및 엔티티의 데이터가 지워집니다.

  • NONE - FDMEE에서 Planning으로의 데이터 익스포트를 건너뜁니다.

Financial Consolidation and Close 및 Tax Reporting 애플리케이션에 허용되는 값은 다음과 같습니다.

  • MERGE - 기본적으로 모든 데이터 로드가 병합 모드에서 처리됩니다. 데이터가 애플리케이션에 이미 있는 경우 시스템이 기존 데이터를 로드 파일의 새 데이터로 덮어씁니다. 데이터가 없는 경우 새 데이터가 생성됩니다.

  • REPLACE - 시스템이 데이터 로드 파일에서 참조된 데이터를 위해 애플리케이션의 기존 데이터를 먼저 지웁니다. 그런 다음 시스템이 병합 모드에서 데이터 로드를 수행합니다.

  • NONE - FDMEE에서 Financial Consolidation and Close로의 데이터 익스포트를 건너뜁니다.

   예 없음
fileName 선택적 파일 이름입니다. 파일 이름을 지정하지 않을 경우 이 API는 로드 데이터 규칙에 지정된 파일 이름에 포함된 데이터를 임포트합니다. 데이터 규칙 실행 전에 데이터 파일이 INBOX에 이미 있어야 합니다.   예 없음

URL 예

https://<SERVICE_NAME>-<TENANT_NAME>.<dcX>.oraclecloud.com/aif/rest/V1/jobs

요청 본문 예

{"jobType":"DATARULE",
"jobName":"aso to bso dr",
"startPeriod":"Dec-18",
"endPeriod":"Dec-18",
"importMode":"REPLACE",
"exportMode":"NONE",
"fileName":""
}

응답

지원되는 미디어 유형: application/json

표 A-2 매개변수

이름 설명

status

작업 상태: -1 = 진행 중, 0 = 성공, 1 = 오류, 2 = 취소 대기 중, 3 = 취소됨, 4 = 부적합한 매개변수

jobStatus

작업 상태의 텍스트 표현, 값은 "RUNNING", "SUCCESS" "FAILED" 중 하나임

jobId

FDMEE에서 작업에 대해 생성된 프로세스 ID

logFileName

이 실행에 대한 항목이 포함된 로그 파일

outputFileName

생성된 출력 파일의 이름(있는 경우)

processType

실행된 프로세스의 유형 모든 데이터 규칙 실행에 대해 "COMM_LOAD_BALANCES" 포함

executedBy

규칙을 실행하는 데 사용되는 사용자의 로그인 이름

details

애플리케이션 오류의 경우 예외 스택 추적 반환

응답 본문 예

다음은 JSON 형식의 응답 본문 예를 보여줍니다.

{
    "jobStatus": "RUNNING"
"jobId": 2019
"logFileName": "\outbox\logs\Account Reconciliation Manager_2019.log"
"outputFileName": null
"processType": "COMM_LOAD_BALANCES"
"executedBy": "admin"
"status": -1
"links": [1]
    0:  {
    "rel": "self"
    "href": "https://<SERVICE_NAME>-<TENANT_NAME>.<dcX>.oraclecloud.com/aif/rest/V1/jobs/2019"
    "action": "GET"
}
"details": null

}