Ativar ações personalizadas (Power Automate flows)

Você pode ativar sistemas externos com uma regra de Ativador ao definir ações personalizadas com o Power Automate. As ações personalizadas podem ser úteis para:

• Envio de notificações utilizando outros sistemas que não o Teams e email.
• Criação de itens de ação em sistemas de ticketing.
• Chamando aplicativos de linha de negócios.

Para ativar ações personalizadas a partir de suas regras, primeiro defina uma ação personalizada criando um fluxo Power Automatic. Em seguida, chame sua ação personalizada a partir da regra do Ativador.

Criar uma ação personalizada

Uma ação personalizada é uma ação reutilizável que você pode usar em várias regras dentro de itens do Ativador. Criar uma ação personalizada requer familiaridade com o Power Automate. No entanto, depois de criar uma ação personalizada, outros usuários do Activator podem usá-la em qualquer regra, sem exigir nenhum conhecimento do Power Automate.

Uma ação personalizada define como chamar um sistema externo específico a partir de uma regra usando um fluxo. Define um conjunto de campos de entrada para passar as suas regras para o fluxo, para que o fluxo chame o sistema externo. Por exemplo, suponha que você queira definir uma ação personalizada que adicione uma tarefa ao Microsoft To Do. O campo de entrada para tal ação pode ser Nome da tarefa. Essa ação personalizada seria vinculada a um fluxo que usa um conector Microsoft To Do para criar a tarefa em seu nome.

Nomeie sua ação e adicione campos de entrada

Abra o Ativador e selecione uma regra para exibir o painel Definição. Desloque-se para baixo até Ação>Tipo, e selecione Nova ação personalizada.

Em seguida, dê um nome à sua ação, como Adicionar uma tarefa de To Do. Defina os campos de entrada que você gostaria de usar mais tarde ao criar um fluxo no Power Automate. Essas cadeias de caracteres, como nome da tarefa, nome do cessionário, etc. , podem ser passadas em código para o Power Automate. E, de volta ao Activator, pode dar nomes a essas cadeias de caracteres que aparecem na sua tarefa a Fazer -- como "verificar a temperatura do pacote" e "Sally".

O próximo passo é definir o seu fluxo no Power Automate. Selecione Copiar para copiar a cadeia de conexão e escolha Abrir construtor de fluxo. O Activator leva-o ao Power Automate para que possa definir o fluxo.

Defina o seu fluxo no Power Automate

O fluxo é pré-preenchido com uma ação para o Activator.

Você deve colar a cadeia de conexão da etapa anterior nesta ação. Selecione o bloco Power Automate que exibe o erro Parâmetros inválidos. Em seguida, cole a cadeia de conexão que você copiou na etapa anterior. Isso remove a mensagem de erro e permite que você continue criando seu fluxo.

Adicionar uma nova etapa ao fluxo

1. Selecione o sinal de adição (+) para adicionar uma nova etapa ao fluxo.

2. Neste exemplo, estamos a adicionar uma tarefa Fazer, portanto, pesquisamos Fazer e escolhemos Adicionar um to-do (V3).

   

3. Preencha os campos necessários na janela Adicionar um to-do (V3). Comece selecionando uma lista existente na lista suspensa Tarefas a Fazer ou escolhendo Inserir um valor personalizado e dando um nome a uma nova lista de Tarefas a Fazer.

Opcionalmente, insira uma expressão nos campos de entrada. Se você selecionar um campo de entrada e vir um ícone de fx, isso significa que o campo suporta funções e conteúdo dinâmico. Vamos adicionar conteúdo dinâmico ao campo de entrada Título e passar uma função no campo de entrada Corpo de Texto.

Use conteúdo dinâmico em seu fluxo

Conteúdo dinâmico permite-lhe adicionar campos do próprio evento Activator. Selecione o campo na lista suspensa para passá-lo dinamicamente para o fluxo.

1. Com o cursor no campo Título, selecione fx.
2. Selecione o separador Conteúdo dinâmico.
   Quando você seleciona conteúdo dinâmico, ele é adicionado à caixa de texto.
3. Adicione a data e a hora usando Hora de ativação. Quando você seleciona Adicionar, a expressão aparece no campo Título. Passe o cursor sobre Tempo de ativação para ver quais informações estão sendo passadas. Ao adicionar uma data ao título, você pode evitar nomes duplicados.
4. Opcionalmente, remova o texto de marcador DefaultToDo e substitua-o por algo mais significativo, como tarefa de temperatura.

Passe um campo de entrada para o seu fluxo

1. Mova o cursor para o campo Body Content, selecione fx.

2. Procure a função triggerBody ou copie e cole esta função: triggerBody()?['customProperties/NAME_OF_INPUT_FIELD']. Substitua NAME_OF_INPUT_FIELD por um dos campos de entrada que tu criaste anteriormente. Neste exemplo, usamos nome da tarefa.

   Pode utilizar qualquer campo de entrada predefinido que criar nas funções Power Automatic.

   

3. Selecione Adicionar>Salvar. Pode demorar alguns minutos a guardar.

4. Opcionalmente, selecione Teste na barra de menus para forçar a execução do fluxo.

Para saber mais sobre o Power Automate, consulte Power Automate.

Conclua sua ação personalizada

Depois de salvar o fluxo, retorne ao Ativador.

Chamar sua ação personalizada a partir de uma regra

Depois de criar uma ação personalizada, ela fica disponível para uso por todas as regras e usuários que têm acesso ao item ativador definido na ação personalizada. Para chamar sua ação personalizada, a partir de uma regra, selecione a regra e escolha Ação>Digite no painel Definição de e selecione sua ação personalizada na lista.

Selecione ação Editar para ver os campos de entrada da regra. Preencha-os conforme apropriado para sua definição de regra:

Quando sua regra é ativada, ela chama seu fluxo, enviando-lhe os valores dos campos de entrada que você definiu. Como solicitámos ao nosso fluxo que atualizasse uma lista de tarefas, abra o Microsoft To Do para ver a tarefa nova.

Conteúdos relacionados

• Introdução ao Activator
• Criar regras do Ativador no modo de design
• Tutorial do ativador usando dados de exemplo

Você também pode saber mais sobre o Microsoft Fabric:

• O que é o Microsoft Fabric?