Partilhar via

Criar uma ação de processo personalizada

  • Artigo

Utilize ações de processo personalizadas quando quiser automatizar uma série de comandos no sistema. As ações de processo personalizadas expandem o vocabulário disponível para os programadores para expressar processos de negócio. Uma ação de processo personalizada utiliza os verbos principais fornecidos pelo sistema, tais como Criar, Atualizar, Eliminar, Atribuir para criar verbos mais expressivos como Aprovar, Escalar, Encaminhar ou Agendar. Se a definição de um processo de negócio sofrer alterações, uma pessoa que não seja um programador pode editar a ação de processo personalizada, pelo que o código não tem de ser alterado.

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

Criar uma ação de processo personalizada

Importante

Se estiver a criar uma ação de processo personalizada 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 de processo personalizadas 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.

  • Tabela

    Com processos ações, pode selecionar uma tabela fornecer contexto para o fluxo de trabalho 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.

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 de processo personalizadas também têm algo que os processos de fluxo de trabalho não têm – argumentos de entrada e saída.

Nota

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

Editar uma ação de processo personalizada

Tem de desativar as ações de processo personalizadas antes de os 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 é 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 de processo personalizada poderão não suportar 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 de processo 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 Power Apps.

  • 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

  • Adicionar fases e passos

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

Definir argumentos do processo

Quando os programadores utilizam mensagens, podem 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 de processo personalizada é 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.
Tabela Uma linha para a tabela especificada. Quando seleciona tabela, a lista pendente é ativada e permite-lhe 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 entityReference, 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 de processo personalizadas 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 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

Invocar ações de processo personalizadas de um fluxo de trabalho

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).