Adicionar um sinalizador de urgência aos problemas relatados

Artigo
03/09/2022
5 minutos para o fim da leitura

Como usuário do aplicativo de exemplo Relatório de problemas para o Microsoft Teams, você pode querer modificar a lógica de como os problemas relatados são criados no Planner. Incluímos muitos dos campos padrão no Planner no aplicativo padrão, mas, você pode querer fazer outras alterações com base em seus requisitos específicos.

Assista a este vídeo para aprender como adicionar uma marca para de urgência para os problemas relacionados:

Criar tarefas no aplicativo em vez de usar o Power Automate

Ao criar ou atualizar um registro em outro serviço, como no Planner/em Tarefas, você tem a opção de como criá-lo ou atualizá-lo:

Crie o registro a partir do aplicativo.

O principal benefício da criação do registro a partir de registros do aplicativo é que ele é criado de forma síncrona, o que pode resultar na criação mais rápida dos registros. Também, em operações simples, a criação do registro a partir do aplicativo pode ser mais simples porque a operação é toda contida no aplicativo. A desvantagem da criação de registros a partir do aplicativo é que se a operação for de execução prolongada ou se criar ou modificar muitos registros, os processos assíncronos, como o fluxo do Power Automate, podem resultar no desempenho mais rápido do aplicativo.
Crie o registro com um fluxo do Power Automate chamado do Power App.

Os benefícios do uso do Power Automate para criar registros a partir do aplicativo incluem a redução de atrasos em operações de execução prolongada. Além disso, ao separar a criação de registros e atualizar a lógica do fluxo do Power Automate para a lógica em constante mudança, um administrador pode alterar a lógica da criação de registros sem ter que modificar e publicar o aplicativo novamente. Para atualizações de registro complexas, a migração do fluxo de criação de registros pode ser mais fácil de gerenciar e estender para alguns criadores em comparação com complexas fórmulas de patch. Outro benefício de usar o Power Automate para criar registros é que há um log de cada execução de fluxo, o que oferece um histórico detalhado de quando os registros foram criados e atualizados.

As desvantagens de usar o fluxo para criar registros a partir de um aplicativo são que você deve lembrar-se de compartilhar o acesso ao fluxo com os usuários do aplicativo e, como os fluxos são executados de forma assíncrona, eles podem levar um pouco mais de tempo para serem concluídos.
Crie o registro com um fluxo do Power Automate acionado por atualizações de dados (como uma criação de registro).

Ao criar registros, como tarefas, você pode fazer com que o aplicativo acione o fluxo diretamente. Nesse caso, o fluxo é executado no contexto do usuário executando o aplicativo, e o fluxo deve ser compartilhado com ele. Em alguns casos, pode ser melhor que o fluxo seja acionado por uma atualização de dados, como quando um registro é atualizado no Dataverse — isso poderá ser uma boa ideia se o fluxo estiver em uma das categorias a seguir.

O fluxo deve atualizar algo para o qual o usuário não tem acesso para atualizar.
O processo é necessário para vários aplicativos. Por exemplo, suponha que você tenha um fluxo para notificar alguém e que a notificação seja acionada por vários aplicativos ou outros processos.
Ter fluxos acionados a partir de atualizações de dados pode simplificar a implantação, já que não é necessário compartilhar o fluxo com o aplicativo.

A principal desvantagem de um fluxo acionado por dados em relação ao um fluxo chamado a partir do aplicativo é que os registros que são criados ou modificados pelo fluxo serão criados e modificados pelo usuário proprietário do fluxo.

Nesta lição, atualizaremos o aplicativo Relatório de problemas para usar um fluxo do Power Automate para criar tarefas no Microsoft Planner e preencher o campo de prioridade para tarefas urgentes.

Habilitar usuários a definir a urgência do problema sendo relatado

Nesta lição, queremos estender a funcionalidade do aplicativo Relatório de problemas incluindo a possibilidade de os usuários sinalizarem um problema como urgente. O motivo que talvez você queira fazer isso é para que os problemas urgentes possam ser priorizados ou notificados a um supervisor.

O resultado deste exercício incluirá:

Um sinalizador de urgência adicionado ao formulário do Relatório de problemas.

Uma tarefa de urgência criada no Microsoft Planner com a prioridade definida como urgente.

Adicionar sinalizador de urgência no aplicativo Relatório de problemas

Nesta etapa, atualizaremos o aplicativo Relatório de problemas para adicionar uma caixa de seleção para sinalizar tarefas de urgência. Esse processo presume que você tenha instalado o aplicativo de modelo Relatório de problemas no Teams e o configurado para usar o Microsoft Planner/as Tarefas.

Dica

Para obter detalhes da arquitetura do aplicativo e o modelo de dados, consulte Arquitetura do Relatório de problemas.

Abra o aplicativo do Power Apps no Teams.
Selecione ... (reticências) no painel esquerdo.
Procure e selecione Power Apps.
Clique com o botão direito do mouse no Power Apps para desencaixar o aplicativo Power Apps para que você não perca suas alterações se navegar para outro lugar no Teams.
Selecione a equipe na qual o aplicativo Relatório de problemas está instalado e selecione a guia Aplicativos instalados.
No bloco Relatório de problemas, selecione Relatório de problemas.

O aplicativo Relatório de problemas será aberto no Power Apps no Teams.

No lado esquerdo da tela, selecione a Exibição de Árvore e, em seguida, selecione a tela Relatório de Problemas
Na tela, clique duas vezes no campo Descrição. A descrição está em um cartão de dados, portanto, se você selecioná-la, todo o cartão de dados será selecionado.
Selecione a propriedade Largura e insira e seguinte fórmula na barra de fórmulas:
```
If(
true,//locLocationEnabled,
tglLocation.X - Self.X,
Parent.Width - Self.X - gblPadding.Page
)
```
Essa fórmula manterá a capacidade de resposta nesse campo.
Adicione um controle de caixa de seleção ao lado do cartão de Descrição.
Altere a etiqueta da caixa de seleção para Urgente.
Altere propriedade X da fórmula da caixa de seleção para:
```
Parent.Width - Self.Width - gblPadding.Page
```
Essa fórmula fará com que a caixa de seleção seja posicionada em relação à largura do aplicativo.
Altere propriedade LabelSize da caixa de seleção para:
```
gblAppStyles.Label.Size.Small
```

Criar um fluxo do Power Automate para criar tarefas do Planner e definir a urgência

Nesta seção, criaremos um fluxo e substituiremos a lógica do aplicativo que cria tarefas do Planner e registros do Dataverse. Recomendamos salvar o aplicativo neste momento.

Clique duas vezes no botão Enviar Problema. Verifique se o botão está selecionado, não o cartão de dados.
Na barra de fórmulas, selecione a fórmula OnSelect. Copie a fórmula e cole-a em um bloco de notas. Isso ajudará você a recuperá-la se for necessário.

Observação

O motivo de copiar a fórmula é que quando adicionarmos um fluxo ao botão, a fórmula será limpa. Queremos garantir que a fórmula seja copiada para que ela possa ser restaurada depois que vincularmos o fluxo ao aplicativo.
No menu superior, selecione as reticências e selecione Power Automate.
Selecione Criar Fluxo.
A janela do Power Automate será aberta no navegador.
Selecione PowerApps na lista de gatilhos.
No canto superior esquerdo, selecione Sem título e renomeio e fluxo Criar Tarefa do Planner.

Observação

Nas etapas a seguir, definiremos valores para Perguntar no PowerApps. Quando você define um valor em um fluxo do Power Automate acionado do Power Apps para o Pergunte no PowerApps, um parâmetro é criado em seu fluxo e o Power Apps passará um valor para este parâmetro quando o fluxo for chamado de um aplicativo.
Selecione Nova Etapa.

Em seguida, adicionaremos duas etapas de composição. Uma etapa de composição é um tipo de variável que pode ser usada para capturar qualquer tipo de valor e usar esse valor posteriormente em seu fluxo.
Insira Compor no localizador e selecione a ação Compor.
Renomear a etapa de composição Categoria.

Observação

Sempre renomeie suas etapas de composição antes de definir seu valor para Pergunte no Power Apps para que o parâmetro criado inclua o nome apropriado, em vez de um nome genérico.
Selecione o painel de conteúdo dinâmico e selecione a ação Pergunte no PowerApps.
Adicione outra etapa de composição.
Renomeie a nova etapa de composição Modelo.
Defina a entrada para a etapa do modelo como Pergunte no PowerApps.
Adicione uma ação Criar uma tarefa (versão preliminar) do Planner.
Defina os seguintes campos como Perguntar no Power Apps.
- ID do Grupo
- ID do Plano
- Title
- ID do Bucket
- Data e hora da Início
- Data e Hora de Previsão de Conclusão
- ID de Usuário Atribuído
- Prioridade
Selecione o campo Prioridade e limpe-o. O motivo de definirmos o campo como Perguntar no PowerApps e depois o limparmos é para que o parâmetro seja criado e que, depois, façamos referência a ele na expressão.
No painel de Conteúdo dinâmico do campo Prioridade, selecione Expressão e insira o seguinte expressão:
```
if(equals(triggerBody()['Createatask_Priority'],1),1,5)
```
Essa fórmula significa que se o valor urgente da tarefa do Power Apps for 1 (urgente), defina a prioridade como 1 (urgente). Caso contrário, defina-a como 5 (não urgente).
Adicione uma etapa Atualizar detalhes da tarefa do Planner.
- Defina o valor da ID da Tarefa como o valor da ID da etapa Criar tarefa usando o painel de Conteúdo dinâmico.
- Defina o campo Descrição como Perguntar no Power Apps.
Adicione uma ação Adicionar uma nova linha do Dataverse.
Selecione Relatórios de problemas na tabela.

Observação

A tabela Relatórios de problemas inclui dois campos de pesquisa. Ao preencher os campos de pesquisa, você deve inserir o valor como nome da tabela(ID do registro). As duas etapas de composição adicionadas anteriormente contêm a ID do registro para a categoria e o modelo. Para inserir esses valores, digite o nome da entidade com parênteses e, dentro dos parênteses, selecione o valor apropriado no painel de conteúdo dinâmico.

Insira os seguintes valores nesta etapa:

Column	Valor
Categoria	msft_issuereport_categories() e, ente os parênteses, selecione o valor de saída da etapa de composição da categoria.
Name	Perguntar no Power Apps
ID da tarefa do Planner	O valor da ID na etapa de criação da tarefa
Atribuição de tarefas	Perguntar no Power Apps
Descrição da tarefa	Perguntar no Power Apps
Data de conclusão da tarefa	Perguntar no Power Apps
Data de início da tarefa	Perguntar no Power Apps
Modelo	msft_issuereport_templates() e, entre os parênteses, selecione o valor de saída da etapas de composição do modelo

O resultado deverá ter a seguinte aparência:

Etapa Adicionar uma nova linha do Dataverse

Adicione uma etapa final para responder a um Power Apps ou um fluxo.

Nessa etapa, adicione uma saída de texto chamada tasked para definir o valor da ID da tarefa do Planner a partir da etapa Criar tarefa.

Agora, a o fluxo deverá estar assim:
Salve o fluxo e retorne ao Power Apps.
No painel em que você selecionou Criar um fluxo, agora você deve ver seu fluxo listado. Se ele não for exibido, feche o painel, selecione o botão Enviar problema e selecione o botão Power Automate novamente.
Selecione seu fluxo Criar Tarefa do Planner no painel de dados.

Observação

Selecionar um fluxo associará esse fluxo com o Power Apps a também limpará sua propriedade OnSelect — é por isso que copiamos o conteúdo da fórmula anteriormente nesta lição.
Na sua cópia de backup da fórmula original de OnSelect, queremos remover a seção que cria a tarefa do Planner, já que ela agora é processada pelo fluxo. Primeiramente, remova esta seção:
Copie a fórmula modificada da cópia de backup e substitua o conteúdo da propriedade OnSelect do botão Enviar problema pelo da fórmula modificada.
Próximo à parte inferior da fórmula, localize a expressão Navegar. Cole a seguinte parte diretamente antes da expressão Navegar:
```
Set(gblPlannerTask,CreatePlannerTask.Run(gblPlannerGroupId,gblPlannerPlanId,locNewTask.appTitle,locPlannerBucketForTask,locNewTask.appStart,locNewTask.appDue,locNewTask.appAssignments,Checkbox1.Checked,locNewTask.appDescription,gblRecordCategory.'Issue Report Category',gblRecordTemplate.'Issue Report Template'));
```
Observação

A fórmula CreatePlannerTask.Run() aciona o fluxo Criar tarefa do Planner, e os valores nos parênteses são os valores passados para os parâmetros no fluxo criado quando adicionamos o valor Perguntar no PowerApps.

A ordem na qual eles são especificados é baseada na ordem em que foram adicionados ao fluxo. Se você os adicionou na ordem especificada, a fórmula funcionará. Se eles não foram adicionados na mesma ordem, o IntelliSense guiará você na ordem correta de campos. As variáveis que estamos especificando na fórmula, como locNewTask.appTitle, são variáveis de contexto definidas anteriormente na fórmula OnSelect.

Essa fórmula fica em uma fórmula set(). Isso define o resultado desse fluxo como uma variável global para que possamos fazer referência à ID da tarefa criada.
Na parte Navigate() da fórmula, altere o valor de locTaskId para gblPlannerTask.taskid.
Salve e publique seu aplicativo.

Testar seu aplicativo

Agora você criou um fluxo para criar tarefas do Planner e substituiu a criação de tarefas no aplicativo pelo fluxo. No processo, adicionamos funcionalidade definindo o campo Prioridade condicionalmente. Mas você não precisa parar aí. Você pode aprimorar o fluxo para definir propriedades adicionais de tarefas do Planner ou realizar outras ações, como fazer com que o fluxo crie a tarefa em algum outro sistema de gerenciamento de tarefas, como o Microsoft To-Do.

Para testar o aplicativo, acesse a equipe na qual seu aplicativo Relatório de problemas foi publicado e relate um problema.
No Power Automate, exiba os logs de execução de seu fluxo. Verifique se o fluxo foi executado com êxito.
Se houve falha no fluxo, selecione a data de início da execução e exiba os detalhes do erro. Em seguida, confira a guia Planner usada pelo seu aplicativo e verifique se você vê a tarefa criada pelo fluxo e se todos os valores foram preenchidos corretamente.

Consulte também

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).