커스텀 클라우드 로더 생성

기본 단계

데이터 소스 설정을 입력합니다.
매개변수를 정의합니다.
에서 CCDS API를 사용하여 JavaScript를 작성합니다. ai 네임스페이스.
비즈니스 규칙을 정의합니다.
로더를 실행 또는 스케줄링합니다.

선행요건

통합 개발자 권한이 있는지 확인합니다.
다음을 확인합니다.
Adaptive Planning
내보내려는 계획 데이터가 스테이징 테이블에 이미 있습니다.
외부 시스템에 대한 OAuth 자격증명을 생성하거나 JavaScript에 명시적으로 포함할 수 있는 자격증명을 획득합니다.
외부 시스템으로 전달하기 위해 필요한 매개변수와 외부 시스템에 대한 기본값이 무엇인지 알아야 합니다.
외부 시스템의 엔드포인트에 작성하는 방법을 이해합니다.

탐색

탐색 메뉴에서

통합

통합 디자인

으로 이동합니다.

데이터 소스 설정 입력

신규 커스텀 클라우드 로더 생성

통합 > 통합 디자인
으로 이동하여 데이터 디자이너에 액세스합니다.
구성요소 라이브러리에 있는 로더 폴더에서
신규 로더 생성
을 선택합니다.
로더 유형으로
커스텀 클라우드 로더
를 선택하고 이름을 입력합니다.
커스텀 클라우드 로더가 옵션으로 보이지 않는다면 이 인스턴스에 대해 활성화되어 있지 않거나 이 인스턴스에 액세스하기 위해 필요한 통합 개발자 역할 권한이 없는 것입니다.
생성
을 선택합니다.

소스 테이블, 자격증명 및 로그 레벨 선택

커스텀 클라우드 로더 정보를 입력합니다.
소스 테이블:
다음을 포함하는 스테이징 테이블을 선택하십시오.
Adaptive Planning
내보낼 계획 데이터
필수 자격증명:
외부 시스템에 OAuth가 필요하고 적절한 OAuth 자격증명을 선택하기 위해 통합 운영자 권한을 가진 사용자가 필요한 경우 선택합니다.
자격증명:
기존 OAuth 자격증명을 선택합니다.
로그 레벨:
로더 실행 시 세부내용을 얼마나 자세히 기록할지 선택합니다.
오류
:
오류만 기록합니다.
정보
:
데이터 소스가 업데이트된 시기와 같은 모든 기본 정보를 기록합니다.
상세
:
모든 단계 및 액션에 대한 매우 상세한 정보를 제공합니다. 일반적인 사용에 비해 더 많은 로그 정보를 생성할 수 있으므로 주로 디버깅 또는 감사에 사용합니다.
액션 메뉴에서
저장
을 클릭합니다.

매개변수 정의

디자이너 설정
을 선택합니다.
설정 구성요소
창에서 '매개변수 있음' 또는 '정적' 설정 항목을
디자이너 설정
으로 끌어서 놓습니다.
로더 실행 시 다른 값을 제공하지 않으면 여기에 입력한 '매개변수 있음' 설정 값이 로더 기본값이 됩니다.
여기에 입력한 '정적' 설정은 로더 실행 시마다 사용되며 런타임 시 입력하지 않아도 됩니다.
부울: 1 또는 0으로 표시되는 값
디멘션: 디멘션 관리의 디멘션
Adaptive Planning
.
정수: 음수가 아닌 정수
비밀번호: 비밀번호. 이 값은 저장 후에는 조회할 수 없습니다.
기간 범위: 다음 범위의 기간 범위입니다.
Adaptive Planning
.
텍스트: 영숫자 값
매개변수 항목을 두 번 클릭하여 이름을 입력하고 값을 변경합니다.
JavaScript에서 참조할 항목을 필요한 만큼 끌어옵니다.
로더를 저장합니다.
JavaScript에 있는 매개변수명을 사용하여 참조합니다.

JavaScript 작성

스크립트
를 선택합니다.
기존 템플릿을 선택하고 변경하거나
신규 스크립트
를 선택하여 직접 작성합니다.
에서 CCDS API를 사용하여 로더에서 실행할 JavaScript를 작성합니다. ai 네임스페이스.
스크립트에서 다음 필수 항목을 포함하는지 확인합니다.
testConnection
외부 시스템에 게시할 https 요청을 생성하는 함수
exportData
데이터를 내보내는 함수
Adaptive Planning
. Adaptive Planning 함수 주제의데이터 내보내기 함수(커스텀 클라우드 로더만 해당)를참조하십시오.
디자이너 설정에서 생성한 매개변수를 이름을 기준으로 참조합니다.
스크립트를 저장합니다.

커스텀 클라우드 로더 스크립트에 OAuth 사용

로더를 실행하기 전에
권한 부여 요청
을 선택합니다.
범위와 같이 외부 시스템 엔드포인트에 필요한 추가 권한 부여 세부내용을 제공합니다.
연결 테스트
를 선택하여 OAuth 자격증명이 성공적으로 엔드포인트로 전달되는지 확인합니다.
권한 부여 상태의 권한 부여 날짜 및 사용자 ID를 기록해 둡니다. 권한 부여 만료일은 외부 시스템마다 다릅니다. 필요한 경우 다시 권한을 부여하려면 '액션' 창에서 '권한 부여 재설정'을 클릭합니다.

비즈니스 규칙 정의

비즈니스 규칙
탭을 선택합니다.
편집
을 선택합니다.
SQL 표현식을 입력합니다. 직접 입력하는 대신 사용가능한 열의 항목을 클릭하여 해당 열을 SQL 표현식으로 가져올 수 있습니다.
적용
을 선택하여 구문을 확인합니다. 오류가 있는 경우 표현식의 테두리가 빨간색으로 바뀝니다. 표현식 위로 마우스 커서를 가져가서 구문 오류 정보를 확인합니다.
구문에 있는 모든 오류를 수정하고
적용
을 선택합니다. SQL 표현식에 일치하는 스테이징 행만 로드합니다.

통합 태스크에 커스텀 클라우드 로더 포함

샘플 CCL 스크립트

스프레드시트 데이터 소스를 설정합니다.
로더
창에서 새로운 커스텀 클라우드 로더를 생성합니다.
데이터 소스 설정
탭으로 이동하여
소스 테이블
필드에서 스프레드시트 데이터 소스를 선택합니다.
스크립트
탭에서 아래 샘플 스크립트를 복사합니다.
 // Manually invoke this method via 'Test connection'
function testConnection(context) {
    return true;
}
// Manually invoke this method via 'Run manually'
function exportData(context) {
   //"xxx" is the name of your Amazon S3 bucket. 
    var bucketName = 'xxx';
    //Name of the sample CSV file to which data from your spreadsheet data source is exported
    var key = 'exampleTest.csv';
    //"xxxx" is the access key for your AWS S3 bucket.
    var awsAccessKey = 'xxxx';
    //"xxxx" is the secret key of your AWS S3 bucket. 
    var awsSecretKey = 'xxxx';
    var region = 'us-west-1';
    // Step 1: Get the data
    var reader = context.createTableReader();
    // Step 2: Process and export the data
    var result = "Column,Heading,Names\n";
    var row = null;
    while ((row = reader.readRow()) !== null) {
       // remove meta columns we don't need
       row.length = row.length - 2;
       result += row.join() + '\n';
   }
    ai.awss3.putFile(bucketName, key, result, region, awsAccessKey, awsSecretKey);
} 
액션
창에서
저장
을 선택합니다.
스크립트를 실행하려면
액션
창에서
수동 실행
을 선택합니다.