Uma introdução ao desenvolvedor do SharePoint. Laboratório prático. Manual do laboratório

Transcrição

1 Uma introdução ao desenvolvedor do SharePoint Laboratório prático Manual do laboratório SPCHOL305 - Desenvolvendo um fluxo de trabalho do SharePoint 2010 com formulários de iniciação no Visual Studio 2010 C#

2 Este documento é fornecido no estado em que se encontra. As informações e exibições expressas neste documento, incluindo URLs e outras referências a sites da Internet, podem ser alteradas sem aviso prévio. Você assume o risco de usá-lo. Este documento não oferece a você quaisquer direitos legais sobre propriedade intelectual em qualquer produto da Microsoft. Este documento pode ser copiado e usado para fins internos e de referência Microsoft. Todos os direitos reservados.

3 Sumário SPCHOL 305 DESENVOLVENDO UM FLUXO DE TRABALHO DO SHAREPOINT 2010 COM UM FORMULÁRIOS DE INICIAÇÃO... 2 Objetivo do laboratório... 2 Recursos adicionais... 2 Guia de Introdução... 2 Como fazer logon na máquina virtual... 2 Locais... 2 Pré-requisitos para o laboratório... 3 Como copiar os exemplos de código do documento do Word... 3 Trechos de código... 4 Exercício Tarefa 1: Criar e preparar o projeto... 5 Tarefa 2: Criar uma nova Atividade de fluxo de trabalho para ser usada pelo Fluxo de trabalho reutilizável... 6 Tarefa 3: Adicionar código para criar uma biblioteca de documentos com base nos parâmetros passados para nossa atividade Tarefa 4: Configurar a atividade para implantação Tarefa 5: Adicionar a atividade SPDActivityDemo a ser implantada com o SPCHOL305Ex Tarefa 6: Configurar um recurso usando o Designer de Recursos Tarefa 7: Adicionar e codificar um Receptor de Recursos Tarefa 8: Criar um fluxo de trabalho reutilizável usando o SharePoint Designer Tarefa 9: Importar o fluxo de trabalho reutilizável no Visual Studio Tarefa 10: Associar o fluxo de trabalho a uma lista no SharePoint Resumo do exercício Exercício Tarefa 1: Verifique se há uma lista de clientes no site Tarefa 2: Criar e preparar o projeto Tarefa 2: Criar um novo Formulário de Iniciação de Fluxo de Trabalho a ser usado pelo fluxo de trabalho Tarefa 3: Preencher o Formulário de Iniciação de Fluxo de Trabalho Tarefa 4: Processar dados do Formulário de Iniciação de Fluxo de Trabalho em Workflow Tarefa 5: Implantar e depurar Workflow Resumo do exercício Resumo do laboratório Página 1

4 SPCHOL 305 Desenvolvendo um fluxo de trabalho do SharePoint 2010 com um formulários de iniciação Tempo estimado para conclusão deste laboratório: 30 minutos Objetivo do laboratório Visão geral do exercício O primeiro exercício mostra como criar uma atividade de fluxo de trabalho personalizada usada por um fluxo de trabalho reutilizável do SharePoint Designer e implantá-los juntos como um único *.WSP. Também mostra como importar esse fluxo de trabalho ao Visual Studio O segundo exercício mostra como criar um fluxo de trabalho do SharePoint com um formulário de iniciação e processar os dados do formulário. Visão geral do recurso O SharePoint Designer permite a criação de um fluxo de trabalho reutilizável em várias listas e sites. O fluxo de trabalho pode ser exportado como um arquivo de solução do SharePoint (*.WSP). Recursos adicionais Este laboratório inclui os seguintes recursos adicionais: Este manual do laboratório Código-fonte SPCHOL305_Manual_CS.docx Completed\CS\Ex1 Completed\CS\Ex2 Este documento Código-fonte completo do laboratório. Recursos Resources\CS Diversos recursos usados em todo este laboratório. Guia de Introdução Como fazer logon na máquina virtual Faça logon na máquina virtual como o seguinte usuário: Nome de usuário: Administrator Senha: pass@word1 Locais Este Laboratório prático contém diversos recursos em locais fixos. Por padrão, supõe-se que o diretório HOL base seja C:\Content Packs\Packs\SharePoint 2010 Developer Labs 1.0\Supporting Files\SPCHOL305\Resources. A pasta de trabalho padrão para este laboratório é C:\SPHOLs\SPCHOL305. Página 2

5 Pré-requisitos para o laboratório 1. Navegue até o diretório HOL base Supporting Files\SPCHOL305\Resources e execute o script do PowerShell optimize.ps1: Clique com o botão direito do mouse em optimize.ps1 e selecione Executar com o PowerShell: Figura 1 - Executar o script do PowerShell Isso abrirá uma janela do PowerShell para executar o script. Aguarde até a conclusão do script do PowerShell e fechamento da janela do PowerShell (isso pode demorar um pouco): Figura 2 - Janela do PowerShell executando o script Como copiar os exemplos de código do documento do Word Copiar e colar o código desse documento do Word para o Visual Studio é seguro apenas para as seções de código formatado, por exemplo: Console.WriteLine("This is safe code!"); Página 3

6 O código que não estiver nessas seções poderá conter Unicode ou outros caracteres invisíveis que não são códigos XML ou C#/VB válidos, por exemplo: Console.WriteLine( Este código NÃO é seguro! ); Trechos de código Também é possível usar os trechos de código para inserir o código apropriado no laboratório. Para usar o trecho de código necessário para este laboratório: Clique com o botão direito do mouse no arquivo de código no qual você deseja inserir o trecho de código. Selecione Inserir Trecho: Selecione os trechos de código da galeria Meus Trechos de Código. Página 4

7 Exercício 1 Este primeiro exercício mostra como criar uma atividade de fluxo de trabalho personalizada usada por um fluxo de trabalho reutilizável do SharePoint Designer e implantá-los juntos como um único *.WSP. Também mostra como importar esse fluxo de trabalho ao Visual Studio Tarefa 1: Criar e preparar o projeto Nesta tarefa, você criará um projeto com uma solução Projeto Vazio e usará os controles de usuário do SharePoint. 1. Abra o Visual Studio 2010 em Iniciar Todos os Programas Microsoft Visual Studio 2010 Microsoft Visual Studio No Visual Studio 2010, crie um novo projeto acessando Arquivo Novo Projeto. 3. Selecione o modelo de projeto Visual C# SharePoint 2010 Projeto Vazio do SharePoint. 4. Insira SPCHOL305Ex1 na caixa de texto Nome e insira C:\SPHOLS\SPCHOL305\CS\Ex1 na caixa de texto Local. Figura 3 - Caixa de diálogo Novo Projeto 5. Clique em OK. Página 5

8 6. No SharePoint Customization Wizard, mude o URL para e selecione Deploy as a farm solution. Em seguida, clique em Concluir. Figura 4 - Assistente de personalização do SharePoint 7. O Visual Studio criará o novo projeto SPCHOL305Ex1 e adicionará os arquivos necessários. Tarefa 2: Criar uma nova Atividade de fluxo de trabalho para ser usada pelo Fluxo de trabalho reutilizável 1. No Visual Studio 2010, adicione um novo projeto acessando Arquivo Adicionar Novo Projeto. 2. Mude o Framework para.net Framework 3.5 Figura 5 - Definição da versão do.net Framework 3. Selecione o modelo de projeto Visual C# Fluxo de Trabalho Workflow Activity Library. Página 6

9 4. Insira SPDActivityDemo na caixa de texto Nome e clique em OK. Figura 6 - Caixa de diálogo Novo Projeto 5. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto SPDActivityDemo e selecione Adicionar Referência. 6. Mude para a guia Procurar. Insira C:\Arquivos de Programa\Common Files\Microsoft Shared\Web Server Extensions\14\ISAPI na caixa de texto Nome de arquivo e pressione Enter. Página 7

10 7. Selecione Microsoft.SharePoint.dll e Microsoft.SharePoint.WorkflowActions.dll e clique em OK. Figura 7 - Caixa de diálogo Adicionar Referência 8. No Gerenciador de Soluções, clique com o botão direito do mouse em Activity1.cs e selecione Renomear. 9. Renomeie o Activity1.cs para CreateDocumentLibrary.cs. Página 8

11 Tarefa 3: Adicionar código para criar uma biblioteca de documentos com base nos parâmetros passados para nossa atividade. 1. No Gerenciador de Soluções, clique com o botão direito do mouse no arquivo CreateDocumentLibrary.cs e selecione Exibir Código. 2. Mude a classe base CreateDocumentLibrary de SequenceActivity para Atividade, como mostrado abaixo. public partial class CreateDocumentLibrary : Activity 3. Adicione as seguintes instruções de uso na parte superior do arquivo abaixo das instruções de uso existentes: using Microsoft.SharePoint; using Microsoft.SharePoint.Workflow; using Microsoft.SharePoint.WorkflowActions; Trecho de código: Meus Trechos de Código spchol305_ex1_createdoclib_namespace 4. Adicione uma nova DependencyProperty com o nome UrlProperty à classe CreateDocumentLibrary. Esse será o local onde a biblioteca de documentos será criada. public static DependencyProperty UrlProperty = DependencyProperty.Register("Url", typeof(string), typeof(createdocumentlibrary), new PropertyMetadata("")); [DescriptionAttribute("Url of base site")] [BrowsableAttribute(true)] [DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Visible )] [ValidationOption(ValidationOption.Optional)] public string Url { get { return ((string)(base.getvalue(createdocumentlibrary.urlproperty))); } set { base.setvalue(createdocumentlibrary.urlproperty, value); } } Trecho de código: Meus Trechos de Código spchol305_ex1_createdoclib_urlproperty Página 9

12 5. Adicione uma nova DependencyProperty à classe CreateDocumentLibrary com o nome DocLibNameProperty. Esse será o nome da DocumentLibrary criada pela atividade. public static DependencyProperty DocLibNameProperty = DependencyProperty.Register("DocLibName", typeof(string), typeof(createdocumentlibrary), new PropertyMetadata("")); [DescriptionAttribute("Used as doc lib name")] [BrowsableAttribute(true)] [DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Visible )] [ValidationOption(ValidationOption.Optional)] public string DocLibName { get { return ((string)(base.getvalue(createdocumentlibrary.doclibnameproperty))); } set { base.setvalue(createdocumentlibrary.doclibnameproperty, value); } } Trecho de código: Meus Trechos de Código spchol305_ex1_createdoclib_doclibproperty 6. Adicione o seguinte código abaixo do construtor CreateDocumentLibrary: protected override ActivityExecutionStatus Execute(ActivityExecutionContext executioncontext) { CreateDocLib(); return ActivityExecutionStatus.Closed; } private void CreateDocLib() { using (SPSite sps = new SPSite(Url)) { using (SPWeb spw = sps.rootweb) { Guid ID = spw.lists.add(doclibname, DocLibName + " Document Library", SPListTemplateType.DocumentLibrary); SPList spdl = spw.lists[id]; spdl.onquicklaunch = true; spdl.update(); } } } Trecho de código: Meus Trechos de Código spchol305_ex1_createdoclib_execute Página 10

13 Tarefa 4: Configurar a atividade para implantação. 1. Configure a atividade com um nome forte. Adicione SPDActivityDemo.snk da pasta Recursos. (Local no início deste manual). Ao projeto SPDActivityDemo. Figura 8 - Adicionar item existente 2. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto SPDActivityDemo e selecione Propriedades. 3. Clique na guia Assinatura, marque Assinar o Assembly e selecione SPDActivityDemo.snk. Figura 9 - Assinatura 4. Compile o projeto (CTRL-SHIFT-B) e corrija quaisquer erros. Página 11

14 5. Clique com o botão direito do mouse no projeto SPCHOL305Ex1 e clique em Adicionar, SharePoint Mapped Folder Figura 10 - Pasta Mapeada do SharePoint Página 12

15 6. Selecione TEMPLATE/1046/Workflow na caixa de diálogo Adicionar Pasta Mapeada do SharePoint e selecione OK. Figura 11 - Caixa de diálogo Adicionar Pasta Mapeada do SharePoint 7. No Gerenciador de Soluções, expanda a recém-adicionada pasta Fluxo de trabalho. 8. Clique com o botão direito do mouse na pasta SPCHOL305Ex1 (se houver) e selecione Excluir. 9. Clique com o botão direito do mouse na pasta Fluxo de trabalho e selecione Adicionar Novo Item. Página 13

16 10. Selecione o modelo Arquivo XML e nomeie o arquivo como SPDActivityDemo.ACTIONS, em seguida, pressione Adicionar. Figura 12 - Caixa de diálogo Adicionar Novo Item Página 14

17 11. Substitua o conteúdo de SPDActivityDemo.ACTIONS pelo seguinte <?xml version="1.0" encoding="utf-8"?> <WorkflowInfo> <Actions Sequential="then" Parallel="and"> <Action Name="Create Document Library" ClassName="SPDActivityDemo.CreateDocumentLibrary" Assembly="SPDActivityDemo, Version= , Culture=neutral, PublicKeyToken=a66e91d2ee2fa8f8" AppliesTo="all" Category="Labs"> <RuleDesigner Sentence="Document Library Name %1 to site %2."> <FieldBind Field="DocLibName" Text="Document Library Name" DesignerType="TextArea" Id="1"/> <FieldBind Field="Url" Text="Url of base site" Id="2" DesignerType="TextArea"/> </RuleDesigner> <Parameters> <Parameter Name="DocLibName" Type="System.String, mscorlib" Direction="In" /> <Parameter Name="Url" Type="System.String, mscorlib" Direction="In" /> </Parameters> </Action> </Actions> </WorkflowInfo> Trecho de código: Meus Trechos de XML spchol305_ex1_workflowactions_xml 12. Compile o projeto SPDActivityDemo Tarefa 5: Adicionar a atividade SPDActivityDemo a ser implantada com o SPCHOL305Ex1. 1. No Gerenciador de Soluções, expanda a pasta Pacote no projeto SPCHOL305Ex1. 2. Clique duas vezes no arquivo Package.package para mostrar o designer do Pacote. 3. Clique na guia Advanced na parte inferior do designer. Figura 13 - Guia Pacote Avançado Página 15

18 4. Clique no botão Adicionar e selecione Adicionar Assembly da Saída do Projeto. 5. Na caixa de diálogo Adicionar Assembly Existente da Saída do Projeto, clique no combo Projeto de Origem e selecione SPDActivityDemo\bin. Figura 14 - Caixa de diálogo Adicionar Assembly Existente da Saída do Projeto 6. Clique no botão em Controles Seguros. Em Controles Seguros adicione o seguinte: Nome do Assembly: SPDActivityDemo, Version= , Culture=neutral, PublicKeyToken= a66e91d2ee2fa8f8 Namespace: SPDActivityDemo Segurança: Verificada Nome do Tipo: * 7. Depois de concluir o preenchimento dos detalhes do controle seguro, pressione Enter para confirmar. 8. Clique em OK Página 16

19 Tarefa 6: Configurar um recurso usando o Designer de Recursos 1. Clique com o botão direito do mouse na pasta Recursos no Gerenciador de Soluções no projeto SPCHOL305Ex1 e selecione Adicionar Recurso. 2. Clique com o botão direito do mouse em Recurso1 e o renomeie para SPCHOL305Ex1Feature. 3. No Designer de recursos, mude o escopo do SPCHOL305Ex1Feature para WebApplication. Figura 15 - Designer de Recursos Tarefa 7: Adicionar e codificar um Receptor de Recursos 1. Clique com o botão direito do mouse no recurso SPCHOL305Ex1Feature no Gerenciador de Soluções e selecione Adicionar Receptor de Eventos 2. Adicione uma instrução de uso na parte superior do código: using Microsoft.SharePoint.Administration; Página 17

20 3. Adicione o seguinte código à sua declaração de classe FeatureReceiver: public override void FeatureActivated(SPFeatureReceiverProperties properties) { SPWebApplication wappcurrent = (SPWebApplication)properties.Feature.Parent; SPWebConfigModification modauthorizedtype = new SPWebConfigModification(); modauthorizedtype.name = "AuthType"; modauthorizedtype.owner = "SPDActivityDemo"; modauthorizedtype.path = "configuration/system.workflow.componentmodel.workflowcompiler/authorizedtypes"; modauthorizedtype.type = SPWebConfigModification.SPWebConfigModificationType.EnsureChildNode; modauthorizedtype.value = "<authorizedtype Assembly=\"SPDActivityDemo, " + "Version= , Culture=neutral, PublicKeyToken=a66e91d2ee2fa8f8\" " + "Namespace=\"SPDActivityDemo\" TypeName=\"*\" Authorized=\"True\" />"; wappcurrent.webconfigmodifications.add(modauthorizedtype); wappcurrent.webservice.applywebconfigmodifications(); } Trecho de código: Meus Trechos de Código spchol305_ex1_spchol305feature_receiver 4. Compile e implemente o projeto SPCHOL305Ex1Feature, clicando com o botão direito do mouse no nome do projeto e selecionando Implantar. Figura 16 - Implantar Solução Página 18

21 Tarefa 8: Criar um fluxo de trabalho reutilizável usando o SharePoint Designer 1. Abra o SharePoint Designer 2010 em Iniciar Todos os Programas SharePoint Microsoft SharePoint Designer Clique em Sites e em Abrir Site. Figura 17 - Botão do menu Sites no SharePoint Designer 2010 Caso você receba uma solicitação de credenciais, use: Nome de usuário: Administrator Senha: pass@word1 Página 19

22 3. Mude Nome do site para e selecione Abrir Figura 18 - Caixa de diálogo Abrir Site Página 20

23 4. Clique no botão Fluxo de Trabalho Reutilizável, quando solicitado, nomeie o fluxo de trabalho como SPDWorkflow e clique no botão OK para criar o fluxo de trabalho reutilizável. Figura 19 - Criar Fluxo de Trabalho Reutilizável Página 21

24 5. Clique no botão Ações na faixa de opções e role até Labs e clique em Create Document Library. Observação: Fizemos esta atividade anteriormente no Visual Studio. Figura 20 - Adicionar ação Criar Biblioteca de Documentos 6. Clique na Etapa 1. Na caixa ao lado de Documentar Nome da Biblioteca, clique no botão Fx. 7. Selecione Item Atual como a Fonte de Dados e Título como o valor de Campo da fonte. Em seguida, pressione OK. Página 22

25 Figura 21 - Caixa de diálogo Consultar Cadeia de Caracteres 8. Digite como o URL do site base. 9. Clique em Salvar, na faixa de opções. Figura 22 - Configurar a ação do fluxo de trabalho 10. Depois de salvar, clique no botão Publicar na faixa de opções. Aguarde a publicação do fluxo de trabalho. Página 23

26 Figura 23 - Publicar fluxo de trabalho 11. Depois de salvar, clique em Fluxos de trabalho na navegação esquerda. 12. Clique novamente no fluxo de trabalho abaixo de Fluxo de Trabalho Reutilizável para mostrar as propriedades do fluxo de trabalho. Clique em Salvar como Modelo para salvar o arquivo.wsp na lista do SharePoint Biblioteca de Ativos do Site. Figura 24 - Salvar como modelo 13. Abra um navegador da web em Página 24

27 14. Clique em Ações do Site -> Exibir Todo o Conteúdo do Site -> Biblioteca de Ativos do Site. Figura 25 - Biblioteca de ativos do site 15. Clique no menu suspenso SPDWorkflow e clique em Enviar para -> Baixar uma Cópia. Figura 26 - Baixar WSP Página 25

28 16. Salve o WSP em um local que você possa acessar em uma etapa subsequente (como a Área de trabalho) Figura 27 - Caixa de diálogo Salvar como Página 26

29 Tarefa 9: Importar o fluxo de trabalho reutilizável no Visual Studio 1. De volta ao Visual Studio 2010, clique com o botão direito do mouse na solução SPCHOL305Ex1, na janela Gerenciador de Soluções e clique em Adicionar Novo Projeto. 2. Selecione o modelo de projeto Visual C# SharePoint 2010 Importar Fluxo de Trabalho Reutilizável. 3. Mude o Nome para SPDWorkflowImport. Figura 28 - Caixa de diálogo Novo Projeto 4. Clique em OK. Página 27

30 5. Certifique-se de que o URL seja Clique em Avançar. Figura 29 - Assistente de personalização do SharePoint Página 28

31 6. Quando receber a solicitação de importação do arquivo.wsp, navegue até o arquivo SPDWorkflow.wsp salvo anteriormente. Clique em Avançar. Figura 30 - Assistente de personalização do SharePoint Página 29

32 7. Clique em Concluir. OBSERVAÇÃO Se você estiver usando o Visual Studio 2010 Beta 2, ocorrerá um erro e não será possível completar este laboratório. Se você estiver usando uma versão mais recente do Visual Studio 2010, continue. Figura 31 - Assistente de personalização do SharePoint Página 30

33 8. Clique duas vezes no Pacote no projeto SPCHOL305Ex1 e adicione o recurso Converted workflows ao Pacote. Figura 32 - Explorador de Pacotes do SharePoint Página 31

34 9. Clique com o botão direito do mouse no projeto SPDWorkflowImtord e selecione Adicionar Referência. 10. Selecione a referência do projeto SPDActivityDemo e clique em OK. Figura 33 - Adicionar referência de assembly 11. No projeto SPDWorkflowImport, expanda o nó Fluxos de Trabalho\SPDWorkflowFT. 12. Abra Elements.xml 13. Mude o Nome do fluxo de trabalho para SPDWorkflowFT. Figura 34 - Configuração do nome do fluxo de trabalho importado 14. Salve o projeto, compile a solução e implante o projeto SPCHOL305Ex1. Página 32

35 Tarefa 10: Associar o fluxo de trabalho a uma lista no SharePoint 1. Navegue até 2. Clique em Ações do Site Mais Opções 3. Selecione Lista Personalizada na lista de itens. 4. Nomeie a lista Clientes e pressione Criar. 5. Abra as Configurações da lista Figura 35 - Configurações da lista 6. Em Permissões e Gerenciamento clique em Configurações do Fluxo de Trabalho. 7. Defina as configurações do fluxo de trabalho da lista da seguinte maneira: Selecione um modelo de fluxo de trabalho: SPDWorkflowFT Digite um nome exclusivo para este fluxo de trabalho: Create Doc Lib for Customer Selecione uma lista de tarefas: Tarefas Selecione uma lista de histórico: Histórico do Fluxo de Trabalho Opções de início: Iniciar este fluxo de trabalho quando um novo item for criado Página 33

36 Figura 36 - Configurações do fluxo de trabalho 8. Clique em OK 9. Navegue até a lista Clientes e selecione Itens Novo Item. Figura 37 - Criar Novo Item Página 34

37 10. Insira Northwind como nome do novo cliente e pressione Salvar quando a caixa de diálogo Clientes Novo Item for exibida. Figura 38 - Caixa de diálogo Novo Item 11. Aguarde enquanto uma nova biblioteca de documentos com o mesmo nome ser criada automaticamente. Resumo do exercício Neste exercício, você construiu uma nova Atividade de fluxo de trabalho para usar em fluxos de trabalho do SharePoint Designer. Você construiu um fluxo de trabalho reutilizável no SharePoint Designer e usou a atividade personalizada. Em seguida, você importou esse fluxo de trabalho reutilizável em Visual Studio 2010 e implantou de volta do fluxo de trabalho final no SharePoint. Exercício 2 Este exercício mostra como criar um fluxo de trabalho do SharePoint com um formulário de iniciação e processar os dados do formulário. Tarefa 1: Verifique se há uma lista de clientes no site 1. Navegue até o site 2. Verifique se existe a Lista de Clientes chamada Cliente ; em caso negativo, crie-a. Página 35

38 Tarefa 2: Criar e preparar o projeto Nesta tarefa, você criará um projeto com uma solução de Fluxo de Trabalho Sequencial e usará os controles de usuário do SharePoint. 1. No Visual Studio 2010 e no menu, selecione Arquivo Novo Novo Projeto. 2. Selecione o modelo de projeto Visual C# SharePoint 2010 Sequential Workflow. 3. Mude o Nome para SPCHOL305Ex2. Figura 39 - Caixa de diálogo Novo Projeto 4. Clique em OK. Página 36

39 5. Mude o URL para 6. Figura 40 - Assistente de personalização do SharePoint Clique em Avançar. Figura 41 - Assistente de personalização do SharePoint Clique em Avançar. Página 37

40 7. Mude The library or list to associate your workflow with: para Client Figura 42 - Assistente de personalização do SharePoint Clique em Avançar. 8. Desmarque The workflow starts automatically when an item is created Figura 43 - Assistente de personalização do SharePoint 9. Clique em Concluir. Página 38

41 Tarefa 2: Criar um novo Formulário de Iniciação de Fluxo de Trabalho a ser usado pelo fluxo de trabalho. 1. Clique com o botão direito do mouse em Workflow1 no projeto de fluxo de trabalho SPCHOL305Ex2, clique em Adicionar, Novo Item. Figura 44 - Adicionar Novo Item 2. Selecione o modelo de item Visual C# SharePoint 2010 Workflow Initiation Form. 3. Mude o Nome para WorkflowIntiationForm.aspx. Figura 45 Caixa de diálogo Novo Item 4. Clique em Adicionar. Página 39

42 Tarefa 3: Preencher o Formulário de Iniciação de Fluxo de Trabalho. 1. Adicione o seguinte código ao espaço reservado para conteúdo Principal: <br /> <br /> <br /> <asp:checkbox ID="Checkbox" runat="server" Text="Fast Track Customer" /> Trecho de código: Meus Trechos de XML spchol305_ex2_initiationform_html Figura 46 - Formulário de Iniciação de Fluxo de Trabalho 2. Abra o WorkflowInitiationForm.aspx.cs. no método GetInitiationData, substitua return string.empty; pelo seguinte código: return Checkbox.Checked.ToString(); Trecho de código: Meus Trechos de XML spchol305_ex2_workflowinitiationform Figura 47 - Código do Formulário de Iniciação de Fluxo de Trabalho Página 40

43 Tarefa 4: Processar dados do Formulário de Iniciação de Fluxo de Trabalho em Workflow1 1. Abra o Designer de Exibição de Workflow1.cs. Na Caixa de ferramentas, adicione uma atividade de Código (Windows Workflow v3.0) após a atividade onworkflowactivated1. Figura 48 - Designer de Fluxo de Trabalho 2. Clique duas vezes em codeactivity1 para gerar um evento ExecuteCode no código. Adicione o seguinte código ao método codeactivity1_executecode. Defina um ponto de quebra no método. if (workflowproperties.initiationdata == "True") { System.Diagnostics.Debug.WriteLine("This is a fast track customer"); } Trecho de código: Meus Trechos de XML spchol305_ex2_codeactivity1 Figura 49 - Executar método de código Página 41

44 Tarefa 5: Implantar e depurar Workflow1 1. Pressione F5 para implantar e depurar o novo fluxo de trabalho 2. Navegue até a lista de Clientes e crie um novo item na lista intitulada Contoso Figura 50 - Lista de Clientes 3. Clique na lista suspensa de edição do item Contoso e selecione Fluxos de Trabalho. Inicie o SPCHOL305Ex2 Workflow1 neste item. Figura 51 - Iniciar fluxo de trabalho 4. Marque a caixa de seleção Fast Track Customer e clique no botão Iniciar Fluxo de Trabalho. Figura 52 - Formulário de Iniciação de Fluxo de Trabalho Página 42

45 5. O ponto de quebra estabelecido no código deverá ser atingido agora. Use F10 para percorrer o código. Figura 53 - Ponto de quebra do código 6. Na janela de saída, o valor submetido no Formulário de Iniciação foi capturado Figura 54 - Saída de depuração 7. Fluxo de trabalho preenchido Figura 55 - Fluxo de trabalho preenchido Resumo do exercício Neste exercício, você criou um fluxo de trabalho do SharePoint com um formulário de iniciação e processou os dados do formulário. Página 43

46 Resumo do laboratório Neste laboratório, você realizou os seguintes exercícios. Criou uma Ação de Fluxo de Trabalho no Visual Studio 2010 Criou um Projeto Vazio do SharePoint e incluiu a Ação de Fluxo de Trabalho nesta solução Implantou a Ação de Fluxo de Trabalho como um pacote de soluções WSP Usou a Ação de Fluxo de Trabalho para criar um Fluxo de Trabalho Reutilizável do SharePoint Designer 2010 Usou o SharePoint Designer para criar um pacote WSP que pode ser importado de volta ao Visual Studio 2010 Importou um WSP do SharePoint Designer 2010 no Visual Studio Usou o Visual Studio 2010 para criar um Formulário de Iniciação e associá-lo a um Fluxo de Trabalho do SharePoint Neste laboratório, você aprendeu como criar uma Ação de Fluxo de Trabalho do SharePoint. Você aprendeu a incluir esta Ação em um pacote de soluções WSP do SharePoint. Você também uso o SharePoint Designer 2010 para criar um fluxo de trabalho reutilizável usado na Ação de Fluxo de Trabalho do Visual Studio. Em seguida, você usa o SharePoint Designer para gerar um WSP que foi importado de volta para o Visual Studio. Você também usou um Formulário de iniciação para capturar dados do usuário e processou esses dados no fluxo de trabalho. Página 44