Partilhar via


Crie e edite ações personalizadas de um fluxo de trabalho

Este tópico aplica-se ao Dynamics 365 Customer Engagement (on-premises). Para a versão Power Apps deste tópico, consulte: Configurar as ações personalizadas de um fluxo de trabalho

Pode ativar uma ação personalizada a partir de um fluxo de trabalho sem escrever código. Mais informações: Invocar ações personalizadas a partir de um fluxo de trabalho.

Poderá também criar uma ação para que um programador a possa utilizar no código ou poderá ser necessário editar uma ação que foi definida anteriormente. Como processos de fluxo de trabalho, considere o seguinte:

  • O que deve a ação fazer?

  • Em que condições deve a ação ser executada?

Ao contrário dos processos de fluxo de trabalho, não tem de definir as seguintes opções:

  • Iniciar quando: Ações começam quando o código chama a mensagem gerado mesmo.

  • Âmbito: As ações são sempre executado no contexto do utilizador de chamadas.

  • É executada em segundo plano: As ações são sempre fluxos de trabalho em tempo real.

As ações também têm algo que os processos de fluxo de trabalho não têm – argumentos de entrada e saída. Mais informações: Definir argumentos do processo

Criar uma ação

Importante

Se estiver a criar uma ação para incluir como parte de uma solução que será distribuída, crie-a no contexto da solução. Aceda a Definições>Soluções e localize a solução não gerida de que esta ação fará parte. Em seguida, na barra de menus, selecione Novo>Processo. Isto assegura que o prefixo de personalização associado ao nome da ação será consistente com os outros componentes na solução. Depois de criar uma ação como, não pode alterar o prefixo.

Como os processos de fluxo de trabalho, as ações têm as seguintes propriedades na caixa de diálogo Criar Processo.

Nome do processo
Depois de introduzir um nome para o processo, será criado um nome exclusivo removendo todos os espaços ou carateres especiais do nome do processo.

Categoria
Esta propriedade estabelece que é um processo de ação. Não pode alterar isto depois de guardar o processo.

Entidade
Com processos ações, pode selecionar uma entidade fornecer contexto para o fluxo de trabalho exatamente como outros tipos de processos, mas também tem a opção de selecionar Não (de). Utilize esta opção se a ação não necessita que o contexto de uma entidade específica. Não pode alterar isto depois de guardar o processo.

Tipo
Utilize esta propriedade para escolher se pretende criar uma nova ação de raiz ou começar a partir de um modelo existente.

Editar uma ação

Tem de desativar processos antes dos poder editar.

Pode editar uma ação criada como parte de uma solução não gerida ou incluída numa solução instalada na organização. Se a solução é uma solução gerida, não poderá editá-la. O fabricante de soluções tem a opção para editar as propriedades geridas de modo a que a solução instalada com uma solução gerida não pode ser editado.

Quando uma ação é guardada, um nome exclusivo é gerado baseado no nome do processo. Este nome tem o prefixo de personalização adicionado do fabricante de soluções. Este é o nome da mensagem que um programador utilizar no código.

Para editar uma ação tem as seguintes opções:

Nome do Processo
Após o processo criado é o nome exclusivo gerado é o nome do processo, pode editar o nome do processo. Poderá pretender aplicar uma convenção de nomenclatura para facilitar a localização de processos específicos.

Nome Exclusivo
Quando uma ação é guardada, um nome exclusivo é gerado baseado no nome do processo. Este nome tem o prefixo de personalização adicionado do fabricante de soluções. Este é o nome da mensagem que um programador utilizar no código. Não altere este nome exclusivo se o processo foi ativado e o código é a localização nos contactar a ação com este nome.

Importante

Quando a ação é ativada e o código esteja escrito para utilizar um nome, o nome não tem de ser alterado sem também alterar o código que referencia a mesma.

Ativar reversão
Normalmente, os processos que suportam transações “anulam" (ou revertem) a operação se a qualquer parte desta falhar. Existem algumas exceções a este. Algumas ações que os programadores podem criar código em iniciou a ação poderão não suporta transações. Por exemplo, se o código efetua ações em outros sistemas que são além de acesso da transação. Estes não poderão ser revertidos pela ação em execução numa aplicação. Algumas mensagens na plataforma não suportam transações. Mas tudo o que pode fazer com apenas a interface de utilizador de ação suporta transações. As ações que fazem parte de um fluxo de trabalho em tempo real são consideradas a transação, mas com ações que optar ativamente a sessão desta.

Tem de procurar com o programador que irá utilizar esta mensagem para determinar se deve ser ou não na transação. Normalmente, uma ação tem de ser a transação se as ações efectuadas pelo processo de negócio não adequadas a menos que todos são concluídas com êxito. A instância está transferir clássico fundos entre duas contas bancárias. Se sair de fundos uma conta tem de depositá-los em outra. Se qualquer um falha, não têm falhar.

Nota

Não poderá ativar a reversão se uma ação personalizada for invocada diretamente a partir de um fluxo de trabalho. Poderá ativar a a reversão se uma ação for acionada por uma mensagem de serviços Web do Dynamics 365 Customer Engagement (on-premises).

Ativar Como
Como os processos, poderá ativar o processo como modelo e utilizar como ponto de partida avançada para os processos que sigam um padrão semelhante.

Definir Argumentos do Processo
Nesta área, especificará todos os dados que a ação espera para começar e os dados que serão transmitidos pela ação. Mais informações: Definir argumentos do processo

Adicione fases e condições, ações
Como outros processos, especifique as ações a efetuar e a executar o. Mais informações: Adicionar fases, condições e ações

Definir argumentos do processo

Quando um programador utiliza uma mensagem, poderá começar com alguns dados que podem ser transmitidos para a mensagem. Por exemplo, para criar um novo registo de, poderá ser o valor do título do incidente que é transmitido como um argumento de entrada.

Quando a mensagem estiver concluída, o programador poderá ter de transmitir alguns dados que foram alterados ou gerados pela mensagem para outra operação no código. Estes dados são o argumento de saída.

Os argumentos de entrada e saída de têm de ter um nome, tipo, e qualquer informação sobre se o incidente é necessário sempre. Também pode fornecer uma descrição.

O nome da mensagem e informações sobre todos os incidentes do processo “representam a subscrição” da mensagem. Quando uma ação é ativada e está a ser utilizada no código, a assinatura não deve ser alterada. Se esta subscrição for alterada, qualquer código que utilizar a mensagem irá falhar. A única à exceção é possível alterar um dos parâmetros de modo a não se necessita sempre.

Poderá alterar a ordem dos argumentos ao ordená-los ou movê-los para cima ou para baixo porque os argumentos estão identificados por nome, não pela ordem. Além disso, alterar a descrição não quebra o código ao utilizar a mensagem.

Tipos de argumento do processo de ação

A tabela seguinte descreve os tipos de argumento do processo de ação.

Tipo Descrição
Booleano Um valor de true ou de false.
DateTime Um valor que armazena informações data e hora.
Decimal O número a precisão decimal. A precisão utilizado quando é extremamente importantes.
Entidade Um registo para a entidade especificada. Quando seleciona Entidade, a lista pendente é ativada e permite-lhe selecionar o tipo de entidade.
EntityCollection Conjunto de registos de entidade.
EntityReference Um objeto que contém o nome, o ID, e o tipo de um registo de entidade que o identifica exclusivamente. Quando seleciona EntityReference, a lista pendente é ativada e permite-lhe selecionar o tipo de entidade.
Flutuante O número a precisão decimal. Utilizado quando os dados vierem de uma medida que não seja absolutamente necessita.
Número Inteiro Um número inteiro.
Dinheiro Um valor que armazena dados para o montante de dinheiro.
Picklist Um valor que representa uma opção para um atributo OptionSet.
Cadeia (de carateres) Um valor de texto.

Nota

Os valores de argumentoEntityCollection não podem ser definidos na interface de utilizador para condições ou ações. Estes são fornecidos apenas utilização dos programadores em código personalizado. Mais informações: Criar as suas próprias ações

Adicionar fases e passos

As ações são um tipo de processo é semelhante para fluxos de trabalho em tempo real. Quaisquer passos que poderão ser utilizadas em fluxos de trabalho em tempo real podem ser utilizadas em ações. Para obter informações sobre os passos que podem ser utilizados para fluxos de trabalho e ações em tempo real, consulte Fases e passos de fluxo de trabalho..

Além dos passos que podem ser utilizados para fluxos de trabalho em tempo real, as ações também têm o passo Atribuir Valor. Em ações, apenas podem ser utilizados para definir argumentos de saída. Pode utilizar o assistente de formulários para definir os argumentos de saída para valores específicos ou, mais provavelmente, para valores do registo contra o qual a ação está a ser executada, registos relacionados com esse registo numa relação um para muitos, registos criados num passo anterior ou valores que fazem parte do próprio processo.

Consulte também

Acções
Invocar ações personalizadas a partir de um fluxo de trabalho
Fluxos de trabalho e ações em tempo real de monitorização
Procedimentos de fluxos de trabalho
Descrição geral dos fluxos de processo empresarial
Monitorizar e gerir processos de fluxo de trabalho
Criar as suas próprias ações