Návod: Import opakovaně použitelného pracovního postupu aplikace SharePoint Designer

Tento názorný postup ukazuje, jak importovat opakovaně použitelný pracovní postup vytvořený v aplikaci SharePoint Designer 2010 do projektu pracovního postupu sady Visual Studio SharePoint.

Pracovní postupy vytvořené v aplikaci SharePoint Designer nebo deklarativní pracovní postupy se skládají z příkazů XML místo kódu. SharePoint Designer 2010 zavádí opakovaně použitelné pracovní postupy, které jsou přenosné a deklarativní pracovní postupy, které můžou používat různé seznamy na sharepointových webech.

Pracovní postupy vytvořené v sadě Visual Studio 2012, jako jsou pracovní postupy sekvenčních a stavových počítačů, se nazývají pracovní postupy kódu. Pracovní postupy kódu se skládají ze souborů XML a modulů kódu, ve kterých mohou uživatelé přizpůsobit chování pracovního postupu.

Visual Studio umožňuje importovat opakovaně použitelné pracovní postupy vytvořené v aplikaci SharePoint Designer 2010 a převést je na pracovní postupy kódu pro použití na sharepointových webech.

Tento názorný postup ukazuje následující úlohy:

• Vytvoření jednoduchého opakovaně použitelného pracovního postupu v aplikaci SharePoint Designer

• Export opakovaně použitelného pracovního postupu aplikace SharePoint Designer do souboru .wsp a do SharePointu.

• Import souboru .wsp do sady Visual Studio pomocí projektu importu opakovaně použitelného pracovního postupu

• Změna pracovního postupu přidáním kódu

• Použití importovaného pracovního postupu na sharepointovém webu

  Poznámka:

  Váš počítač může v následujících pokynech zobrazovat odlišné názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio. 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í (IDE).

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.

• systém Microsoft Office SharePoint Designer 2010.

Vytvoření cílových podřízených webů SharePointu

Nejprve vytvoříte dva nové podřízené weby SharePointu: jeden pro hostování opakovaně použitelných pracovních postupů ze SharePoint Designeru, druhý pro hostování převedených pracovních postupů.

Vytvoření podřízených webů služby SharePoint

1. V SharePoint Designeru 2010 na řádku nabídek zvolte Soubor>nový prázdný web.

2. V dialogovém okně Nový prázdný web přejděte na sharepointový web, na kterém chcete vytvořit pracovní postup, nebo použijte hodnotu http:// SystemName/ a pak zvolte tlačítko OK .

   Zobrazí se domovská stránka.

3. V části Podřízené weby zvolte tlačítko Nový.

4. V dialogovém okně Nový zvolte ze seznamu v levém podokně šablony Služby SharePoint a v pravém podokně zvolte Týmový web .

5. V poli Zadejte umístění webu nahraďte podřízený web slova v adrese URL aktualizací SPD1 a pak zvolte tlačítko OK.

   Tím se otevře nový podřízený web v aplikaci SharePoint Designer. Zavřete tuto instanci aplikace SharePoint Designer a vraťte se na první instanci (web nejvyšší úrovně).

6. Opakujte kroky 3 až 5 a vytvořte druhý podřízený web, tentokrát nahraďte podřízený web slova v adrese URL aktualizací SPD2.

Vytvoření opakovaně použitelného pracovního postupu aplikace SharePoint Designer

Protože SharePoint neobsahuje žádné opakovaně použitelné pracovní postupy, které můžete použít v tomto příkladu, vytvoříte ho. V tomto jednoduchém pracovním postupu, když uživatel zadá nový úkol do seznamu úkolů, který má určitý název, je úkol přiřazen tomuto uživateli.

Vytvoření opakovaně použitelného pracovního postupu aplikace SharePoint Designer

1. V části Podřízené weby zvolte web SPD1, který chcete upravit.

2. Na pásu karet zvolte tlačítko Opakovaně použitelný pracovní postup .

   Zobrazí se průvodce vytvořit opakovaně použitelný pracovní postup.

3. Do pole Název zadejte pracovní postup úkolu SPD.

4. V seznamu Typ obsahu zvolte Úkol a pak zvolte tlačítko OK.

   Pracovní postup se otevře v návrháři pracovního postupu aplikace SharePoint Designer.

5. V návrháři pracovního postupu zvolte Krok 1 a potom na pásu karet zvolte tlačítko Podmínka .

6. V seznamu podmínek zvolte Pokud se pole aktuální položky rovná hodnotě.

   Tento krok přidá podmínku s názvem If field equals value.

7. V podmínce Pokud se pole rovná hodnotě , zvolte odkaz na pole .

8. V seznamu hodnot zvolte Název.

9. V poli If se rovná hodnotové podmínce zvolte odkaz na hodnotu.

10. Do pole zadejte Nový úkol.

    Příkaz podmínky nyní přečte If Current Item:Title se rovná novému úkolu.

11. Zvolte řádek pod příkazem podmínky a potom na pásu karet zvolte tlačítko Akce .

12. V seznamuakcích

13. V akci Nastavit pole na hodnotu zvolte odkaz na pole a potom v seznamu zvolte Přiřazeno.

14. V poli Nastavit na hodnotu akci zvolte odkaz na hodnotu a potom v seznamu existujících uživatelů a skupin zvolte Uživatel, který položku vytvořil.

15. Zvolte tlačítko Přidat a pak zvolte tlačítko OK.

    Příkaz akce teď načte nastavení přiřazené k aktuální položce:CreatedBy.

Uložení a nasazení opakovaně použitelného pracovního postupu

Vzhledem k tomu, že Visual Studio může importovat pouze soubory .wsp , musíte před importem do sady Visual Studio uložit opakovaně použitelný pracovní postup jako soubor WSP a nasadit ho do SharePointu.

Důležité

Pokud při provádění následujícího postupu dojde k chybě za běhu, musíte provést postup v systému, který má přístup k webu služby SharePoint.

Uložení a nasazení opakovaně použitelného pracovního postupu

1. V horní části aplikace SharePoint Designer zvolte tlačítko Uložit , abyste uložili průběh, a pak zvolte tlačítko Publikovat , abyste pracovní postup nasadili na sharepointový web SPD1 .

2. V navigačním podokně zvolte objekt Pracovní postupy .

3. V části Opakovaně použitelný pracovní postup zvolte Pracovní postup úkolu SPD.

4. Na pásu karet zvolte tlačítko Uložit jako šablonu a uložte pracovní postup jako soubor WSP .

5. Otevřete sharepointový web SPD1 v prohlížeči a zobrazte soubor WSP v SharePointu.

6. Na panelu QuickLaunch zvolte odkaz Knihovny .

7. V části Knihovny dokumentů zvolte odkaz Prostředky webu.

   Soubor pracovního postupu úkolu SPD je uveden s dalšími prostředky webu.

8. V seznamu souborů zvolte název tohoto souboru.

9. V dialogovém okně Stáhnout soubor zvolte tlačítko Uložit a uložte soubor WSP do místního systému.

Import souboru .wsp do sady Visual Studio

Importujte soubor .wsp do sady Visual Studio pomocí projektu importu opakovaně použitelného pracovního postupu. Tento projekt převede pracovní postup z opakovaně použitelného deklarativního pracovního postupu na pracovní postup kódu. Po převodu pracovního postupu použijete kód ke změně jeho chování.

Import pracovního postupu ze souboru WSP a jeho úpravy

1. V sadě Visual Studio na řádku nabídek zvolte Soubor>nový>projekt.

2. V dialogovém okně Nový projekt rozbalte uzel SharePointu v jazyce Visual C# nebo Visual Basic a pak zvolte uzel 2010.

3. V podokně Šablony zvolte šablonu Pracovního postupu importu opakovaně použitelného SharePointu 2010, ponechte název projektu jako WorkflowImportProject1 a pak zvolte tlačítko OK.

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

4. Na stránce Zadat web a úroveň zabezpečení pro ladění zadejte adresu URL druhého podřízeného webu SharePointu, který jste vytvořili dříve: http:// název systému nebo SPD2.

5. V části Co je úroveň důvěryhodnosti pro toto řešení Služby SharePoint? zvolte tlačítko Nasadit jako řešení farmy a pak zvolte tlačítko Další .

   Další informace o řešeních izolovaného prostoru (sandbox) a farmách najdete v tématu Aspekty řešení v izolovaném prostoru (sandbox).

6. Na stránce Zadat nový zdroj projektu přejděte do umístění v systému, kam jste dříve uložili soubor .wsp, otevřete soubor a pak zvolte tlačítko Další.

   Poznámka:

   Pokud chcete importovat všechny dostupné položky v souboru WSP, zvolte tlačítko Dokončit.

   Zobrazí se seznam opakovaně použitelných pracovních postupů dostupných pro import.

7. V poli Vybrat položky, které chcete importovat, zvolte pracovní postup pracovního postupu úkolu SPD a pak zvolte tlačítko Dokončit.

   Po dokončení importu se vytvoří projekt s názvem WorkflowImportProject1 obsahující pracovní postup s názvem SPD_Workflow_TestFT. V této složce je definiční soubor pracovního postupu Elements.xml a soubor návrháře pracovního postupu (.xoml). Návrhář obsahuje dva soubory: soubor pravidel (.rules) a soubor kódu za kódem (v závislosti na programovacím jazyce projektu).

8. V Průzkumník řešení odstraňte složku Další importované soubory.

9. V souboru Elements.xml odstraňte InstantiationURL="_layouts/IniErkflIP.sspx".

10. V Průzkumník řešení zvolte WorkflowImportProject1 a potom na řádku nabídek zvolte Project Set as Startup Project> a set WorkflowImportProject1 as the Startup Item.

    Zobrazí se seznam okamžitě při ladění projektu.

11. Vzhledem k tomu, že šablona pracovního postupu importu opakovaně použitelného SharePointu 2010 neimportuje hodnoty vlastností přidružení pro importovaný pracovní postup, musíte je zadat. Akce:

    1. V Průzkumník řešení zvolte uzel SPD_Workflow_TestFT.

    2. Zvolte tlačítko se třemi tečkou () vedle některé z vlastností seznamu, jako je například vlastnost Cílový seznam .

    3. Vyplňte chybějící hodnoty v Průvodci přizpůsobením SharePointu a pak zvolte tlačítko Dokončit .

12. Zvolte soubor .xoml a potom na řádku nabídek zvolte Návrhář zobrazení>a zobrazte importovaný pracovní postup v návrháři pracovního postupu.

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

    • Otevřete místní nabídku pro aktivitu s kódem a pak zvolte Kopírovat. V návrháři pracovního postupu otevřete místní nabídku řádku pod aktivitou SequenceActivity1 a pak zvolte Vložit.

    • Přetáhněte aktivitu kódu z panelu nástrojů do návrháře pracovního postupu a připojte ji k řádku pod aktivitou SequenceActivity1.

      Tím se přidá aktivita do návrháře pracovního postupu s názvem CodeActivity1. V této aktivitě přidáte akci kódu, která při spuštění pracovního postupu vytvoří oznámení v seznamu Oznámení.

14. Proveďte jednu z následujících sad kroků:

    • Poklikáním na CodeActivity1 vygenerujte obslužnou rutinu události a zobrazte kód.

    • V okně Properties pro CodeActivity1 nastavte hodnotu ExecuteCode vlastnost codeActivity_ExecuteCode.

15. Do stávajících direktiv using nebo Imports přidejte následující:

    C#

    using Microsoft.SharePoint;
    using System;
    

    VB

    Imports Microsoft.SharePoint
    Imports System
    

16. Nahraďte codeActivity1_ExecuteCode následujícím kódem:

    C#

    private void codeActivity1_ExecuteCode(object sender, System.EventArgs e)
    {
        
        try
        {
            // Get reference to SharePoint site.
            SPSite site = new SPSite("http://MyServer");
            SPWeb web = site.OpenWeb("SPD2/");
            // Get reference to Announcements list.
            SPList announcementsList = web.Lists["Announcements"];
    
            // Add announcement to Announcements list for the Task.
            SPListItem oListItem = announcementsList.Items.Add();
            oListItem["Title"] = "Assigned task on " + DateTime.Now.ToString();
            oListItem.Update();
        }
    
        catch (Exception err)
        {
            Console.WriteLine("Error: " + err.ToString());
        }        
    }
    

    VB

    Private Sub codeActivity1_ExecuteCode(ByVal sender As System.Object, ByVal e As System.EventArgs)
        Try
            ' Get reference to SharePoint site.
            Dim site As SPSite = New SPSite("http://MyServer")
            Dim web As SPWeb = site.OpenWeb("SPD2/")
            ' Get reference to Announcements list.
            Dim announcementsList As SPList = web.Lists("Announcements")
            ' Add announcement to Announcements list for the Task.
            Dim oListItem As SPListItem = announcementsList.Items.Add
            oListItem("Title") = ("Assigned task on " + DateTime.Now.ToString)
            oListItem.Update()
        Catch err As Exception
            Console.WriteLine(("Error: " + err.ToString))
        End Try
    End Sub
    

Nasazení projektu a přidružení pracovního postupu

Potom spusťte WorkflowImportProject1 a nasaďte ho na sharepointový web a pak přidružte pracovní postup k seznamu úkolů, abyste mohli zobrazit a otestovat upravený převedený pracovní postup.

Nasazení projektu a přidružení pracovního postupu

1. V sadě Visual Studio zvolte klávesu F5 , která se má spustit a nasadit převedený projekt pracovního postupu.

2. Na panelu QuickLaunch zvolte odkaz Úkoly a zobrazte seznam Úkolů.

3. Na kartě Nástroje seznamu zvolte tlačítko Položky a pak zvolte tlačítko Nová položka.

   Otevře se dialogové okno Úkoly – Nová položka .

4. Do pole Název zadejte Nový úkol a pak zvolte tlačítko Uložit.

5. Na kartě Nástroje seznamu zvolte tlačítko Seznam a pak zvolte tlačítko Seznam Nastavení.

   Zobrazí se stránka Seznam Nastavení.

6. V části Oprávnění a správa zvolte odkaz Pracovní postup Nastavení.

   Zobrazí se stránka pracovního postupu Nastavení.

7. Zvolte odkaz Přidat pracovní postup.

8. V seznamu Pracovních postupů zvolte WorkflowImportProject1 – SPD Workflow Test.

9. Do pole Název zadejte test pracovního postupu SPD a pak zvolte tlačítko OK.

10. Na panelu QuickLaunch zvolte seznam Úkolů .

11. Zvolte šipku vedle položky Nový úkol a potom v seznamu zvolte Pracovní postupy.

12. V části Spustit nový pracovní postup zvolte odkaz pro test pracovního postupu SPD a pak zvolte tlačítko Start, které zahájí pracovní postup.

    Poznámka:

    Případně můžete automaticky přidružit pracovní postup k seznamu spuštěním průvodce nastavením pracovního postupu a nastavením pracovního postupu na automatické přidružení.

    Všimněte si, že pracovní postup provádí dvě akce: vaše jméno se zobrazí ve sloupci Přiřazeno úkolu a v seznamu Oznámení se zobrazí oznámení.

Související obsah

• Import položek z existujícího sharepointového webu
• Vývoj sharepointových řešení
• Vytváření opakovaně použitelných ovládacích prvků pro webové části nebo stránky aplikací