Formulários de modificação de fluxo de trabalho (serviços SharePoint Windows)

Você pode desejar para habilitar os usuários a alterar o fluxo de trabalho em determinados pontos enquanto ele estiver execução em um item. De exemplo, você pode desejar para habilitar um usuário para atribuir tarefa para outra pessoa ou até mesmo adicionar uma tarefa específica para o fluxo de trabalho. As opções você apresentar aos usuários para alteração de fluxo de trabalho quanto são execução em um item chamado Modificações .

Você pode criar formulários de modificação que os usuários habilitar especificar os parâmetros de modificações.

Como você design seu fluxo de trabalho, você cria uma modificação adicionando um EnableWorkflowModification T:Microsoft.SharePoint.WorkflowActions.EnableWorkflowModification atividade para o fluxo de trabalho. A disponibilidade da modificação é determinada pela atividade EventHandlingScope EventHandlingScope para que você adicionar o EnableWorkflowModification T:Microsoft.SharePoint.WorkflowActions.EnableWorkflowModification atividade. Definir uma modificação adiciona um link a página status fluxo de trabalho para essa modificação específica. Quando a atividade EventHandlingScope EventHandlingScope contendo entra em escopo conforme o fluxo de trabalho é executado, Windows SharePoint Services faz o link de modificação disponível para o usuário. Quando a atividade que contém passa out of escopo, os serviços SharePoint Windows remove a página status fluxo de trabalho o link de modificação.

O link de modificação na página de status fluxo de trabalho direciona o usuário para a forma de modificação fluxo de trabalho.

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

Cada forma de modificação que você usar o fluxo de trabalho deve ter seu próprio GUID. Windows SharePoint Services usa este GUID para coincidir com a modificação selecionada pelo usuário com o apropriado forma.

Para especificar uma forma de modificação, você deve definir três partes dos dados:

1. Defina o ModificationID ModificationID propriedade do EnableWorkflowModification T:Microsoft.SharePoint.WorkflowActions.EnableWorkflowModification atividade como o GUID é gerado para sua modificação.

2. Na definição de modelo fluxo de trabalho, defina o atributo ModificationURL ModificationURL do elemento 57efcd92-6cd3-465e-af3b-12a17d6b2c35 de fluxo de trabalho como a forma de modificação desejar usar.

   Se seu fluxo de trabalho inclui múltiplo modificações, você pode programa de forma você especificar com esse atributo para fazer o seguinte:

   • Exiba uma exibição diferente da forma, com base no identificador de modificação passado para esta forma.

   • Redirecionar para separar uma forma, com base no identificador de modificação passado para esta forma.

     Observação

     Windows SharePoint Services 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.

3. Na definição de modelo fluxo de trabalho, adicionar um elemento ca629084-42d0-4e22-9559-34ed1158b30a Modification_guid_Name, onde GUID é o GUID é gerado para sua modificação. Defina este elemento com o nome desejar dar sua modificação. Windows SharePoint Services exibe esse nome como o texto link para o link de modificação na página status de fluxo de trabalho. Por exemplo:

                           <Modification_GUID_Name>Add a New Reviewer</Modification_GUID_Name>
   

Processamento de formulário de modificação

Quando um determinado EnableWorkflowModification atividade entra em escopo T:Microsoft.SharePoint.WorkflowActions.EnableWorkflowModification, o fluxo de trabalho invoca o EnableWorkflowModification EnableWorkflowModification método e passa Windows SharePoint Services wssnoversshort duas partes de dados como parâmetros:

• O GUID de forma a modificação, conforme armazenado no ModificationId P:Microsoft.SharePoint.WorkflowActions.EnableWorkflowModification.ModificationId propriedade da atividade.

• As informações para transmitir para a forma de modificação, na forma seqüência de caracteres; Este informações é principalmente contexto dados, como armazenados no ContextData P:Microsoft.SharePoint.WorkflowActions.EnableWorkflowModification.ContextData propriedade da atividade.

  Observação

  O desenvolvedor fluxo de trabalho deve gerar o seqüência de caracteres que contém os dados contexto para transmitir no EnableWorkflowModification método EnableWorkflowModification.Para facilitar de programação, recomendamos que os desenvolvedores crie um objeto para cada modificação criarem.Cada objeto de modificação deve ter uma esquema serialização XML que corresponda exatamente a esquema de primário da forma de modificação fonte de dados.

Windows SharePoint Services examina a definição modelo fluxo de trabalho XML para determinar o nome da modificação e usa esse como o texto link para o link de modificação que ele adiciona para a página status fluxo de trabalho.

Em modelo de objeto o SharePoint, as modificações atualmente disponível para uma instância fluxo de trabalho está listados no objeto SPWorkflowModificationCollection T:Microsoft.SharePoint.Workflow.SPWorkflowModificationCollection.

Se um usuário clicar em um link determinado modificação, Windows SharePoint Services examina a definição modelo fluxo de trabalho XML, especificamente o ModificationURL do elemento 57efcd92-6cd3-465e-af3b-12a17d6b2c35 de fluxo de trabalho, que especifica a forma de modificação para exibir. Windows SharePoint Services carrega a forma e passa os contexto dados a partir de EnableWorkflowModification T:Microsoft.SharePoint.WorkflowActions.EnableWorkflowModification atividade.

O desenvolvedor forma de modificação deve programa as ações que ocorrem quando o usuário envia a forma de modificação. Na maioria dos casos, a forma chama o ModifyWorkflow método M:Microsoft.SharePoint.Workflow.SPWorkflowManager.ModifyWorkflow(Microsoft.SharePoint.Workflow.SPWorkflow,Microsoft.SharePoint.Workflow.SPWorkflowModification,System.String), passando a instância fluxo de trabalho identificação, um objeto SPWorkflowModification T:Microsoft.SharePoint.Workflow.SPWorkflowModification e, opcionalmente, as informações atualizadas contexto. Essa ação modifica a execução instância fluxo de trabalho de acordo.

Ao identificador de evento de modificação fluxo de trabalho, adicionar um OnWorkflowModified evento atividade para o fluxo de trabalho. Windows SharePoint Services raises this event activity when the ModifyWorkflow method is invoked. Esta atividade é mais útil quando usado dentro de manipulador de eventos de um EventHandlingScope EventHandlingScope atividade. Windows SharePoint Services passa os dados contexto de modificação para a atividade evento.

Novamente, o desenvolvedor fluxo de trabalho deve analisar os dados contexto que são passados como um seqüência de caracteres para o OnWorkflowModified T:Microsoft.SharePoint.WorkflowActions.OnWorkflowModified evento atividade.

Consulte também

Conceitos

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