ガイド · 連携
Anaplan API:アクション、インポート、エクスポート、プロセスのIDを調べる方法
著者:Umang Chauhan · 2026年11月14日 · 約6分で読めます
Anaplan Integration APIの呼び出しに必要な5種類のID、それぞれの調べ方、そして自分のトークンでスクリプトからプロセスを実行する方法。
スクリプトやスケジューラーからAnaplanのプロセスを実行するには、正しいURLに正しいIDを入れる必要があります。 それらのIDはどれも、通常のモデリング画面には表示されません。そのため、多くの人がブラウザーの開発者ツールで探すことになります。 ここでは、必要なものと、その調べ方を説明します。
Integration APIの呼び出しで使うID
見慣れた名前から、APIが受け付けるIDへ
Workspace ID
どのワークスペースか
Model ID
その中のどのモデルか
Action ID
プロセス、インポート、エクスポート、その他のアクション
File ID
ファイルを使うインポートとエクスポートのみ
- 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が含まれます。そのタスクを問い合わせると、実行が成功したかどうかが分かります。
手順の整え方
- モデルとToolkitのパネルを開き、Actions & File IDs を選びます。
- プロセスを名前で検索して、IDをコピーします。
- Process Steps を開いて、その中のアクションの順序を確認します。
- スケジュール実行を予定しているなら、Lock Monitor を確認して、モデルがたいてい空いている時間帯を把握します。
- IDはスクリプトではなくスケジューラーの設定に保存します。そうすれば、モデルをコピーした先にも、コードを変えずに向けられます。
モデルをコピーするとIDは変わるため、本番モデルを対象にするスクリプトには、本番用のIDが必要です。 これはリリースにも関わります。ALMとリビジョンタグ を参照してください。
この確認作業を、数日ではなく数分で
Anaplan Toolkit は、開いているモデルの構造(モジュール、ラインアイテム、リスト、数式、利用状況、容量)を読み取る無料のChrome・Firefox拡張機能です。通信先はAnaplanだけで、ほかのどこにも送信しません。
Anaplan Toolkit を入手ほかのガイド
- Anaplanモデルの改善方法と、チームでの使われ方の見直し
- Anaplanモデルのサイズを小さくする方法
- AnaplanのDISCOとは:モデルを速く保つアーキテクチャ
- Anaplanのスパース性とディメンション:本当のコストはセル数