Centro de suporte da Workiva

Para importar e exportar dados e executar funções de automação e administração gerais no BlackLine® como parte de uma cadeia, adicione uma etapa que use um comando de conexão BlackLine OAuth2. 

Observação: Quando você usa um comando para importar dados para a BlackLine, é necessária uma estrutura de dados diferente com base no tipo de importação. O Wdata cuida disso para você, mas o formato dos dados deve ser mapeado para os modelos de importação da BlackLine.

Para habilitar esses comandos, um administrador de TI primeiro configura uma conexão BlackLine OAuth2.

Configurações da conta

Para importar dados de configurações de conta em um arquivo de valores separados por vírgula (CSV) para a BlackLine, adicione um comando Account Settings. 

Chamada de API equivalente: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/overview

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Digite o arquivo CSV que contém os dados para a importação das configurações de conta.
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Contas

Para importar dados de conta em um arquivo CSV para a BlackLine, adicione um comando Accounts. 

Chamada de API equivalente: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/overview

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Digite o arquivo CSV que contém os dados para a importação de contas.
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Saldos bancários

Para importar dados de saldo bancário em um arquivo CSV para a BlackLine, adicione um comando Bank Balances. 

Chamada de API equivalente: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/bank-balances/put

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Digite o arquivo CSV que contém os dados para a importação de saldos bancários.
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Taxas de câmbio

Para importar dados de taxas de câmbio em um arquivo CSV para a BlackLine, adicione um comando Currency Rates. 

Chamada de API equivalente: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/cross-currency-rates/put

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Digite o arquivo CSV que contém os dados para a importação de taxas de câmbio.
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Baixar relatório

Para fazer download de um relatório da BlackLine, adicione um comando Download Report.

Observação: Para garantir que um relatório esteja disponível para download, recomendamos que você crie uma programação na BlackLine para executar automaticamente o relatório em um intervalo regular, como a cada 30-45 dias.

Chamada de API equivalente:

Propriedades

Propriedade	Detalhes
ID do relatório	Digite o ID do relatório a ser baixado.
Formatação	Selecione o formato do relatório.

Saídas

Saída	Tipo de saída
Relatório	Arquivo

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Entidades

Para importar dados de entidades em um arquivo CSV para o BlackLine, adicione um comando Entities.

Chamada de API equivalente: https://developer.blackline.com/docs/master-data/1/overview

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Digite o arquivo CSV que contém os dados para a importação de entidades.
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Tipos de entidades

Para importar dados de tipos de entidades em um arquivo CSV para o BlackLine, adicione um comando Entity Types. 

Chamada de API equivalente: https://developer.blackline.com/docs/master-data/1/overview

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Digite o arquivo CSV que contém os dados para a importação de Tipos de entidade.
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Obter erros de importação

Para recuperar uma lista dos erros que ocorreram durante uma importação, adicione um comando Obter erros de importação . 

Chamada de API equivalente: N/A

Propriedades

Propriedade	Detalhes
ID de importação	O ID exclusivo do processo de importação.

Saídas

Saída	Tipo de saída
Erros	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Itens

Para importar dados de itens em um arquivo CSV para a BlackLine, adicione um comando Items. 

Chamada de API equivalente: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/items/put

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Digite o arquivo CSV que contém os dados para a importação de itens.
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Importar dados

Para importar os dados fornecidos, adicione um comando Import data . 

Chamada de API equivalente: N/A

Propriedades

Propriedade	Detalhes
ID de importação	O ID (Nome do Perfil de Importação) da importação.
Formatação	O formato dos dados de importação. Opções: CSV JSON
Dados	Os dados a serem importados.
Delimitador	O delimitador dos dados a serem importados. Isso só se aplica se estiver usando o formato de dados CSV. Opções: Vírgula Aba Cano

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Relatórios de listagem

Para listar os relatórios disponíveis para download na BlackLine, adicione um comando List Reports.

Observação: Para garantir que os relatórios estejam disponíveis para download, recomendamos que você crie uma programação na BlackLine para executar automaticamente os relatórios em um intervalo regular, como a cada 30-45 dias.

Chamada de API equivalente:

Propriedades

Nenhum

Saídas

Saída	Tipo de saída
Relatório	Arquivo

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Saldos em várias moedas

Para importar dados de saldos de várias moedas em um arquivo CSV para o BlackLine, adicione um comando Multi-Currency Balances. 

Chamada de API equivalente: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/multi-currency-balances/put

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Digite o arquivo CSV que contém os dados para a importação de saldos em várias moedas.
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Subledgers

Para importar dados de subledgers em um arquivo CSV para o BlackLine, adicione um comando Subledgers. 

Chamada de API equivalente: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/subledgers/put

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Digite o arquivo CSV que contém os dados para a importação do Subledgers.
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Tarefa de certificação automática concluída

Para importar dados sobre tarefas de certificação automática concluídas em um arquivo CSV para o BlackLine, adicione um comando Task Auto-Certify Completed. 

Chamada de API equivalente: https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Digite o arquivo CSV que contém os dados para a importação da tarefa Auto-Certify Completed (Certificação automática concluída).
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Dependências de tarefas

Para importar dados sobre dependências de tarefas em um arquivo CSV para o BlackLine, adicione um comando Task Dependencies. 

Chamada de API equivalente: https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Digite o arquivo CSV que contém os dados para a importação de dependências de tarefas.
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Tarefas

Para importar dados de tarefas em um arquivo CSV para o BlackLine, adicione um comando Tasks. 

Chamada de API equivalente: https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Digite o arquivo CSV que contém os dados para a importação de Tarefas.
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Atribuições de contas de usuário

Para importar dados de atribuições de contas de usuário em um arquivo CSV para o BlackLine, adicione um comando User Account Assignments. 

Chamadas de API equivalentes:

• 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

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Digite o arquivo CSV que contém os dados para a importação de atribuições de contas de usuário.
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Entidades de usuários

Para importar dados de entidades de usuários em um arquivo CSV para o BlackLine, adicione um comando User Entities. 

Chamada de API equivalente:  https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/entities/get

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Insira o arquivo CSV que contém os dados para a importação de entidades de usuários.
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Funções do usuário

Para importar dados de funções de usuário em um arquivo CSV para o BlackLine, adicione um comando User Roles.

Chamada de API equivalente: https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/roles-products/get

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Digite o arquivo CSV que contém os dados para a importação de funções de usuário.
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação

Usuários

Para importar dados de usuários em um arquivo CSV para o BlackLine, adicione um comando Users. 

Chamada de API equivalente: https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/roles-products/get

Propriedades

Propriedade	Detalhes
Delimitador	Digite o delimitador usado no arquivo CSV.
Fonte de dados CSV	Insira o arquivo CSV que contém os dados para a importação de usuários.
Mapeamentos de colunas	A importação requer uma ordem de coluna específica, conforme prescrito no modelo de importação da BlackLine. Se o arquivo CSV tiver os mesmos nomes de cabeçalho que o modelo de importação, deixe em branco. Caso contrário, mapeie as colunas do CSV para as colunas do modelo de importação, como ID -> Entity Unique Identifier.

Saídas

Saída	Tipo de saída
Importação	JSON

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
1	Erro	Houve um erro na importação