Pular para as operações

Produtividade

Linear em um fluxo de decisão.

8 Linear 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 ou OAuth 2.0
Ambiente de teste
Somente host de produção

Quem são

Gestão de issues e planejamento de produto para times de software.

A Linear é um sistema de gestão de issues e planejamento de produto organizado em torno de times, projetos e ciclos. Times de software a usam para transformar decisões de produto e relatos de clientes em trabalho atribuído e acompanhar esse trabalho por um fluxo definido. Sua API é GraphQL, e o acesso pode agir como o dono de uma chave de API pessoal ou como a pessoa que autorizou um aplicativo OAuth.

O que um fluxo pode chamar

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

  1. POST/

    Verificar conexão

    Retorna a pessoa da Linear que possui esta chave de API ou autorizou a conexão OAuth.

  2. POST/

    Criar uma issue

    Defina data.linear_issue_create como um objeto com uma propriedade input.

  3. POST/

    Buscar uma issue

    Defina data.linear_issue_lookup como { issueId }, usando um UUID da Linear ou um identificador como ENG-123.

  4. POST/

    Listar issues

    Retorna as primeiras 50 issues visíveis para a conexão.

  5. POST/

    Atualizar uma issue

    Defina data.linear_issue_update como { issueId, input }.

  6. POST/

    Excluir uma issue

    Defina data.linear_issue_delete como { issueId }. Isso exclui permanentemente a issue selecionada na Linear.

  7. POST/

    Adicionar um link a uma issue

    Defina data.linear_issue_link como { issueId, url }. A Linear adiciona a URL como um anexo da issue.

  8. POST/

    Adicionar um comentário ou resposta

    Defina data.linear_comment como { input }, em que input contém issueId e body.

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 Linear 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 Linear as a connection authenticating with an API key or OAuth 2.0.
  • 02A Linear 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 — “Verificar conexão” 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 Linear em um fluxo.

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

Adicione a Linear como uma conexão no seu workspace, autenticando com uma chave de API ou OAuth 2.0, 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 Linear em uma decisão sem nunca ver o segredo.

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

A Linear 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 Linear?

8 operações, incluindo “Verificar conexão”, “Criar uma issue”, “Buscar uma issue”. 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 “Verificar conexão”. 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 Linear 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 Linear 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