Passo a passo: Criando e depurando uma solução de fluxo de trabalho do SharePoint

Artigo
02/25/2013

Essa explicação passo a passo demonstra como criar um modelo seqüencial básico de fluxo de trabalho.O fluxo de trabalho verifica uma propriedade de uma biblioteca de documento compartilhado para determinar se um documento foi revisado.Se o documento foi revisado, o fluxo de trabalho completa.

Essa explicação passo a passo mostra as seguintes tarefas:

Criando um fluxo de trabalho seqüencial de definição de lista do SharePoint projeto em Visual Studio.
Criando atividades de fluxo de trabalho.
Eventos de atividade do fluxo de trabalho de manipulação.

Observação
Embora essa explicação passo a passo usa um projeto de fluxo de trabalho seqüencial, o processo é idêntico para um projeto de fluxo de trabalho do computador de estado. Além de isso, seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos de interface de usuário do Visual Studio nas instruções a seguir.A edição Visual Studio que você possui e as configurações que você usa determinam esses elementos.Para mais informações, consulte Configurações de Visual Studio.

Embora essa explicação passo a passo usa um projeto de fluxo de trabalho seqüencial, o processo é idêntico para um projeto de fluxo de trabalho do computador de estado.

Além de isso, seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos de interface de usuário do Visual Studio nas instruções a seguir.A edição Visual Studio que você possui e as configurações que você usa determinam esses elementos.Para mais informações, consulte Configurações de Visual Studio.

Pré-requisitos

Para completar este passo-a-passo, são necessários os seguintes componentes:

Edições suportadas do Microsoft Windows e do SharePoint.Para mais informações, consulte Requisitos para o desenvolvimento de soluções do SharePoint.
O Visual Studio.

Adicionar propriedades à biblioteca documentos compartilhados do SharePoint

Para acompanhar o status de revisão de documentos na biblioteca de Documentos Compartilhados , nós criaremos três novas propriedades para documentos compartilhados na nossa site do SharePoint: Status, Assignee, e Review Comments.Nós definimos essas propriedades na biblioteca de Documentos Compartilhados .

Para adicionar propriedades à biblioteca documentos compartilhados do SharePoint

Abra um site web do SharePoint, como http://, /SitePages/Home.aspx<system name>em um navegador da Web.
Em a barra de QuickLaunch, escolha compartilhadoDocumentos.
Escolha Biblioteca em fita de Ferramentas de biblioteca e então escolha o botão de crie a coluna em fita para criar uma nova coluna.
Nomeie o status de documento de coluna, defina seu tipo a Escolha a escolha de (menu), especifica as três opções, e clique no botão de OK :
- Revisão necessária
- Revisão completo
- Alterações solicitadas
Crie mais duas colunas e nomeie-as procurador e examinar-lo comentários.Defina o tipo de coluna de procurador como uma única linha de texto, e a revisão retire o tipo de coluna como várias linhas de texto.

Ativando documentos a ser editados sem precisar fazer o check-out

É mais fácil testar o modelo de fluxo de trabalho quando você edita os documentos sem ter que os verificar para fora.Em o próximo procedimento, você configura o site do SharePoint para permitir isso.

Para ativar os documentos a ser editados sem fazer o check-out de eles

Em a barra de QuickLaunch, escolha o link de Documentos Compartilhados .
Em fita de Ferramentas de biblioteca , escolha a guia de Biblioteca , e então escolha o botão de Configurações de biblioteca para exibir a página de Configurações de biblioteca de documentos .
Em a seção de Configurações Gerais , escolha o link de Configurações de controle de versão para exibir a página de Configurações de controle de versão .
Verifique se a configuração para Requer documentos para ser feito antes que eles possam ser editados é Não.Se não estiver, alterá-la para Não e escolha o botão de OK .
Feche o navegador.

Criando um projeto de fluxo de trabalho seqüencial do SharePoint

Um fluxo de trabalho seqüencial é um conjunto de etapas que é executado em ordem até que a atividade a última terminar.Em este procedimento, nós criaremos um fluxo de trabalho seqüencial que aplica a nossos documentos compartilhados a lista.O assistente de fluxo de trabalho permite que você associe o fluxo de trabalho com a definição do site ou a definição da lista e permite que você determinar quando o fluxo de trabalho iniciará.

Para criar um projeto de fluxo de trabalho seqüencial do SharePoint

Inicie o Visual Studio
Em a barra de menu, escolha Arquivo, Novo, Projeto para exibir a caixa de diálogo de Novo Projeto .
Expanda o nó de SharePoint em Visual C# ou Visual Basic, e então escolha o nó de 2010 .
Em o painel de Modelos , escolha o modelo de Projeto do SharePoint 2010 .
Em a caixa de Nome , entre em MySharePointWorkflow e então escolha o botão de OK .

Assistente de personalização do SharePoint Aparece.
Em a página de Especificar o site e o nível de segurança para depuração , escolha o botão de opção de Implantar como uma solução de farm , e então escolha o botão de Concluir para aceitar o nível de confiança e o site padrão.

Esta etapa define o nível de confiança para a solução como a solução de farm, a única opção disponível para projetos de fluxo de trabalho.Para mais informações, consulte Considerações sobre a solução no modo seguro.
Em Gerenciador de Soluções, escolha o nó de projeto e, em seguida, na barra de menu, escolha Projeto, Adicionar novo item.
Em Visual C# ou Visual Basic, expanda o nó de SharePoint , e então escolha o nó de 2010 .
Em o painel de Modelos , escolha o modelo de Fluxo de trabalho seqüencial de farm solução (somente) , e então escolha o botão de Adicionar .

Assistente de personalização do SharePoint Aparece.
Em a página de Especifique o nome de fluxo de trabalho para depuração , aceite o nome padrão (MySharePointWorkflow - Workflow1).Manter o valor padrão do tipo de modelo de fluxo de trabalho, listar o fluxo de trabalho, e então escolha o botão de Avançar .
Em a página de Você tem do Visual Studio para associar automaticamente o fluxo de trabalho em uma sessão de depuração? , escolha o botão de Avançar para aceitar todas as configurações padrão.

Esta etapa automaticamente associa o fluxo de trabalho com a biblioteca de documentos compartilhados.
Em a página de Para especificar as condições como o fluxo de trabalho é iniciado , deixe as opções padrão selecionadas na seção de Como você deseja que o fluxo de trabalho para começar? e escolha o botão de Concluir .

Esta página permite que você especifique quando seus começa de fluxo de trabalho.Por padrão, o fluxo de trabalho inicia ou quando um usuário manualmente no início do SharePoint ou quando um item ao fluxo de trabalho está associado é criado.

Criando atividades de fluxo de trabalho

Fluxos de trabalho contém uma ou mais atividades que representam ações executar.Use o designer de fluxo de trabalho para organizar atividades para um fluxo de trabalho.Em este procedimento, adicionaremos duas atividades ao fluxo de trabalho: HandleExternalEventActivity e OnWorkFlowItemChanged.Essas atividades monitoram o status de revisão de documentos na lista de Documentos Compartilhados

Para criar atividades de fluxo de trabalho

O fluxo de trabalho devem ser exibido no designer de fluxo de trabalho.Se o não for, então abra Workflow1.cs ou Workflow1.vb em Gerenciador de Soluções.
Em o designer, escolha a atividade de OnWorkflowActivated1 .
Em a janela de Propriedades , entre onWorkflowActivated próximo à propriedade de invocado , e escolha a tecla ENTER.

O editor de códigos abre, e um método manipulador de eventos chamado onWorkflowActivated é adicionado ao arquivo de código Workflow1.
Alternar de volta para o designer de fluxo de trabalho, abre a caixa de ferramentas, e expanda o nó de Fluxo de trabalho v3.0 do windows .
Em o nó de Fluxo de trabalho v3.0 do windows de Caixa de Ferramentas, execute um dos seguintes conjuntos de etapas:
1. Abra o menu de atalho para atividades de quando , e então escolha Copiar.Em o designer de fluxo de trabalho, abra o menu de atalho para a linha abaixo da atividade de onWorkflowActivated1 , e então escolha Colar.
2. Arraste a atividade de quando de Caixa de Ferramentas o designer de fluxo de trabalho, e se conectar a atividade a linha abaixo da atividade de onWorkflowActivated1 .
Escolha a atividade de WhileActivity1 .
Em a janela de Propriedades , defina Condição para codificar a condição.
Expanda a propriedade de Condição , digite isWorkflowPending próximo à propriedade filho de Condição , e escolha a tecla ENTER.

O editor de códigos abre, e um método chamado isWorkflowPending é adicionado ao arquivo de código Workflow1.
Alternar de volta para o designer de fluxo de trabalho, abre a caixa de ferramentas, e expanda o nó de Fluxo de trabalho do SharePoint .
Em o nó de Fluxo de trabalho do SharePoint de Caixa de Ferramentas, execute um dos seguintes conjuntos de etapas:
- Abra o menu de atalho para atividades de OnWorkflowItemChanged , e então escolha Copiar.Em o designer de fluxo de trabalho, abra o menu de atalho para a linha dentro de atividade de whileActivity1 , e então escolha Colar.
- Arraste a atividade de OnWorkflowItemChanged de Caixa de Ferramentas o designer de fluxo de trabalho, e se conectar a atividade a linha dentro de atividade de whileActivity1 .
Escolha a atividade de onWorkflowItemChanged1 .
Em a janela de Propriedades , defina as propriedades conforme mostrado na tabela.

Propriedade

Valor

CorrelationToken

workflowToken

Invocado

onWorkflowItemChanged

Propriedade	Valor
CorrelationToken	workflowToken
Invocado	onWorkflowItemChanged

Eventos de atividade de tratamento

Finalmente, verificar o status de cada atividade do documento.Se o documento foi revisado, então o fluxo de trabalho está concluído.

Para manipular eventos de atividades

Em Workflow1.cs ou em Workflow1.vb campo, adicione o seguinte à parte superior da classe de Workflow1 .Este campo é usado em uma atividade para determinar se o fluxo de trabalho está concluído.
```
Dim workflowPending As Boolean = True
```
```
Boolean workflowPending = true;
```
Adicione o seguinte método à classe de Workflow1 .Este método verifica o valor da propriedade de Document Status lista de documentos para determinar se o documento foi revisado.Se a propriedade de Document Status é definida como Review Complete, então o método de checkStatus define o campo de workflowPending a false para indicar que o fluxo de trabalho está pronto para concluir.
```
Private Sub checkStatus()
    If CStr(workflowProperties.Item("Document Status")) = "Review Complete" Then
        workflowPending = False
    End If
End Sub 
```
```
private void checkStatus()
{
    if ((string)workflowProperties.Item["Document Status"] == "Review Complete")
    workflowPending = false;
}
```
Adicione o seguinte código para os métodos de onWorkflowActivated e de onWorkflowItemChanged para chamar o método de checkStatus .Quando inicia o fluxo de trabalho, o método de onWorkflowActivated chamarem o método de checkStatus para determinar se o documento já tenha sido revisado.Se não foi revisado, o fluxo de trabalho continua.Quando o documento é salvo, o método de onWorkflowItemChanged chama o método de checkStatus novamente para determinar se o documento foi revisado.Quando o campo de workflowPending estiver definida como, trueo fluxo de trabalho continuará a ser executado.
```
Private Sub onWorkflowActivated(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ExternalDataEventArgs)
    checkStatus()
End Sub

Private Sub onWorkflowItemChanged(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ExternalDataEventArgs)
    checkStatus()
End Sub
```
```
private void onWorkflowActivated(object sender, ExternalDataEventArgs e)
{
    // Check the status.
    checkStatus();
}

private void onWorkflowItemChanged(object sender, ExternalDataEventArgs e)
{
    // Check the status.
    checkStatus();
}
```
Adicione o seguinte código ao método de isWorkflowPending para verificar o status da propriedade de workflowPending .Cada vez que o documento é salva, a atividade de whileActivity1 chama o método de isWorkflowPending .Este método examina a propriedade de Result do objeto de ConditionalEventArgs para determinar se a atividade de WhileActivity1 deve continuar ou concluir.Se a propriedade é definida como true, a atividade continua.Caso contrário, os conclusão da atividade e os terminar de fluxo de trabalho.
```
Private Sub isWorkflowPending(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ConditionalEventArgs)
    e.Result = workflowPending
End Sub
```
```
private void isWorkflowPending(object sender, ConditionalEventArgs e)
{
    e.Result = workflowPending;
}
```
Salvar o projeto.

Testando o modelo de fluxo de trabalho do SharePoint

Quando você inicia o depurador, Visual Studio implantar o modelo de fluxo de trabalho para o servidor do SharePoint e associa o fluxo de trabalho com a lista de Documentos Compartilhados .Para testar o fluxo de trabalho, inicie uma instância de fluxo de trabalho de um documento na lista de Documentos Compartilhados .

Para testar o modelo de fluxo de trabalho do SharePoint

Em Workflow1.cs ou em Workflow1.vb, definir um ponto de interrupção próximo ao método de onWorkflowActivated .
Escolha a tecla F5 para compilar e executar a solução.

O site da web do SharePoint aparece.
Em o painel de navegação no SharePoint, escolha o link de Documentos Compartilhados .
Em a página de Documentos Compartilhados , escolha o link de Documentos na guia de Ferramentas de biblioteca , e então escolha o botão de Carregar Documento .
Em a caixa de diálogo de Carregar Documento , escolha o botão de Procurar , escolha qualquer arquivo de documento, escolha o botão de Abrir , e então escolha o botão de OK .

Isso carrega o documento selecionado na lista de Documentos Compartilhados e inicia o fluxo de trabalho.
Em Visual Studio, verifique se o depurador pára no ponto de interrupção próximo ao método de onWorkflowActivated .
Escolha a tecla F5 para continuar a execução.
Você pode alterar as configurações do documento aqui, mas deixa-as nos valores padrão por agora escolhendo o botão de Salvar .

Isso retorna para a página de Documentos Compartilhados de site padrão do SharePoint.
Em a página de Documentos Compartilhados , verifique se o valor abaixo da coluna de MySharePointWorkflow – Workflow1 está definido como Em andamento.Isso indica que o fluxo de trabalho está em andamento e que o documento está aguardando a revisão.
Em a página de Documentos Compartilhados , escolha o documento, clique na seta que aparece, e escolha o item de menu Editar propriedades .
Definir status de documento a revisão completo, e clique no botão de Salvar .

Isso retorna para a página de Documentos Compartilhados de site padrão do SharePoint.
Em a página de Documentos Compartilhados , verifique se o valor abaixo da coluna de status de documento está definido como revisão completo.Atualize a página de Documentos Compartilhados e verifique se o valor abaixo da coluna de MySharePointWorkflow – Workflow1 está definido como Concluído.Isso indica que o fluxo de trabalho terminou e que o documento foi revisado.

Próximas etapas

Você pode aprender mais sobre como criar modelos de fluxo de trabalho de esses tópicos:

Para saber mais sobre atividades de fluxo de trabalho do SharePoint, consulte Atividades de fluxo de trabalho para a base do SharePoint.
Para saber mais sobre atividades Windows Workflow Foundation, consulte namespace de System.Workflow.Activities.

Consulte também

Outros recursos

Criação de soluções de fluxo de trabalho do SharePoint

Projeto do SharePoint e modelos de Item de projeto

Criação e depuração de soluções do SharePoint

Partilhar via