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 Get import errors.
Chamada de API equivalente: N/A
Propriedades
| Propriedade |
Detalhes |
| ID de importação |
A ID exclusiva 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:
|
| Dados |
Os dados a serem importados. |
| Delimitador |
O delimitador dos dados a serem importados. Isso só se aplica se você estiver usando o formato de dados CSV.
Opções:
|
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:
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 |