Workiva支持中心

要导入和导出数据，并在 BlackLine® 中执行一般自动化和管理功能（作为链的一部分），请添加一个使用 BlackLine OAuth2 连接命令的步骤。 

注意： 当您使用命令将数据导入 BlackLine 时，根据导入类型，需要不同的数据结构。Wdata 会为您处理此问题，但数据格式应与 BlackLine 导入模板相匹配。

要启用这些命令，IT 管理员 首先配置BlackLine OAuth2 连接。

账户设置

要将逗号分隔值 (CSV) 文件中的帐户设置数据导入 BlackLine，请添加 帐户设置 命令。 

等效 API 调用： https://developer.blackline.com/docs/data-ingestion-accounts-api/1/overview

属性

摘要信息	细节
分隔符号	请输入CSV文件中使用的分隔符。
CSV数据源	输入包含账户设置导入数据的 CSV 文件。
列映射	导入操作需要按照 BlackLine 导入模板中规定的特定列顺序进行。如果 CSV 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
0	成功	成功
1	错误	导入过程中出现错误

账户

要将 CSV 文件中的帐户数据导入 BlackLine，请添加 Accounts 命令。 

等效 API 调用：https://developer.blackline.com/docs/data-ingestion-accounts-api/1/overview

属性

摘要信息	细节
分隔符号	请输入CSV文件中使用的分隔符。
CSV数据源	输入包含账户导入数据的 CSV 文件。
列映射	导入操作需要按照 BlackLine 导入模板中规定的特定列顺序进行。如果 CSV 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
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 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
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 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
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数据源	输入包含实体导入数据的 CSV 文件。
列映射	导入操作需要按照 BlackLine 导入模板中规定的特定列顺序进行。如果 CSV 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
0	成功	成功
1	错误	导入过程中出现错误

实体类型

要将 CSV 文件中的实体类型数据导入 BlackLine，请添加 Entity Types 命令。 

等效 API 调用： https://developer.blackline.com/docs/master-data/1/overview

属性

摘要信息	细节
分隔符号	请输入CSV文件中使用的分隔符。
CSV数据源	输入包含实体类型导入数据的 CSV 文件。
列映射	导入操作需要按照 BlackLine 导入模板中规定的特定列顺序进行。如果 CSV 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
0	成功	成功
1	错误	导入过程中出现错误

获取导入错误

要检索导入过程中发生的错误列表，请添加 获取导入错误命令。 

等效 API 调用：不 适用

属性

摘要信息	细节
导入ID	导入过程的唯一标识符。

输出

输出	输出类型
错误	JSON

退出代码

代码	类型	细节
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 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
0	成功	成功
1	错误	导入过程中出现错误

导入数据

要导入提供的数据，请添加 Import data 命令。 

等效 API 调用: 不适用

属性

摘要信息	细节
导入ID	导入的 ID（导入配置文件名称）。
格式	导入数据的格式。 选项： CSV JSON
数据	待导入的数据。
分隔符号	要导入的数据的分隔符。这仅适用于使用 CSV 数据格式的情况。 选项： 逗号 Tab 管道

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
0	成功	成功
1	错误	导入过程中出现错误

列表报告

要列出 BlackLine 中可供下载的报告，请添加 List Reports 命令。

注： 为确保报告可供下载，我们建议您在 BlackLine 中创建计划任务，定期自动运行报告，例如每 30-45 天一次。

等效 API 调用：

属性

没有任何

输出

输出	输出类型
报表	文件

退出代码

代码	类型	细节
0	成功	成功
1	错误	导入过程中出现错误

多币种余额

要将 CSV 文件中的多币种余额数据导入 BlackLine，请添加 多币种余额 命令。 

等效 API 调用： https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/multi-currency-balances/put

属性

摘要信息	细节
分隔符号	请输入CSV文件中使用的分隔符。
CSV数据源	输入包含多币种余额导入数据的 CSV 文件。
列映射	导入操作需要按照 BlackLine 导入模板中规定的特定列顺序进行。如果 CSV 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
0	成功	成功
1	错误	导入过程中出现错误

子账

要将 CSV 文件中的子账数据导入 BlackLine，请添加 Subledgers 命令。 

等效 API 调用： https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/subledgers/put

属性

摘要信息	细节
分隔符号	请输入CSV文件中使用的分隔符。
CSV数据源	输入包含子账导入数据的 CSV 文件。
列映射	导入操作需要按照 BlackLine 导入模板中规定的特定列顺序进行。如果 CSV 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
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 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
0	成功	成功
1	错误	导入过程中出现错误

任务依赖关系

要将 CSV 文件中有关任务依赖关系的数据导入 BlackLine，请添加 Task Dependencies 命令。 

等效 API 调用： https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview

属性

摘要信息	细节
分隔符号	请输入CSV文件中使用的分隔符。
CSV数据源	输入包含任务依赖关系导入数据的 CSV 文件。
列映射	导入操作需要按照 BlackLine 导入模板中规定的特定列顺序进行。如果 CSV 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
0	成功	成功
1	错误	导入过程中出现错误

任务

要将 CSV 文件中的任务数据导入 BlackLine，请添加 Tasks 命令。 

等效 API 调用： https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview

属性

摘要信息	细节
分隔符号	请输入CSV文件中使用的分隔符。
CSV数据源	输入包含任务导入数据的 CSV 文件。
列映射	导入操作需要按照 BlackLine 导入模板中规定的特定列顺序进行。如果 CSV 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
0	成功	成功
1	错误	导入过程中出现错误

用户帐户分配

要将 CSV 文件中的用户帐户分配数据导入 BlackLine，请添加 用户帐户分配 命令。 

等效 API 调用：

• https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/user-account-assignments/put
• https://developer.blackline.com/docs/users/1/overview

属性

摘要信息	细节
分隔符号	请输入CSV文件中使用的分隔符。
CSV数据源	输入包含用户帐户分配导入数据的 CSV 文件。
列映射	导入操作需要按照 BlackLine 导入模板中规定的特定列顺序进行。如果 CSV 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
0	成功	成功
1	错误	导入过程中出现错误

用户实体

要将 CSV 文件中的用户实体数据导入 BlackLine，请添加 User Entities 命令。 

等效 API 调用： https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/entities/get

属性

摘要信息	细节
分隔符号	请输入CSV文件中使用的分隔符。
CSV数据源	输入包含用户实体导入数据的 CSV 文件。
列映射	导入操作需要按照 BlackLine 导入模板中规定的特定列顺序进行。如果 CSV 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
0	成功	成功
1	错误	导入过程中出现错误

用户角色

要将 CSV 文件中的用户角色数据导入 BlackLine，请添加 用户角色 命令。

等效 API 调用： https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/roles-products/get

属性

摘要信息	细节
分隔符号	请输入CSV文件中使用的分隔符。
CSV数据源	输入包含用户角色导入数据的 CSV 文件。
列映射	导入操作需要按照 BlackLine 导入模板中规定的特定列顺序进行。如果 CSV 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
0	成功	成功
1	错误	导入过程中出现错误

用户

要将 CSV 文件中的用户数据导入 BlackLine，请添加 Users 命令。 

等效 API 调用： https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/roles-products/get

属性

摘要信息	细节
分隔符号	请输入CSV文件中使用的分隔符。
CSV数据源	输入包含用户导入数据的 CSV 文件。
列映射	导入操作需要按照 BlackLine 导入模板中规定的特定列顺序进行。如果 CSV 文件的标题名称与导入模板相同，则留空。否则，将 CSV 中的列映射到导入模板中的列，例如 ID -> 实体唯一标识符。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	细节
0	成功	成功
1	错误	导入过程中出现错误