CSV のアップロードとインポート

API を使用して Anaplan に CSV をインポートする方法は以下のとおりです。

自分自身の認証を行います。
リクエスト:POST https://auth.anaplan.com/token/authenticate後続のリクエストで使用するために、返された認証トークン (Authorization: AnaplanAuthToken {anaplan_auth_token}) を保存します。
ワークスペースを見つけます。
リクエスト:GET /workspaces使用するワークスペースの id を workspaceId として保存します。
モデルを見つけます。
リクエスト:GET /workspaces/{workspaceId}/models使用するモデルの id を modelId として保存します。
インポートアクションを見つけます。
リクエスト:GET /workspaces/{workspaceId}/models/{modelId}/importsインポートアクションの id を importId として保存します。
ソースファイルを見つけます。
リクエスト:GET /workspaces/{workspaceId}/models/{modelId}/filesインポートで使用されるファイルの id を fileId として保存します。
アップロードチャンク数を設定します。
リクエスト:PUT /workspaces/{workspaceId}/models/{modelId}/files/{fileId}/chunksアップロードする予定のチャンク数を設定します。小さなファイルの場合は一つのチャンクで構いません。大きなファイルについては、アップロード前に複数のチャンクに分割します。
各チャンクをアップロードします。
リクエスト:PUT /workspaces/{workspaceId}/models/{modelId}/files/{fileId}/chunks/{chunkId}各チャンクを順番にアップロードします。注記:0 から始まる連番のチャンク ID を使用します。
アップロードを完了としてマークします。
リクエスト:POST /workspaces/{workspaceId}/models/{modelId}/files/{fileId}/completeこれにより、アップロードされたファイルがインポートアクションで使用できる状態になったことが Anaplan に伝わります。
インポートを開始します。
リクエスト:POST /workspaces/{workspaceId}/models/{modelId}/imports/{importId}/tasks返された taskId を保存します。
インポートタスクをポーリングします。
リクエスト:GET /workspaces/{workspaceId}/models/{modelId}/imports/{importId}/tasks/{taskId}タスクが終了状態に達するまで、このリクエストを繰り返します。タスクの状態だけに依存しないでください。レコードが正常にインポートされたかどうかをタスクの結果で確認します。
必要に応じてエラーダンプをダウンロードします。
リクエスト:GET /workspaces/{workspaceId}/models/{modelId}/imports/{importId}/tasks/{taskId}/dumpエラーダンプが利用可能であることがタスクの結果で示されている場合にのみこのリクエストを使用します。

CSV データがモデルファイルオブジェクトにアップロードされ、インポートアクションが実行されると、タスクの結果にレコードのインポートが成功したかどうかが表示されます。

インポートに失敗した場合は以下を確認します。

ファイルアップロードが完了としてマークされたかどうか。
CSV 構造がインポートマッピングと一致しているかどうか。
インポートアクションで想定されるソースファイルが使用されているかどうか。
統合ユーザーがインポートを実行できるかどうか。
エラーダンプが利用可能かどうか。

CSV のアップロードとインポート

プロセス

結果

失敗の処理

communityLink.title

title

caseportalLink.text

registrationLink.text

callLink.text