Criar ou editar ações personalizadas de um fluxo de trabalho
Este tópico se aplica a Dynamics 365 Customer Engagement (on-premises). Para a versão Power Apps deste tópico, consulte: Configurar ações personalizadas de um fluxo de trabalho
Você pode habilitar uma ação personalizada de um fluxo de trabalho sem escrever código. Mais informações: Invocar ações personalizadas de um fluxo de trabalho.
Você também pode criar uma ação para que um desenvolvedor possa usá-la no código ou que talvez seja necessário editar uma ação definida anteriormente. Como os processos do fluxo de trabalho, considere o seguinte:
O que a ação deve fazer?
Sob quais condições as ações devem ser executadas?
Diferentemente dos processos do fluxo de trabalho, não é necessário definir as seguintes opções:
Iniciar Quando: As ações iniciam quando o código chama a mensagem gerada para elas.
Escopo: As ações sempre são executadas no contexto do usuário da chamada.
Executar em segundo plano: as ações são sempre fluxos de trabalho em tempo real.
Uma ação também é algo que os processos do fluxo de trabalho não têm – argumentos de entrada e saída. Mais informações: Definir argumentos de processo
Criar uma ação
Importante
Se você estiver criando uma ação que será incluída como parte de uma solução a ser distribuída, crie no contexto da solução. Vá para Configurações>Soluções e localize a solução não gerenciada da qual essa ação fará parte. Em seguida, na barra de menus, selecione Novo>Processo. Isso irá garantir que o prefixo de personalização associado ao nome da ação será consistente com outros componentes da solução. Depois de criar a ação, você não poderá alterar o prefixo.
Como os processos do fluxo de trabalho, as ações têm as seguintes propriedades na caixa de diálogo Criar Processo.
Nome do Processo
Depois de inserir um nome para o processo, um nome exclusivo será criado para ele por meio da remoção de todos os espaços ou caracteres especiais do nome do processo.
Categoria
Esta propriedade estabelece que isso é um processo da ação. Você não pode alterar após salvar o processo.
Entidade
Com processos de ações, é possível selecionar uma entidade para fornecer contexto para o fluxo de trabalho assim como outros tipos de processos, mas você também tem a opção de escolher Nenhum (global). Use a ação se isso sua ação não exige o contexto de uma entidade específica. Você não pode alterar após salvar o processo.
Tipo
Você pode usar essa propriedade para escolher criar uma nova ação do zero criar ou iniciar de um modelo existente.
Editar uma ação
Você deve desativar processos antes de poder editar.
Você pode editar uma ação criada como parte de uma solução não gerenciada ou incluídos em uma solução instalada na sua organização. Se a solução for uma solução gerenciada, você não poderá editá-la. O publicador da solução tem a opção de editar as propriedades gerenciadas de forma que a ação instalada com uma solução gerenciada não possa ser editada.
Quando uma ação é salva, um nome exclusivo é gerado com base no nome do processo. Esse nome exclusivo tem o prefixo de personalização adicionado pelo fornecedor de soluções. Esse é o nome da mensagem que um desenvolvedor usará no código.
Ao editar uma ação, você tem as seguintes opções:
Nome do Processo
Depois que o processo for criado e o nome exclusivo for gerado com base no nome do processo, é possível editar o nome do processo. Talvez você queira aplicar uma convenção de nomenclatura para facilitar a localização de processos específicos.
Nome Exclusivo
Quando uma ação é salva, um nome exclusivo é gerado com base no nome do processo. Esse nome exclusivo tem o prefixo de personalização adicionado pelo fornecedor de soluções. Esse é o nome da mensagem que um desenvolvedor usará no código. Não altere o nome exclusivo se o processo foi ativado e o código estiver esperando a chamada da ação usando esse nome.
Importante
Quando a ação é ativada e o código é criado para usar um nome exclusivo, o nome exclusivo não deve ser alterado sem alterar também o código que faz referência a ele.
Habilitar reversão
Em geral, os processos que oferecem suporte às transações irão "desfazer" (ou reverter) toda a operação se houver falha em qualquer parte. Há algumas exceções. Algumas ações que os desenvolvedores podem fazer no código iniciado pela ação poderão não ser transações suportadas. Por exemplo, se o código executar ações em outros sistemas que estão além do escopo das transações. Elas não podem ser revertidas pela execução da ação no aplicativo. Algumas mensagens na plataforma não oferecem suporte às transações. Mas tudo o que você pode fazer apenas com a interface do usuário da ação terá suporte às transações. Todas as ações que fazem parte de um fluxo de trabalho em tempo real são consideradas nas transações, mas com ações que você tem a opção de excluir.
Você deve usar o desenvolvedor que usará essa mensagem para determinar se deve ou não ser estar em transação. Geralmente, uma ação deve estar em transações se as ações executadas por processos de negócios não façam sentido, a menos que todas sejam concluídas com êxito. O exemplo clássico é transferir fundos entre duas contas bancárias. Se você retirar fundos de uma conta, é necessário depositá-lo em outra. Quando uma falha, ambas falharão.
Nota
Você não pode habilitar a reversão se uma ação personalizada é invocada diretamente de um fluxo de trabalho. Você pode habilitar a reversão se uma ação é disparada por uma mensagem da web Dynamics 365 Customer Engagement (on-premises).
Ativar como
Como todos os processos, você pode ativar o processo como um modelo e usá-lo como ponto de partida avançada para processos que seguem um padrão semelhante.
Definir Argumentos do Processo
Nessa área, você especificará todos os dados que a ação espera iniciar e quais dados são transmitidos da ação. Mais informações: Definir argumentos de processo
Adicionar condições, ações e estágios
Como os processos, você especifica as ações para executar e quando as executar. Mais informações: Adicionar estágios, condições e ações
Definir argumentos do processo
Quando um desenvolvedor usa uma mensagem, ele pode começar a usar alguns dados que podem passar para a mensagem. Por exemplo, para criar um novo registro de ocorrência, talvez o valor de título da ocorrência será passado como um argumento.
Quando a mensagem for concluída, o desenvolvedor pode precisar encaminhar alguns dados alterados ou gerados pela mensagem para outra operação no código. Esses dados são o argumento de saída.
Os argumentos de entrada e saída devem ter um nome, um tipo e algumas informações sobre onde o argumento é sempre obrigatório. Você também pode fornecer uma descrição.
O nome da mensagem e as informações sobre todos os argumentos do processo representam a "assinatura" da mensagem. Após uma ação ser ativada e estiver sendo usada no código, a assinatura não deverá ser alterada. Modificar esta assinatura fará com que qualquer código que use a mensagem falhe. A única exceção a isso pode ser alterar um dos parâmetros de modo que não seja sempre necessário.
Alterar a ordem dos argumentos classificando ou movendo para cima ou para baixo não faz diferença porque os argumentos são identificados pelo nome, não pela ordem. Alterar a descrição não quebrará o código usando a mensagem.
Tipos de argumento do processo de ação
A tabela a seguir descreve os tipos de argumento do processo da ação.
| Tipo | Descrição |
|---|---|
| Booliano | Um valor true ou false. |
| DateTime | Um valor que armazena informações de data e hora. |
| Decimal | Um valor numérico com precisão decimal. Usado quando a precisão é extremamente importante. |
| Entidade | Um registro para a entidade especificada. Quando você seleciona Entidade, a lista suspensa é habilitada e permite selecionar o tipo de entidade. |
| EntityCollection | Um conjunto de registros de entidade. |
| EntityReference | Um objeto que contém o nome, a ID e o tipo de um registro de entidade que o identifica exclusivamente. Quando você seleciona EntityReference, a lista suspensa é habilitada e permite selecionar o tipo de entidade. |
| Flutuante | Um valor numérico com precisão decimal. Usado quando os dados são fornecidos de uma medida que não é absoluta precisa. |
| Inteiro | Um número inteiro. |
| Dinheiro | Um valor que armazena dados sobre um valor. |
| Picklist | Um valor que representa uma opção para um atributo OptionSet. |
| String | Um valor de texto. |
Nota
Os valores de argumento entityCollection não podem ser definidos na interface do usuário para condições ou ações. São fornecidos para uso pelos desenvolvedores no código personalizado. Mais informações: Criar suas próprias ações
Adicionar estágios e etapas
As ações são um tipo de processo muito semelhante aos fluxos de trabalho em tempo real. Todas as etapas que podem ser usadas em fluxos de trabalho em tempo real podem ser usadas em ações. Para obter informações sobre as etapas que podem ser usadas para fluxos de trabalho e ações em tempo real, consulte Estágios e etapas do fluxo de trabalho.
Além das etapas que podem ser usadas com fluxos de trabalho em tempo real, as ações também têm a etapa Atribuir valor. Nas ações, elas podem ser usadas apenas para definir argumentos de saída. É possível usar o assistente de formulário para definir argumentos de saída para valores específicos ou, mais provavelmente, para valores do registro que a ação está executando, registros relacionados com um registro de relacionamento muitos-para-um, registros criados na etapa anterior ou valores que fazem parte do próprio processo.
Veja também
Ações
Invocar ações personalizadas de um fluxo de trabalho
Monitorando fluxos de trabalho em tempo real e ações
Processos de fluxos de trabalho
Visão geral dos fluxos do processo empresarial
Monitorar e gerenciar processos de fluxo de trabalho
Criar suas próprias ações