주 컨텐츠로 이동
문서
문서
Adaptive Planning
스크립팅된 계획 내보내기로 계획 데이터 내보내기

스크립팅된 계획 내보내기로 계획 데이터 내보내기

커스터마이즈된 Pentaho 플러그인 SPE(스크립팅된 계획 내보내기)를 사용하여 계획 데이터를 외부 시스템으로 내보낼 수 있습니다. 자세한 내용은
Adaptive Planning
Pentaho 사용에 대한 자세한 내용은스크립팅된 데이터 소스 설정을참조하십시오.

SPE 이해

SPE는 다음을 호출하여 작동합니다.
Adaptive Planning
REST API를 내보낸 다음 해당 API 호출의 결과를 지정된 파일에 저장합니다. SPE는 CSV 및 XML 파일 형식으로 출력을 지원하지만, 모든 내보내기 데이터를 CSV 형식으로 변환할 수 있는 것은 아닙니다.
SPE는 버전 v51.17.0734로 시작하는 데이터 에이전트에 포함된 플러그인입니다. 프로그램을 열면 보유하고 있는 Data Agent Service Manager 버전을 확인할 수 있습니다. 버전 번호는 정보 탭의 정보에 나타납니다. 데이터 에이전트 설치에 대한 자세한 내용은Install the Data Agent Service Manager를참조하십시오. SPE가 설치되어 있는 경우 Adaptive Planning 플러그인은 Spoon의 Design 탭에서 Input 폴더에 나타납니다.
스크립팅된 계획 내보내기 어댑터 관련 용어는 약간 혼동을 일으킬 수 있습니다. 데이터가 계획에서 스크립트로 이동한 다음 외부 대상으로 이동하기 때문에, 계획에서 데이터 내보내기이자 외부 대상으로 데이터 가져오기에 모두 해당합니다. 하지만 Spoon의 관점에서 SPE는 스크립트에 입력을 제공하기 때문에 입력 단계입니다. 따라서 Spoon에서는 'Adaptive Planning Input'으로 레이블이 지정됩니다.
SPE는 Spoon 환경 안에서 바로 시작하거나 스크립터 로더에 포함하여 원격으로 시작할 수 있습니다. SPE를 사용하는 일반적인 프로세스는 계획 서버에서 허용하는 형식으로 XML 요청을 생성하고 이를 SPE로 전달한 다음 결과를 처리하는 스크립트를 작성하는 것입니다. 다음은 SPE 스크립트에 대한 최소 요건을 보여주는 샘플 스크립트입니다.

      Scripted Planning Exporter
-------------------------------------------
Input:
      requestXMLString: request in XML format
      targetResponseFormat: CSV or XML
      targetFolder: target folder to store result file generated by
         this plugin

Output: The type of output fields is String, except
    requestSuccess, which is boolean
      requestSuccess: Boolean, Y' or N'
      planningMsgs: concatenate Planning messages in a string,
    delimited by ###'
      responseFileName: complete path of the response file name
      fieldNames: column name in CSV header, or NULL if
    targetResponseFormat is XML
      numberRecReturned: String, number of records returned by
    Planning, or NULL if targetResponseFormat is XML
이 스크립트를 위한 모범 사례에는 다음이 포함됩니다.
  • 모든 입력 필드명은 대소문자를 구분합니다. 이를 Kettle 스크립트에서 적절하게 정의해야 합니다.
  • requestXMLString:
    각 내보내기 API에 고유한 요청 XML 형식이 있습니다. 다음을 참조하십시오.
    Adaptive Planning
    자세한 내용은 REST API를 참조하십시오.
  • targetResponseFormat:
    API v11부터는 'exportData' API의 페이로드만 CSV 형식으로 변환할 수 있습니다. 모든 기타 내보내기는 XML 형식이어야 합니다.
  • TargetFolder:
    일반적으로Agent Service Manager에서 Restrict Runner Access to Files 확인란을 선택하지 마십시오. 대상 폴더는 파일 시스템의 어디에나 있을 수 있습니다.
  • responseFileName:
    응답 파일의 형식은 다음과 같습니다.
    <targetFolder>_ApiResponse_<exportMethod>_<UUID>.<targetFormat>;
    예:
    C:\pdiTemp\ApResponse_exportData_83980a17b3dc40c48282483cb9ea5e96.csv
  • requestSuccess:
     내보내기 요청이 계획 서버 측을 통해 진행되는 경우, requestSuccess에 true 값('Y')이 있습니다. 계획에 대한 호출의 결과로 내보내기 요청이 실패하는 경우, SPE에서 예외가 발생하고 계획 서버에서 오류 메시지가 반환됩니다.
정보를 계획에서 추출하고 출력 파일로 전송하는 일반적인 워크플로는 다음과 같습니다.
  1. 요청 XML 파일 입력
  2. 파일 콘텐츠를 문자열로 변환
  3. 대상 형식(CSV | XML) 및 폴더 설정
  4. Adaptive 스크립팅된 계획 내보내기
  5. 차단 단계
  6. Adapter 출력 로깅

Kettle 스크립트에서 계획 내보내기 API 사용

SPE는 다음을 사용합니다.
Adaptive Planning
API v11 이상 SPE에서 다음 API를 사용할 수 있습니다.
  • customReportValues:
    요청된 인스턴스에서 요청된 리포트 조건에 대한 데이터 세트를 반환합니다.
  • exportData:
     특정 버전에서 값 세트를 검색합니다.
이해를 참조하십시오.
Adaptive Planning
자세한 내용은 API를참조하십시오.

SPE Kettle 플러그인 구성

SPE Kettle 플러그인을 구성하려면 다음을 수행합니다.
  1. Spoon Design 탭에서
    Adaptive Planning Input
    을 클릭합니다.
  2. SPE의 정보를 입력합니다.
    • 활성 에이전트:
       SPE에서 자동으로 채워집니다.
    • 인스턴스 호스트:
       SPE에서 자동으로 채워집니다.
    • 인스턴스 코드:
       SPE에서 자동으로 채워집니다.
    • 로그인:
       로그인 컨텍스트 매개변수 값입니다.
    • 로그인 비밀번호:
       비밀번호 컨텍스트 매개변수 값입니다.
    • 로케일:
       기본값은
      en_US
      입니다.
  3. 확인
    을 클릭합니다.
SPE 작업에 대한 입력 및 출력을 정의하는 스크립트를 생성해야 합니다. 이 문서의 샘플 스크립트를 참조하십시오.

다음 기간 내에 SPE 구성
Adaptive Planning
통합 클라우드 UI

통합의 클라우드 UI에서 스크립팅된 로더를 생성하는 일반적인 프로세스는 다음과 같습니다.
  • 스크립팅된 로더 생성
  • 진입점 선택
  • 필수 매개변수 구성
신규 스크립팅된 로더 생성을 시작합니다. 자세한 내용은스크립팅된 로더 생성을참조하십시오. 또한 진입점 드롭다운에서 진입점을 선택해야 합니다. 진입점은 스크립팅된 로더가 실행될 때 실행될 스크립트명으로 설정됩니다.
스크립팅된 로더에서 정의된 로컬 및 공유 컨텍스트 매개변수를 Kettle/Spoon 환경에 환경 변수로 매핑하고 노출해야 합니다. 예를 들어 매개변수 섹션의 로더 설정 화면에서 'login'이라는 컨텍스트 매개변수가 정의된 경우, 이는 Kettle 환경에서 변수 '${login}'으로 노출됩니다. 그러면 스크립팅된 로더에 있는 두 개의 컨텍스트 매개변수의 정의가 두 개의 해당 Kettle 변수에 대해 SPE에서 사용됩니다.
Adaptive Script Editor를 시작하고
구성 새로고침
을 클릭하여 새로고침을 트리거하면 디자인 타임에 Kettle 변수를 현재 기본 컨텍스트 매개변수 값으로 업데이트할 수 있습니다.