Compartilhar via

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

  • Artigo

Esta explicação passo a passo demonstra como criar um modelo de fluxo de trabalho seqüencial básico. O fluxo de trabalho verifica uma propriedade de uma biblioteca de documentos compartilhados para determinar se um documento foi revisado. Se o documento foi revisado, o fluxo de trabalho for concluído.

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

  • Criando um projeto de fluxo de trabalho seqüencial de definição de lista SharePoint no Visual Studio.

  • A criação de atividades de fluxo de trabalho.

  • Manipulação de eventos de atividade de fluxo de trabalho.

ObservaçãoObservação

Embora este passo a passo usa um projeto de fluxo de trabalho seqüencial, o processo é idêntico um projeto de fluxo de trabalho de máquina de estado.

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

Pré-requisitos

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

Adicionando propriedades para o SharePoint compartilhado a biblioteca de documentos

Para rastrear o status da revisão de documentos na Documentos compartilhados biblioteca, criaremos três novas propriedades para documentos compartilhados no site do SharePoint: Status, Assignee, and Review Comments. Podemos definir essas propriedades de Documentos compartilhados biblioteca.

Biblioteca de documentos adicionar propriedades para o SharePoint compartilhado

  1. Abrir um site do SharePoint, como, por exemplo, http:// < nome do sistema > / SitePages/Home.aspx, em um navegador da Web.

  2. Na barra Inicialização rápida, clique em compartilhado documentos.

  3. Clique em biblioteca na Ferramentas de biblioteca faixa de opções e, em seguida, clique no Criar coluna botão na faixa de opções para criar uma nova coluna.

  4. Nome da coluna de Status do documento, defina seu tipo como opção (menu à sua escolha), especifique as três opções a seguintes e clique em OK:

    • Revisão necessária

    • Análise concluída

    • Alterações solicitadas

  5. Criar duas ou mais colunas e nomeá-los cessionário e comentários de revisão. Defina o tipo de coluna cessionário como uma única linha de texto e o tipo de coluna de comentários de revisão como várias linhas de texto.

Permitindo que os documentos sejam editados sem exigir um Check-Out

É mais fácil de testar o modelo de fluxo de trabalho quando você pode editar os documentos sem precisar fazer check-out. No próximo procedimento, você pode configurar para permitir que o site do SharePoint.

Para habilitar os documentos a serem editadas sem check-out

  1. Na barra Inicialização rápida, clique em compartilhado documentos.

  2. Clique em biblioteca na Ferramentas de biblioteca faixa de opções e, em seguida, clique no Definições da biblioteca de botão para exibir a Definições de biblioteca de documentos página.

  3. No Configurações gerais seção, clique As configurações de controle de versão para exibir o As configurações de controle de versão página.

  4. Verifique a configuração de exigir check-out antes de serem editados de documentos é não. Se não estiver, altere-a para não e, em seguida, clique em OK.

  5. 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 executa na ordem até que a última atividade seja concluída. Neste procedimento, criamos um fluxo de trabalho seqüencial que serão aplicadas à nossa lista de documentos compartilhados. O Assistente de fluxo de trabalho permite que você associe o fluxo de trabalho com a definição de site ou a definição de lista e permite que você determine quando o fluxo de trabalho será iniciado.

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

  1. Iniciar Visual Studio e exibir o Novo projeto caixa de diálogo, apontando para nova na arquivo menu e, em seguida, clicando em projeto.

  2. Expanda o SharePoint o nó em um Visual C# ou Visual Basice, em seguida, clique em 2010.

  3. No modelos de painel, selecione o fluxo de trabalho seqüencial.

  4. No nome digite MySharePointWorkflow e clique em OK.

    O O Assistente para personalização do SharePoint aparece.

  5. No especificar o site e o nível de segurança de depuração página, clique em próximo 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 solução do farm, a única opção disponível para projetos de fluxo de trabalho. Para obter mais informações, consulte Considerações sobre a solução no modo seguro.

  6. No Especifique o nome do fluxo de trabalho para depuração de página, aceite o nome padrão (MySharePointWorkflow - Workflow1). Manter o valor de tipo de modelo de fluxo de trabalho padrão, Fluxo de trabalho da lista dee em seguida, clique em próximo.

  7. No você gostaria de Visual Studio para associar automaticamente o fluxo de trabalho em uma sessão de depuração? página, clique em próximo para aceitar todas as configurações padrão.

    Esta etapa associa automaticamente o fluxo de trabalho a biblioteca de documentos compartilhados.

  8. No especificar as condições como seu fluxo de trabalho é iniciado de página, deixe as opções padrão selecionadas na como você deseja que o fluxo de trabalho para iniciar? seção e clique Concluir.

    Esta página permite que você especificar quando inicia o seu fluxo de trabalho. Por padrão, o fluxo de trabalho inicia ou quando um usuário inicia-lo manualmente no SharePoint ou quando um item ao qual o fluxo de trabalho está associado é criado.

Criação de atividades de fluxo de trabalho

Fluxos de trabalho contêm um ou mais atividades que representam ações a serem executadas. Use o designer de fluxo de trabalho para organizar as atividades para um fluxo de trabalho. Neste procedimento, adicionaremos duas atividades ao fluxo de trabalho: HandleExternalEventActivity e OnWorkFlowItemChanged. Essas atividades monitoram o status da revisão de documentos na Documentos compartilhados lista

Para criar atividades de fluxo de trabalho

  1. O fluxo de trabalho deve ser exibido no designer de fluxo de trabalho. Se não estiver, clique duas vezes em um workflow1. cs ou Workflow1.vb na Solution Explorer para abri-lo.

  2. No designer, clique na OnWorkflowActivated1 a atividade para selecioná-lo.

  3. No Propriedades janela, o tipo de onWorkflowActivated ao lado do Invoked propriedade e pressione ENTER.

    O Editor de código é aberto e um método do manipulador de evento chamado onWorkflowActivated é adicionado ao arquivo de código Workflow1.

  4. Voltar para o designer de fluxo de trabalho, abra a caixa de ferramentas e, em seguida, expanda o v 3.0 do fluxo de trabalho do Windows nó.

  5. Arrastar um enquanto atividade a partir do v 3.0 do fluxo de trabalho do Windows nó do Toolbox e conectar-se para a linha no onWorkflowActivated1 atividade.

  6. Clique na WhileActivity1 a atividade para selecioná-lo.

  7. No Propriedades janela, defina condição a condição de código.

  8. Expanda o condição propriedade e o tipo de isWorkflowPending próximo ao filho condição propriedade e pressione ENTER.

    O Editor de código é aberto e um método chamado isWorkflowPending é adicionado ao arquivo de código Workflow1.

  9. Voltar para o designer de fluxo de trabalho, abra a caixa de ferramentas e, em seguida, expanda o Fluxo de trabalho do SharePoint nó.

  10. Arrastar um OnWorkflowItemChanged atividade a partir de Fluxo de trabalho do SharePoint nó do Toolbox e conecte-o para a linha dentro a whileActivity1 atividade.

  11. Clique na onWorkflowItemChanged1 a atividade para selecioná-lo.

  12. No Propriedades janela, defina as propriedades conforme mostrado na tabela a seguir.

    Propriedade

    Valor

    CorrelationToken

    workflowToken

    Invocado

    onWorkflowItemChanged

Manipulação de eventos de atividade

Finalmente, verifique o status do documento de cada atividade. Se o documento foi revisado, o fluxo de trabalho for concluído.

Para manipular eventos de atividade

  1. Em workflow1. cs ou Workflow1.vb, adicione o seguinte campo à parte superior da Workflow1 classe. Este campo é usado em uma atividade para determinar se o fluxo de trabalho for concluído.

    Dim workflowPending As Boolean = True

    Boolean workflowPending = true;

  2. Adicione o seguinte método para o Workflow1 classe. Esse método verifica o valor de Document Status propriedade da lista de documentos para determinar se o documento foi revisado. Se o Document Status propriedade estiver definida como Review Complete, em seguida, a checkStatus método define a workflowPending campo para 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;
}

  3. Adicione o seguinte código para o onWorkflowActivated e onWorkflowItemChanged métodos para chamar o checkStatus método. Quando o fluxo de trabalho é iniciado, o onWorkflowActivated chamadas de método de checkStatus método para determinar se o documento já foram analisado. Se não foi analisada, continua o fluxo de trabalho. Quando o documento é salvo, o onWorkflowItemChanged chamadas de método de checkStatus método novamente para determinar se o documento foi revisado. Enquanto o workflowPending campo será definido como true, o fluxo de trabalho continua a executar.

    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();
}

  4. Adicione o seguinte código para o isWorkflowPending método para verificar o status da workflowPending propriedade. Cada vez que o documento é salvo, o whileActivity1 chamadas de atividade de isWorkflowPending método. Esse método examina a Result propriedade da ConditionalEventArgs objeto para determinar se o WhileActivity1 atividade deve continuar ou terminar. Se a propriedade estiver definida como true, a atividade continua. Caso contrário, a atividade é concluída e o fluxo de trabalho for concluído.

    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;
}

  5. Salve o projeto.

Teste o modelo de fluxo de trabalho do SharePoint

Quando você iniciar o depurador, Visual Studio implanta o modelo de fluxo de trabalho para o servidor do SharePoint e associa o fluxo de trabalho com o Documentos compartilhados lista. Para testar o fluxo de trabalho, iniciar uma instância do fluxo de trabalho a partir de um documento de Documentos compartilhados lista.

Para testar o modelo de fluxo de trabalho do SharePoint

  1. Em workflow1. cs ou Workflow1.vb, defina um ponto de interrupção ao lado do onWorkflowActivated método.

  2. Pressione F5 para compilar e executar a solução.

    O site do SharePoint é exibida.

  3. No painel de navegação do SharePoint, clique em compartilhado documentos.

  4. No Documentos compartilhados página, clique em documentos na Ferramentas de biblioteca guia e clique o Carregar documento botão para carregar um documento.

  5. No Carregar documento caixa de diálogo, clique no Procurar botão, selecione qualquer arquivo do documento, clique em Abrire em seguida, clique em OK.

    Isso carrega o documento selecionado para o Documentos compartilhados lista e inicia o fluxo de trabalho.

  6. Em Visual Studio, verifique se que o depurador pára no ponto de interrupção ao lado do onWorkflowActivated método.

  7. Pressione F5 para continuar a execução.

  8. Você pode alterar as configurações para o documento aqui, mas deixá-los com os valores padrão por enquanto, clicando em Salvar.

    Você voltará para a Documentos compartilhados página do site da Web do SharePoint padrão.

  9. No Documentos compartilhados de página, verifique o valor abaixo de MySharePointWorkflow coluna é definida como Em andamento. Isso indica que o fluxo de trabalho está em andamento e que o documento está aguardando a revisão.

  10. No Documentos compartilhados página, aponte para o documento, clique na seta para baixo e, em seguida, clique em Editar propriedades do.

  11. Definir Status do documento para Revisão completa e, em seguida, clique em Salvar.

    Você voltará para a Documentos compartilhados página do site da Web do SharePoint padrão.

  12. No Documentos compartilhados de página, verifique o valor sob a MySharePointWorkflow coluna é definida como Revisão completa. Isso indica que a conclusão do fluxo de trabalho e o documento foi revisado.

Próximas etapas

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

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