Elemento Condition (WorkflowInfo)

Artigo
08/11/2022

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Representa uma instrução Condition , que faz parte de uma frase de regra que pode ser exibida em um editor de fluxo de trabalho declarativo, baseado em regras, sem código, como o Microsoft SharePoint Designer 2010.

Quando um fluxo de trabalho é disparado por um evento que corresponde a uma lista do SharePoint ou item de biblioteca de documentos no Microsoft SharePoint Foundation 2010, geralmente é necessário avaliar qual ação de fluxo de trabalho deve ser executada ou se uma ação é necessária. Um elemento Condition permite que o fluxo de trabalho execute essa avaliação com os valores e argumentos fornecidos a ele pelo editor de fluxo de trabalho.

Cada elemento Condition também corresponde a um método booliano dentro de uma biblioteca de fluxo de trabalho do SharePoint Foundation 2010 especificada. Esses métodos são usados para avaliar valores passados por seus parâmetros e retornar verdadeiro ou falso.

Um elemento Condition contém informações sobre o assembly do Microsoft .NET em que o código condition é implementado e também os parâmetros necessários para fazer a chamada de função. Ele também contém informações sobre como a instrução Condition deve ser exibida para o editor de fluxo de trabalho.

Definição

<WorkflowInfo>
      <Conditions>
            <Condition>
               <RuleDesigner>…</RuleDesigner>
               <Paramaters>…</Parameters>
            </Condition>
            <Default>…</Default>
      </Conditions>
      <Action>…</Actions>
</WorkflowInfo>

Elementos e atributos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo	Descrição
AppliesTo	Texto obrigatório. Especifica que a instrução condicional que está sendo avaliada é aplicada a uma lista ou biblioteca de documentos do SharePoint. Ao alterar o valor, você pode mostrar ou ocultar uma instrução de condição específica no editor de fluxo de trabalho, dependendo do tipo de lista do SharePoint à qual o fluxo de trabalho está associado. Os seguintes valores não diferenciam maiúsculas de minúsculas: tudo especifica que uma instrução de condição está disponível para todos os tipos de lista e biblioteca de documentos. doclib especifica que uma instrução de condição é visível para o editor de fluxo de trabalho somente quando o fluxo de trabalho está associado a uma biblioteca de documentos. Se o fluxo de trabalho estiver associado a qualquer outro tipo de lista, a instrução de condição será ocultada do editor de fluxo de trabalho. especifica que uma instrução de condição fica visível para o editor de fluxo de trabalho somente quando o fluxo de trabalho está associado a uma lista do SharePoint. Se o fluxo de trabalho estiver associado a qualquer tipo diferente de um tipo de lista, a instrução de condição será ocultada do editor de fluxo de trabalho. nenhum especifica que uma instrução de condição está oculta do editor de fluxo de trabalho.
Assembly	Texto obrigatório. Especifica o assembly .NET que contém o código de implementação para o elemento Condition . Tipo de valor: cadeia de caracteres. Especifica o assembly .NET que contém o código do fluxo de trabalho. O formato deve ser o seguinte: Nome do assembly, Versão, Cultura, PublicKeyToken Exemplo: Assembly=>Microsoft.SharePoint.WorkflowActions, Version=12.0.0.0, Culture=neutral, PublicKeyToken= 71e9bce111e9429c>
ClassName	Texto obrigatório. Contém o nome de classe totalmente qualificado no qual o código do elemento Condition é implementado. Tipo de valor: cadeia de caracteres. Nome de classe totalmente qualificado no qual o código do elemento Condition personalizado é implementado. Exemplo: XML: ClassName=>Microsoft.SharePoint.WorkflowActions.Helper>
FunctionName	Texto obrigatório. Nome do método booliano na classe que implementa o código condition . Tipo de valor: cadeia de caracteres. Representa o nome do método na classe na qual o código do elemento Condition é implementado. Método de exemplo: `Bool myCondition(WorkflowContext context, string ListGUIDorName, int ItemWorkflowAttachedTo)` XML: FunctionName=>myCondition>
ItemKeyType	Texto opcional. O identificador específico da implementação para o tipo de objeto padrão.
Nome	Texto obrigatório. Especifica um nome de condição localizado.
Tipo	Texto opcional. Especifica se o elemento Condition é Personalizado ou Avançado. Os seguintes valores não diferenciam maiúsculas de minúsculas: Personalizado Usado para comparar um valor encontrado na lista atual do SharePoint ou item de biblioteca de documentos com um valor especificado pelo designer de fluxo de trabalho. Avançado Usado para indicar que uma Condição pode ser usada para comparar dois valores de qualquer tipo (por exemplo, texto, inteiros e datas).
UsesCurrentItem	Boolean opcional. Especifica que o item selecionado no momento está associado ao fluxo de trabalho. Tipo de valor: Boolean. Se definido como true, o fluxo de trabalho será associado ao item de lista do SharePoint ou ao item da biblioteca de documentos que iniciou a instância de fluxo de trabalho. Ao usar um editor de fluxo de trabalho declarativo e sem código, esse valor sempre retorna true e não pode ser alterado.

Elementos filho

RuleDesigner

Parameters

Elementos pai

Condições

Exemplo

O exemplo a seguir mostra como expor um elemento Condition ao editor sem código durante o processo de design do fluxo de trabalho.

    <WorkflowInfo Language="en-us">
       <Conditions And="and" Or="or" Not="not" When="If" Else="ElseIf">
          <Condition
                  AppliesTo="list"
                  Assembly="MyWorkflowProject.Workflow1,
                            PublicKeyToken=71e9bce111e9429c,
                            Version=1.0.0.0,
                            Culture=neutral"
                  ClassName="MyWorkflowProject.Workflow1.MyClass"
                  FunctionName="IsOrderComplete"
                  Name="Check if item in %1 is a complete order"
                  Type="Custom"
                  UsesCurrentItem="True">
              <RuleDesigner>...</RuleDesigner>
          </Condition>
       </Conditions>
    </WorkflowInfo>

Atributo	Descrição
AppliesTo	Texto obrigatório. Especifica que a instrução condicional que está sendo avaliada é aplicada a uma lista ou biblioteca de documentos do SharePoint. Ao alterar o valor, você pode mostrar ou ocultar uma instrução de condição específica no editor de fluxo de trabalho, dependendo do tipo de lista do SharePoint à qual o fluxo de trabalho está associado. Os seguintes valores não diferenciam maiúsculas de minúsculas: tudo especifica que uma instrução de condição está disponível para todos os tipos de lista e biblioteca de documentos. doclib especifica que uma instrução de condição é visível para o editor de fluxo de trabalho somente quando o fluxo de trabalho está associado a uma biblioteca de documentos. Se o fluxo de trabalho estiver associado a qualquer outro tipo de lista, a instrução de condição será ocultada do editor de fluxo de trabalho. especifica que uma instrução de condição fica visível para o editor de fluxo de trabalho somente quando o fluxo de trabalho está associado a uma lista do SharePoint. Se o fluxo de trabalho estiver associado a qualquer tipo diferente de um tipo de lista, a instrução de condição será ocultada do editor de fluxo de trabalho. nenhum especifica que uma instrução de condição está oculta do editor de fluxo de trabalho.
Assembly	Texto obrigatório. Especifica o assembly .NET que contém o código de implementação para o elemento Condition . Tipo de valor: cadeia de caracteres. Especifica o assembly .NET que contém o código do fluxo de trabalho. O formato deve ser o seguinte: Nome do assembly, Versão, Cultura, PublicKeyToken Exemplo: Assembly=>Microsoft.SharePoint.WorkflowActions, Version=12.0.0.0, Culture=neutral, PublicKeyToken= 71e9bce111e9429c>
ClassName	Texto obrigatório. Contém o nome de classe totalmente qualificado no qual o código do elemento Condition é implementado. Tipo de valor: cadeia de caracteres. Nome de classe totalmente qualificado no qual o código do elemento Condition personalizado é implementado. Exemplo: XML: ClassName=>Microsoft.SharePoint.WorkflowActions.Helper>
FunctionName	Texto obrigatório. Nome do método booliano na classe que implementa o código condition . Tipo de valor: cadeia de caracteres. Representa o nome do método na classe na qual o código do elemento Condition é implementado. Método de exemplo: `Bool myCondition(WorkflowContext context, string ListGUIDorName, int ItemWorkflowAttachedTo)` XML: FunctionName=>myCondition>
ItemKeyType	Texto opcional. O identificador específico da implementação para o tipo de objeto padrão.
Nome	Texto obrigatório. Especifica um nome de condição localizado.
Tipo	Texto opcional. Especifica se o elemento Condition é Personalizado ou Avançado. Os seguintes valores não diferenciam maiúsculas de minúsculas: Personalizado Usado para comparar um valor encontrado na lista atual do SharePoint ou item de biblioteca de documentos com um valor especificado pelo designer de fluxo de trabalho. Avançado Usado para indicar que uma Condição pode ser usada para comparar dois valores de qualquer tipo (por exemplo, texto, inteiros e datas).
UsesCurrentItem	Boolean opcional. Especifica que o item selecionado no momento está associado ao fluxo de trabalho. Tipo de valor: Boolean. Se definido como true, o fluxo de trabalho será associado ao item de lista do SharePoint ou ao item da biblioteca de documentos que iniciou a instância de fluxo de trabalho. Ao usar um editor de fluxo de trabalho declarativo e sem código, esse valor sempre retorna true e não pode ser alterado.

Partilhar via