Módulos de placas Adobe Workfront

NOTE
O conector de fusão de placas está em status beta. Como resultado, o suporte para este conector é limitado e pode mudar devido ao desenvolvimento futuro das placas. Além disso, pode haver alterações na API do GraphQL sem aviso prévio que podem afetar o processo do conector Fusion.

As placas Adobe Workfront são ferramentas flexíveis que permitem a colaboração em equipe, fornecendo acesso a uma placa compartilhada que contém colunas e cartões.

Você pode usar os módulos Quadros Adobe Workfront para ler ou atualizar registros, fazer uma chamada de API para a API Quadros Workfront ou acionar um cenário quando uma ação ocorre em um quadro.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso para a funcionalidade neste artigo.

Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront Qualquer
Licença do Adobe Workfront

Novo: Padrão

Ou

Atual: trabalho ou superior

Licença do Adobe Workfront Fusion**

Atual: nenhum requisito de licença do Workfront Fusion

Ou

Herdados: Automação e integração do Workfront Fusion for Work

Produto

Novo menu:

  • Selecionar ou pacote do Prime Workfront: sua organização deve comprar o Adobe Workfront Fusion.
  • Pacote do Ultimate Workfront: o Workfront Fusion está incluído.

Ou

Atual: sua organização deve comprar o Adobe Workfront Fusion.

Para obter mais detalhes sobre as informações nesta tabela, consulte Requisitos de acesso na documentação.

Para obter informações sobre licenças do Adobe Workfront Fusion, consulte licenças do Adobe Workfront Fusion.

Pré-requisitos

Você deve ter configurado um quadro no Adobe Workfront antes de se conectar a ele.

Informações da API de placas Adobe Workfront

O conector das placas Adobe Workfront usa o seguinte:

Tag da API
v1.23.6

Criar uma conexão com Workfront Boards

NOTE
Você pode usar uma conexão do Workfront para se conectar a placas Workfront ou criar uma conexão separada de placas Workfront.

Para criar uma conexão com Workfront Boards:

  1. Em qualquer módulo Adobe Workfront Boards, clique em Adicionar ao lado da caixa Conexão.

  2. Preencha os seguintes campos:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
    Nome da Conexão Insira um nome para esta conexão.
    Ambiente Selecione se você está se conectando a um ambiente de produção ou não produção.
    Tipo Selecione se você deseja se conectar a uma conta de serviço ou a uma conta pessoal.

    ID do Cliente

    (Opcional)

    Insira sua Adobe ID do Cliente. Isso pode ser encontrado na seção Credentials details do Adobe Developer Console.

    Segredo do Cliente

    (Opcional)

    Insira seu Adobe Segredo do Cliente. Isso pode ser encontrado na seção Credentials details do Adobe Developer Console.

    URL de Autenticação

    (Opcional)

    Insira o URL que sua instância do Workfront usará para autenticar essa conexão.

    O valor padrão é https://oauth.my.workfront.com/integrations/oauth2.

    Prefixo de host

    Insira seu prefixo de host.

    O valor padrão é origin-.

  3. Clique em Continuar para salvar a conexão e retornar ao módulo.

Módulos de placas Adobe Workfront e seus campos

Ao configurar módulos do Workfront Boards, o Workfront Fusion exibe os campos listados abaixo. Junto com esses, campos adicionais dos Workfront Boards podem ser exibidos, dependendo de fatores como nível de acesso no aplicativo ou serviço. Um título em negrito em um módulo indica um campo obrigatório.

Se você vir o botão de mapa acima de um campo ou função, poderá usá-lo para definir variáveis e funções para esse campo. Para obter mais informações, consulte Mapear informações de um módulo para outro.

Alternância de mapa

Cartões

Adicionar item da lista de verificação

Esse módulo de ação adiciona um item de lista de verificação ao cartão especificado.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

ID do Cartão

Insira ou mapeie a ID do cartão ao qual deseja adicionar um item da lista de verificação.

Você pode encontrar a ID do cartão no URL ao visualizá-lo no Workfront.

Itens da lista de verificação
Para cada item da lista de verificação que você deseja adicionar, clique em Adicionar item, digite o nome do item da lista de verificação e selecione se o item foi concluído.

Adicionar subtarefa

Este módulo de ação adiciona uma subtarefa a um cartão em Quadros. A placa deve ser conectada. A subtarefa também é adicionada à tarefa do Workfront que o cartão representa.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

ID de cartão pai

Insira ou mapeie a ID do cartão ao qual deseja adicionar uma subtarefa.

Você pode encontrar a ID do cartão no URL ao visualizá-lo no Workfront.

ID do Quadro

Insira ou mapeie a ID do quadro que contém o cartão ao qual você deseja adicionar uma subtarefa.

Você pode encontrar a ID da placa no URL ao visualizar a placa no Workfront.

Nome
Insira ou mapeie um nome para a nova subtarefa.

Criar um cartão

Este módulo de ação cria um novo cartão em um quadro Workfront.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

ID do Quadro

Insira ou mapeie a ID do quadro ao qual você deseja adicionar um cartão.

Você pode encontrar a ID da placa no URL ao visualizar a placa no Workfront.

Identificação de Coluna

Insira ou mapeie a ID da coluna à qual deseja adicionar uma subtarefa.

Você pode encontrar a ID da coluna nas informações retornadas do módulo Leia uma placa.

Nome
Insira ou mapeie um nome para o novo cartão.

Mover uma carta

Este módulo de ação move um cartão para uma coluna diferente no mesmo quadro.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

ID do Cartão

Insira ou mapeie a ID do cartão que você deseja mover.

Você pode encontrar a ID do cartão no URL ao visualizá-lo no Workfront.

ID do Quadro

Insira ou mapeie a ID do quadro que contém o cartão que você deseja mover.

Você pode encontrar a ID da placa no URL ao visualizar a placa no Workfront.

ID da coluna de destino

Insira ou mapeie a ID da coluna para a qual deseja mover o cartão.

Você pode encontrar a ID da coluna nas informações retornadas do módulo Leia uma placa.

Para índice

Insira ou mapeie a posição que deseja que o cartão tenha na nova coluna.

A posição superior na coluna no índice 0.

Ler um cartão

Este módulo de ação recupera informações sobre um cartão específico.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

ID do Cartão

Insira ou mapeie a ID do cartão que deseja ler.

Você pode encontrar a ID do cartão no URL ao visualizá-lo no Workfront.

ID do Cartão

Insira ou mapeie a ID do quadro que contém o cartão que você deseja ler.

Você pode encontrar a ID da placa no URL ao visualizar a placa no Workfront.

Atualizar um cartão

Esse módulo de ação atualiza as informações de um cartão especificado.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

ID do Cartão

Insira ou mapeie a ID do cartão que deseja atualizar.

Você pode encontrar a ID do cartão no URL ao visualizá-lo no Workfront.

ID do Quadro

Insira ou mapeie a ID do quadro que contém o cartão que você deseja atualizar.

Você pode encontrar a ID da placa no URL ao visualizar a placa no Workfront.

Nome
Insira ou mapeie um novo nome para o cartão.
Descrição
Insira ou mapeie uma nova descrição para o cartão.
Estimativa
Insira ou mapeie uma estimativa do tempo necessário para concluir este cartão.
Data de vencimento

Insira ou mapeie a data de vencimento deste cartão.

Para obter uma lista de formatos de data e hora com suporte, consulte Coerção de tipo.

Status
Selecione um novo status para o cartão.

Quadros

Criar um quadro

Este módulo de ação cria um quadro no Workfront. Você pode especificar o tipo de quadro que deseja criar.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

Board name
Informe ou mapeie um nome para o novo quadro.
Modelo
Selecione o modelo para o tipo de quadro que deseja criar.

Ler um quadro

Esse módulo de ação retorna informações sobre um único quadro, como cartões, colunas, tags e membros do quadro.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

ID do Quadro

Informe ou mapeie o ID do quadro para o qual deseja recuperar informações.

Você pode encontrar a ID da placa no URL ao visualizar a placa no Workfront.

Colunas

Criar uma coluna

Esse módulo de ação cria uma nova coluna no quadro especificado.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

ID do Quadro

Informe ou mapeie a ID do quadro ao qual deseja adicionar uma coluna.

Você pode encontrar a ID da placa no URL ao visualizar a placa no Workfront.

Identificação de Coluna

Insira ou mapeie a ID da coluna que você deseja atualizar.

Você pode encontrar a ID da coluna nas informações retornadas do módulo Leia uma placa.

Nome da coluna
Insira ou mapeie um novo nome para a coluna.

Pesquisar uma coluna

Este módulo de pesquisa retorna informações sobre a coluna com o nome especificado.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

ID do Quadro

Informe ou mapeie a ID do quadro que contém a coluna que você deseja recuperar.

Você pode encontrar a ID da placa no URL ao visualizar a placa no Workfront.

Nome da Coluna
Insira ou mapeie o nome da coluna que deseja recuperar.

Atualizar uma coluna

Esse módulo de ação atualiza o nome ou o limite WIP da coluna especificada.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

ID do Quadro

Informe ou mapeie a ID do quadro que contém a coluna que você deseja recuperar.

Você pode encontrar a ID da placa no URL ao visualizar a placa no Workfront.

Nome da Coluna
Insira ou mapeie o nome da coluna que deseja recuperar.
Limite de WIP
Informe ou mapeie um novo limite WIP para a coluna.

Tags

Adicionar uma tag a um cartão

Esse módulo de ação adiciona uma tag a um cartão.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

ID do Cartão

Insira ou mapeie a ID do cartão ao qual deseja adicionar uma tag.

Você pode encontrar a ID do cartão no URL ao visualizá-lo no Workfront.

ID do Quadro

Insira ou mapeie a ID do quadro que contém o cartão ao qual deseja adicionar uma tag.

Você pode encontrar a ID da placa no URL ao visualizar a placa no Workfront.

ID de Marca

Insira ou mapeie a ID da tag que deseja adicionar.

Você pode encontrar a ID da tag nas informações retornadas do módulo Leia uma placa.

Criação de uma tag

Esse módulo de ação cria uma nova tag e a atribui a uma cor.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

ID do Quadro

Insira ou mapeie a ID do quadro para o qual você deseja criar uma tag.

Você pode encontrar a ID da placa no URL ao visualizar a placa no Workfront.

Marca nome
Insira ou mapeie um nome para a nova tag.
Cor da Marca
Selecione a cor para esta tag.

Comentários

Criar um comentário

Esse módulo de ação criou um comentário no cartão especificado.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

ID do Cartão

Insira ou mapeie a ID do cartão ao qual deseja adicionar um comentário.

Você pode encontrar a ID do cartão no URL ao visualizá-lo no Workfront.

Comentário
Insira ou mapeie o texto do comentário que deseja adicionar.

Ler comentários do cartão

Esse módulo de ação recupera os comentários do cartão especificado.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

ID do Cartão

Insira ou mapeie a ID do cartão para o qual deseja recuperar os comentários.

Você pode encontrar a ID do cartão no URL ao visualizá-lo no Workfront.

Limite
Insira o número máximo de comentários que você deseja que o módulo retorne em um ciclo de execução.

Outras

Fazer uma chamada de API personalizada

Esse módulo de ação faz uma chamada personalizada para a API de placas do Workfront.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

URL
Insira um caminho relativo a https://<WORKFRONT_DOMAIN>/boards-service/graphql?.
Método

Selecione o método de solicitação HTTP necessário para configurar a chamada de API. Para obter mais informações, consulte Métodos de solicitação HTTP.

Para a maioria das chamadas de quadros, o método é POST.

Cabeçalhos

Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão. Isso determina o tipo de conteúdo da solicitação.

Por exemplo, { "Content-type":"application/json-stringify()"}

Cadeia de Consulta

Adicione a consulta da chamada à API na forma de um objeto JSON padrão.

Para Workfront Boards, essa seção geralmente fica vazia.

Corpo

Adicione o conteúdo do corpo para a chamada de API na forma de um Graphql incorporado JSON

Exemplo:

Este exemplo atualiza um nome de coluna. Você pode incluir o boardId e columnId como GUIDs codificados ou mapeados de um módulo anterior.

{
 "query": "mutation { updateColumn(boardId: \"\", columnId: \"\", updateColumnInput: { name: \"\" }) { id name }}"
}

Observação:

Ao usar instruções condicionais como if em seu JSON, coloque as aspas fora da instrução condicional.

Fazer uma chamada de API do GraphQL personalizada

Esse módulo de ação faz uma solicitação GraphQL personalizada para a API de placas Workfront.

Conexão

Você pode usar uma conexão Workfront existente para se conectar a Workfront Boards, ou usar uma conexão Workfront Boards específica.

Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Criar uma conexão com Workfront Boards neste artigo.

Método
Selecione o método para esta chamada.
Consulta
Adicione a consulta da chamada à API na forma de um objeto JSON padrão.
Nome da operação
Insira um nome para esta operação. Isso pode facilitar o rastreamento e a depuração da chamada.
Fonte de dados de variáveis
Selecione se as variáveis serão de um formulário ou de uma coleção.
Variáveis
Para cada variável que você deseja adicionar, clique em Adicionar item e insira a chave e o valor da variável.
Limite
Insira ou mapeie o número máximo de registros que deseja que o módulo retorne durante cada ciclo de execução de cenário.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3