Criar soluções de fluxo de trabalho do SharePoint

O Visual Studio fornece ferramentas para ajudá-lo a criar fluxos de trabalho personalizados que gerenciam o ciclo de vida de documentos e itens de lista em um site do SharePoint. Os itens fornecidos incluem um designer, um conjunto de controles de atividade e as referências de assembly necessárias. O Visual Studio também inclui o Assistente de Personalização do SharePoint, para ajudar a criar e configurar os fluxos de trabalho.

Para obter mais informações sobre o SharePoint, confira Produtos e Tecnologias do Microsoft SharePoint.

Fluxos de trabalho no SharePoint

Ao adicionar um fluxo de trabalho a uma biblioteca ou lista do SharePoint, você impõe um processo empresarial em todos os itens na biblioteca ou na lista. Um fluxo de trabalho descreve as ações que o sistema ou os usuários devem executar em cada item, como enviar o item a ser editado e revisado. Essas ações, conhecidas como atividades, são os blocos de construção do fluxo de trabalho.

Você pode criar fluxos de trabalho do SharePoint no Visual Studio e implantá-los em um site do SharePoint. Depois que um fluxo de trabalho é implantado no SharePoint, você o associa a uma biblioteca ou lista. Em seguida, ele pode ser iniciado automaticamente por um processo ou manualmente por um usuário. Para obter mais informações sobre a operação de fluxo de trabalho, confira Desenvolver fluxos de trabalho do SharePoint usando o Visual Studio.

Criar fluxos de trabalho personalizados do SharePoint

Dois projetos de fluxo de trabalho do SharePoint estão disponíveis para você no Visual Studio: Fluxo de Trabalho Sequencial e Fluxo de Trabalho da Máquina de Estado.

Um fluxo de trabalho sequencial representa uma série de etapas. As etapas são executadas uma após a outra até que a última atividade seja concluída. Fluxos de trabalho sequenciais são sempre estritamente sequenciais em sua execução. Como eles podem receber eventos externos e incluir fluxos lógicos paralelos, a ordem exata de execução pode variar. A ilustração a seguir mostra um exemplo de um fluxo de trabalho sequencial.

Um fluxo de trabalho da máquina de estado representa um conjunto de estados, transições e ações. As etapas em um fluxo de trabalho da máquina de estado são executadas de forma assíncrona. Isso significa que elas não são necessariamente executadas uma após a outra, mas são disparadas por ações e estados. Um estado é atribuído como o estado inicial e, com base em um evento, uma transição é feita para outro estado. A máquina de estado pode ter um estado final que determina o fim do fluxo de trabalho. O diagrama a seguir mostra um exemplo de um fluxo de trabalho da máquina de estado.

Para obter mais informações sobre tipos de fluxo de trabalho, consulte Tipos de fluxo de trabalho.

Usar o assistente

Ao criar um projeto de fluxo de trabalho do SharePoint no Visual Studio, primeiro você especifica suas configurações no Assistente de Personalização do SharePoint. O assistente usa essas configurações para criar um projeto no Gerenciador de Soluções. Este projeto contém um arquivo de código, vários arquivos usados para implantar o fluxo de trabalho e referências a assemblies necessários para criar um fluxo de trabalho personalizado do SharePoint.

Depois de criar o fluxo de trabalho, você pode modificar suas propriedades na janela Propriedades. Embora a maioria das propriedades de fluxo de trabalho possa ser alterada diretamente na janela Propriedades, algumas exigem que você clique em um botão de reticências () para alterar seus valores. Este botão reinicia o Assistente de Personalização do SharePoint. Depois de fazer as alterações no valor da propriedade, escolha o botão Concluir para finalizá-las.

Observação

A propriedade Tipo de Fluxo de Trabalho é somente leitura e não pode ser alterada. Se você quiser alterar o tipo de fluxo de trabalho, crie outro fluxo de trabalho.

Criar um fluxo de trabalho do SharePoint

Depois de definir todas as etapas no processo empresarial, use o designer de fluxo de trabalho do Visual Studio para projetar o fluxo de trabalho do SharePoint. Para abrir o designer, clique duas vezes em Workflow1.cs ou Workflow1.vb em Gerenciador de Soluções ou abra o menu de atalho para qualquer um desses arquivos e escolha Abrir.

Atividades

Para criar um fluxo de trabalho, adicione atividades da Caixa de Ferramentas a um agendamento de fluxo de trabalho no designer. Um agendamento de fluxo de trabalho contém a sequência de atividades na ordem em que elas devem ser executadas.

Há dois tipos de atividades:

• Atividades simples executam uma única unidade de trabalho, como "atraso por 1 dia" ou "iniciar serviço Web".

• As atividades compostas contêm outras atividades. Por exemplo, uma atividade condicional pode conter dois branches.

  Ambos os tipos de atividades estão disponíveis na Caixa de Ferramentas.

  As atividades podem ter propriedades, métodos e eventos. Use a janela Propriedades para definir as propriedades de uma atividade.

  Você também pode criar uma atividade personalizada. Para obter mais informações, consulte Instruções passo a passo: criar uma atividade personalizada de fluxo de trabalho do site.

  As atividades são organizadas nas seguintes guias na Caixa de Ferramentas:

• Fluxo de Trabalho do SharePoint

• Fluxo de trabalho do Windows v3.0

• Fluxo de trabalho do Windows v3.5

  Nem todas as principais atividades de fluxo de trabalho têm suporte do SharePoint. Para obter mais informações, consulte Visão geral das atividades de fluxo de trabalho para Windows SharePoint Services.

Atividades de fluxo de trabalho do SharePoint

As guias Fluxo de Trabalho do SharePoint contêm atividades especializadas para uso no Microsoft SharePoint Foundation. Essas atividades simplificam o desenvolvimento de fluxos de trabalho do ciclo de vida do documento. Para obter mais informações sobre as atividades listadas na guia Fluxo de Trabalho do SharePoint, consulte Visão geral das atividades de fluxo de trabalho para Windows SharePoint Services.

Atividades de fluxo de trabalho do Windows

As guias Fluxo de trabalho do Windows contêm atividades fornecidas pelo Windows Workflow Foundation. Você pode usar essas atividades para criar agendas de fluxo de trabalho para qualquer tipo de aplicativo de fluxo de trabalho do Windows.

Para obter mais informações sobre as atividades listadas na guia Fluxos de Trabalho do Windows, consulte Atividades do Windows Workflow Foundation. Para obter mais informações sobre o Windows Workflow Foundation, consulte Visão geral do Windows Workflow Foundation.

Trabalhar com atividades no designer

Seu agendamento de fluxo de trabalho pode conter uma combinação de atividades do Fluxo de Trabalho do Windows e atividades do Fluxo de Trabalho do SharePoint.

O designer exibe indicações visuais para ajudá-lo a posicionar e configurar as atividades corretamente. Quando você arrasta ou copia uma atividade para o agendamento de fluxo de trabalho, o designer exibe ícones verdes de sinal de adição (+) que mostram locais válidos para essa atividade no fluxo de trabalho. Você não pode posicionar uma atividade em um local onde ela não seria válida. Por exemplo, você não pode posicionar uma atividade Send como a primeira atividade em um branch de atividade Listen. Para obter mais informações, consulte Centro de Desenvolvedores do SharePoint Designer.

Coletar informações durante o fluxo de trabalho

Talvez você queira coletar informações de usuários em horários predefinidos no fluxo de trabalho. Você pode coletar informações usando formulários ou propriedades de item.

Formulários

Os formulários são como caixas de diálogo que contêm perguntas e fornecem maneiras dos usuários fornecerem respostas.

Há quatro tipos de formulários que podem ser usados em um fluxo de trabalho:

• Associação

• Iniciação

• Modification

• Tarefa

  Destes, o Visual Studio inclui modelos de item para formulários de associação e iniciação. Um exemplo de um formulário de associação é aquele que permite que o administrador que instala o fluxo de trabalho insira parâmetros relacionados ao fluxo de trabalho, como um limite de gastos para um fluxo de trabalho de despesas. Um exemplo de um formulário de iniciação é aquele que permite que o usuário de um fluxo de trabalho de despesas insira o valor gasto no fluxo de trabalho. Para obter mais informações sobre esses tipos de formulários, consulte Modelos de projeto e de item de projeto do SharePoint.

Propriedades do item

Você também pode coletar informações dos usuários usando as propriedades de um item na biblioteca ou na lista do SharePoint. O arquivo de código principal (Workflow1.cs ou Workflow1.vb) declara uma instância da classe Microsoft.SharePoint.Workflow.SPWorkflowActivationProperties.WorkflowProperties chamada workflowProperties. Use o objeto workflowProperties para acessar as propriedades da biblioteca ou lista no código. Para obter um exemplo, confira Passo a passo: criar e depurar uma solução de fluxo de trabalho do SharePoint.

Depurar um modelo de fluxo de trabalho do SharePoint

Você pode depurar um projeto de fluxo de trabalho do SharePoint da mesma forma que depura outros projetos baseados na Web do Visual Studio. Quando você inicia o depurador do Visual Studio, o Visual Studio usa as configurações especificadas no Assistente de Personalização do SharePoint para abrir o site apropriado do SharePoint e associar automaticamente o modelo de fluxo de trabalho à biblioteca ou lista apropriada. O Visual Studio também anexa o depurador do Visual Studio ao processo do Microsoft SharePoint Foundation chamado w3wp.exe.

Para testar o fluxo de trabalho, você deve iniciá-lo manualmente. Para obter mais informações, consulte a seção "Depurando fluxos de trabalho" em Depurando soluções do SharePoint. Para obter mais informações sobre a depuração de aplicativos Web do Visual Studio, consulte Depurar aplicativos Web e script.

Implantar um modelo de fluxo de trabalho do SharePoint

Os projetos de fluxo de trabalho do SharePoint do Visual Studio são implantados da mesma forma que outros projetos do SharePoint do Visual Studio. Para obter mais informações, confira Empacotar e implantar soluções do SharePoint.

Importar fluxos de trabalho reutilizáveis globalmente

Além de criar fluxos de trabalho reutilizáveis específicos do site, o SharePoint Designer permite que você crie fluxos de trabalho reutilizáveis globalmente, que são fluxos de trabalho que podem ser usados por qualquer site do SharePoint. O projeto Importar Fluxo de Trabalho Reutilizável no Visual Studio atualmente não importa fluxos de trabalho reutilizáveis globalmente. No entanto, você pode usar o SharePoint Designer para converter um fluxo de trabalho reutilizável globalmente em um fluxo de trabalho reutilizável ou importar o fluxo de trabalho como um fluxo de trabalho declarativo não convertido. Para obter mais informações, confira Importar itens de um site existente do SharePoint.

Tópicos relacionados

Título	Descrição
Passo a passo: criar e depurar uma solução de fluxo de trabalho do SharePoint	Guia você passo a passo na criação e depuração de um fluxo de trabalho simples do Visual Studio.
Passo a passo: Criar um fluxo de trabalho com formulários de associação e iniciação	Guia você passo a passo na criação de um fluxo de trabalho do Visual Studio mais completo com formulários de Associação e Iniciação.
Instruções passo a passo: adicionar uma página de aplicativo a um fluxo de trabalho	Baseia-se no tópico Passo a passo: Criar um fluxo de trabalho com formulários de associação e iniciação adicionando uma página de aplicativo .aspx adicional que relata os dados inseridos no fluxo de trabalho.
Instruções passo a passo: criar uma atividade personalizada de fluxo de trabalho do local	Demonstra como executar duas tarefas principais: criar um fluxo de trabalho no nível do site e criar uma atividade de fluxo de trabalho personalizada.
Informações passo a passo: importar um fluxo de trabalho reutilizável do designer do SharePoint para o Visual Studio	Demonstra como importar fluxos de trabalho declarativos reutilizáveis criados no SharePoint Designer 2010 para um projeto do SharePoint do Visual Studio.

Confira também

• Desenvolver soluções do SharePoint
• Compilar e depurar soluções do SharePoint
• Criar páginas de aplicativo para o SharePoint