Elemento Association (WorkflowConfig)

Artigo
04/08/2023

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

Contém as informações necessárias para um editor de fluxo de trabalho baseado em regras declarativas, sem código, como o Microsoft SharePoint Designer 2010, associar um modelo de fluxo de trabalho à lista especificada do SharePoint no SharePoint Foundation.

Definição

<Association
  ListID="Text"
  TaskListID="Text"
  HistoryListID="Text"
  StartManually="true" | "false"
  StartOnCreate="true" | "false"
  StartOnChange="true" | "false"
>
</Association>

Elementos e atributos

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

Atributos

Atributo	Descrição
Listid	Necessário Text. Especifica o GUID da lista à qual o fluxo de trabalho deve ser associado.
TaskListID	Necessário Text. Especifica o GUID da lista de tarefas que o fluxo de trabalho deve usar para tarefas de fluxo de trabalho, se houver.
HistoryListID	Opcional Text. Especifica o GUID da lista de histórico que o fluxo de trabalho deve usar para registrar eventos de histórico de fluxo de trabalho, se houver. Se não for especificado, o fluxo de trabalho registrará eventos de histórico de fluxo de trabalho em uma lista de histórico padrão.
StartManually	Opcional Boolean. Se definido como true, o fluxo de trabalho poderá ser iniciado manualmente pelos usuários. Se esse atributo não estiver presente, o SharePoint Foundation tratará o fluxo de trabalho como se esse atributo estivesse definido como false.
StartOnCreate	Opcional Boolean. Se definido como true, o SharePoint Foundation iniciará o fluxo de trabalho automaticamente quando um novo item é criado na lista à qual o fluxo de trabalho está associado. Se esse atributo não estiver presente, o SharePoint Foundation tratará o fluxo de trabalho como se esse atributo estivesse definido como false.
StartOnChange	Opcional Boolean. Se definido como true, o SharePoint Foundation iniciará o fluxo de trabalho automaticamente quando um item é alterado na lista à qual o fluxo de trabalho está associado. Se esse atributo não estiver presente, o SharePoint Foundation tratará o fluxo de trabalho como se esse atributo estivesse definido como false.

Elementos filho

Nenhum

Elementos pai

Elemento
Elemento WorkflowConfig

Comentários

Depois que o fluxo de trabalho tiver sido associado a uma lista específica do SharePoint, os valores dos seguintes atributos serão armazenados no objeto SPWorkflowAssociation para o fluxo de trabalho:

O valor do atributo StartManually é armazenado na propriedade AllowManual .
O valor do atributo StartOnCreate é armazenado na propriedade AutoStartCreate .
O valor do atributo StartOnChange é armazenado na propriedade AutoStartChange .
O valor do atributo HistoryListID é armazenado na propriedade HistoryListId .
O valor do atributo TaskListID é armazenado na propriedade TaskListId .

Os aplicativos criados para funcionar como um editor de fluxo de trabalho baseado em regras declarativas e sem código podem usar o método AssociateWorkflowMarkup(String, String) do WebsvcWebPartPages Web Service para criar um modelo de fluxo de trabalho e associá-lo a uma lista do SharePoint especificando um arquivo de marcação de fluxo de trabalho, um arquivo de configuração de fluxo de trabalho e, opcionalmente, um arquivo de marcação de regras de fluxo de trabalho.

Para obter mais informações sobre como criar um aplicativo que pode atuar como um editor de fluxo de trabalho baseado em regras declarativas e sem código, consulte Criando Editores declarativos e No-Code de fluxo de trabalho.

Exemplo

O exemplo a seguir mostra um elemento Association para uma configuração de fluxo de trabalho. Os atributos do elemento especificam a lista do SharePoint à qual o fluxo de trabalho está associado, a lista de tarefas que o fluxo de trabalho usa, que o fluxo de trabalho pode ser iniciado manualmente e que o fluxo de trabalho começa automaticamente quando um novo item é criado na lista.

    <Association
        ListID="{B8C6FEEA-8066-462E-958D-1B4E90FE1C34}"
        TaskListID="{C64BA541-9D5B-42F3-A989-96F56FD51155}"
        StartManually="true"
        StartOnCreate="true"
    >

Atributo	Descrição
Listid	Necessário Text. Especifica o GUID da lista à qual o fluxo de trabalho deve ser associado.
TaskListID	Necessário Text. Especifica o GUID da lista de tarefas que o fluxo de trabalho deve usar para tarefas de fluxo de trabalho, se houver.
HistoryListID	Opcional Text. Especifica o GUID da lista de histórico que o fluxo de trabalho deve usar para registrar eventos de histórico de fluxo de trabalho, se houver. Se não for especificado, o fluxo de trabalho registrará eventos de histórico de fluxo de trabalho em uma lista de histórico padrão.
StartManually	Opcional Boolean. Se definido como true, o fluxo de trabalho poderá ser iniciado manualmente pelos usuários. Se esse atributo não estiver presente, o SharePoint Foundation tratará o fluxo de trabalho como se esse atributo estivesse definido como false.
StartOnCreate	Opcional Boolean. Se definido como true, o SharePoint Foundation iniciará o fluxo de trabalho automaticamente quando um novo item é criado na lista à qual o fluxo de trabalho está associado. Se esse atributo não estiver presente, o SharePoint Foundation tratará o fluxo de trabalho como se esse atributo estivesse definido como false.
StartOnChange	Opcional Boolean. Se definido como true, o SharePoint Foundation iniciará o fluxo de trabalho automaticamente quando um item é alterado na lista à qual o fluxo de trabalho está associado. Se esse atributo não estiver presente, o SharePoint Foundation tratará o fluxo de trabalho como se esse atributo estivesse definido como false.

Partilhar via