Compartilhar via

Propriedades de inicialização e a configuração de fluxos de trabalho

See an overview of the initiation and association properties that SharePoint sets on workflows.

Observação

Os fluxos de trabalho do Microsoft Office SharePoint Online 2010 foram desativados desde 1º de agosto de 2020 para novos locatários e removidos de locatários existentes em 1º de novembro de 2020. Se você estiver usando fluxos de trabalho do Microsoft Office SharePoint Online 2010, recomendamos a migração para o Power Automate ou outras soluções suportadas. Para mais informações, confira Retirada do fluxo de trabalho do Microsoft Office SharePoint Online 2010.

When you launch a workflow, SharePoint automatically sets a number of association and initiation properties that support the workflow. These are listed below. The set of properties that are set differs slightly depending whether it is a site workflows or a list workflow. These differences are identified in the lists.

Use the following guidelines to associate and launch (initiate) your workflows using the workflow object model:

Observação

[!OBSERVAçãO] The two methods for associating workflows are found on the WorkflowSubscriptionService class, while the two methods for launching workflows are found on the WorkflowInstanceService class.

Association properties

Os valores das propriedades de associação são definidos quando você chama PublishSubscription . The association property values are association-level properties, meaning that all workflow instances with a given association share the same property value. You can retrieve an association property value within the workflow itself by using the GetConfigurationValue activity.

Following is a list of association properties that are set by default for both list and site workflows when you call PublishSubscription .

  • AssociationTitle
  • AssociatorUserId
  • LayoutsFolder
  • ParentContentTypeId()
  • HistoryListId*
  • TaskListId*
  • FormData*
  • SharePointWorkflowContext.Subscription.EventSourceId*
  • SharePointWorkflowContext.Subscription.EventType*
  • SharePointWorkflowContext.Subscription.DisplayName*
  • SharePointWorkflowContext.Subscription.Id*
  • SharePointWorkflowContext.Subscription.Name*
  • SharePointWorkflowContext.Subscription.CreatedDate*

Importante: As propriedades marcadas com um asterisco (*) não são definidas nas APIs de fluxo de trabalho, portanto, para acessá-las, basta usar seus valores de cadeia de caracteres.

In the case of list workflows, there are four additional association properties that are set by default when you call PublishSubscriptionForList(WorkflowSubscription, Guid) .

Importante

[!IMPORTANTE] Properties marked with an asterisk (*) are not defined in the Workflow APIs, so to access them simply use their string values.

Observação

[!OBSERVAçãO] You can add custom association properties by using an association form.

Initiation properties

Initiation properties are external variables whose values are set when the workflow is initiated - that is, when you call StartWorkflow. Note, however, that the property values can be updated at runtime from within the workflow instance by using the ExternalVariableValue activity. Você pode recuperar os valores de variáveis externas de fora do fluxo de trabalho usando propriedades .

External variable values are specific to each workflow instance (as opposed to association properties, where all workflow instances share the same property values).

All workflow instances (both list and site) have some external variables that are set by default when you call StartWorkflow:

As instâncias de fluxos de trabalho de lista têm algumas variáveis externas adicionais que são definidas por padrão quando você chama StartWorkflowOnListItem :

Observação

[!OBSERVAçãO] You can add custom initiation properties by using an initiation form.

Confira também

  • Last updated on