BlackLine®内でデータのインポート/エクスポートや一般的な自動化/管理機能をチェーンの一部として実行するには、BlackLine OAuth2接続コマンドを使用するステップを追加します。
注： BlackLine にデータをインポートするためにコマンドを使用する場合、インポート タイプに応じて異なるデータ構造が必要になります。Wdataがこれを処理しますが、データのフォーマットはBlackLineインポートテンプレートに対応する必要があります。
これらのコマンドを有効にするには、IT 管理者はまず、BlackLine OAuth2 接続 を設定します。
アカウント設定
カンマ区切り値（CSV）ファイルのアカウント設定データを BlackLine にインポートするには、Account Settings コマンドを追加します。
同等のAPIコール： https://developer.blackline.com/docs/data-ingestion-accounts-api/1/overview
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
アカウント設定のインポート用データを含むCSVファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
アカウント
CSVファイルにある口座データをBlackLineにインポートするには、Accounts コマンドを追加します。
同等のAPIコール： https://developer.blackline.com/docs/data-ingestion-accounts-api/1/overview
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
Accounts インポート用のデータを含む CSV ファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
銀行残高
CSV ファイルの銀行残高データを BlackLine にインポートするには、Bank Balances コマンドを追加します。
同等のAPIコール： https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/bank-balances/put
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
銀行残高インポート用のデータを含むCSVファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
為替レート
CSVファイルの通貨レートデータをBlackLineにインポートするには、Currency Rates コマンドを追加します。
同等のAPIコール： https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/cross-currency-rates/put
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
通貨レートのインポート用データを含むCSVファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
レポートダウンロード
BlackLineからレポートをダウンロードするには、Download Report コマンドを追加します。
注： レポートを確実にダウンロードできるようにするには、BlackLine でスケジュールを作成し、30～45 日ごとなど、定期的にレポートを自動的に実行することをお勧めします。
同等のAPIコール:
プロパティ
| プロパティ |
詳細 |
| レポートID |
ダウンロードするレポートのIDを入力してください。 |
| 書式 |
レポートのフォーマットを選択します。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
エンティティ
CSV ファイルのエンティティデータを BlackLine にインポートするには、Entities コマンドを追加します。
同等のAPIコール： https://developer.blackline.com/docs/master-data/1/overview
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
Entitiesインポート用のデータを含むCSVファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
エンティティ・タイプ
CSV ファイルのエンティティタイプデータを BlackLine にインポートするには、Entity Types コマンドを追加します。
同等のAPIコール： https://developer.blackline.com/docs/master-data/1/overview
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
Entity Types インポート用のデータを含む CSV ファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
インポートエラーの取得
インポート中に発生したエラーのリストを取得するには、Get import errors コマンドを追加する。
同等のAPIコール： 該当なし
プロパティ
| プロパティ |
詳細 |
| インポートID |
インポートプロセスの一意のID。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
アイテム
CSV ファイルのアイテムデータを BlackLine にインポートするには、Items コマンドを追加します。
同等のAPIコール： https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/items/put
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
項目インポートのデータを含むCSVファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
データのインポート
提供されたデータをインポートするには、データをインポート コマンドを追加する。
同等のAPIコール ：該当なし
プロパティ
| プロパティ |
詳細 |
| インポートID |
インポートのID（インポート・プロファイル名）。 |
| 書式 |
インポートデータのフォーマット。
オプション :
|
| データ |
インポートするデータ。 |
| 区切り記号 |
インポートするデータの区切り文字。これはCSVデータ形式を使用する場合にのみ適用されます。
オプション :
|
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
レポート一覧
BlackLineでダウンロード可能なレポートを一覧表示するには、List Reports コマンドを追加します。
注： レポートを確実にダウンロードできるようにするには、BlackLineでスケジュールを作成し、30～45日ごとなど定期的にレポートを自動的に実行することをお勧めします。
同等のAPIコール：
プロパティ
なし
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
複数通貨の残高
CSV ファイルにある複数通貨の残高データを BlackLine にインポートするには、Multi-Currency Balances コマンドを追加します。
同等のAPIコール： https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/multi-currency-balances/put
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
多通貨残高インポート用のデータを含むCSVファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
サブレジャー
CSV ファイルの小計データを BlackLine にインポートするには、小計 コマンドを追加します。
同等のAPIコール： https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/subledgers/put
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
Subledgersインポート用のデータを含むCSVファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
タスク自動認証完了
完了した自動認証タスクのデータを CSV ファイルで BlackLine にインポートするには、Task Auto-Certify Completed コマンドを追加します。
同等のAPIコール： https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
タスク自動認証完了インポートのデータを含む CSV ファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
タスクの依存関係
CSV ファイルにあるタスクの依存関係に関するデータを BlackLine にインポートするには、Task Dependencies コマンドを追加します。
同等のAPIコール： https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
タスクの依存関係をインポートするためのデータを含む CSV ファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
タスク
CSV ファイルのタスクデータを BlackLine にインポートするには、Tasks コマンドを追加します。
同等のAPIコール： https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
タスクのインポート用データを含むCSVファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
ユーザーアカウントの割り当て
CSV ファイルのユーザーアカウント割り当てデータを BlackLine にインポートするには、User Account Assignments コマンドを追加します。
同等のAPIコール:
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
ユーザー アカウント割り当てインポート用のデータを含む CSV ファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
ユーザーエンティティ
CSV ファイルのユーザーエンティティデータを BlackLine にインポートするには、User Entities コマンドを追加します。
同等のAPIコール： https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/entities/get
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
User Entitiesインポート用のデータを含むCSVファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
ユーザーの役割
CSVファイルのユーザ・ロール・データをBlackLineにインポートするには、User Roles コマンドを追加します。
同等のAPIコール： https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/roles-products/get
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
ユーザーロールインポート用のデータを含むCSVファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |
ユーザー
CSV ファイルのユーザーデータを BlackLine にインポートするには、Users コマンドを追加します。
同等のAPIコール： https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/roles-products/get
プロパティ
| プロパティ |
詳細 |
| 区切り記号 |
CSVファイルで使用する区切り文字を入力します。 |
| CSVデータソース |
Usersインポート用のデータを含むCSVファイルを入力します。 |
| カラムマッピング |
インポートには、BlackLineインポートテンプレートで規定されている特定の列の順序が必要です。CSVファイルのヘッダー名がインポートテンプレートと同じ場合は、空白のままにしてください。そうでない場合は、ID -> Entity Unique Identifier のように、CSVのカラムをインポートテンプレートのカラムにマッピングする。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
インポートでエラーが発生しました |