Pular para as operações

Produtividade

Trello em um fluxo de decisão.

4 Trello operations a decision flow can call directly, with the credentials your own contract issued. The response is data the rest of the flow reads, branches on, and keeps in the trace.

Categoria
Produtividade
Tipo
Integração
Autenticação
Chave de API
Ambiente de teste
Somente host de produção

Quem são

Kanban boards for team work, from Atlassian.

Trello organizes work as cards on lists on a board, and a team moves each card from list to list as the work advances. Atlassian owns it. Its REST API reads boards, cards and the history of each card, and it can move a card or add a comment as the user who approved the token.

O que um fluxo pode chamar

4 operações, cada uma um passo que você coloca no editor.

  1. GET/boards/$data.trello_board_id/cards?token={token}

    List the cards of a board

    Returns the open cards of one board. Set data.trello_board_id to the board ID.

  2. GET/cards/$data.trello_card_id/actions?filter=updateCard:idList&token={token}

    Get the moves of a card

    Returns the actions of one card that moved it to a different list.

  3. PUT/cards/$data.trello_card_id?token={token}

    Move a card to a list

    Moves one card to a different list. Set data.trello_card_id to the card ID and data.trello_list_id to the ID of the destination list.

  4. POST/cards/$data.trello_card_id/actions/comments?token={token}

    Add a comment to a card

    Adds a comment to one card. Set data.trello_card_id to the card ID and data.trello_comment to the comment text.

Onde isso entra na decisão

Productivity calls have a natural place in a flow.

O trabalho operacional começa onde a decisão termina. Criar uma issue, anexar suas evidências e manter seu estado atualizado pelo fluxo dá ao time um registro durável do que foi decidido e do que precisa acontecer depois, sem uma segunda cópia se perder na passagem.

Whatever Trello returns is part of the run, so it is part of the record. When someone asks months later why an applicant was declined, the answer cites what came back at the time rather than re-fetching from a service whose answer has since changed.

  • 01Add Trello as a connection authenticating with an API key.
  • 02A Trello tem um host só para os dois ambientes, então proteja as execuções de teste com credenciais e limites seus.
  • 03Coloque um nó de Conexão e escolha uma operação — “List the cards of a board” costuma ser a primeira de que um fluxo precisa.
  • 04Mapeie a resposta nos campos que suas regras leem e depois teste o caminho inteiro antes de ele receber tráfego de produção.

Perguntas frequentes

Usando a Trello em um fluxo.

Como conecto a Trello a um fluxo de decisão?

Adicione a Trello como uma conexão no seu workspace, autenticando com uma chave de API, com as credenciais que o seu próprio contrato emitiu — a ArboRule chama o provedor no seu lugar e nunca assume um contrato por você. Depois que a conexão existe, qualquer fluxo do workspace pode colocar um nó de Conexão e escolher uma das operações dela. As credenciais ficam na conexão, não no fluxo, então quem cuida da política usa a Trello em uma decisão sem nunca ver o segredo.

Dá para testar a Trello sem tocar em produção?

A Trello expõe um host só para os dois ambientes, então não existe um sandbox separado para apontar. As execuções de teste continuam rodando no Sandbox e ficam registradas à parte no histórico de decisões, mas a chamada vai para o mesmo lugar que a de produção — então proteja isso com credenciais de teste, limites de taxa ou dados seus.

O que um fluxo pode chamar na Trello?

4 operações, incluindo “List the cards of a board”, “Get the moves of a card”, “Move a card to a list”. Cada uma é um passo que você coloca no editor e mapeia nos campos que suas regras leem, e a maioria dos fluxos começa por “List the cards of a board”. A lista vem do mesmo manifesto que o motor usa para fazer a chamada, então esta página não consegue descrever uma operação que o produto não tem.

Em que ponto de uma decisão a Trello deve ser chamada?

O trabalho operacional começa onde a decisão termina. Criar uma issue, anexar suas evidências e manter seu estado atualizado pelo fluxo dá ao time um registro durável do que foi decidido e do que precisa acontecer depois, sem uma segunda cópia se perder na passagem.

Quando você quiser

Wire Trello into a real decision.

Monte o fluxo no Sandbox, conecte sua conta e veja a decisão buscar o que precisa antes de responder.

Leia a documentação