Power Automate

Artigo
04/04/2023

O Power Automate pode ser usado para automatizar fluxos de trabalho em torno de seu aplicativo Collaboration Manager. Por exemplo, crie tarefas automaticamente quando um novo registro é criado.

O conector de controle de colaboração permite que os desenvolvedores acessem APIs de controle de colaboração por gatilhos ou ações em fluxos de trabalho automatizados nos aplicativos Microsoft Power Automate, Microsoft Power Apps e Azure Logic.

Observação

Atualmente, os controles de colaboração estão disponíveis apenas na versão prévia do desenvolvedor público.

Nesta versão, o conector permite que os fabricantes configurem gatilhos:

Quando uma sessão de Colaboração é criada.
Quando uma tarefa de planejador é criada ou modificada.

Ele também inclui um conjunto de APIs de controles de colaboração e tarefas que podem ser invocadas com um fluxo. As ações do conector são encontradas em seleções de etapas de fluxo de trabalho. O conector em si seria encontrado em conectores personalizados com opções configuráveis. Para usar o conector em sua solução, é necessário criar um Azure App confiável pelo seu ambiente para executar os fluxos.

Criar um Azure App

No portal do Azure para o gerenciamento do Azure Active Directory, entre em sua conta com permissões adequadas para adicionar um aplicativo de usuário ao seu ambiente com as seguintes etapas:

Na página inicial do portal do Azure, selecione Azure Active Directory. No Azure Active Directory, selecione lista suspensa para Adicionar e selecione Registro de aplicativo.
No registro do aplicativo, defina o nome do aplicativo e adicione o URI de redirecionamento da Web como https://global.consent.azure-apim.net/redirect.
Na seção Concessão Implícita e fluxos híbridos, selecione Tokens de Acesso e tokens de ID.
Selecione Permissão de API no painel esquerdo e selecione Adicionar uma permissão e pesquise a permissão do CRM Dinâmico .
Certifique-se de selecionar user_impersonation em Permissões depois de selecionar o Dynamics CRM.
Na página Segredos de Certificados & , adicione um novo segredo do cliente e salve o valor para uso posterior ao configurar a segurança do conector.
Na página Visão geral do aplicativo, copie a ID do Aplicativo (cliente) e salve-a para uso posterior ao configurar a segurança do conector.

Agora seu aplicativo do Azure está todo definido e você precisa adicioná-lo como um aplicativo de usuário em seu ambiente.

Adicionar o aplicativo do Azure ao ambiente do Power Automate

Abra o portal do Power Apps, no canto superior direito selecione configurações e abra Administração centro.
No centro de administração, selecione Ambiente no painel esquerdo e selecione seu ambiente na lista que você deseja adicionar o aplicativo conector.
Na página de detalhes do ambiente, selecione Configurações.
Na página de detalhes de configurações, selecione Usuários + permissões e selecione Usuários do aplicativo.
Na página Usuários do aplicativo, selecione o usuário + Novo aplicativo. Criar uma nova janela de usuário do aplicativo é exibida.
Selecione + Adicionar um aplicativo.
Selecione seu aplicativo na caixa de pesquisa e selecione adicionar novamente.

Depois que o aplicativo for adicionado, defina a unidade business e as funções de segurança para seu aplicativo conector. Selecione Criar e seu aplicativo está na lista. Com o usuário do aplicativo definido no ambiente, podemos continuar para a configuração do conector personalizado.

Configuração do conector personalizado

Abra o PowerApps ou o Power Automate e selecione o menu Conectores Personalizados . Selecione editar para o conector colaboração.
Na guia Informações Gerais, insira o host com o endereço do domínio da instância do Dynamic 365 (sem o https://).
Na guia Segurança, insira as seguintes entradas:
- Segredo do cliente: use o valor de segredo do aplicativo salvo na entrada.
- ID do cliente: seu aplicativo do Azure (ID do cliente).
- URL do recurso: a URL da instância do Dynamic 365 (https://org.crm.dynamics.com/).
- Escopo: o mesmo que acima com. Sufixo padrão (https://org.crm.dynamics.com/.default).
Selecione Atualizar conector para salvar as alterações e permitir que seu fluxo estabeleça conexões.

Como invocar o conector

Gatilhos e ações são pré-definidos com entrada e saída configuráveis como uma etapa de fluxo de trabalho. Adicionando a etapa de fluxo de trabalho à posição de fluxo de trabalho adequada com a configuração correta de entrada e saída a ser definida quando o gatilho ou a ação deve ser invocado.

Captura de tela é um exemplo que mostra como invocar o conector.

Gatilhos e ações compatíveis com o conector

Os seguintes gatilhos e ações têm suporte em um fluxo:

Gatilhos
1. Quando uma sessão de colaboração é criada.
  
  Escopo: Um escopo a ser limitado, quais linhas podem disparar o fluxo.
  
  Execute como: O usuário em execução para etapas em que as conexões do invocador são usadas.
2. Quando uma tarefa é criada ou modificada
  
  Por padrão, a Tarefa planejadora de gatilho está desabilitada e não será disparada. Para habilitá-lo, o administrador do locatário deve seguir as etapas:
  1. Crie um tíquete de suporte no caminho Controles/Configurações do Power Apps/Colaboração.
  2. Solicite que seu ambiente esteja habilitado para o conector de Colaboração e forneça sua URL de Ambiente (preferencial) ou ID da Organização.
  3. Você pode adicionar o seguinte texto de exemplo à sua solicitação de suporte: "Habilitar URL do Ambiente: url para o Conector de Colaboração".
  4. Para abrir um tíquete de suporte, confira Obter Ajuda + Suporte
Ações
1. Iniciar sessão colaboração
  
  Esta ação de etapa cria uma nova sessão de colaboração para sua entidade de negócios do dataverse:
  - Nome do aplicativo: O nome do aplicativo associado, por exemplo, pode ser "Collaboration Manager for Loans" ou "Collaboration Manager for Closed Loan Auditing".
  - Nome da entidade raiz da colaboração: O tipo de registro de aplicativo (nome da tabela), por exemplo, pode ser "msfi_loanapplication" para um aplicativo Collaboration Manager for Loans.
  - ID da entidade raiz de colaboração: A ID do registro de aplicativo associado, por exemplo, pode ser a ID de um registro de aplicativo de empréstimo.
  Opções avançadas
  
  Metadados (Avançados): Adiciona metadados para uma sessão de colaboração.
  - Tipo OData: Esse campo precisa ser fornecido se a outra chave/valor estiver definida e precisar corresponder exatamente #Microsoft.Dynamics.CRM.m365_collaborationmetadata.
  - Chave: Chave associada ao atributo de metadados.
  - Valor: Valor associado ao atributo de metadados.
2. Recuperar sessão colaboração
  
  ::image type="content" source=".. /assets/images/collaboration-control/retrieve-collab-session.png" alt-text="Captura de tela é um exemplo que mostra como recuperar a sessão de colaboração.":::
  
  Esta ação de etapa retorna a sessão de colaboração que corresponde às entradas fornecidas:
  - Nome do aplicativo: O contexto do nome do aplicativo para a sessão de colaboração.
  - ID da entidade raiz de colaboração: A ID da entidade empresarial para a sessão de colaboração.
  - Nome da entidade raiz da colaboração: O tipo de entidade empresarial para a sessão de colaboração.
3. Atualizar sessão colaboração
  
  Esta ação de etapa atualiza uma sessão de colaboração existente:
  - ID raiz de colaboração: O GUID para a sessão de colaboração de destino/registro raiz.
  - ID da entidade raiz de colaboração: A ID da entidade empresarial à qual a sessão de colaboração se refere.
  - Nome da entidade raiz da colaboração: O nome do tipo de entidade empresarial ao qual a sessão de colaboração se refere.
  Opções avançadas:
  
  Criar metadados (avançado): Adiciona mais metadados a um registro de sessão de colaboração.
  - Tipo OData: Esse campo precisa ser fornecido se a outra chave/valor estiver definida e precisar corresponder exatamente #Microsoft.Dynamics.CRM.m365_collaborationmetadata.
  - Chave: Chave associada ao atributo de metadados.
  - Valor: Valor associado ao atributo de metadados.
  Atualizar metadados (Avançado): Atualizações metadados existentes em um registro de sessão de colaboração.
  - Tipo OData: Esse campo precisa ser fornecido se a outra chave/valor estiver definida e precisar corresponder exatamente #Microsoft.Dynamics.CRM.m365_collaborationmetadata.
  - Chave: Chave associada ao atributo de metadados a ser atualizado.
  - Valor: Valor associado ao atributo de metadados.
  Excluir metadados (avançado): Remove todos os metadados existentes em um registro de sessão de colaboração.
  - Tipo OData: Esse campo precisa ser fornecido se a outra chave/valor estiver definida e precisar corresponder exatamente #Microsoft.Dynamics.CRM.m365_collaborationmetadata.
  - Chave: Chave associada ao atributo de metadados a ser removido.
4. Mapa de Colaboração de Associados (externo)
  
  Essa ação de etapa cria um mapeamento de uma entidade de colaboração externa (fora do dataverse) com sua sessão de colaboração:
  - ID raiz de colaboração: O identificador exclusivo da sessão de colaboração a ser mapeado para uma entidade colaborativa.
  - ID externa do Mapa de Colaboração: A ID de recurso colaborativo externo a ser mapeada.
  - Nome da entidade do mapa de colaboração: O nome do tipo de entidade colaborativa externa a ser mapeado.
  Opções avançadas:
  
  Metadados: Adicione metadados para um mapa de colaboração.
  - Tipo OData: Esse campo precisa ser fornecido se a outra chave/valor estiver definida e precisar corresponder exatamente #Microsoft.Dynamics.CRM.m365_collaborationmetadata.
  - Chave: Chave associada ao atributo de metadados.
  - Valor: Valor associado ao atributo de metadados.
5. Mapa de Colaboração de Associados (interno)
  
  Essa ação de etapa cria um mapeamento de uma entidade de colaboração (tabela dataverse) com sua sessão de colaboração. Os internos destinam-se a criar mapeamentos somente entre entidades/tabelas internas do Dataverse.
  - ID raiz de colaboração: O identificador exclusivo da sessão de colaboração a ser mapeado para uma entidade colaborativa.
  - ID da entidade do mapa de colaboração: A ID de entidade colaborativa do Dataverse a ser mapeada.
  - Nome da entidade do mapa de colaboração: O nome do tipo de entidade colaborativa do Dataverse a ser mapeado.
  Opções avançadas:
  
  Metadados (Avançado) Adicione metadados para um mapa de colaboração.
  - Tipo OData: Esse campo precisa ser fornecido se a outra chave/valor estiver definida e precisar corresponder exatamente #Microsoft.Dynamics.CRM.m365_collaborationmetadata
  - Chave: Chave associada ao atributo de metadados
  - Valor: Valor associado ao atributo de metadados
6. Atualizar mapa de colaboração
  
  Esta ação de etapa atualiza um mapa de colaboração existente:
  - ID do Mapa da Colaboração: O identificador exclusivo do mapa de colaboração a ser atualizado.
  - ID da entidade do mapa de colaboração: A ID da entidade colaborativa a ser mapeada. Esse valor deve estar vazio se a ID externa for fornecida
  - Nome da entidade do mapa de colaboração
  - ID externa do Mapa de Colaboração: A ID de recurso colaborativo externo a ser mapeada. Esse valor deve estar vazio se a ID da entidade for fornecida.
  Opções avançadas:
  
  Criar metadados: Adiciona mais metadados a um registro de mapa de colaboração.
  - Tipo OData: Esse campo precisa ser fornecido se a outra chave/valor estiver definida e precisar corresponder exatamente #Microsoft.Dynamics.CRM.m365_collaborationmetadata.
  - Chave: Chave associada ao atributo de metadados.
  - Valor: Valor associado ao atributo de metadados.
  Atualizar metadados: Atualizações metadados existentes em um registro de mapa de colaboração.
  - Tipo OData: Esse campo precisa ser fornecido se a outra chave/valor estiver definida e precisar corresponder exatamente #Microsoft.Dynamics.CRM.m365_collaborationmetadata
  - Chave: Chave associada ao atributo de metadados a ser atualizado
  - Valor: Valor associado ao atributo de metadados
  Excluir metadados: Remove todos os metadados existentes em um registro de mapa de colaboração.
  - Tipo OData: Esse campo precisa ser fornecido se a outra chave/valor estiver definida e precisar corresponder exatamente #Microsoft.Dynamics.CRM.m365_collaborationmetadata.
  - Chave: Chave associada ao atributo de metadados a ser removido.
7. Obter metadados de colaboração
  
  Esta ação de etapa lista todos os metadados que correspondem ao filtro especificado.
  
  Filtro: Um filtro a ser aplicado à consulta de metadados. Exemplo de recuperação de todos os metadados relacionados a uma ID de entidade de mapa de colaboração
  m365_entityname eq 'm365_collaborationmap' e m365_entityid eq 'GUID'
8. Criar tarefa de planejador
  
  Esta ação de etapa cria uma tarefa do Graph Planner usando controles de colaboração Tabela virtual de tarefas do Planner:
  - ID raiz de colaboração (obrigatório): Identificador exclusivo da sessão de colaboração
  - ID do plano (obrigatório): ID do plano de que a tarefa pertence
  - Título (Obrigatório): Título da tarefa
  - Atribuições: Um objeto formatado por json que representa todas as atribuições de uma Tarefa. Veja, tipo de recurso plannerAssignments
  - ID do bucket: ID do bucket à qual as tarefas pertencem.
  - Prioridade: Prioridade da tarefa. 0 e 10 valor de aumento (inclusivo) sendo menor prioridade.
  Opções avançadas:
  - Contagem de Itens da Lista de Verificação Ativa (Avançado): Número de itens de lista de verificação com valor definido como false representando itens incompletos.
  - Categorias aplicadas: Um objeto json formatter que representa todas as categorias a serem aplicadas à tarefa. Consulte o tipo de recurso plannerAppliedCategories.
  - Prioridade de atribuição: Dicas de valor de cadeia de caracteres usadas para solicitar itens desse tipo em uma exibição de lista. Veja, usando dicas de pedido no Planner
  - Contagem de itens da lista de verificação: Número de itens de lista de verificação presentes na tarefa.
  - Concluído por: Um objeto formatado por json que representa a identidade do usuário que concluiu a tarefa. Veja, tipo de recurso identitySet
  - ID do Thread de Conversa: ID do thread da conversa na tarefa. Essa é a ID do objeto thread de conversa criado no grupo.
  - Criado por: Um objeto formatado por json que representa a identidade do usuário que criou a tarefa. Veja, tipo de recurso identitySet
  - Hora da data de vencimento: Data e hora em que a tarefa está prevista. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1º de janeiro de 2014 é 2014-01T00:00:00Z.
  - Dica de pedido: Dica usada para solicitar itens desse tipo em uma exibição de lista. O formato é definido como descrito no uso de dicas de ordem no Planner.
  - Percentual completo: Percentual de conclusão da tarefa (0-100)
  - Tipo de visualização: Isso define o tipo de visualização que aparece na tarefa. Os valores possíveis são: automático, noPreview, checklist, descrição, referência.
  - Contagem de referências: Número de referências externas que existem na tarefa.
  - Hora da Data de Início: Data e hora em que a tarefa é iniciada. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 01 de janeiro de 2014 é 2014-01-01T00:00:00Z.
9. Tarefa Obter Planejador
  
  Esta ação de etapa retorna um dados de tarefa do Planner usando controles de colaboração Tabela virtual de tarefas do Planner:
  
  ID da tarefa (Obrigatório): Identificador exclusivo da tarefa
10. Tarefa de Planejador de Atualizações
  
  Esta ação de etapa atualiza um registro de tarefa de planejador usando a tabela virtual de tarefas planner controles de colaboração.
  - ID da tarefa (Obrigatório): Identificador exclusivo da tarefa.
  - Atribuições: Um objeto formatado por json que representa todas as atribuições de uma Tarefa. Consulte o tipo de recurso plannerAssignments – Microsoft Graph v1.0 | Microsoft Docs.
  - ID do bucket: ID do bucket para onde a tarefa pertence.
  - Detalhes da tarefa do planejador: Representa as informações adicionais sobre uma tarefa.
  - Hora da data de vencimento: Data e hora em que a tarefa está prevista. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 01 de janeiro de 2014 é 2014-01-01T00:00:00Z.
  - Prioridade: Prioridade da tarefa. 0 e 10 valor de aumento (inclusivo) sendo menor prioridade.
  - Percentual completo: Percentual de conclusão da tarefa (0-100).
  - Título: Título da tarefa.
  Opções avançadas:
  - Categorias aplicadas: Um objeto formatado por json que representa todas as categorias a serem aplicadas à tarefa. Consulte o tipo de recurso plannerAppliedCategories.
  - Prioridade de atribuição: Dicas de valor de cadeia de caracteres usadas para solicitar itens desse tipo em uma exibição de lista. Veja, usando dicas de pedido no Planner.
  - ID do Thread de Conversa: ID do thread da conversa na tarefa. Essa é a ID do objeto thread de conversa criado no grupo.
  - ID raiz de colaboração: O identificador exclusivo da sessão de colaboração.
  - Dica de pedido: Dica usada para solicitar itens desse tipo em uma exibição de lista. O formato é definido como tópico aqui.
  - Hora da Data de Início: Data e hora em que a tarefa é iniciada. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1º de janeiro de 2014 é 2014-01T00:00:00Z.

Exemplo de cenário de fluxo

Veja a seguir exemplos de fluxos:

Obtendo uma resposta dos formulários da Microsoft, criando uma sessão de colaboração e uma tarefa associada.
Sempre que uma sessão de colaboração é criada, capture os detalhes e envie uma notificação por email.