Workiva 支持中心

要在 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 文件的标题名称与导入模板相同，则留空。否则，将 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，请添加 银行余额 命令。 

等效 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 -> Entity Unique Identifier。

输出

输出	输出类型
导入	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 -> Entity Unique Identifier。

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	导入时出现错误

实体类型

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

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

属性

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

输出

输出	输出类型
导入	JSON

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	导入时出现错误

获取导入错误

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

等效 API 调用： 不适用

属性

摘要信息	详细信息
进口 ID	导入流程的唯一 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 -> Entity Unique Identifier。

输出

输出	输出类型
导入	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，请添加 任务依赖关系 命令。 

等效 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，请添加 User Account Assignments 命令。 

等效 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，请添加 User Roles 命令。

等效 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	错误	导入时出现错误