Criar um cenário de integração de prática no Adobe Workfront Fusion
Este artigo descreve como criar um cenário de integração com o Adobe Workfront Fusion. Os cenários de integração conectam aplicativos separados, permitindo que seus dados fluam por diferentes aplicativos.
Para criar um cenário de integração, sua organização deve ter uma licença do Workfront Fusion for Work Automation and Integration.
Para obter instruções sobre como criar um cenário de automação somente com o Workfront, consulte Criar um cenário de automação de prática no Adobe Workfront Fusion
Para obter mais informações sobre licenças do Workfront Fusion, consulte licenças do Adobe Workfront Fusion.
Requisitos de acesso
Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:
Para saber que plano, tipo de licença ou acesso você tem, contate o administrador do Workfront.
Para obter informações sobre Adobe Workfront Fusion licenças, consulte Adobe Workfront Fusion licenças.
Criar um cenário de prática
O papel de Adobe Workfront Fusion é automatizar seus processos para que você possa se concentrar em novas tarefas em vez de repetir as mesmas tarefas repetidamente. Ele funciona vinculando ações em e entre aplicativos e serviços para criar um cenário que transfere e transforma seus dados automaticamente. O cenário que você cria observa dados em um aplicativo ou serviço e processa esses dados para fornecer o resultado desejado.
Um cenário é composto de uma série de módulos que indicam como os dados devem ser transformados em um aplicativo ou transferidos entre aplicativos e serviços da Web.
Para explicar como criar um cenário e reforçar as práticas recomendadas à medida que você aprende a usar o Workfront Fusion, este artigo o orienta pelo processo passo a passo. Criaremos um cenário que cria um novo registro em Workfront para cada linha em uma planilha Google Sheets.
A criação de um cenário consiste em várias tarefas principais:
Escolha os aplicativos e nomeie o cenário
-
Baixe esta planilha e carregue-a no seu Google Drive para usar durante este exercício.
Ou
Crie ou encontre sua própria planilha simples do Google Sheets semelhante a esta:
-
Entre na sua conta Workfront Fusion.
-
Clique em Cenários no painel esquerdo.
note note NOTE Se você não vir o painel de navegação esquerdo ou seus ícones, clique no ícone Menu . No painel cinza Pastas que é exibido, você pode organizar seus cenários em pastas.
Na parte superior da área principal à direita, você pode ver Todos os cenários que criou, os Cenários Ativos e os Cenários Inativos e os Conceitos, que são cenários que precisam de mais trabalho para que o Workfront Fusion possa classificá-los como ativos ou inativos.
-
No painel Pastas, clique no ícone de Adicionar pasta e digite um nome como "Cenários de prática" para a sua primeira pasta.
-
Abra a pasta e clique em Criar um novo cenário no canto superior direito da página.
A landing page que é exibida permite pré-carregar todos os aplicativos que você deseja usar no cenário que você vai criar.
-
Neste exercício, pesquise e selecione o aplicativo Google Sheets.
-
Clique em Continuar no canto superior direito.
O editor de cenários exibe, contendo um módulo vazio no centro, o aplicativo Google Sheets pré-carregado e algumas opções na barra de ferramentas na parte inferior.
Quando você começar a criar um novo cenário, é uma boa ideia começar criando um nome para ele.
- Selecione o nome do espaço reservado Novo cenário no canto superior esquerdo e digite um nome como "Praticar cenário 1".
- Continue com Adicione e configure o primeiro módulo abaixo.
Adicionar e configurar o primeiro módulo
O módulo vazio com um ponto de interrogação representa o módulo acionador que você precisa adicionar. Esse módulo iniciará o cenário sempre que for executado. O ícone de relógio no módulo vazio indica que é um módulo agendado.
Este módulo conterá os dados que você deseja que o cenário observe.
-
Clique no módulo vazio para escolher o aplicativo do qual você selecionará um módulo.
O aplicativo pré-carregado anteriormente é exibido ao lado do módulo vazio. Você pode adicionar outros aplicativos que tenham módulos usando a caixa Pesquisar.
-
Clique em Google Sheets.
A lista é alterada para exibir todos os Google Sheets módulos que você pode usar como um módulo de gatilho.
-
Clique no módulo do acionador Observar Registros.
Agora é necessário estabelecer uma conexão autenticada com sua conta do Google. Cada módulo adicionado a um cenário deve ter uma conexão com seu aplicativo.
-
Na caixa Google Sheets, em Conexão, clique em Adicionar e digite um nome para a conexão, como "Conta da Google de Olivia", e clique em Continuar.
-
Autentique a conexão na janela que é exibida.
O processo para autenticar uma conexão pode variar um pouco entre os aplicativos. Talvez seja necessário fazer logon no aplicativo. Normalmente, você precisará clicar no botão Permitir. Se precisar de ajuda, consulte Visão geral das conexões.
Configurar o primeiro módulo
Após conectar o Workfront Fusion à sua conta Google Sheets, você pode especificar uma planilha Google Sheets à qual tem acesso e os dados que deseja que o primeiro módulo processe.
-
Clique na caixa Planilha e selecione a planilha cenário de prática do Workfront Fusion #1 na lista exibida.
Esta planilha contém 2 planilhas (guias), portanto, precisamos especificar qual planilha contém os dados desejados:
-
Na lista suspensa Planilha, selecione Projetos.
Nossa planilha contém cabeçalhos e queremos que o módulo os use para identificar os dados que queremos processar:
-
Deixe Sim selecionado para A tabela contém cabeçalhos.
-
Na caixa Linha com cabeçalhos, você pode especificar um intervalo de linhas que deseja incluir, mas deixe o padrão A1:Z1 aqui para este exercício.
-
Na caixa Limite, digite 1.
Dessa forma, sempre que você executar o cenário, o módulo processará apenas uma linha na planilha. Isso é útil para simplificar suas execuções de teste enquanto você está criando o cenário.
-
Clique em OK.
A caixa Escolher onde começar solicita que você especifique onde deseja que o módulo inicie o processamento na planilha.
-
Clique em Escolher manualmente, selecione a opção superior na lista exibida e clique em OK.
-
Clique com o botão direito do mouse no módulo, clique em Renomear, digite um nome que descreva o que você deseja que o módulo faça (como "Assista à lista de projetos") e clique em OK.
O nome aparece logo abaixo do módulo. Abaixo disso, Workfront Fusion inclui uma breve descrição do tipo de ação executada pelo módulo.
-
Continue com Adicionar e configurar o segundo módulo.
Adicionar e configurar o segundo módulo
-
Clique no círculo parcial à direita do do módulo para Adicionar outro módulo.
Este segundo módulo precisa ser um módulo Workfront, mas não pré-carregamos o aplicativo Workfront.
-
Para localizar o aplicativo Workfront, comece digitando "Workfront" e clique no aplicativo quando ele for exibido.
-
Na lista de Workfront módulos exibidos, clique em Criar Registro.
-
Como você fez antes com o aplicativo Google Sheets, clique em Adicionar na caixa Workfront para adicionar uma conexão entre o Workfront Fusion e o Workfront.
Agora começaremos a especificar o que queremos fazer com os dados da planilha.
-
Clique em Tipo de registro e selecione Projeto porque queremos criar um projeto em Workfront usando uma linha da planilha.
note tip TIP Você pode encontrar Projeto na lista se começar a digitar a palavra "projeto." A caixa se expande para exibir todos os campos de projeto Workfront disponíveis, nos quais você pode colocar as informações encontradas pelo primeiro módulo.
Vamos usar o campo Nome: queremos que este módulo nomeie cada projeto em Workfront usando o texto na linha Google Sheets correspondente.
-
Localize e clique no campo Nome.
note tip TIP Você pode usar Cmd+F (Mac SO) ou Ctrl-F(Windows OS) para localizar um campo rapidamente. Isso abre a lista de variáveis que você pode usar no campo Nome para definir o nome de cada projeto criado no Workfront.
Observe que as variáveis próximas à parte superior da lista correspondem aos cabeçalhos das colunas na planilha.
-
Clique na variável Meu Nome de Projeto (A) para adicioná-la ao campo Nome.
Você acabou de mapear os primeiros dados para esse cenário.
Vamos mapear mais um dado da planilha para Workfront: a data de início de cada projeto.
-
Localize e clique no campo Data de Início Planejada e clique na variável Data de Início Planejada (E) para extrair dados dessa coluna na planilha.
-
Clique em OK.
Agora você tem um cenário de trabalho.
-
Dê um nome ao segundo módulo, como "Criar projeto Workfront", e continue com Testar o cenário.
Testar o cenário
Antes de ativar o cenário, é importante testá-lo executando-o pelo menos uma vez e visualizando os resultados. Isso ajuda você a entender como os dados fluem pelo cenário e encontrar erros.
Escolhemos ter uma linha da planilha processada para criar um projeto no Workfront. Se você executar o cenário, isso é o que deve acontecer.
-
Clique em Executar uma vez no canto inferior esquerdo do editor de cenários.
-
Depois que o cenário terminar de ser executado, clique no balão acima do módulo Google Sheets.
Na caixa que aparece, você pode exibir informações sobre o pacote de dados que o módulo processou, incluindo os dados reais que foram extraídos da planilha para a linha com a qual você começou.
-
Clique na bolha do inspetor de execução acima do módulo Workfront para ver a entrada de informações e a saída, que é a ID do projeto agora criado em Workfront
Você pode saber mais sobre como ler as informações de execução do cenário nos seguintes artigos:
- Para obter informações gerais, consulte Fluxo de execução do cenário em Adobe Workfront Fusion.
- Para obter informações sobre pacotes processados, consulte Execução do cenário, ciclos e fases em Adobe Workfront Fusion.
-
Acesse Workfront e procure por "soho center loft" para ver o projeto que o cenário criou. Esta foi a última linha da planilha.
-
Em Workfront Fusion, clique em Salvar próximo ao canto inferior esquerdo para salvar seu progresso no cenário.
note important IMPORTANT Salve com frequência à medida que você aprimora e testa um cenário.
Finalize o cenário e teste-o novamente
Ainda precisamos configurar o cenário para criar projetos para todas as outras linhas na planilha.
-
Clique no módulo Linhas de observação que você criou para o Google Sheets.
-
Altere o Limite para 100.
Especificar um número maior do que o número de linhas que você sabe que estão na planilha garante que o cenário capturará todas elas.
-
Clique com o botão direito do mouse no módulo Linhas de observação, clique em Escolher onde começar, clique em Todas e em OK.
-
Clique em Executar uma vez e observe o que acontece nos balões do inspetor de execução.
O módulo Google Planilhas Linhas de observação é executado uma vez para ler todas as linhas. Em seguida, o módulo Criar registro do Workfront é executado 20 vezes para criar um projeto para cada uma das 20 linhas restantes na planilha.
-
Clique na bolha do inspetor de execução para o módulo Workfront para exibir todas as 20 operações, em seguida, clique em uma das operações para exibir as informações sobre o projeto criado.
-
Clique em Salvar próximo ao canto inferior esquerdo.
-
Vá para Workfront para ver os projetos criados pelo cenário.
-
Clique com o botão direito do mouse no módulo Workfront e clique em Adicionar uma observação.
-
Na nota exibida, digite uma visão geral do módulo.
Isso é útil porque você não precisará abrir o módulo continuamente para ver o que ele faz. Você pode digitar algo como "Cria um projeto com Nome, Data de início planejada e Prioridade mapeada da planilha".
Para o módulo Google Sheets, você pode digitar algo como "Assista à Lista de Projetos para novas linhas/projetos adicionados".
Você pode adicionar várias notas para um módulo.
-
Feche a área Notas.
Depois de adicionar uma observação a um cenário, um ponto laranja é exibido no ícone das Notas, na parte inferior do editor de cenários.
-
Clique no ícone Notas para exibir suas notas.
Ativar o cenário
Se esse fosse um cenário que você usaria para dados reais, a última coisa que faria seria ativá-lo. Após ativar um cenário, por padrão, ele é executado a cada 15 minutos. Você pode alterar isso definindo quando e com que frequência deseja que ele seja executado.
Para obter mais informações sobre como ativar cenários, consulte Ativar ou desativar um cenário no Adobe Workfront Fusion.
Para obter informações sobre agendamentos, consulte Agendar um cenário no Adobe Workfront Fusion.