Partilhar via

Configurar as ações de processo personalizadas de um fluxo de trabalho

  • Artigo

Pode ativar uma ação de processo personalizada a partir de um fluxo de trabalho em tempo real 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 de processo personalizada 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 em tempo real, 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 em tempo real, não tem de definir as seguintes opções:

  • Iniciar quando: as ações de processo personalizadas começam quando o código chama a mensagem gerada para elas.

  • Âmbito: as ações de processo personalizada são sempre executadas no contexto do utilizador de chamadas.

  • Executar em segundo plano: as ações de processo personalizada são sempre fluxos de trabalho em tempo real.

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

Criar uma ação de processo personalizada

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.

Nota

Se pretende escrever um plug-in para implementar a sua lógica para uma ação de processo personalizada em vez de utilizar o estruturador de fluxos de trabalho, deve utilizar a API personalizada. Mais informações: Comparar Ação de Processo Personalizada com a API personalizada

Como os processos de fluxo de trabalho em tempo real, 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 de ação, pode selecionar uma tabela para fornecer contexto para o fluxo de trabalho em tempo real, exatamente como outros tipos de processos, mas também tem a opção de selecionar Nenhum (global). Utilize esta opção se a ação não necessita que o contexto de uma tabela 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 processo personalizada 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 de processo personalizada 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 de processo personalizada é 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 exceções a isto. As ações executadas no código por um programador iniciadas pela ação de processo personalizada poderão não suportar transações. Um exemplo seria quando o código efetua ações noutros sistemas que estão para além do âmbito 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 de processo personalizada for invocada diretamente a partir de um fluxo de trabalho. Poderá ativar a reversão se uma ação de processo personalizada for acionada por uma mensagem dos serviços Web do Power Apps.
    • Se a ação definida não alterar dados, mas apenas obtiver dados, existem determinadas situações em que o desempenho pode ser melhorado desativando Ativar reversão.

  • 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, pode começar com alguns dados que podem ser transmitidos para a mensagem. Por exemplo, para criar uma nova linha, poderá ser o valor do título do incidente que é transmitido como o 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 a isto poderá ser alterar um dos parâmetros de modo a não ser sempre necessário.

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.
Tabela Uma linha para a tabela especificada. Quando seleciona Tabela, a lista pendente é ativada, o que lhe permite selecionar o tipo de tabela.
entityCollection Uma coleção de linhas de tabela.
entityReference Um objeto que contém o nome, o ID, e o tipo de uma linha de tabela que o identifica exclusivamente. Quando seleciona tableReference, a lista pendente é ativada e permite-lhe selecionar o tipo de tabela.
Float 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 do argumento deentityCollection não podem ser definidas 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 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, visite 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 da linha contra a qual a ação está a ser executada, linhas relacionadas com essa linha numa relação um para muitos, linhas criadas num passo anterior ou valores que fazem parte do próprio processo.

Propriedades geridas

As ações de processo personalizadas têm duas propriedades geridas relevantes

É Personalizável

A propriedade gerida Is Customizabl controla se alguém que instala um solução gerida que contenha a ação de processo personalizada pode editá-la ou eliminá-la. Se pretende que a ação doe processo personalizada seja editada ou eliminada quando é incluída num solução gerida, deve definir esta propriedade como verdadeira.

É o Passo de Processamento Personalizado Permitido para Outros Editores

O É o Passo de Processamento Personalizado Permitido para Outros Editores geriu controlos de propriedade se os programadores de plug-ins de terceiros podem registar os passos de plug-ins na mensagem criada pela ação de processo personalizada. Quando isto for verdadeiro, os plug-ins registados por qualquer pessoa nesta mensagem serão executados e poderá modificar o comportamento da ação de processo personalizada. Quando for falso, apenas os passos do plug-in registadas numa solução a partir do mesmo fabricante de soluções serão executados.

Passos seguintes

Utilizar ações
Invocar ações personalizadas de um fluxo de trabalho
Fluxos de trabalho e ações em tempo real de monitorização

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).