Mapa de negócios
O Businessmap é a plataforma de software mais flexível para agilidade empresarial orientada por resultados. A funcionalidade incomparável consolida várias ferramentas em uma, permitindo a implantação acessível em escala, visibilidade em todos os projetos/portfólios e alinhamento em metas, para oferecer um trabalho de qualidade mais rapidamente. O conector businessmap pode ser usado para refletir alterações em ferramentas externas (por exemplo, rastreadores de problemas, email, ferramentas de acompanhamento de tempo etc.) dentro de seus cartões Kanban.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte ao Businessmap |
| URL | https://businessmap.io/customer-support |
| support@businessmap.io |
| Metadados do conector | |
|---|---|
| Publicador | Mapa de negócios |
| Site | https://businessmap.io |
| Política de privacidade | https://businessmap.io/privacy-policy |
| Categorias | Gestão de empresas; Business Intelligence |
O Businessmap é a plataforma de software mais flexível para agilidade empresarial orientada por resultados. Ele ajuda os gerentes a obter visibilidade em todos os projetos, conecta o planejamento com a execução e orienta a otimização contínua dos fluxos de trabalho de entrega. Criado com a escala em mente, o Businessmap pode expandir facilmente de uma única equipe de entrega para um portfólio estratégico. A funcionalidade incomparável consolida várias ferramentas em uma, permitindo a implantação acessível em escala, visibilidade em todos os projetos/portfólios e alinhamento em metas, para oferecer um trabalho de qualidade mais rapidamente. O Businessmap é a plataforma Kanban líder para gerenciamento e entrega eficientes de projetos.
Este é o Conector do Businessmap para Power Automate. Ele funciona diretamente com dados do Businessmap por meio de nossa API v2 mais recente. O conector do Businessmap pode ser usado para refletir alterações em ferramentas externas dentro de seus cartões Kanban ou ler dados do Businessmap e usá-los em conectores de terceiros. Visite a seção integrações em nossa base de dados de conhecimento para obter alguns exemplos reais sobre como usar o conector.
Pré-requisitos
- Para usar esse conector, você precisa de uma conta do Businessmap e de um usuário com permissões para acessar a API. Sign-Up aqui e crie e conta para experimentá-lo.
Como obter credenciais
Você pode encontrar sua chave de API dentro do menu "API" em seu perfil.
Introdução ao conector
O conector tem um gatilho que é geral e manipula todos os eventos. Defina esse gatilho como a primeira etapa em seu fluxo quando você quiser receber eventos do Businessmap. Sua próxima ação deve ser uma verificação de "Condição", em que você adicionará um filtro em "evento" e continuará somente se o tipo de evento corresponder ao que você está interessado. Aqui você pode encontrar uma lista com todos os eventos e valores possíveis que dispararão o gatilho. A próxima etapa geralmente será "Obter Cartão por ID", ela obterá todos os detalhes do cartão e você poderá usar e operar esses dados no fluxo a seguir.
Problemas e limitações conhecidos
Determinados limites são aplicados para garantir que o produto e nossas APIs estejam em execução da maneira mais tranquila e eficiente possível. Os limites exatos da API dependem do seu plano de serviço. Você pode ler mais informações sobre isso aqui
Erros e soluções comuns
Se você encontrar um erro 429, isso significa que você atingiu seus limites de API. Os detalhes do erro informam quanto tempo você precisa aguardar para poder enviar sua próxima solicitação. Todos os outros erros têm mensagens que explicam o motivo exato do erro.
perguntas frequentes
Temos uma extensa seção da Base de Dados de Conhecimento e, se você tiver alguma pergunta para a qual não consegue encontrar a resposta, entre em contato conosco e ficaremos felizes em ajudar.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API | secureString | A chave de API para esta api | Verdade |
| Subdomain | cadeia | Especificar o subdomínio da sua conta do Businessmap | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Adicionar Comentário |
Adicione um comentário a um cartão ou iniciativa. |
| Adicionar Comentário (preterido) [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Adicionar Comentário .
|
| Arquivar ou desarquivar cartão |
Adicione cartão ao arquivo morto ou extraia-o do arquivo morto. |
| Atualizar Cartão |
Atualize as propriedades de um cartão (Título, Descrição, Prioridade etc.). Se o tempo limite ou o limite de API atingir erros, tente dividir a configuração de campos personalizados, adesivos e marcas em ações separadas. |
| Baixar Anexo |
Baixe um anexo de um cartão. O conteúdo do arquivo é retornado como cadeia de caracteres codificada em base64. |
| Bloquear Cartão |
Bloquear um cartão. |
| Bloquear ou desbloquear cartão (preterido) [PRETERIDO] |
(Preterido) Bloquear, desbloquear ou editar motivos de bloco para um cartão. |
| Carregar anexo |
Carregue um anexo em um cartão. |
| Cartão de arquivo morto (preterido) [PRETERIDO] |
Esta ação foi preterida. Em vez disso , use Arquivo Morto ou Cartão Não Dinâmico .
|
| Cartão de Atualização (preterido) [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use o Cartão de Atualização .
|
| Cartões de Link |
Vincule um cartão a um cartão existente. |
| Criar Cartão |
Crie um cartão em um quadro de sua escolha. Para definir campos personalizados, adesivos e marcas são usados em combinação com "Atualizar Cartão". |
| Criar Cartão (preterido) [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Criar Cartão .
|
| Criar subtarefa |
Crie uma nova subtarefa de um cartão ou iniciativa. |
| Criar subtarefa (preterida) [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Criar Subtarefa .
|
| Definir ou desafina adesivos |
Adicionar adesivos a um cartão ou remover adesivos atribuídos de um cartão |
| Definir ou desafinar marcas |
Adicionar marcas a um cartão ou remover marcas atribuídas de um cartão |
| Definir valor de campo personalizado |
Defina o valor de um campo personalizado. |
| Desbloquear Cartão |
Desbloqueie um cartão. |
| Descartar ou restaurar cartão |
Descarte um cartão ou restaure um cartão descartado anteriormente. |
| Desvincular Cartões |
Remova um link entre dois cartões. |
| Excluir Cartão (preterido) [PRETERIDO] |
(Preterido) Excluir um cartão. |
| Get Boards (preterido) [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Get Boards .
|
| Get Lanes (preterido) [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Get Lanes .
|
| Mover Cartão |
Mover um cartão para nova coluna, faixa, fluxo de trabalho ou placa. |
| Mover Cartão (preterido) [PRETERIDO] |
Esta ação foi preterida. Em vez disso , use Move Card .
|
| Obter anexos de cartão |
Obtenha uma lista com todos os anexos de um cartão especificado. |
| Obter cartão por ID |
Obtenha detalhes do cartão por sua ID interna. |
| Obter cartão por ID (preterido) [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Get Card by ID .
|
| Obter Cartão por ID Personalizada |
Localize o cartão por ID de cartão personalizada. Se vários cartões forem encontrados, somente o primeiro será retornado. Use o parâmetro 'Board' para filtrar a pesquisa por placas. |
| Obter colunas de quadro (preterido) [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Obter Colunas .
|
| Obter fluxos de trabalho (preterido) [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Obter Fluxos de Trabalho .
|
| Obter o nome {Object} |
Obtenha o nome de um objeto com base em sua ID. Função auxiliar usada quando você deseja obter o nome da placa, fluxo de trabalho, coluna etc. com base em sua ID |
| Obter tipos (preterido) [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Get Types .
|
| Obter todos os cartões |
Obtenha todos os cartões de um quadro selecionado. A resposta contém até 200 cartões. Para mais de 200 cartões, use paginação. |
| Obter todos os cartões (preterido) [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Get All Cards .
|
| Tempo de Log |
Tempo de log para um cartão. |
| Tempo de Log (número de segundos) (preterido) [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use o Tempo de Log .
|
Adicionar Comentário
Adicione um comentário a um cartão ou iniciativa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
|
Comment
|
text | True | string |
Comment |
Adicionar Comentário (preterido) [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Adicionar Comentário .
(Preterido) Adiciona um comentário a um cartão ou iniciativa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tipo de conteúdo
|
Content-Type | True | string |
Sempre usar: application/json |
|
Tipo de conteúdo
|
Accept | True | string |
Sempre usar: application/json |
|
ID do Cartão
|
taskid | string |
ID do cartão |
|
|
Comment
|
comment | string |
comentário |
Arquivar ou desarquivar cartão
Adicione cartão ao arquivo morto ou extraia-o do arquivo morto.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
|
Ação
|
is_archived | True | integer |
Selecionar ação |
Atualizar Cartão
Atualize as propriedades de um cartão (Título, Descrição, Prioridade etc.). Se o tempo limite ou o limite de API atingir erros, tente dividir a configuração de campos personalizados, adesivos e marcas em ações separadas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
|
Quadro
|
board_id | True | integer |
A placa deve ser selecionada na lista suspensa |
|
Workflow
|
workflow_id | integer |
O fluxo de trabalho deve ser selecionado na lista suspensa |
|
|
Template
|
template_id | integer |
Selecionar Modelo |
|
|
Coluna
|
column_id |
Selecionar Coluna ou Inserir Nome da Coluna ou ID como um Valor Personalizado |
||
|
Pista
|
lane_id |
Selecione Lane ou Inserir nome ou ID de faixa como um valor personalizado |
||
|
Title
|
title | string |
Título do Cartão |
|
|
Description
|
description | string |
Descrição do cartão |
|
|
ID personalizada
|
custom_id | string |
ID personalizada |
|
|
Proprietário
|
owner_user_id | integer |
Selecionar Proprietário do Cartão |
|
|
Tipo
|
type_id | integer |
Selecionar Tipo de Cartão |
|
|
Tamanho do cartão
|
size | double |
Tamanho do cartão |
|
|
Priority
|
priority | integer |
Selecionar Prioridade |
|
|
Cor
|
color | string |
Cor (Hex, por exemplo, #000000) |
|
|
Data limite
|
deadline | string |
Prazo (Formato: YYYY-MM-DD) |
|
|
Data de início planejada
|
planned_start_date | string |
Data de início planejada (formato: YYYY-MM-DD) (somente iniciativas) |
|
|
Data de término planejada
|
planned_end_date | string |
Data de término planejada (formato: YYYY-MM-DD) (somente iniciativas) |
|
|
Hora de início real
|
actual_start_time | string |
Hora de início real (formato: YYYY-MM-DDTHH:mm:ssZ) (somente iniciativas) |
|
|
Hora de término real
|
actual_end_time | string |
Hora de término real (formato: YYYY-MM-DDTHH:mm:ssZ) (somente iniciativas) |
|
|
Adesivos
|
stickers | string |
Selecionar adesivos ou adicioná-los como texto separado por vírgula |
|
|
Etiquetas
|
tags | string |
Selecionar marcas ou adicioná-las como texto separado por vírgula |
|
|
Nome
|
field_id | integer |
Selecionar Campo Personalizado |
|
|
Value
|
value | string |
Valor do campo personalizado |
Retornos
- Corpo
- getCardResponse
Baixar Anexo
Baixe um anexo de um cartão. O conteúdo do arquivo é retornado como cadeia de caracteres codificada em base64.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
|
Nome do arquivo
|
attachment_id | True | integer |
Selecione Anexo ou insira a ID do Anexo de Obter Anexos de Cartão |
Retornos
Bloquear Cartão
Bloquear um cartão.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Quadro
|
board_id | True | integer |
A placa deve ser selecionada na lista suspensa |
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
|
Motivo do bloco
|
reason_id | True | string |
Selecionar Motivo do Bloco |
|
Comment
|
comment | string |
Adicionar comentário ao motivo do bloco |
Bloquear ou desbloquear cartão (preterido) [PRETERIDO]
(Preterido) Bloquear, desbloquear ou editar motivos de bloco para um cartão.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
boardid | True | string |
Selecionar quadro na lista suspensa |
|
ID do Cartão
|
taskid | True | string |
ID do cartão |
|
Tipo de evento
|
event | True | string | |
|
Motivo do bloco
|
blockreason | string |
motivo do bloco |
Carregar anexo
Carregue um anexo em um cartão.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
|
Nome do Arquivo
|
file_name | True | string |
Inserir nome do arquivo |
|
Content
|
content | True | binary |
Fornecer conteúdo de arquivo (base64) |
Retornos
- Corpo
- uploadAttachmentResponse
Cartão de arquivo morto (preterido) [PRETERIDO]
Esta ação foi preterida. Em vez disso , use Arquivo Morto ou Cartão Não Dinâmico .
(Preterido) Mover o cartão para o arquivo morto. O cartão não deve ser bloqueado e deve estar na coluna Concluído ou na coluna Arquivo Morto.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
cardid | True | string |
ID do cartão |
|
Versão
|
version | string |
versão |
Cartão de Atualização (preterido) [PRETERIDO]
Esta ação foi preterida. Em vez disso, use o Cartão de Atualização .
(Preterido) Atualize as propriedades de um cartão (Título, Descrição, Prioridade etc.)
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tipo de conteúdo
|
Content-Type | True | string |
Sempre definido como: application/json |
|
Aceitar
|
Accept | True | string |
Sempre definido como: application/json |
|
ID da placa
|
boardid | integer |
Selecionar quadro na lista suspensa |
|
|
ID do Cartão
|
taskid | integer |
ID do cartão |
|
|
Title
|
title | string |
title |
|
|
Description
|
description | string |
detalhes do cartão |
|
|
Priority
|
priority | string | ||
|
Assignee
|
assignee | string |
nome de usuário do destinatário |
|
|
Cor
|
color | string |
código de cor hex como este #F37325 |
|
|
Tamanho
|
size | integer |
size |
|
|
Etiquetas
|
tags | string |
várias marcas devem ser separadas com espaço |
|
|
Campos personalizados
|
cfields | string |
Lista formatada em JSON de campos personalizados e seus valores {"field1":"value1","field2":"value2"} |
|
|
Data limite
|
deadline | string |
data de data limite neste formato YYYY-MM-DD |
|
|
Link Externo
|
extlink | string |
link externo |
|
|
Tipo
|
type | string |
o nome do tipo que você deseja definir |
Cartões de Link
Vincule um cartão a um cartão existente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
|
Será vinculado como
|
link_type | True | string |
Selecionar Tipo de Link |
|
Para a ID do cartão
|
linked_card_id | True | integer |
ID do cartão para vincular ao cartão atual |
Criar Cartão
Crie um cartão em um quadro de sua escolha. Para definir campos personalizados, adesivos e marcas são usados em combinação com "Atualizar Cartão".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Quadro
|
board_id | True | integer |
A placa deve ser selecionada na lista suspensa |
|
Workflow
|
workflow_id | True | integer |
O fluxo de trabalho deve ser selecionado na lista suspensa |
|
Template
|
template_id | integer |
Selecionar Modelo |
|
|
Coluna
|
column_id | True |
Selecionar Coluna ou Inserir Nome da Coluna ou ID como um Valor Personalizado |
|
|
Pista
|
lane_id | True |
Selecione Lane ou Inserir nome ou ID de faixa como um valor personalizado |
|
|
Title
|
title | True | string |
Título do Cartão |
|
Description
|
description | string |
Descrição do cartão |
|
|
ID personalizada
|
custom_id | string |
ID do cartão personalizado |
|
|
Proprietário
|
owner_user_id | integer |
Selecionar Proprietário do Cartão |
|
|
Usuário do Repórter
|
reporter_user_id | integer |
Selecionar o repórter de usuários do Businessmap |
|
|
Email do Repórter
|
reporter_email | string |
Insira o endereço de email do Repórter, somente se nenhum usuário estiver selecionado acima |
|
|
Tipo
|
type_id | integer |
Selecionar Tipo de Cartão |
|
|
Tamanho do cartão
|
size | double |
Tamanho do cartão |
|
|
Priority
|
priority | integer |
Selecionar Prioridade |
|
|
Cor
|
color | string |
Cor (Hex, por exemplo, #000000) |
|
|
Data limite
|
deadline | string |
Prazo (Formato: YYYY-MM-DD) |
|
|
Data de início planejada
|
planned_start_date | string |
Data de início planejada (formato: YYYY-MM-DD) (somente iniciativas) |
|
|
Data de término planejada
|
planned_end_date | string |
Data de término planejada (formato: YYYY-MM-DD) (somente iniciativas) |
|
|
Hora de início real
|
actual_start_time | string |
Hora de início real (formato: YYYY-MM-DDTHH:mm:ssZ) (somente iniciativas) |
|
|
Hora de término real
|
actual_end_time | string |
Hora de término real (formato: YYYY-MM-DDTHH:mm:ssZ) (somente iniciativas) |
Retornos
- Corpo
- getCardResponse
Criar Cartão (preterido) [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Criar Cartão .
(Preterido) Crie um cartão em um quadro de sua escolha.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tipo de conteúdo
|
Content-Type | string |
Sempre usar: application/json |
|
|
Tipo de conteúdo
|
Accept | string |
Sempre usar: application/json |
|
|
ID da placa
|
boardid | True | string |
Selecionar quadro |
|
Title
|
title | string |
title |
|
|
Description
|
description | string |
detalhes do cartão |
|
|
Priority
|
priority | string |
valores possíveis: Baixo, Médio, Alto, Crítico |
|
|
Assignee
|
assignee | string |
nome de usuário do destinatário |
|
|
Cor
|
color | string |
código de cor hex como este #F37325 |
|
|
Tamanho
|
size | string |
size |
|
|
Etiquetas
|
tags | string |
várias marcas devem ser separadas com espaço |
|
|
Campos personalizados
|
cfields | string |
Lista formatada em JSON de campos personalizados e seus valores {"field1":"value1","field2":"value2"} |
|
|
Data limite
|
deadline | string |
data de data limite neste formato YYYY-MM-DD |
|
|
Link Externo
|
extlink | string |
link externo |
|
|
Tipo
|
type | string |
o nome do tipo que você deseja definir |
|
|
Modelo de Cartão
|
template | string |
o nome do modelo de cartão que você deseja aplicar |
|
|
Nome da coluna
|
column | string |
nome exato da coluna |
|
|
Pista
|
lane | string |
nome da faixa |
|
|
Position
|
position | string |
posição do cartão na coluna |
|
|
Motivo excedido
|
exceedingreason | string |
motivo excedido |
Criar subtarefa
Crie uma nova subtarefa de um cartão ou iniciativa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Quadro
|
board_id | True | integer |
A placa deve ser selecionada na lista suspensa |
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
|
Description
|
description | True | string |
Descrição da subtarefa |
|
Proprietário
|
owner_user_id | string |
Selecionar usuário |
|
|
Status da subtarefa
|
is_finished | integer |
Selecionar Status da Subtarefa |
Criar subtarefa (preterida) [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Criar Subtarefa .
(Preterido) Cria uma nova subtarefa de um cartão ou iniciativa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tipo de conteúdo
|
Content-Type | True | string |
Sempre usar: application/json |
|
Tipo de conteúdo
|
Accept | True | string |
Sempre usar: application/json |
|
ID do cartão pai
|
taskparent | integer |
ID do cartão pai |
|
|
Title
|
title | string |
title |
|
|
Assignee
|
assignee | string |
nome de usuário do destinatário |
Definir ou desafina adesivos
Adicionar adesivos a um cartão ou remover adesivos atribuídos de um cartão
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
|
Quadro
|
board_id | True | integer |
A placa deve ser selecionada na lista suspensa |
|
Ação
|
action | True | string |
Escolha definir ou desafina adesivos |
|
Adesivos
|
stickers | True | string |
Selecione um único adesivo na lista suspensa ou insira vários adesivos separados com uma vírgula |
|
Se o adesivo estiver ausente
|
missing_stickers | integer |
Selecione o comportamento desejado quando um adesivo está faltando |
Definir ou desafinar marcas
Adicionar marcas a um cartão ou remover marcas atribuídas de um cartão
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
|
Quadro
|
board_id | True | integer |
A placa deve ser selecionada na lista suspensa |
|
Ação
|
action | True | string |
Optar por definir ou desafinar marcas |
|
Etiquetas
|
tags | True | string |
Selecione uma única marca na lista suspensa ou insira várias marcas separadas com uma vírgula |
|
Se a marca estiver ausente
|
missing_tags | integer |
Selecione o comportamento desejado quando uma marca está ausente |
Definir valor de campo personalizado
Defina o valor de um campo personalizado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
|
ID da placa
|
board_id | True | integer |
A placa deve ser selecionada na lista suspensa |
|
Nome do campo
|
field_id | True | integer |
Selecionar Campo Personalizado |
|
Value
|
values | True | string |
Selecione na lista suspensa ou insira valores personalizados separados com uma vírgula |
Desbloquear Cartão
Desbloqueie um cartão.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
Descartar ou restaurar cartão
Descarte um cartão ou restaure um cartão descartado anteriormente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
|
Ação
|
is_discarded | True | integer |
Selecionar ação |
Desvincular Cartões
Remova um link entre dois cartões.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Desvincular ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
|
Vinculado como
|
link_type | True | string |
Selecionar tipo de link |
|
Para a ID do Cartão
|
linked_card_id | True | integer |
Insira a ID do cartão vinculado |
Excluir Cartão (preterido) [PRETERIDO]
(Preterido) Excluir um cartão.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
boardid | True | string |
Selecionar quadro na lista suspensa |
|
ID do Cartão
|
taskid | True | string |
ID do cartão |
Get Boards (preterido) [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Get Boards .
(Preterido) Obtenha todos os quadros da conta.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of object |
dados |
|
board_id
|
data.board_id | integer |
board_id |
|
workspace_id
|
data.workspace_id | integer |
workspace_id |
|
is_archived
|
data.is_archived | integer |
is_archived |
|
nome
|
data.name | string |
nome |
Get Lanes (preterido) [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Get Lanes .
(Preterido) Obtém todas as pistas para uma placa especificada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
board_id | True | string |
A placa para a qual pegar as pistas. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of object |
dados |
|
lane_id
|
data.lane_id | integer |
lane_id |
|
fluxo de trabalho
|
data.workflow | integer |
fluxo de trabalho |
|
parent_lane_id
|
data.parent_lane_id | integer |
parent_lane_id |
|
posição
|
data.position | integer |
posição |
|
nome
|
data.name | string |
nome |
|
descrição
|
data.description | string |
descrição |
|
color
|
data.color | string |
color |
Mover Cartão
Mover um cartão para nova coluna, faixa, fluxo de trabalho ou placa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
|
Quadro
|
board_id | True | integer |
A placa deve ser selecionada na lista suspensa |
|
Workflow
|
workflow_id | True | integer |
O fluxo de trabalho deve ser selecionado na lista suspensa |
|
Coluna
|
column_id | True |
Selecionar Coluna ou Inserir Nome da Coluna ou ID como um Valor Personalizado |
|
|
Pista
|
lane_id | True |
Selecione Lane ou Inserir nome ou ID de faixa como um valor personalizado |
Mover Cartão (preterido) [PRETERIDO]
Esta ação foi preterida. Em vez disso , use Move Card .
(Preterido) Mova um cartão (Tarefa ou Iniciativa, se possível) para uma coluna.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tipo de conteúdo
|
Content-Type | True | string |
Sempre usar: application/json |
|
Tipo de conteúdo
|
Accept | True | string |
Sempre usar: application/json |
|
ID do Cartão
|
taskid | string |
ID do cartão |
|
|
ID da placa
|
boardid | True | string |
ID da placa |
|
Coluna
|
column | string |
nome da coluna |
|
|
Pista
|
lane | string |
nome da faixa |
|
|
Position
|
position | string |
posição do cartão na coluna |
|
|
Motivo excedido
|
exceedingreason | string |
motivo excedido |
Obter anexos de cartão
Obtenha uma lista com todos os anexos de um cartão especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
Retornos
Obter cartão por ID
Obtenha detalhes do cartão por sua ID interna.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
card_id | True | integer |
Inserir ID do Cartão |
Retornos
- Corpo
- getCardResponse
Obter cartão por ID (preterido) [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Get Card by ID .
(Preterido) Obter cartão por sua ID
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
boardid | True | string |
Selecionar quadro na lista suspensa |
|
ID do Cartão
|
taskid | True | string |
ID do cartão |
|
Obter histórico
|
history | string |
definido como 'sim' se você quiser obter o histórico do cartão |
|
|
Obter comentários
|
comments | string |
definido como 'sim' se você quiser obter comentários de cartão |
|
|
Formato de texto
|
textformat | string |
formato de texto retornado para a descrição do cartão |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
taskid
|
taskid | string |
taskid |
|
boardid
|
boardid | string |
boardid |
|
title
|
title | string |
title |
|
descrição
|
description | string |
descrição |
|
tipo
|
type | string |
tipo |
|
destinatário
|
assignee | string |
destinatário |
|
Subtarefas
|
subtasks | string |
Subtarefas |
|
subtaskscomplete
|
subtaskscomplete | string |
subtaskscomplete |
|
color
|
color | string |
color |
|
priority
|
priority | string |
priority |
|
size
|
size | string |
size |
|
prazo
|
deadline | string |
prazo |
|
deadlineoriginalformat
|
deadlineoriginalformat | string |
deadlineoriginalformat |
|
extlink
|
extlink | string |
extlink |
|
tags
|
tags | string |
tags |
|
leadtime
|
leadtime | integer |
leadtime |
|
bloqueado
|
blocked | string |
bloqueado |
|
blockedreason
|
blockedreason | string |
blockedreason |
|
columnname
|
columnname | string |
columnname |
|
lanename
|
lanename | string |
lanename |
|
subtaskdetails
|
subtaskdetails | array of |
subtaskdetails |
|
columnid
|
columnid | string |
columnid |
|
laneid
|
laneid | string |
laneid |
|
posição
|
position | string |
posição |
|
fluxo de trabalho
|
workflow | integer |
fluxo de trabalho |
|
workflow_id
|
workflow_id | integer |
workflow_id |
|
url
|
attachments.FXPR1VE0LIC9.url | string |
url |
|
clientName
|
attachments.FXPR1VE0LIC9.clientName | string |
clientName |
|
Nome único
|
attachments.FXPR1VE0LIC9.uniqueName | string |
Nome único |
|
tamanho do arquivo
|
attachments.FXPR1VE0LIC9.fileSize | float |
tamanho do arquivo |
|
fileType
|
attachments.FXPR1VE0LIC9.fileType | string |
fileType |
|
status
|
attachments.FXPR1VE0LIC9.status | string |
status |
|
url
|
attachments.0XC7C1PRR9ZK.url | string |
url |
|
clientName
|
attachments.0XC7C1PRR9ZK.clientName | string |
clientName |
|
Nome único
|
attachments.0XC7C1PRR9ZK.uniqueName | string |
Nome único |
|
tamanho do arquivo
|
attachments.0XC7C1PRR9ZK.fileSize | float |
tamanho do arquivo |
|
fileType
|
attachments.0XC7C1PRR9ZK.fileType | string |
fileType |
|
status
|
attachments.0XC7C1PRR9ZK.status | string |
status |
|
columnpath
|
columnpath | string |
columnpath |
|
repórter
|
reporter | string |
repórter |
|
campos personalizados
|
customfields | array of object |
campos personalizados |
|
fieldid
|
customfields.fieldid | integer |
fieldid |
|
nome
|
customfields.name | string |
nome |
|
tipo
|
customfields.type | string |
tipo |
|
value
|
customfields.value | string |
value |
|
obrigatório
|
customfields.mandatory | boolean |
obrigatório |
|
imutável
|
customfields.immutable | boolean |
imutável |
|
updatedat
|
updatedat | string |
updatedat |
|
loggedtime
|
loggedtime | integer |
loggedtime |
|
historydetails
|
historydetails | array of object |
historydetails |
|
eventtype
|
historydetails.eventtype | string |
eventtype |
|
historyevent
|
historydetails.historyevent | string |
historyevent |
|
taskid
|
historydetails.taskid | string |
taskid |
|
details
|
historydetails.details | string |
details |
|
autor
|
historydetails.author | string |
autor |
|
entrydate
|
historydetails.entrydate | string |
entrydate |
|
historyid
|
historydetails.historyid | string |
historyid |
|
comments
|
comments | array of |
comments |
Obter Cartão por ID Personalizada
Localize o cartão por ID de cartão personalizada. Se vários cartões forem encontrados, somente o primeiro será retornado. Use o parâmetro 'Board' para filtrar a pesquisa por placas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do cartão personalizado
|
custom_ids | True | string |
Inserir IDs Personalizadas |
|
Quadro
|
board_ids | integer |
A placa deve ser selecionada na lista suspensa |
Retornos
- Corpo
- getCardResponse
Obter colunas de quadro (preterido) [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Obter Colunas .
(Preterido) Obtenha todas as colunas de um quadro especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
board_id | True | string |
O quadro para o qual obter as colunas. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of object |
dados |
|
column_id
|
data.column_id | integer |
column_id |
|
fluxo de trabalho
|
data.workflow | integer |
fluxo de trabalho |
|
section
|
data.section | integer |
section |
|
parent_column_id
|
data.parent_column_id | integer |
parent_column_id |
|
posição
|
data.position | integer |
posição |
|
nome
|
data.name | string |
nome |
|
descrição
|
data.description | string |
descrição |
|
color
|
data.color | string |
color |
|
limit
|
data.limit | integer |
limit |
|
cards_per_row
|
data.cards_per_row | integer |
cards_per_row |
|
flow_type
|
data.flow_type | integer |
flow_type |
Obter fluxos de trabalho (preterido) [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Obter Fluxos de Trabalho .
(Preterido) Obtenha todos os fluxos de trabalho de um determinado quadro.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
board_id | True | string |
Quadro |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of object |
dados |
|
tipo
|
data.type | integer |
tipo |
|
posição
|
data.position | integer |
posição |
|
is_enabled
|
data.is_enabled | integer |
is_enabled |
|
is_collapsible
|
data.is_collapsible | integer |
is_collapsible |
|
nome
|
data.name | string |
nome |
|
workflow_id
|
data.workflow_id | integer |
workflow_id |
Obter o nome {Object}
Obtenha o nome de um objeto com base em sua ID. Função auxiliar usada quando você deseja obter o nome da placa, fluxo de trabalho, coluna etc. com base em sua ID
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Quadro
|
board_id | True | integer |
A placa deve ser selecionada na lista suspensa |
|
Item
|
item | True | string |
Selecionar Tipo de Objeto |
|
ID
|
id | True | integer |
Inserir ID do objeto |
Retornos
- Corpo
- getObjectNameResponse
Obter tipos (preterido) [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Get Types .
(Preterido) Obtém todos os tipos dentro da conta.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of object |
dados |
|
type_id
|
data.type_id | integer |
type_id |
|
icon_type
|
data.icon_type | integer |
icon_type |
|
icon_id
|
data.icon_id | integer |
icon_id |
|
nome
|
data.name | string |
nome |
|
descrição
|
data.description | string |
descrição |
|
color
|
data.color | string |
color |
|
card_color_sync
|
data.card_color_sync | integer |
card_color_sync |
|
all_properties_are_locked
|
data.all_properties_are_locked | integer |
all_properties_are_locked |
|
disponibilidade
|
data.availability | integer |
disponibilidade |
|
is_enabled
|
data.is_enabled | integer |
is_enabled |
Obter todos os cartões
Obtenha todos os cartões de um quadro selecionado. A resposta contém até 200 cartões. Para mais de 200 cartões, use paginação.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Quadro
|
board_ids | True | integer |
A placa deve ser selecionada na lista suspensa |
|
IDs de cartão personalizadas
|
custom_ids | array |
Inserir IDs Personalizadas |
|
|
Página
|
page | integer |
Número da Página |
|
|
Estado
|
state | string |
O valor de estado dos cartões que você deseja obter. Por padrão, é o estado ativo. |
Retornos
- Corpo
- getAllCardsResponse
Obter todos os cartões (preterido) [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Get All Cards .
(Preterido) Pegue todas as cartas de uma determinada placa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
boardid | True | string |
Selecionar quadro na lista suspensa |
Tempo de Log
Tempo de log para um cartão.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Cartão
|
card_id | True | string |
ID do cartão interno |
|
Unidade de Tempo
|
time_unit | True | string |
Unidade de Tempo |
|
Duração
|
time | True | integer |
Duração |
|
Comment
|
comment | string |
Comment |
Tempo de Log (número de segundos) (preterido) [PRETERIDO]
Esta ação foi preterida. Em vez disso, use o Tempo de Log .
(Preterido) Tempo de log para um cartão. O tempo é registrado em segundos.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tipo de conteúdo
|
Content-Type | True | string |
Sempre usar: application/json |
|
Tipo de conteúdo
|
Accept | True | string |
Sempre usar: application/json |
|
ID do Cartão
|
card_id | string |
ID do cartão interno |
|
|
Hora
|
time | string |
Tempo em Segundos |
|
|
Comment
|
comment | string |
Comment |
Gatilhos
| Gatilho Geral |
Dispara qualquer ação no quadro. Use Control/Condition ou Control/Switch para gerenciar o fluxo para gatilhos diferentes. Aqui está uma lista parcial dos tipos de evento com suporte: "Cartão criado", "Cartão movido", "Detalhes do cartão alterados", "Cartão excluído", "Cartão bloqueado" \n\n Sua próxima etapa após o gatilho deve ser "Obter Cartão por ID" para que você possa levar todos os detalhes do cartão \n\nUsar Controle/Condição na ID do autor em integrações bidirecionais para evitar loops |
Gatilho Geral
Dispara qualquer ação no quadro. Use Control/Condition ou Control/Switch para gerenciar o fluxo para gatilhos diferentes. Aqui está uma lista parcial dos tipos de evento com suporte: "Cartão criado", "Cartão movido", "Detalhes do cartão alterados", "Cartão excluído", "Cartão bloqueado" \n\n Sua próxima etapa após o gatilho deve ser "Obter Cartão por ID" para que você possa levar todos os detalhes do cartão \n\nUsar Controle/Condição na ID do autor em integrações bidirecionais para evitar loops
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
board_id | True | string |
Selecionar quadro |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
empresa
|
company | string |
empresa |
|
evento
|
event | string |
evento |
|
user_id
|
user_id | integer |
user_id |
|
board_id
|
board_id | integer |
board_id |
|
card_id
|
card_id | integer |
card_id |
Definições
downloadAttachmentResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome do Arquivo
|
data.file_name | string |
Nome do arquivo de anexo |
|
Content
|
data.content | binary |
Conteúdo do Anexo (base64) |
getAllCardsResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Todas as Páginas
|
data.pagination.all_pages | integer |
Número total de páginas |
|
Página Atual
|
data.pagination.current_page | integer |
Página atual |
|
Resultados por página
|
data.pagination.results_per_page | integer |
Número de resultados por página |
|
dados
|
data.data | array of object | |
|
ID do cartão
|
data.data.card_id | integer |
ID do cartão interno |
|
ID do cartão personalizado
|
data.data.custom_id | string |
ID do cartão personalizado |
|
ID da placa
|
data.data.board_id | integer |
ID da placa |
|
ID do fluxo de trabalho
|
data.data.workflow_id | integer |
ID do fluxo de trabalho do cartão |
|
Título do Cartão
|
data.data.title | string |
Título do cartão |
|
ID do usuário do proprietário
|
data.data.owner_user_id |
ID do proprietário do cartão |
|
|
ID do tipo
|
data.data.type_id |
ID do tipo de cartão |
|
|
Cor
|
data.data.color | string |
Cor do cartão |
|
Seção
|
data.data.section | integer |
ID da seção do cartão |
|
ID da coluna
|
data.data.column_id | integer |
ID da coluna do cartão |
|
ID da pista
|
data.data.lane_id | integer |
ID da faixa do cartão |
getCardAttachmentsResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of object |
dados |
|
id
|
data.id | integer |
ID do anexo do cartão |
|
nome_do_arquivo
|
data.file_name | string |
Nome do arquivo de anexo do cartão |
|
link
|
data.link | string |
Link de Anexo de Cartão |
getCardResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do cartão
|
data.card_id | integer |
ID do cartão interno |
|
ID do cartão personalizado
|
data.custom_id | string |
ID do cartão personalizado |
|
ID da placa
|
data.board_id | integer |
ID da placa |
|
ID do fluxo de trabalho
|
data.workflow_id | integer |
ID do fluxo de trabalho do cartão |
|
Título do Cartão
|
data.title | string |
Título do cartão |
|
ID do usuário do proprietário
|
data.owner_user_id |
ID do proprietário do cartão |
|
|
ID do tipo
|
data.type_id |
ID do tipo de cartão |
|
|
Cor
|
data.color | string |
Cor do cartão |
|
Seção
|
data.section | integer |
ID da seção do cartão |
|
ID da coluna
|
data.column_id | integer |
ID da coluna do cartão |
|
ID da pista
|
data.lane_id | integer |
A ID da pista do cartão |
|
Position
|
data.position | integer |
Posição do cartão |
|
Descrição do cartão
|
data.description | string |
Descrição do cartão |
|
Tamanho do cartão
|
data.size |
Tamanho do cartão |
|
|
Priority
|
data.priority | integer |
ID de prioridade do cartão |
|
Data limite
|
data.deadline | string |
Data limite do cartão |
|
Tipo
|
data.reporter.type | string |
Tipo de valor. Pode ser interno ou externo |
|
Repórter
|
data.reporter.value |
Repórter do cartão |
|
|
Criado em
|
data.created_at | string |
Carimbo de data/hora da criação do cartão |
|
Última modificação
|
data.last_modified | string |
Carimbo de data/hora da última modificação do cartão |
|
Blocked
|
data.is_blocked | integer |
Booliano, se o cartão está bloqueado |
|
Campos personalizados
|
data.custom_fields | array of object |
Matriz dos campos personalizados atribuídos ao cartão |
|
ID do campo
|
data.custom_fields.field_id | integer |
ID do campo personalizado |
|
Nome do campo
|
data.custom_fields.name | string |
Nome do campo personalizado |
|
Valor do campo
|
data.custom_fields.value |
Valor do campo personalizado |
|
|
Valor de Exibição de Campo
|
data.custom_fields.display_value |
Exibir o valor do campo personalizado |
|
|
values
|
data.custom_fields.values | array of object | |
|
ID do valor
|
data.custom_fields.values.value_id | integer |
ID do valor do campo personalizado |
|
Valor do campo
|
data.custom_fields.values.value |
Valor do campo personalizado |
getObjectNameResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
nome
|
data.name | string |
Nome |
uploadAttachmentResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of object |
dados |
|
ID do cartão
|
data.card_id | integer |
ID do cartão interno |
|
Nome do Arquivo
|
data.file_name | string |
Nome do arquivo a ser carregado |