Compartilhar via

Associação de fluxo de trabalho e formulários de inicialização (serviços SharePoint Windows)

  • Artigo

Associação e iniciação formulários são exibidos para os usuários completo antes de qualquer fluxo de trabalho realmente inicia. Você pode usar esses formulários para habilitar os usuários definam parâmetros e outras informações para o fluxo de trabalho em avançado. Associação formulários como o fluxo de trabalho se aplica a um determinado endereço lista, biblioteca ou tipo de conteúdo; iniciação formulários endereço como o fluxo de trabalho aplica a um SharePoint específico item.

Formulários de associação são exibidos para os administradores quando eles primeiro decidirem adicionar ? ou associar ? um fluxo de trabalho com uma determinada lista, biblioteca documento, ou tipo de conteúdo. Você pode usar formulários associação para permitir que um administrador especificar parâmetros, valores usar como padrão e outras informações para o fluxo de trabalho como ela se aplica aos itens na lista, biblioteca ou tipo de conteúdo com os quais o administrador está associando-lo.

Iniciação formulários são exibidos para os usuários quando eles iniciar um fluxo de trabalho em um SharePoint específico item. Você pode utilizar os formulários iniciação para permitir que os usuários substituir ou anexar os parâmetros associação definidos por administradores, ou especificar parâmetros adicionais ou informações sobre o fluxo de trabalho como ela se aplica ao SharePoint específico item. Nem todos os fluxos de trabalho precisam iniciação formulários.

A forma inicial pode ser a mesma forma como a forma associação. Para exemplo, usando a mesma forma para cada forma fluxo de trabalho permite que você permitir que os administradores definir determinados parâmetros usar como padrão durante associação fluxo de trabalho e em seguida, permitir que o usuário que realmente inicia a instância fluxo de trabalho em um determinado item revisão e substituir esses parâmetros usar como padrão.

Especificação de formulários de associação

Você especificar forma associação de uma fluxo de trabalho na definição de modelo fluxo de trabalho XML. Para fazer isso, defina o valor do atributo AssociationURL AssociationURL do elemento 57efcd92-6cd3-465e-af3b-12a17d6b2c35 de fluxo de trabalho para o personalizado página forma você desejar usar para associação fluxo de trabalho. Por exemplo:

                    AssociationURL="MyWkflAssociationPage.aspx"

Observação

Windows SharePoint Services 3.0 oferece suporte a absoluto ou servidor-relativo caminhos na definição de modelo fluxo de trabalho.Você deve expressar todas as URLs caminho forma em um desses formatos.Exemplo, você pode usar um caminho absoluto, such as "http://site/library/page.aspx", ou um servidor-caminho relativo, such as "/layouts/page.aspx".Windows SharePoint Services dá suporte não link correção-up em definições modelo fluxo de trabalho.

Para obter mais informações sobre definições fluxo de trabalho, consulte O esquema de definição de fluxo de trabalho.

Processamento de formulário de associação

Quando um administrador seleciona um fluxo de trabalho para associar com uma determinada lista, biblioteca ou tipo de conteúdo, Windows SharePoint Services exibe a adicionar uma página New Workflow. O administrador pode usar esta página para especificar configurações comum para todos os fluxos de trabalho, such as o fluxo de trabalho definição e condições iniciação, e se o fluxo de trabalho é executado em itens, pastas, ou ambos.

Quando o administrador clica o botão avançar sobre esta página, Windows SharePoint Services examina o atributo AssociationURL AssociationURL do elemento de fluxo de trabalho 57efcd92-6cd3-465e-af3b-12a17d6b2c35, na definição de modelo fluxo de trabalho, para determinar a forma apropriada para carregar.

Para fornecer personalizado dados para a forma associação, você pode armazenar este informações no elemento 878ef52b-94e2-4218-a499-56c1416340ba AssocationData. Para exemplo, você poderá usar esse elemento para usar como padrão armazenar valores desejar para transmitir para a forma associação quando ela é exibida. O elemento 878ef52b-94e2-4218-a499-56c1416340ba AssocationData pode conter qualquer válido XML. A forma pode em seguida, carregar dados dessa associação do modelo de fluxo de trabalho.

Porque a associação fluxo de trabalho não é criada até o personalizado forma associação é enviada, Windows SharePoint Services também passa a seguinte consulta parâmetros para o personalizado forma associação:

                    <input type="hidden" name="WorkflowDefinition" value=<% _STSWriteHTML(Request.Form["WorkflowDefinition"]); %>>
<input type="hidden" name="WorkflowName" value=<% _STSWriteHTML(Request.Form["WorkflowName"]); %>>
<input type="hidden" name="AddToStatusMenu" value=<% _STSWriteHTML(Request.Form["AddToStatusMenu"]); %>>
<input type="hidden" name="AllowManual" value=<% _STSWriteHTML(Request.Form["AllowManual"]); %>>
<input type="hidden" name="RoleSelect" value=<% _STSWriteHTML(Request.Form["RoleSelect"]); %>>
<input type="hidden" name="AutoStartCreate" value=<% _STSWriteHTML(Request.Form["AutoStartCreate"]); %>>
<input type="hidden" name="AutoStartChange" value=<% _STSWriteHTML(Request.Form["AutoStartChange"]); %>>
<input type="hidden" name="GuidAssoc" value=<% _STSWriteHTML(Request.Form["GuidAssoc"]); %>>

O desenvolvedor fluxo de trabalho deve programa o que acontece quando o administrador envia as alterações de forma. Em geral, o personalizado forma associação fluxo de trabalho deve executar o seguinte ações:

  • Examine o valor do parâmetro de GuidAssoc GuidAssoc para determinar se o usuário é adicionar uma nova associação fluxo de trabalho ou edição uma associação fluxo de trabalho existente.

  • Se o usuário está adicionando uma nova associação fluxo de trabalho, chamar o AddWorkflowAssociation M:Microsoft.SharePoint.SPList.AddWorkflowAssociation(Microsoft.SharePoint.Workflow.SPWorkflowAssociation) método para criar uma nova associação fluxo de trabalho.

  • Se o usuário é edição uma associação existente fluxo de trabalho, chamar o método Update M:Microsoft.SharePoint.Workflow.SPWorkflowAssociation.UPDATE a atualização dessa associação fluxo de trabalho.

  • Crie a lista tarefa para o fluxo de trabalho, se ele ainda não existir.

  • Use os dados coletados a partir de usuário para definir propriedades do objeto de SPWorkflowAssociation T:Microsoft.SharePoint.Workflow.SPWorkflowAssociation, como apropriado.

  • Crie lista de histórico fluxo de trabalho, se necessário.

Especificação de formulários de inicialização

Se você desejar o fluxo de trabalho para ter uma forma iniciação, você deve definir o atributo InstantiationURL InstantiationURL do elemento 57efcd92-6cd3-465e-af3b-12a17d6b2c35 de fluxo de trabalho na definição de modelo fluxo de trabalho. Defina esse elemento como a forma você desejar usar para coletar os dados iniciação fluxo de trabalho, conforme o seguinte exemplo.

                    InstantiationURL="MyWkflInitiationPage.aspx"

Observação

Windows SharePoint Services 3.0 oferece suporte a absoluto ou servidor-relativo caminhos na definição de modelo fluxo de trabalho.Você deve expressar todas as URLs caminho forma em um desses formatos.Para exemplo, você pode definir um caminho absoluto, such as "http://site/library/page.aspx", ou um servidor-caminho relativo, such as "/layouts/page.aspx".Windows SharePoint Services dá suporte não link correção-up em definições modelo fluxo de trabalho.

Para obter mais informações sobre definições fluxo de trabalho, consulte O esquema de definição de fluxo de trabalho.

Processamento de formulário inicial

Quando um usuário inicia um fluxo de trabalho em um item específico, Windows SharePoint Services examina o atributo InstantiationURL InstantiationURL do elemento de fluxo de trabalho 57efcd92-6cd3-465e-af3b-12a17d6b2c35, na definição de modelo fluxo de trabalho, para determinar a forma apropriada para carregar.

Windows SharePoint Services carrega a forma especificada, passando para ela a seguinte consulta parâmetros de URL:

  • List The GUID da lista à qual o item pertence.

  • ID The ID de item da lista no qual o fluxo de trabalho é iniciado.

  • Source A página da qual o usuário iniciado o fluxo de trabalho.

  • TemplateID The GUID de associação de fluxo de trabalho.

Além disso, você pode programa sua forma para carregar o dados do formulário associação para esta associação fluxo de trabalho. Este informações estão contidas no AssociationData P:Microsoft.SharePoint.Workflow.SPWorkflowAssociation.AssociationData propriedade do objeto SPWorkflowAssociation T:Microsoft.SharePoint.Workflow.SPWorkflowAssociation que representa a associação fluxo de trabalho.

O desenvolvedor fluxo de trabalho deve programa o que acontece quando o usuário envia as alterações a página. Em geral, a forma deve executar o seguinte ações:

  • Localize o objeto SPWorkflowManager T:Microsoft.SharePoint.Workflow.SPWorkflowManager para a atual site.

  • Use the SPWorkflowManager object to invoke the StartWorkflow method, passing the appropriate SPListItem and SPWorkflowAssociation objects. Use o parâmetro eventData eventData para transmitir o dados do formulário iniciação no formato da seqüência de caracteres.

  • Return o usuário para a página origem do qual ele ou ela iniciado o fluxo de trabalho.

Quando o M:Microsoft.SharePoint.Workflow.SPWorkflowManager.StartWorkflow(Microsoft.SharePoint.SPListItem,Microsoft.SharePoint.Workflow.SPWorkflowAssociation,System.String) método for chamado, o Gerenciador fluxo de trabalho cria uma instância do fluxo de trabalho de SharePoint item. O Gerenciador fluxo de trabalho, em seguida, passa os dados coletados usando a forma inicial para o evento OnWorkflowActivated T:Microsoft.SharePoint.WorkflowActions.OnWorkflowActivated de fluxo de trabalho o próprio.

Qualquer fluxo de trabalho Windows SharePoint Services wssnoversshort deve iniciar com um OnWorkflowActivated T:Microsoft.SharePoint.WorkflowActions.OnWorkflowActivated atividade. The OnWorkflowActivated activity contains a property, WorkflowProperties, that returns an SPWorkflowActivationProperties object. Esse objeto representa as propriedades iniciais do fluxo de trabalho como ele é iniciado, such as o usuário que adicionado o fluxo de trabalho e a lista e item ao qual o fluxo de trabalho foi adicionado. Além disso, a AssociationData P:Microsoft.SharePoint.Workflow.SPWorkflowActivationProperties.AssociationData propriedade retorna um objeto System.Collections.Hashtable System.Collections.Hashtable que representa o personalizado dados fornecidos pela forma iniciação fluxo de trabalho.

Consulte também

Conceitos

Visão geral sobre de formulários de fluxo de trabalho
Formulários de modificação de fluxo de trabalho (serviços SharePoint Windows)
Formulários de tarefas Fluxo de Trabalho (serviços SharePoint Windows)