Mapa de negócios
O Businessmap é a plataforma de software mais flexível para uma agilidade empresarial orientada para resultados. A funcionalidade incomparável consolida várias ferramentas em uma só, permitindo uma implantação acessível em escala, visibilidade em todos os projetos/portfólios e alinhamento de metas, para entregar um trabalho de qualidade mais rápido. O conector Businessmap pode ser usado para refletir mudanças em ferramentas externas (por exemplo, rastreadores de problemas, e-mail, ferramentas de controle de tempo, etc.) dentro de seus cartões Kanban.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte de mapa de negócios |
| URL | https://businessmap.io/customer-support |
| support@businessmap.io |
| Metadados do conector | |
|---|---|
| Editora | Mapa de negócios |
| Sítio Web | https://businessmap.io |
| Política de privacidade | https://businessmap.io/privacy-policy |
| Categorias | Gestão Empresarial; Inteligência de Negócios |
O Businessmap é a plataforma de software mais flexível para uma agilidade empresarial orientada para resultados. Ele ajuda os gerentes a ganhar 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. Construído com escala em mente, o Businessmap pode facilmente se expandir de uma única equipe de entrega para um portfólio estratégico. A funcionalidade incomparável consolida várias ferramentas em uma só, permitindo uma implantação acessível em escala, visibilidade em todos os projetos/portfólios e alinhamento de metas, para entregar um trabalho de qualidade mais rápido. O Businessmap é a plataforma Kanban líder para gerenciamento e entrega eficiente de projetos.
Este é o Businessmap Connector for Power Automate. Ele funciona diretamente com dados do Businessmap através da nossa API v2 mais recente. O conector Businessmap pode ser usado para refletir alterações em ferramentas externas dentro de seus cartões Kanban ou para ler dados do Businessmap e usá-los em conectores de terceiros. Visite a seção de integrações em nossa base de conhecimento para obter alguns exemplos reais sobre como usar o conector.
Pré-requisitos
- Para usar esse conector, você precisa de uma conta de mapa de negócios e um usuário com permissões para acessar a API. Sign-Up aqui e criar e conta para experimentá-lo.
Como obter credenciais
Você pode encontrar sua chave de API dentro do menu "API" no seu perfil.
Introdução ao conector
O conector tem um gatilho que é geral e lida com todos os eventos. Defina esse gatilho como a primeira etapa do seu fluxo quando quiser receber eventos do Businessmap. Sua próxima ação deve ser uma verificação de "Condição", onde você adicionará um filtro em "evento" e prosseguirá 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 irão disparar o gatilho. O próximo passo geralmente será "Obter cartão por ID", ele obterá todos os detalhes do cartão e você poderá usar e operar esses dados no fluxo que se segue.
Problemas conhecidos e limitações
Certos limites são aplicados para garantir que o produto e nossas APIs estejam funcionando da forma mais suave 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ê tem que esperar antes de poder enviar sua próxima solicitação. Todos os outros erros têm mensagens que explicam o motivo exato do erro.
FAQ
Temos uma extensa seção da Base de Conhecimento e, se você tiver alguma dúvida para a qual não consiga encontrar a resposta, entre em contato conosco e teremos prazer em ajudar.
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 (de caracteres) | Especifique o subdomínio da sua conta Businessmap | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de 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. Por favor, use Adicionar comentário em vez disso.
|
| Arquivar ou desarquivar cartão |
Adicione o cartão ao arquivo ou extraia-o do arquivo. |
| Atualizar cartão |
Atualize as propriedades de um cartão (Título, Descrição, Prioridade, etc.). Se o tempo limite ou o limite da API atingirem erros, tente dividir a configuração de campos personalizados, adesivos e tags em ações separadas. |
| Baixar anexo |
Transfira um anexo a partir 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) [DEPRECATED] |
(Preterido) Bloqueie, desbloqueie ou edite motivos de bloqueio para um cartão. |
| Carregar anexo |
Carregue um anexo para um cartão. |
| Cartão de Arquivo (preterido) [PRETERIDO] |
Esta ação foi preterida. Por favor, use Archive ou Unarchive Card em vez disso.
|
| 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 num quadro à sua escolha. Para definir campos personalizados, adesivos e tags use em combinação com "Atualizar cartão". |
| Criar cartão (preterido) [PRETERIDO] |
Esta ação foi preterida. Por favor, use Criar cartão em vez disso.
|
| Criar subtarefa |
Crie uma nova subtarefa de um cartão ou iniciativa. |
| Criar Subtarefa (preterido) [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Criar Subtarefa .
|
| Definir ou desdefinir adesivos |
Adicionar autocolante a um cartão ou remover autocolante atribuído de um cartão |
| Definir ou desdefinir tags |
Adicionar etiqueta(s) a um cartão ou remover etiqueta(s) atribuída(s) de um cartão |
| Definir valor de campo personalizado |
Defina o valor de um campo personalizado. |
| Desbloqueie o 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. |
| Mover Cartão |
Mova um cartão para uma nova coluna, faixa, fluxo de trabalho ou quadro. |
| Mover cartão (preterido) [PRETERIDO] |
Esta ação foi preterida. Por favor, use Move Card em vez disso.
|
| Obter anexos de cartão |
Obtenha uma lista com todos os anexos de um cartão especificado. |
| Obter Cartão por ID |
Obtenha os detalhes do cartão através do seu ID interno. |
| Obter cartão por ID (preterido) [PRETERIDO] |
Esta ação foi preterida. Por favor, use Get Card by ID em vez disso.
|
| Obter cartão por ID personalizado |
Encontre o cartão por ID de cartão personalizado. Se forem encontrados vários cartões, apenas o primeiro será devolvido. Use o parâmetro 'Board' para filtrar a pesquisa por placas. |
| Obter colunas da placa (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 pistas (preterido) [PRETERIDO] |
Esta ação foi preterida. Por favor, use Get Lanes em vez disso.
|
| Obter placas (preterido) [DEPRECATED] |
Esta ação foi preterida. Por favor, use Get Boards em vez disso.
|
| Obter tipos (preterido) [DEPRECATED] |
Esta ação foi preterida. Por favor, use Get Types em vez disso.
|
| 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. Por favor, use Obter todos os cartões em vez disso.
|
| Obter {Object} Nome |
Obtenha o nome de um objeto com base em sua ID. Função auxiliar usada quando você deseja obter o nome do quadro, fluxo de trabalho, coluna, etc. com base em seu ID |
| Tempo de log (número de segundos) (preterido) [PRETERIDO] |
Esta ação foi preterida. Em vez disso, utilize o Log Time .
|
| Tempo de registo |
Registre o tempo em um cartão. |
Adicionar comentário
Adicione um comentário a um cartão ou iniciativa.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação do cartão
|
card_id | True | integer |
Introduza o ID do Cartão |
|
Comment
|
text | True | string |
Comment |
Adicionar comentário (preterido) [PRETERIDO]
Esta ação foi preterida. Por favor, use Adicionar comentário em vez disso.
(Preterido) Adiciona um comentário a um cartão ou iniciativa.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tipo de conteúdo
|
Content-Type | True | string |
Use sempre: application/json |
|
Tipo de conteúdo
|
Accept | True | string |
Use sempre: application/json |
|
Identificação do cartão
|
taskid | string |
Identificação do cartão |
|
|
Comment
|
comment | string |
comentário |
Arquivar ou desarquivar cartão
Adicione o cartão ao arquivo ou extraia-o do arquivo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação do cartão
|
card_id | True | integer |
Introduza o 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 da API atingirem erros, tente dividir a configuração de campos personalizados, adesivos e tags em ações separadas.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação do cartão
|
card_id | True | integer |
Introduza o ID do Cartão |
|
Placa
|
board_id | True | integer |
O quadro deve ser selecionado a partir da 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 |
Selecione Coluna ou insira o nome ou ID da coluna como um valor personalizado |
||
|
Faixa de rodagem
|
lane_id |
Selecione Lane ou Digite o nome ou ID da pista como um valor personalizado |
||
|
Title
|
title | string |
Título do cartão |
|
|
Description
|
description | string |
Descrição do Cartão |
|
|
ID personalizado
|
custom_id | string |
ID personalizado |
|
|
Proprietário
|
owner_user_id | integer |
Selecione o proprietário do cartão |
|
|
Tipo
|
type_id | integer |
Selecione o tipo de cartão |
|
|
Tamanho do cartão
|
size | double |
Tamanho do cartão |
|
|
Priority
|
priority | integer |
Selecione Prioridade |
|
|
Cor
|
color | string |
Cor (Hex, por exemplo, #000000) |
|
|
Deadline
|
deadline | string |
Prazo (Formato: AAAA-MM-DD) |
|
|
Data de início prevista
|
planned_start_date | string |
Data prevista de início (formato: AAAA-MM-DD) (apenas iniciativas) |
|
|
Data de Fim Prevista
|
planned_end_date | string |
Data de conclusão prevista (formato: AAAA-MM-DD) (apenas iniciativas) |
|
|
Hora de início real
|
actual_start_time | string |
Hora real de início (formato: AAAA-MM-DDTHH:mm:ssZ) (apenas iniciativas) |
|
|
Hora de Fim Real
|
actual_end_time | string |
Hora real de fim (formato: AAAA-MM-DDTHH:mm:ssZ) (apenas iniciativas) |
|
|
Autocolantes
|
stickers | string |
Selecione adesivos ou adicione-os como texto separado por vírgula |
|
|
Etiquetas
|
tags | string |
Selecione tags ou adicione-as como texto separado por vírgula |
|
|
Nome
|
field_id | integer |
Selecionar campo personalizado |
|
|
Valor
|
value | string |
Valor do campo personalizado |
Devoluções
- Body
- getCardResponse
Baixar anexo
Transfira um anexo a partir de um cartão. O conteúdo do arquivo é retornado como cadeia de caracteres codificada em base64.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação do cartão
|
card_id | True | integer |
Introduza o ID do Cartão |
|
Nome do ficheiro
|
attachment_id | True | integer |
Selecione Anexo ou insira ID do Anexo em Obter Anexos de Cartão |
Devoluções
Bloquear Cartão
Bloquear um cartão.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Placa
|
board_id | True | integer |
O quadro deve ser selecionado a partir da lista suspensa |
|
Identificação do cartão
|
card_id | True | integer |
Introduza o ID do Cartão |
|
Motivo do bloqueio
|
reason_id | True | string |
Selecione Bloquear Motivo |
|
Comment
|
comment | string |
Adicionar comentário ao motivo do bloqueio |
Bloquear ou desbloquear cartão (preterido) [DEPRECATED]
(Preterido) Bloqueie, desbloqueie ou edite motivos de bloqueio para um cartão.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
boardid | True | string |
Selecionar quadro na lista suspensa |
|
Identificação do cartão
|
taskid | True | string |
Identificação do cartão |
|
Tipo de Evento
|
event | True | string | |
|
Motivo do bloqueio
|
blockreason | string |
Motivo do bloqueio |
Carregar anexo
Carregue um anexo para um cartão.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação do cartão
|
card_id | True | integer |
Introduza o ID do Cartão |
|
Nome do arquivo
|
file_name | True | string |
Insira o nome do arquivo |
|
Content
|
content | True | binary |
Fornecer conteúdo de arquivo (base64) |
Devoluções
Cartão de Arquivo (preterido) [PRETERIDO]
Esta ação foi preterida. Por favor, use Archive ou Unarchive Card em vez disso.
(Preterido) Mova o cartão para o arquivo. O cartão não deve ser bloqueado e deve estar na coluna Concluído ou na coluna Arquivo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação do cartão
|
cardid | True | string |
Identificação 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) Atualizar as propriedades de um cartão (Título, Descrição, Prioridade, etc.)
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tipo de conteúdo
|
Content-Type | True | string |
Sempre definido para: application/json |
|
Aceitar
|
Accept | True | string |
Sempre definido para: application/json |
|
ID da placa
|
boardid | integer |
Selecionar quadro na lista suspensa |
|
|
Identificação do cartão
|
taskid | integer |
Identificação do cartão |
|
|
Title
|
title | string |
title |
|
|
Description
|
description | string |
Detalhes do cartão |
|
|
Priority
|
priority | string | ||
|
Cessionário
|
assignee | string |
Nome de utilizador do cessionário |
|
|
Cor
|
color | string |
código de cores hexadecimais como este #F37325 |
|
|
Tamanho
|
size | integer |
size |
|
|
Etiquetas
|
tags | string |
várias tags devem ser separadas com espaço |
|
|
Campos personalizados
|
cfields | string |
Lista formatada em JSON de campos personalizados e seus valores {"field1":"value1","field2":"value2"} |
|
|
Deadline
|
deadline | string |
data limite neste formato: AAAA-MM-DD |
|
|
Link externo
|
extlink | string |
Ligação externa |
|
|
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
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação do cartão
|
card_id | True | integer |
Introduza o ID do Cartão |
|
Será vinculado como
|
link_type | True | string |
Selecione o tipo de link |
|
Para o 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 num quadro à sua escolha. Para definir campos personalizados, adesivos e tags use em combinação com "Atualizar cartão".
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Placa
|
board_id | True | integer |
O quadro deve ser selecionado a partir da 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 |
Selecione Coluna ou insira o nome ou ID da coluna como um valor personalizado |
|
|
Faixa de rodagem
|
lane_id | True |
Selecione Lane ou Digite o nome ou ID da pista como um valor personalizado |
|
|
Title
|
title | True | string |
Título do cartão |
|
Description
|
description | string |
Descrição do Cartão |
|
|
ID personalizado
|
custom_id | string |
ID do cartão personalizado |
|
|
Proprietário
|
owner_user_id | integer |
Selecione o proprietário do cartão |
|
|
Usuário Repórter
|
reporter_user_id | integer |
Selecionar repórter de usuários do Businessmap |
|
|
E-mail do repórter
|
reporter_email | string |
Digite o endereço de e-mail do Reporter, somente se nenhum usuário estiver selecionado acima |
|
|
Tipo
|
type_id | integer |
Selecione o tipo de cartão |
|
|
Tamanho do cartão
|
size | double |
Tamanho do cartão |
|
|
Priority
|
priority | integer |
Selecione Prioridade |
|
|
Cor
|
color | string |
Cor (Hex, por exemplo, #000000) |
|
|
Deadline
|
deadline | string |
Prazo (Formato: AAAA-MM-DD) |
|
|
Data de início prevista
|
planned_start_date | string |
Data prevista de início (formato: AAAA-MM-DD) (apenas iniciativas) |
|
|
Data de Fim Prevista
|
planned_end_date | string |
Data de conclusão prevista (formato: AAAA-MM-DD) (apenas iniciativas) |
|
|
Hora de início real
|
actual_start_time | string |
Hora real de início (formato: AAAA-MM-DDTHH:mm:ssZ) (apenas iniciativas) |
|
|
Hora de Fim Real
|
actual_end_time | string |
Hora real de fim (formato: AAAA-MM-DDTHH:mm:ssZ) (apenas iniciativas) |
Devoluções
- Body
- getCardResponse
Criar cartão (preterido) [PRETERIDO]
Esta ação foi preterida. Por favor, use Criar cartão em vez disso.
(Preterido) Crie um cartão num quadro à sua escolha.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tipo de conteúdo
|
Content-Type | string |
Use sempre: application/json |
|
|
Tipo de conteúdo
|
Accept | string |
Use sempre: 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 |
|
|
Cessionário
|
assignee | string |
Nome de utilizador do cessionário |
|
|
Cor
|
color | string |
código de cores hexadecimais como este #F37325 |
|
|
Tamanho
|
size | string |
size |
|
|
Etiquetas
|
tags | string |
várias tags devem ser separadas com espaço |
|
|
Campos personalizados
|
cfields | string |
Lista formatada em JSON de campos personalizados e seus valores {"field1":"value1","field2":"value2"} |
|
|
Deadline
|
deadline | string |
data limite neste formato: AAAA-MM-DD |
|
|
Link externo
|
extlink | string |
Ligação externa |
|
|
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 pretende aplicar |
|
|
Nome da coluna
|
column | string |
Nome exato da coluna |
|
|
Faixa de rodagem
|
lane | string |
Nome da pista |
|
|
Position
|
position | string |
Posição do cartão na coluna |
|
|
Excesso de razão
|
exceedingreason | string |
razão excessiva |
Criar subtarefa
Crie uma nova subtarefa de um cartão ou iniciativa.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Placa
|
board_id | True | integer |
O quadro deve ser selecionado a partir da lista suspensa |
|
Identificação do cartão
|
card_id | True | integer |
Introduza o ID do Cartão |
|
Description
|
description | True | string |
Descrição da subtarefa |
|
Proprietário
|
owner_user_id | string |
Selecionar utilizador |
|
|
Status da subtarefa
|
is_finished | integer |
Selecionar Status da Subtarefa |
Criar Subtarefa (preterido) [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
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tipo de conteúdo
|
Content-Type | True | string |
Use sempre: application/json |
|
Tipo de conteúdo
|
Accept | True | string |
Use sempre: application/json |
|
ID do cartão dos pais
|
taskparent | integer |
Identificação do cartão de progenitor |
|
|
Title
|
title | string |
title |
|
|
Cessionário
|
assignee | string |
Nome de utilizador do cessionário |
Definir ou desdefinir adesivos
Adicionar autocolante a um cartão ou remover autocolante atribuído de um cartão
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação do cartão
|
card_id | True | integer |
Introduza o ID do Cartão |
|
Placa
|
board_id | True | integer |
O quadro deve ser selecionado a partir da lista suspensa |
|
Ação
|
action | True | string |
Opte por definir ou desconfigurar autocolantes |
|
Autocolantes
|
stickers | True | string |
Selecione um único adesivo na lista suspensa ou insira vários adesivos separados por uma vírgula |
|
Se o adesivo estiver faltando
|
missing_stickers | integer |
Selecione o comportamento desejado quando um adesivo estiver faltando |
Definir ou desdefinir tags
Adicionar etiqueta(s) a um cartão ou remover etiqueta(s) atribuída(s) de um cartão
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação do cartão
|
card_id | True | integer |
Introduza o ID do Cartão |
|
Placa
|
board_id | True | integer |
O quadro deve ser selecionado a partir da lista suspensa |
|
Ação
|
action | True | string |
Optar por definir ou desdefinir etiquetas |
|
Etiquetas
|
tags | True | string |
Selecione uma única tag na lista suspensa ou insira várias tags separadas por vírgula |
|
Se a tag estiver ausente
|
missing_tags | integer |
Selecionar o comportamento desejado quando uma tag está ausente |
Definir valor de campo personalizado
Defina o valor de um campo personalizado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação do cartão
|
card_id | True | integer |
Introduza o ID do Cartão |
|
ID da placa
|
board_id | True | integer |
O quadro deve ser selecionado a partir da lista suspensa |
|
Nome do campo
|
field_id | True | integer |
Selecionar campo personalizado |
|
Valor
|
values | True | string |
Selecionar a partir da lista pendente ou introduzir valores personalizados separados por vírgula |
Desbloqueie o cartão
Desbloqueie um cartão.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação do cartão
|
card_id | True | integer |
Introduza o ID do Cartão |
Descartar ou restaurar cartão
Descarte um cartão ou restaure um cartão descartado anteriormente.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação do cartão
|
card_id | True | integer |
Introduza o 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
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Desvincular o ID do cartão
|
card_id | True | integer |
Introduza o ID do Cartão |
|
Ligado como
|
link_type | True | string |
Selecione o tipo de link |
|
Para o ID do cartão
|
linked_card_id | True | integer |
Insira o ID do cartão vinculado |
Excluir cartão (preterido) [PRETERIDO]
(Preterido) Excluir um cartão.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
boardid | True | string |
Selecionar quadro na lista suspensa |
|
Identificação do cartão
|
taskid | True | string |
Identificação do cartão |
Mover Cartão
Mova um cartão para uma nova coluna, faixa, fluxo de trabalho ou quadro.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação do cartão
|
card_id | True | integer |
Introduza o ID do Cartão |
|
Placa
|
board_id | True | integer |
O quadro deve ser selecionado a partir da lista suspensa |
|
Workflow
|
workflow_id | True | integer |
O fluxo de trabalho deve ser selecionado na lista suspensa |
|
Coluna
|
column_id | True |
Selecione Coluna ou insira o nome ou ID da coluna como um valor personalizado |
|
|
Faixa de rodagem
|
lane_id | True |
Selecione Lane ou Digite o nome ou ID da pista como um valor personalizado |
Mover cartão (preterido) [PRETERIDO]
Esta ação foi preterida. Por favor, use Move Card em vez disso.
(Preterido) Mova um cartão (Tarefa ou Iniciativa, se possível) para uma coluna.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tipo de conteúdo
|
Content-Type | True | string |
Use sempre: application/json |
|
Tipo de conteúdo
|
Accept | True | string |
Use sempre: application/json |
|
Identificação do cartão
|
taskid | string |
Identificação do cartão |
|
|
ID da placa
|
boardid | True | string |
ID da placa |
|
Coluna
|
column | string |
nome da coluna |
|
|
Faixa de rodagem
|
lane | string |
Nome da pista |
|
|
Position
|
position | string |
Posição do cartão na coluna |
|
|
Excesso de razão
|
exceedingreason | string |
razão excessiva |
Obter anexos de cartão
Obtenha uma lista com todos os anexos de um cartão especificado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação do cartão
|
card_id | True | integer |
Introduza o ID do Cartão |
Devoluções
Obter Cartão por ID
Obtenha os detalhes do cartão através do seu ID interno.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação do cartão
|
card_id | True | integer |
Introduza o ID do Cartão |
Devoluções
- Body
- getCardResponse
Obter cartão por ID (preterido) [PRETERIDO]
Esta ação foi preterida. Por favor, use Get Card by ID em vez disso.
(Preterido) Obter cartão pelo seu ID
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
boardid | True | string |
Selecionar quadro na lista suspensa |
|
Identificação do cartão
|
taskid | True | string |
Identificação do cartão |
|
Obter Histórico
|
history | string |
Defina como 'Sim' se quiser obter o histórico do cartão |
|
|
Receba comentários
|
comments | string |
Defina como 'Sim' se quiser receber comentários do cartão |
|
|
Formato de texto
|
textformat | string |
formato de texto retornado para a descrição do cartão |
Devoluções
| Name | 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 |
|
detentor
|
assignee | string |
detentor |
|
subtarefas
|
subtasks | string |
subtarefas |
|
subtarefasconcluir
|
subtaskscomplete | string |
subtarefasconcluir |
|
color
|
color | string |
color |
|
priority
|
priority | string |
priority |
|
size
|
size | string |
size |
|
Prazo
|
deadline | string |
Prazo |
|
deadlineformato original
|
deadlineoriginalformat | string |
deadlineformato original |
|
extlink
|
extlink | string |
extlink |
|
tags
|
tags | string |
tags |
|
prazo de entrega
|
leadtime | integer |
prazo de entrega |
|
bloqueado
|
blocked | string |
bloqueado |
|
razão bloqueada
|
blockedreason | string |
razão bloqueada |
|
nome da coluna
|
columnname | string |
nome da coluna |
|
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 |
|
nome_do_cliente
|
attachments.FXPR1VE0LIC9.clientName | string |
nome_do_cliente |
|
uniqueName
|
attachments.FXPR1VE0LIC9.uniqueName | string |
uniqueName |
|
tamanho do ficheiro
|
attachments.FXPR1VE0LIC9.fileSize | float |
tamanho do ficheiro |
|
fileType
|
attachments.FXPR1VE0LIC9.fileType | string |
fileType |
|
estado
|
attachments.FXPR1VE0LIC9.status | string |
estado |
|
URL
|
attachments.0XC7C1PRR9ZK.url | string |
URL |
|
nome_do_cliente
|
attachments.0XC7C1PRR9ZK.clientName | string |
nome_do_cliente |
|
uniqueName
|
attachments.0XC7C1PRR9ZK.uniqueName | string |
uniqueName |
|
tamanho do ficheiro
|
attachments.0XC7C1PRR9ZK.fileSize | float |
tamanho do ficheiro |
|
fileType
|
attachments.0XC7C1PRR9ZK.fileType | string |
fileType |
|
estado
|
attachments.0XC7C1PRR9ZK.status | string |
estado |
|
columnpath
|
columnpath | string |
columnpath |
|
repórter
|
reporter | string |
repórter |
|
Campos Personalizados
|
customfields | array of object |
Campos Personalizados |
|
ID de campo
|
customfields.fieldid | integer |
ID de campo |
|
nome
|
customfields.name | string |
nome |
|
tipo
|
customfields.type | string |
tipo |
|
valor
|
customfields.value | string |
valor |
|
obrigatório
|
customfields.mandatory | boolean |
obrigatório |
|
imutável
|
customfields.immutable | boolean |
imutável |
|
atualizadoem
|
updatedat | string |
atualizadoem |
|
LoggedTime
|
loggedtime | integer |
LoggedTime |
|
históriadetalhes
|
historydetails | array of object |
históriadetalhes |
|
tipo de evento
|
historydetails.eventtype | string |
tipo de evento |
|
históriaevento
|
historydetails.historyevent | string |
históriaevento |
|
TaskID
|
historydetails.taskid | string |
TaskID |
|
details
|
historydetails.details | string |
details |
|
autor
|
historydetails.author | string |
autor |
|
data de entrada
|
historydetails.entrydate | string |
data de entrada |
|
historyid
|
historydetails.historyid | string |
historyid |
|
comments
|
comments | array of |
comments |
Obter cartão por ID personalizado
Encontre o cartão por ID de cartão personalizado. Se forem encontrados vários cartões, apenas o primeiro será devolvido. Use o parâmetro 'Board' para filtrar a pesquisa por placas.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do cartão personalizado
|
custom_ids | True | string |
Insira IDs personalizados |
|
Placa
|
board_ids | integer |
O quadro deve ser selecionado a partir da lista suspensa |
Devoluções
- Body
- getCardResponse
Obter colunas da placa (preterido) [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Obter Colunas .
(Preterido) Obtenha todas as colunas para um quadro especificado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
board_id | True | string |
O quadro para obter as colunas. |
Devoluções
| Name | 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
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
board_id | True | string |
Placa |
Devoluções
| Name | 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 pistas (preterido) [PRETERIDO]
Esta ação foi preterida. Por favor, use Get Lanes em vez disso.
(Preterido) Obtém todas as pistas para uma placa especificada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
board_id | True | string |
A placa para obter as pistas para. |
Devoluções
| Name | 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 |
Obter placas (preterido) [DEPRECATED]
Esta ação foi preterida. Por favor, use Get Boards em vez disso.
(Preterido) Obtenha todos os quadros da conta.
Devoluções
| Name | 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 |
Obter tipos (preterido) [DEPRECATED]
Esta ação foi preterida. Por favor, use Get Types em vez disso.
(Preterido) Obtém todos os tipos dentro da conta.
Devoluções
| Name | 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
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Placa
|
board_ids | True | integer |
O quadro deve ser selecionado a partir da lista suspensa |
|
IDs de cartão personalizados
|
custom_ids | array |
Insira IDs personalizados |
|
|
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. |
Devoluções
- Body
- getAllCardsResponse
Obter todos os cartões (preterido) [PRETERIDO]
Esta ação foi preterida. Por favor, use Obter todos os cartões em vez disso.
(Preterido) Obtenha todos os cartões de um determinado quadro.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
boardid | True | string |
Selecionar quadro na lista suspensa |
Obter {Object} Nome
Obtenha o nome de um objeto com base em sua ID. Função auxiliar usada quando você deseja obter o nome do quadro, fluxo de trabalho, coluna, etc. com base em seu ID
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Placa
|
board_id | True | integer |
O quadro deve ser selecionado a partir da lista suspensa |
|
Item
|
item | True | string |
Selecionar tipo de objeto |
|
ID
|
id | True | integer |
Inserir ID do objeto |
Devoluções
Tempo de log (número de segundos) (preterido) [PRETERIDO]
Esta ação foi preterida. Em vez disso, utilize o Log Time .
(Preterido) Registre o tempo em um cartão. O tempo é registrado em segundos.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tipo de conteúdo
|
Content-Type | True | string |
Use sempre: application/json |
|
Tipo de conteúdo
|
Accept | True | string |
Use sempre: application/json |
|
Identificação do cartão
|
card_id | string |
ID do cartão interno |
|
|
Time
|
time | string |
Tempo em segundos |
|
|
Comment
|
comment | string |
Comment |
Tempo de registo
Registre o tempo em um cartão.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação 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 |
Acionadores
| Gatilho Geral |
Gatilhos para qualquer ação no quadro. Use Control/Condition ou Control/Switch para gerenciar o fluxo para diferentes gatilhos. Aqui está uma lista parcial de tipos de eventos suportados: "Cartão criado", "Cartão movido", "Detalhes do cartão alterados", "Cartão excluído", "Cartão bloqueado" \n\n Seu próximo passo após o gatilho deve ser "Obter cartão por ID" para que você possa obter todos os detalhes do cartão \n\nUse Control/Condition na ID do autor em integrações bidirecionais para evitar loops |
Gatilho Geral
Gatilhos para qualquer ação no quadro. Use Control/Condition ou Control/Switch para gerenciar o fluxo para diferentes gatilhos. Aqui está uma lista parcial de tipos de eventos suportados: "Cartão criado", "Cartão movido", "Detalhes do cartão alterados", "Cartão excluído", "Cartão bloqueado" \n\n Seu próximo passo após o gatilho deve ser "Obter cartão por ID" para que você possa obter todos os detalhes do cartão \n\nUse Control/Condition na ID do autor em integrações bidirecionais para evitar loops
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da placa
|
board_id | True | string |
Selecionar quadro |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Companhia
|
company | string |
Companhia |
|
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
baixarAttachmentResponse
| Name | 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
| Name | 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 | |
|
Identificação 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 |
|
Identificação da placa
|
data.data.board_id | integer |
Cartão de identificação do cartão |
|
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 de 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 |
Secção ID do cartão |
|
ID da coluna
|
data.data.column_id | integer |
ID da coluna do cartão |
|
Identificação da faixa de rodagem
|
data.data.lane_id | integer |
Identificação da faixa de rodagem do cartão |
getCardAttachmentsResponse
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of object |
dados |
|
id
|
data.id | integer |
ID do anexo do cartão |
|
nome_do_ficheiro
|
data.file_name | string |
Nome do arquivo de anexo do cartão |
|
ligação
|
data.link | string |
Link de anexo do cartão |
getCardResponse
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Identificação 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 |
|
Identificação da placa
|
data.board_id | integer |
Cartão de identificação do cartão |
|
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 de 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 |
Secção ID do cartão |
|
ID da coluna
|
data.column_id | integer |
ID da coluna do cartão |
|
Identificação da faixa de rodagem
|
data.lane_id | integer |
A identificação da faixa de rodagem 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 |
|
Deadline
|
data.deadline | string |
Prazo do cartão |
|
Tipo
|
data.reporter.type | string |
Tipo de valor. Pode ser interno ou externo |
|
Jornalista
|
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 |
|
Bloqueado
|
data.is_blocked | integer |
Booleano, 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 de campo personalizado |
|
Nome do campo
|
data.custom_fields.name | string |
Nome do campo personalizado |
|
Valor de Campo
|
data.custom_fields.value |
Valor do campo personalizado |
|
|
Valor de exibição de campo
|
data.custom_fields.display_value |
Exibir 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 de Campo
|
data.custom_fields.values.value |
Valor do campo personalizado |
getObjectNameResponse
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
nome
|
data.name | string |
Nome |
uploadAttachmentResponse
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of object |
dados |
|
Identificação do cartão
|
data.card_id | integer |
ID do cartão interno |
|
Nome do arquivo
|
data.file_name | string |
Nome do ficheiro a carregar |