カスタム クラウド ローダの作成

基本ステップ

データ ソース設定を入力します。
パラメータを定義します。
以下の CCDS API を使用して JavaScript を書き込みます。 ai 名前空間。
ビジネス ルールを定義します。
ローダを実行またはスケジュール設定します。

前提条件

インテグレーション開発者権限があることを確認します。
次のことを確認してください
Adaptive Planning
エクスポートしたい 計画データは、ステージング テーブルにすでに存在します。
外部システムの OAuth 認証情報を作成するか、JavaScript に明示的に含めることができる認証情報を取得します。
外部システムに転送する必要があるパラメータが何であり、外部システムが想定しているデフォルトが何であるかを確認します。
外部システムのエンドポイントに書き込む方法を理解します。

ナビゲーション

ナビゲーション メニューから、

"インテグレーション"

"インテグレーション設定"

へ移動します。

データ ソース設定の入力

新規カスタム クラウド ローダの作成

"インテグレーション" > "インテグレーション設定"
に移動し、データ デザイナーにアクセスします。
コンポーネント ライブラリの "ローダ" フォルダで
"新しいローダの作成"
を選択します。
ローダのタイプとして
"カスタム クラウド ローダ"
を選択し、名前を入力します。
カスタム クラウド ローダがオプションの 1 つとして表示されない場合は、このインスタンスに関して有効化されていないか、アクセスに必要なインテグレーション開発者権限がありません。
"作成"
を選択します。

"ソース テーブル"、"認証情報"、"ログ レベル" を選択

カスタム クラウド ローダの情報を入力します。
ソース テーブル:
を含むステージング テーブルを選択
Adaptive Planning
エクスポートする Planning データ
必要な認証情報:
外部システムが OAuth を必要とするかどうかを選択し、適切な OAuth 認証情報を選択するにあたりインテグレーション オペレーター権限を持つユーザーが必要であるかどうかを選択します。
認証情報:
既存の OAuth 認証情報を選択します。
ログ レベル:
ローダの実行時にどの程度の詳細を記録するかを選択します。
エラー
:
エラーのみを記録します。
情報
:
データ ソースが更新されたときなど、すべての基本情報を記録します。
詳細
:
すべてのフェーズとアクションに関する非常に詳細な情報を提供します。
典型的な使用方法よりも多くのログ情報を生成する可能性があるため、主にデバッグや監査に使用されます。
"アクション" メニューで
"保存"
をクリックします。

パラメータの定義

"デザイナー設定"
を選択します。
パラメータ化された設定アイテムまたは静的設定アイテムを
"設定コンポーネント"
ペインから
"デザイナー設定"
にドラッグします。
ローダの実行時に別の値を入力しない場合、ここに入力されたパラメータ化された設定値がローダのデフォルトになります。
ここに入力した静的設定は、ローダが実行されるたびに使用され、実行時に入力する必要はありません。
ブール値: 1 またはゼロとして表される値です。
属性: 内の属性管理の属性
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);
} 
"アクション"
ペインで
"保存"
を選択します。
スクリプトを実行するには、
"アクション"
ペインで
"手動で実行"
を選択します。