ガイド · 連携

Anaplan API:アクション、インポート、エクスポート、プロセスのIDを調べる方法

著者:Umang Chauhan · 2026年11月14日 · 約6分で読めます

Anaplan Integration APIの呼び出しに必要な5種類のID、それぞれの調べ方、そして自分のトークンでスクリプトからプロセスを実行する方法。

ID{ }200

スクリプトやスケジューラーからAnaplanのプロセスを実行するには、正しいURLに正しいIDを入れる必要があります。 それらのIDはどれも、通常のモデリング画面には表示されません。そのため、多くの人がブラウザーの開発者ツールで探すことになります。 ここでは、必要なものと、その調べ方を説明します。

Integration APIの呼び出しで使うID

見慣れた名前から、APIが受け付けるIDへ

  1. Workspace ID

    どのワークスペースか

  2. Model ID

    その中のどのモデルか

  3. Action ID

    プロセス、インポート、エクスポート、その他のアクション

  4. File ID

    ファイルを使うインポートとエクスポートのみ

Anaplanの呼び出しは、ワークスペース、モデル、その中の1つのオブジェクトの順に特定します。
  • Workspace IDとModel IDは、モデルがどこにあるかを示します。Anaplan ToolkitのModel Summaryには、開いているモデルのこれらが表示されます。
  • プロセス、インポート、エクスポート、アクションのIDは、何を実行するかを示します。Actions & File IDs がすべてを一覧にし、名前で検索してワンクリックでコピーできます。
  • File IDは、インポートが読むファイル、エクスポートが書き出すファイルを示します。実行の前後でデータをアップロード・ダウンロードするときに必要です。

プロセスを実行する

IDと有効なトークンがあれば、プロセスは tasks エンドポイントへのPOSTで開始できます。プレースホルダーを使った形は次のとおりです。

curl -X POST \
  "https://api.anaplan.com/2/0/workspaces/$WORKSPACE_ID/models/$MODEL_ID/processes/$PROCESS_ID/tasks" \
  -H "Authorization: AnaplanAuthToken $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"localeName": "en_US"}'

インポート、エクスポート、その他のアクションも同じ形で、processes の代わりに imports、exports、actions を使います。 レスポンスにはタスクIDが含まれます。そのタスクを問い合わせると、実行が成功したかどうかが分かります。

手順の整え方

  1. モデルとToolkitのパネルを開き、Actions & File IDs を選びます。
  2. プロセスを名前で検索して、IDをコピーします。
  3. Process Steps を開いて、その中のアクションの順序を確認します。
  4. スケジュール実行を予定しているなら、Lock Monitor を確認して、モデルがたいてい空いている時間帯を把握します。
  5. IDはスクリプトではなくスケジューラーの設定に保存します。そうすれば、モデルをコピーした先にも、コードを変えずに向けられます。

モデルをコピーするとIDは変わるため、本番モデルを対象にするスクリプトには、本番用のIDが必要です。 これはリリースにも関わります。ALMとリビジョンタグ を参照してください。

この確認作業を、数日ではなく数分で

Anaplan Toolkit は、開いているモデルの構造(モジュール、ラインアイテム、リスト、数式、利用状況、容量)を読み取る無料のChrome・Firefox拡張機能です。通信先はAnaplanだけで、ほかのどこにも送信しません。

Anaplan Toolkit を入手

ほかのガイド

Anaplanガイド一覧 →