Návod: Vytvoření a ladění řešení pracovního postupu SharePointu

Tento názorný postup ukazuje, jak vytvořit základní šablonu sekvenčního pracovního postupu. Pracovní postup zkontroluje vlastnost sdílené knihovny dokumentů a určí, jestli byl dokument zkontrolován. Pokud byl dokument zkontrolován, pracovní postup se dokončí.

Tento návod znázorňuje následující úlohy:

• Vytvoření projektu sekvenčního pracovního postupu definice seznamu SharePointu v sadě Visual Studio

• Vytváření aktivit pracovního postupu

• Zpracování událostí aktivity pracovního postupu

Poznámka:

I když tento návod používá sekvenční projekt pracovního postupu, proces je stejný pro projekt pracovního postupu stavového počítače.

Počítač může také zobrazit různé názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio v následujících pokynech. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace naleznete v tématu Přizpůsobení integrovaného vývojového prostředí sady Visual Studio.

Požadavky

K dokončení tohoto návodu budete potřebovat následující komponenty:

• Podporované edice systému Microsoft Windows a SharePoint.

• Visual Studio.

Přidání vlastností do knihovny sdílených dokumentů SharePointu

Ke sledování stavu kontroly dokumentů v knihovně Sdílených dokumentů vytvoříme tři nové vlastnosti pro sdílené dokumenty na sharepointovém webu: Status, Assigneea Review Comments. Tyto vlastnosti definujeme v knihovně sdílených dokumentů .

Přidání vlastností do knihovny sdílených dokumentů SharePointu

1. Otevřete sharepointový web, například název systému http://</>SitePages/Home.aspx, ve webovém prohlížeči.

2. Na panelu QuickLaunch zvolte SharedDocuments.

3. Na pásu karet Nástroje knihovny zvolte Knihovnu a pak kliknutím na tlačítko Vytvořit sloupec na pásu karet vytvořte nový sloupec.

4. Pojmenujte sloupec Stav dokumentu, nastavte jeho typ na Volba (nabídka, ze které chcete vybírat), zadejte následující tři možnosti a pak zvolte tlačítko OK :

   • Kontrola potřebná

   • Zkontrolovat dokončeno

   • Požadované změny

5. Vytvořte dva další sloupce a pojmenujte je Assignee a Review Comments (Revize komentářů). Nastavte typ sloupce Assignee jako jeden řádek textu a sloupec Review Comments (Zkontrolovat komentáře) nastavte jako více řádků textu.

Povolení úprav dokumentů bez nutnosti rezervace

Šablonu pracovního postupu můžete snadněji otestovat, když budete moct upravovat dokumenty, aniž byste je museli rezervovat. V dalším postupu nakonfigurujete sharepointový web tak, aby to povolil.

Povolení úprav dokumentů bez jejich rezervace

1. Na panelu QuickLaunch zvolte odkaz Sdílené dokumenty .

2. Na pásu karet Nástroje knihovny zvolte kartu Knihovna a potom klikněte na tlačítko Knihovna Nastavení a zobrazte Nastavení stránku Knihovna dokumentů.

3. V části Obecné Nastavení zvolte odkaz Nastavení správy verzí a zobrazte stránku Nastavení správy verzí.

4. Ověřte, že nastavení Vyžadovat, aby byly dokumenty rezervovány, než je možné je upravit , je Ne. Pokud ne, změňte ho na Ne a pak zvolte tlačítko OK.

5. Zavřete prohlížeč.

Vytvoření projektu sekvenčního pracovního postupu SharePointu

Sekvenční pracovní postup je sada kroků, které se provádějí v pořadí, dokud se nedokončí poslední aktivita. V tomto postupu vytvoříme sekvenční pracovní postup, který bude platit pro seznam sdílených dokumentů. Průvodce pracovním postupem umožňuje přidružit pracovní postup k definici webu nebo definici seznamu a umožňuje určit, kdy se pracovní postup spustí.

Vytvoření projektu sekvenčního pracovního postupu SharePointu

1. Spusťte Visual Studio.

2. Na řádku nabídek zvolte Soubor>nový>projekt, aby se zobrazilo dialogové okno Nový projekt.

3. Rozbalte uzel SharePointu v sadě Visual C# nebo Visual Basic a zvolte uzel 2010.

4. V podokně Šablony zvolte šablonu projektu SharePointu 2010.

5. Do pole Název zadejte MySharePointWorkflow a pak zvolte tlačítko OK.

   Zobrazí se Průvodce přizpůsobením SharePointu.

6. Na stránce Zadat web a úroveň zabezpečení pro ladění zvolte tlačítko nasadit jako řešení farmy a pak zvolte tlačítko Dokončit, abyste přijali úroveň důvěryhodnosti a výchozí web.

   Tento krok nastaví úroveň důvěryhodnosti pro řešení jako řešení farmy, což je jediná dostupná možnost pro projekty pracovního postupu. Další informace najdete v tématu Aspekty řešení v izolovaném prostoru (sandbox).

7. V Průzkumník řešení zvolte uzel projektu a potom na řádku nabídek zvolte Přidat novou položku projektu>.

8. V části Visual C# nebo Visual Basic rozbalte uzel SharePointu a pak zvolte uzel 2010.

9. V podokně Šablony zvolte šablonu Sekvenční pracovní postup (pouze řešení farmy) a pak zvolte tlačítko Přidat.

   Zobrazí se Průvodce přizpůsobením SharePointu.

10. Na stránce Zadat název pracovního postupu pro ladění přijměte výchozí název (MySharePointWorkflow – Workflow1). Ponechte výchozí hodnotu typu šablony pracovního postupu, List Workflow a pak zvolte tlačítko Další .

11. Na stránce Chcete, aby sada Visual Studio automaticky přidružila pracovní postup v relaci ladění? Pokud chcete přijmout všechna výchozí nastavení, zvolte tlačítko Další.

    Tento krok automaticky přidruží pracovní postup ke knihovně Sdílených dokumentů.

12. Na stránce Zadat podmínky pro zahájení pracovního postupu ponechte výchozí možnosti vybrané v části Jak má pracovní postup začít? a zvolte tlačítko Dokončit.

    Tato stránka umožňuje zadat, kdy se pracovní postup spustí. Ve výchozím nastavení se pracovní postup spustí buď ručně, když ho uživatel spustí v SharePointu nebo když se vytvoří položka, ke které je pracovní postup přidružený.

Vytváření aktivit pracovního postupu

Pracovní postupy obsahují jednu nebo více aktivit , které představují akce, které se mají provést. Pomocí návrháře pracovního postupu uspořádejte aktivity pro pracovní postup. V tomto postupu přidáme do pracovního postupu dvě aktivity: HandleExternalEventActivity a OnWorkFlowItemChanged. Tyto aktivity monitorují stav kontroly dokumentů v seznamu Sdílené dokumenty .

Vytvoření aktivit pracovního postupu

1. Pracovní postup by se měl zobrazit v návrháři pracovního postupu. Pokud tomu tak není, otevřete soubor Workflow1.cs nebo Workflow1.vb v Průzkumník řešení.

2. V návrháři zvolte aktivitu OnWorkflowActivated1 .

3. V okně Vlastnosti zadejte onWorkflowActivated vedle vyvoláné vlastnosti a pak zvolte klávesu Enter.

   Otevře se Editor kódu a do souboru kódu Workflow1 se přidá metoda obslužné rutiny události s názvem onWorkflowActivated.

4. Přepněte zpět do návrháře pracovního postupu, otevřete panel nástrojů a rozbalte uzel Windows Workflow v3.0 .

5. V uzlu Windows Workflow v3.0 sady nástrojů proveďte jednu z následujících sad kroků:

   1. Otevřete místní nabídku aktivity While a pak zvolte Kopírovat. V návrháři pracovního postupu otevřete místní nabídku řádku pod aktivitou onWorkflowActivated1 a pak zvolte Vložit.

   2. Přetáhněte aktivitu While ze sady nástrojů do návrháře pracovního postupu a připojte aktivitu k řádku pod aktivitou onWorkflowActivated1.

6. Zvolte aktivitu WhileActivity1.

7. V okně Vlastnosti nastavte Podmínku na Podmínku kódu.

8. Rozbalte vlastnost Podmínka, zadejte isWorkflowPending vedle podřízené Podmínky vlastnost a pak zvolte klávesu Enter.

   Otevře se Editor kódu a do souboru kódu Workflow1 se přidá metoda s názvem isWorkflowPending.

9. Přepněte zpět do návrháře pracovního postupu, otevřete panel nástrojů a potom rozbalte uzel Pracovního postupu Služby SharePoint.

10. V uzlu Pracovního postupu SharePointu na panelu nástrojů proveďte jednu z následujících sad kroků:

    • Otevřete místní nabídku aktivity OnWorkflowItemChanged a pak zvolte Kopírovat. V návrháři pracovního postupu otevřete místní nabídku řádku uvnitř aktivity whileActivity1 a pak zvolte Vložit.

    • Přetáhněte aktivitu OnWorkflowItemChanged ze sady nástrojů do návrháře pracovního postupu a připojte aktivitu k řádku uvnitř aktivity whileActivity1.

11. Zvolte aktivitu onWorkflowItemChanged1.

12. V okně Vlastnosti nastavte vlastnosti, jak je znázorněno v následující tabulce.

    Vlastnost	Hodnota
    Correlationtoken	workflowToken
    Vyvolána	onWorkflowItemChanged

Zpracování událostí aktivit

Nakonec zkontrolujte stav dokumentu z každé aktivity. Pokud byl dokument zkontrolován, pracovní postup se dokončí.

Zpracování událostí aktivit

1. Do souboru Workflow1.cs nebo Workflow1.vb přidejte do horní části Workflow1 třídy následující pole. Toto pole se používá v aktivitě k určení, zda je pracovní postup dokončen.

   C#

   Boolean workflowPending = true;
   

   VB

   Dim workflowPending As Boolean = True
   

2. Do třídy přidejte následující metodu Workflow1 . Tato metoda zkontroluje hodnotu Document Status vlastnosti seznamu Dokumenty a určí, zda byl dokument zkontrolován. Document Status Pokud je vlastnost nastavena na Review Complete, pak checkStatus metoda nastaví workflowPending pole na false indikuje, že pracovní postup je připraven dokončit.

   C#

   private void checkStatus()
   {
       if ((string)workflowProperties.Item["Document Status"] == "Review Complete")
       workflowPending = false;
   }
   

   VB

   Private Sub checkStatus()
       If CStr(workflowProperties.Item("Document Status")) = "Review Complete" Then
           workflowPending = False
       End If
   End Sub
   

3. Do metod a onWorkflowItemChanged metod volání checkStatus metody přidejte následující kódonWorkflowActivated. Při spuštění pracovního postupu metoda volá metoducheckStatus, aby určila, onWorkflowActivated zda byl dokument již zkontrolován. Pokud nebyl zkontrolován, pracovní postup pokračuje. Při uložení dokumentu metoda zavolá metodu checkStatus znovu, aby určila, onWorkflowItemChanged zda byl dokument zkontrolován. workflowPending Zatímco je pole nastaveno na hodnotu true, pracovní postup se bude dál spouštět.

   C#

   private void onWorkflowActivated(object sender, ExternalDataEventArgs e)
   {
       // Check the status.
       checkStatus();
   }
   
   private void onWorkflowItemChanged(object sender, ExternalDataEventArgs e)
   {
       // Check the status.
       checkStatus();
   }
   

   VB

   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
   

4. Do metody přidejte následující kód isWorkflowPending , který zkontroluje stav workflowPending vlastnosti. Při každém uložení dokumentu aktivita whileActivity1 volá metodu isWorkflowPending . Tato metoda zkoumá Result vlastnost objektu ConditionalEventArgs určit, zda má aktivita WhileActivity1 pokračovat nebo dokončit. Pokud je vlastnost nastavena na true, aktivita pokračuje. V opačném případě se aktivita dokončí a pracovní postup se dokončí.

   C#

   private void isWorkflowPending(object sender, ConditionalEventArgs e)
   {
       e.Result = workflowPending;
   }
   

   VB

   Private Sub isWorkflowPending(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ConditionalEventArgs)
       e.Result = workflowPending
   End Sub
   

5. Uložte projekt.

Otestování šablony pracovního postupu SharePointu

Když spustíte ladicí program, Visual Studio nasadí šablonu pracovního postupu na sharepointový server a přidruží pracovní postup k seznamu Sdílené dokumenty . Pokud chcete pracovní postup otestovat, spusťte instanci pracovního postupu z dokumentu v seznamu Sdílené dokumenty .

Otestování šablony pracovního postupu SharePointu

1. V Souboru Workflow1.cs nebo Workflow1.vb nastavte zarážku vedle metody onWorkflowActivated .

2. Zvolte klávesu F5 pro sestavení a spuštění řešení.

   Zobrazí se sharepointový web.

3. V navigačním podokně na SharePointu zvolte odkaz Sdílené dokumenty .

4. Na stránce Sdílené dokumenty zvolte odkaz Dokumenty na kartě Nástroje knihovny a pak zvolte tlačítko Nahrát dokument.

5. V dialogovém okně Nahrát dokument zvolte tlačítko Procházet , zvolte libovolný soubor dokumentu, zvolte tlačítko Otevřít a pak zvolte tlačítko OK .

   Tím se vybraný dokument nahraje do seznamu Sdílené dokumenty a spustí se pracovní postup.

6. V sadě Visual Studio ověřte, že se ladicí program zastaví na zarážce vedle onWorkflowActivated metody.

7. Pokud chcete pokračovat v provádění, zvolte klávesu F5 .

8. Tady můžete změnit nastavení dokumentu, ale prozatím je ponechte na výchozích hodnotách tak, že zvolíte tlačítko Uložit .

   Tím se vrátíte na stránku Sdílené dokumenty výchozího webu služby SharePoint.

9. Na stránce Sdílené dokumenty ověřte, že hodnota pod sloupcem MySharePointWorkflow – Workflow1 je nastavená na Probíhá. To znamená, že pracovní postup probíhá a že dokument čeká na revizi.

10. Na stránce Sdílené dokumenty zvolte dokument, zvolte šipku, která se zobrazí, a pak zvolte položku nabídky Upravit vlastnosti.

11. Nastavte stav dokumentu na Zkontrolovat dokončeno a pak zvolte tlačítko Uložit .

    Tím se vrátíte na stránku Sdílené dokumenty výchozího webu služby SharePoint.

12. Na stránce Sdílené dokumenty ověřte, že hodnota pod sloupcem Stav dokumentu je nastavená na Zkontrolovat dokončeno. Aktualizujte stránku Sdílené dokumenty a ověřte, že hodnota pod sloupcem MySharePointWorkflow – Workflow1 je nastavená na Dokončeno. To znamená, že pracovní postup je dokončený a že byl dokument zkontrolován.

Další kroky

Další informace o vytváření šablon pracovních postupů najdete v těchto tématech:

• Další informace o aktivitách pracovního postupu SharePointu najdete v tématu Aktivity pracovního postupu pro Službu SharePoint Foundation.

• Další informace o aktivitách Windows Workflow Foundation najdete v tématu System.Workflow.Activities – obor názvů.

Související obsah

• Vytváření řešení pracovních postupů SharePointu
• Šablony projektů a položek projektu služby SharePoint
• Sestavování a ladění řešení SharePointu