데이터 매핑 임포트

멤버 매핑은 소스 값을 기준으로 각 차원의 대상 멤버를 파생시키는 데 사용됩니다. 멤버 매핑은 데이터 로드 중에 참조되며, 타겟 애플리케이션으로 로드되는 데이터를 차원화하는 방법을 Oracle Hyperion Financial Data Quality Management, Enterprise Edition에서 결정할 수 있게 합니다. 멤버 매핑은 하나의 차원에 있는 소스 멤버와 타겟 차원 멤버 간의 관계를 정의합니다. 각 대상 차원에 대해 멤버 매핑을 생성해야 합니다.

선택한 Excel, .CSV 또는 .TXT 에서 멤버 매핑을 임포트할 수 있습니다. 텍스트 파일에서 새 매핑을 생성하여 임포트할 수도 있습니다. [멤버 매핑 임포트]는 대상 멤버에 대한 검증 또는 검증 없음 옵션과 함께 병합 또는 바꾸기 모드를 지원합니다.

REST 리소스

POST /aif/rest/{api_version}/jobs

요청

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

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

표 A-5 매개변수

이름	설명	유형	필수	기본값
`api_version`	작업 중인 API의 버전(예: V1)	경로	예	없음
`jobType`	작업 유형, `MAPPINGIMPORT`	경로	예	없음
`jobName`	임포트할 특정 차원의 차원 이름(예: `ACCOUNT` 또는 모든 차원을 임포트할 `ALL`)	경로	예	없음
`fileName`	매핑을 임포트할 파일 및 경로. 파일 형식은 .CSV, .TXT, .XLS 또는 .XLSX일 수 있습니다. 파일은 임포트하기 전에 인박스 또는 인박스의 서브 디렉토리로 업로드되어야 합니다. 파일 경로에 인박스가 포함됩니다(예: `inbox/BESSAPPJan-06.csv`).	경로	예	없음
`importMode`	임포트 모드: `MERGE` - 새 규칙을 추가하거나 기존 규칙을 바꿈, `REPLACE` - 임포트하기 전에 이전 매핑 규칙을 지움	경로	아니요	`MERGE`
`validationMode`	검증 모드 사용 여부로 `true` 또는 `false`. `true`를 입력하면 타겟 애플리케이션에 대해 타겟 멤버를 검증합니다. `false`는 검증 없이 매핑 파일을 로드합니다. 검증 프로세스는 자원을 집중적으로 사용하며 `false`의 검증 모드보다 오래 걸립니다. 대부분의 고객이 선택하는 옵션은 `false`입니다.	경로	아니요	`false`
`locationName`	매핑 규칙이 로드될 FDMEE 위치로, 매핑 규칙은 FDMEE의 위치에 따라 다릅니다.	경로	아니요	없음

요청 본문 예

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

{
"jobType":"MAPPINGIMPORT",
"jobName":"ACCOUNT",
"fileName":"inbox/BESSAPPJan-06.csv",
"importMode":"MERGE",
"validationMode":"false",
"locationName":"BESSAPP"
}

샘플 코드는 데이터 규칙 실행에 포함된 코드 샘플을 참조하십시오.

응답

다음 표에 응답 매개변수가 요약되어 있습니다.

표 A-6 매개변수

이름	설명
`jobId`	FDMEE에서 작업에 대해 생성된 프로세스 ID(예: 1880)
`jobStatus`	작업 상태(예: `RUNNING`)
`logFileName`	이 실행에 대한 항목이 포함된 로그 파일(예: `outbox/logs/BESSAPP-DB_1880.log`)
`outputFileName`	생성된 출력 파일의 이름(있는 경우) 또는 `null`
`processType`	실행된 프로세스의 유형, `IMPORT_MAPPING`
`executedBy`	규칙을 실행하는 데 사용되는 사용자의 로그인 이름(예: `admin`)
`details`	애플리케이션 오류의 경우 예외 스택 추적을, 그렇지 않은 경우 `null`을 반환합니다.

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

매개변수

응답 본문 예

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

{
"links": 
[
0]
"status":"-1"
"details":"null"
"jobId":"1880"
"jobStatus":"RUNNING",
"logFileName":"outbox/logs/BESSAPP-DB_1880.log",
"outputFileName":"null",
"processType":"IMPORT_MAPPING",
"executedBy":"admin"
}

샘플 코드는 데이터 규칙 실행에 포함된 코드 샘플을 참조하십시오.