Elemento Coercion

(Elemento Coercions) (Elemento WorkflowInfo) (Action4)

Aplica-se a: SharePoint Server 2013

Especifica uma coerção para converter dados de um formulário para outro.

Uso

    <Coercions>
        <Coercion />
    </Coercions>

Elemento de informações

Informações	Local
Tipo de elemento
Namespace
Arquivo de Esquema	Actions4.xsd

Definição

    <xs:element name="Coercion"      minOccurs="0"     maxOccurs="unbounded"    >
        <xs:complexType>
            <xs:all>
                <xs:element name="Parameters"      type="coercionParametersType" minOccurs="0"     maxOccurs="1"    >
                </xs:element>
            </xs:all>
            <xs:attribute name="Name"   type="s:string"      use="required"     />
            <xs:attribute name="Assembly"   type="s:string"     />
            <xs:attribute name="DisplayName"   type="s:string"      use="required"     />
            <xs:attribute name="CatchAll"   type="s:boolean"      use="required"     />
            <xs:attribute name="RankDefault"   type="s:integer"      use="required"     />
            <xs:attribute name="SourceType"   type="s:string"     />
            <xs:attribute name="SourceFieldType"   type="s:string"     />
            <xs:attribute name="DestinationType"   type="s:string"      use="required"     />
            <xs:attribute name="DestinationFieldType"   type="s:string"     />
            <xs:attribute name="ClassName"   type="s:string"      use="required"     />
            <xs:attribute name="Id"   type="s:string"      use="required"     />
            <xs:attribute name="SourceProperty"   type="s:string"      use="required"     />
        </xs:complexType>
    </xs:element>

Elementos e atributos

Se o esquema definir requisitos específicos, como sequence, minOccurs,maxOccurs e choice, confira a seção de definição.

Elementos pai

Elemento	Tipo	Descrição
Coercions

Elementos filho

Elemento	Tipo	Descrição
Parameters	coercionParametersType

Atributos

Atributo	Tipo	Obrigatório	Descrição	Valores possíveis
Assembly	s:string	opcional	Especifica o arquivo binário no qual a coerção é implementada.	Valores do tipo s:string.
Catchall	s:boolean	obrigatório	Defina como true para mostrar a coerção em cenários em que o DestinationType ou o DestinationFieldType permitem, independentemente dos valores SourceType ou SourceFieldType . Defina como false para mostrar a coerção somente em cenários em que SourceType ou SourceFieldType especifica que ela deve ser mostrada.	Valores do tipo s:booliano.
ClassName	s:string	obrigatório	Identifica exclusivamente a classe no arquivo binário especificado pelo valor assembly.	Valores do tipo s:string.
DestinationFieldType	s:string	opcional	O tipo de campo de saída da coerção. Se o destino não puder lidar com esse tipo, a coerção não será exibida.	Valores do tipo s:string.
Destinationtype	s:string	obrigatório	O tipo de classe de saída do valor de coerção. Se o destino não puder lidar com esse tipo, a coerção não será exibida.	Valores do tipo s:string.
DisplayName	s:string	obrigatório	Especifica o nome de exibição da coerção.	Valores do tipo s:string.
Id	s:string	obrigatório	Identificador guid exclusivo da coerção.	Valores do tipo s:string.
Nome	s:string	obrigatório	O nome interno da coerção.	Valores do tipo s:string.
RankDefault	s:inteiro	obrigatório	Especifica um valor de classificação para a lista de coerções.	Valores do tipo s:integer.
SourceFieldType	s:string	opcional	O tipo de campo a ser usado para determinar se deve mostrar a coerção. Se definido, o cliente mostrará a coerção somente quando o valor anterior for do tipo correspondente, a menos que SourceFieldType ou CatchAll especifique o contrário.	Valores do tipo s:string.
SourceProperty	s:string	obrigatório	O nome do argumento na atividade que deve ser usada para associar à entrada.	Valores do tipo s:string.
SourceType	s:string	opcional	Um tipo de classe do qual os dados são convertidos. Se definido, o cliente mostrará a coerção somente quando o valor anterior for do tipo correspondente, a menos que SourceFieldType ou CatchAll especifique o contrário.	Valores do tipo s:string.

Definição de coerção de exemplo

Na definição de coerção de exemplo a seguir, a coerção com o nome AsDNGuidFromString usa a atividade Microsoft.Activities.Expressions.ParseGuid e o ParseGuid.ValueInArgument para aceitar a entrada de outras atividades.

    <Coercion Name="AsDNGuidFromString"
          DisplayName="As Guid"
          CatchAll="false"
          RankDefault="21"
          SourceType="System.String"
          DestinationType="System.Guid"
          Id="6682B03F-170A-461B-8DFB-D668A1C4220A"
          ClassName="Microsoft.Activities.Expressions.ParseGuid"
          Assembly="Microsoft.Activities, Version=2.0.0.0,
              Culture=neutral, PublicKeyToken=31bf3856ad364e35"
          SourceProperty="Value">