Przewodnik: importowanie przepływu pracy Projektant wielokrotnego użytku programu SharePoint

W tym przewodniku pokazano, jak zaimportować przepływ pracy wielokrotnego użytku utworzony w programie SharePoint Projektant 2010 do projektu przepływu pracy programu Visual Studio SharePoint.

Przepływy pracy utworzone w Projektant programu SharePoint lub deklaratywne przepływy pracy składają się z instrukcji XML zamiast kodu. Program SharePoint Projektant 2010 wprowadza przepływy pracy wielokrotnego użytku, które są przenośnymi, deklaratywnymi przepływami pracy, które mogą być używane przez różne listy w witrynach programu SharePoint.

Przepływy pracy utworzone w programie Visual Studio 2012, takie jak sekwencyjne i przepływy pracy maszyny stanu, są nazywane przepływami pracy kodu. Przepływy pracy kodu składają się z plików XML i modułów kodu, w których użytkownicy mogą dostosować zachowanie przepływu pracy.

Program Visual Studio umożliwia importowanie przepływów pracy wielokrotnego użytku utworzonych w programie SharePoint Projektant 2010 i konwertowanie ich na przepływy pracy kodu do użycia w witrynach programu SharePoint.

W tym przewodniku przedstawiono następujące zadania:

• Tworzenie prostego przepływu pracy wielokrotnego użytku w programie SharePoint Projektant.

• Eksportowanie przepływu pracy Projektant wielokrotnego użytku programu SharePoint do pliku wsp i do programu SharePoint.

• Importowanie pliku wsp do programu Visual Studio przy użyciu projektu Importuj przepływ pracy wielokrotnego użytku.

• Zmiana przepływu pracy przez dodanie kodu.

• Za pomocą zaimportowanego przepływu pracy w witrynie programu SharePoint.

  Uwaga

  Na komputerze w poniższych instrukcjach mogą być wyświetlane inne nazwy i lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio. Te elementy są określane przez numer wersji Visual Studio oraz twoje ustawienia. Aby uzyskać więcej informacji, zobacz Personalizowanie środowiska IDE.

Wymagania wstępne

Następujące składniki są wymagane do przeprowadzenia tego instruktażu:

• Obsługiwane wersje systemów Microsoft Windows i SharePoint.

• Visual Studio.

• Microsoft Office SharePoint Projektant 2010.

Tworzenie docelowych podwitryn programu SharePoint

Najpierw należy utworzyć dwie nowe podwitryny programu SharePoint: jeden do hostowania przepływów pracy wielokrotnego użytku z programu SharePoint Projektant, a drugi do hostowania przekonwertowanych przepływów pracy.

Aby utworzyć podwitrynę programu SharePoint

1. Na pasku menu programu SharePoint Projektant 2010 wybierz pozycję Plik>nowa pusta witryna sieci Web.

2. W oknie dialogowym Nowa pusta witryna sieci Web przejdź do witryny programu SharePoint, w której chcesz utworzyć przepływ pracy, lub użyj wartości http:// SystemName/, a następnie wybierz przycisk OK.

   Zostanie wyświetlona strona główna.

3. W sekcji Podwitryny wybierz przycisk Nowy.

4. W oknie dialogowym Nowy wybierz pozycję Szablony programu SharePoint z listy w okienku po lewej stronie, a następnie wybierz pozycję Witryna zespołu z listy w okienku po prawej stronie.

5. W polu Określ lokalizację witryny sieci Web zastąp ciąg word subsite w adresie URL ciągiem SPD1, a następnie wybierz przycisk OK.

   Spowoduje to otwarcie nowej podwitryny w Projektant programu SharePoint. Zamknij to wystąpienie programu SharePoint Projektant i wróć do pierwszego wystąpienia (witryny najwyższego poziomu).

6. Powtórz kroki 3– 5, aby utworzyć drugą podwitrynę, tym razem zastępując wyraz subsite w adresie URL spD2.

Tworzenie przepływu pracy Projektant wielokrotnego użytku programu SharePoint

Ponieważ program SharePoint nie zawiera żadnych przepływów pracy wielokrotnego użytku, których można użyć w tym przykładzie, utworzysz jeden. W tym prostym przepływie pracy, gdy użytkownik wprowadzi nowe zadanie na liście Zadanie, które ma określony tytuł, zadanie zostanie przydzielone temu użytkownikowi.

Aby utworzyć wielokrotny przepływ danych programu SharePoint Designer

1. W sekcji Podwitryny wybierz witrynę SPD1, aby ją zmodyfikować.

2. Na wstążce wybierz przycisk Przepływ pracy wielokrotnego użytku.

   Zostanie wyświetlony kreator Tworzenie przepływu pracy wielokrotnego użytku.

3. W polu Nazwa wprowadź przepływ pracy zadań SPD.

4. Na liście Typ zawartości wybierz pozycję Zadanie, a następnie wybierz przycisk OK.

   Przepływ pracy zostanie otwarty w projektancie przepływu pracy Projektant programu SharePoint.

5. W projektancie przepływu pracy wybierz pozycję Krok 1, a następnie na wstążce wybierz przycisk Warunek .

6. Na liście warunków wybierz pozycję Jeśli bieżące pole elementu jest równe wartości.

   Ten krok dodaje warunek o nazwie Jeśli pole jest równe wartości.

7. W polu Jeśli równa się warunek wartości, wybierz link pola.

8. Na liście wartości wybierz pozycję Tytuł.

9. W polu Jeśli równa się warunek wartości, wybierz link wartości.

10. W polu wprowadź nowe zadanie.

    Instrukcja condition jest teraz odczytywana, jeśli bieżący element:Tytuł jest równa Nowe zadanie.

11. Wybierz wiersz pod instrukcją condition, a następnie na wstążce wybierz przycisk Akcja .

12. Na liście akcji wybierz pozycję Ustaw pole w bieżącym elemencie.

13. W akcji Ustaw na wartość wybierz link pola, a następnie na liście wybierz pozycję Przypisane do.

14. W akcji Ustaw wartość wybierz link wartość, a następnie na liście istniejących użytkowników i grup wybierz pozycję Użytkownik, który utworzył element.

15. Wybierz przycisk Dodaj, a następnie wybierz przycisk OK.

    Instrukcja akcji odczytuje teraz pozycje Ustaw przypisane do bieżącego elementu:CreatedBy.

Zapisywanie i wdrażanie przepływu pracy wielokrotnego użytku

Ponieważ program Visual Studio może importować tylko pliki wsp, należy zapisać przepływ pracy wielokrotnego użytku jako plik wsp i wdrożyć go w programie SharePoint przed zaimportowaniem go do programu Visual Studio.

Ważne

Jeśli wystąpi błąd środowiska uruchomieniowego wykonujący poniższą procedurę, należy wykonać procedurę w systemie, który ma dostęp do witryny programu SharePoint.

Aby zapisać i wdrożyć wielokrotny przepływ danych

1. W górnej części Projektant programu SharePoint wybierz przycisk Zapisz, aby zapisać postęp, a następnie wybierz przycisk Publikuj, aby wdrożyć przepływ pracy w witrynie programu SharePoint SPD1.

2. W okienku Nawigacja wybierz obiekt Przepływy pracy.

3. W obszarze Przepływ pracy wielokrotnego użytku wybierz pozycję Przepływ pracy zadań SPD.

4. Na wstążce wybierz przycisk Zapisz jako szablon , aby zapisać przepływ pracy jako plik wsp .

5. Otwórz witrynę programu SharePoint SPD1 w przeglądarce, aby wyświetlić plik wsp w programie SharePoint.

6. Na pasku QuickLaunch wybierz link Biblioteki .

7. W sekcji Biblioteki dokumentów wybierz link Zasoby witryny.

   Plik przepływu pracy zadań SPD znajduje się na liście z innymi elementami zawartości witryny.

8. Na liście plików wybierz nazwę tego pliku

9. W oknie dialogowym Pobieranie pliku wybierz przycisk Zapisz, aby zapisać plik wsp w systemie lokalnym.

Importowanie pliku .wsp do programu Visual Studio

Zaimportuj plik wsp do programu Visual Studio przy użyciu projektu Importuj przepływ pracy wielokrotnego użytku. Ten projekt konwertuje przepływ pracy z przepływu pracy wielokrotnego użytku, deklaratywnego na przepływ pracy kodu. Po przekonwertowaniu przepływu pracy użyjesz kodu, aby zmodyfikować jego zachowanie.

Aby zaimportować przepływu danych z pliku .wsp, a następnie go zmodyfikować

1. W programie Visual Studio na pasku menu wybierz pozycję Plik>nowy>projekt.

2. W oknie dialogowym Nowy projekt rozwiń węzeł programu SharePoint w obszarze Visual C# lub Visual Basic, a następnie wybierz węzeł 2010.

3. W okienku Szablony wybierz szablon Przepływ pracy importu wielokrotnego użytku programu SharePoint 2010, pozostaw nazwę projektu jako WorkflowImportProject1, a następnie wybierz przycisk OK.

   Zostanie wyświetlony Kreator dostosowywania programu SharePoint.

4. Na stronie Określanie witryny i poziomu zabezpieczeń na potrzeby debugowania wprowadź adres URL drugiej utworzonej wcześniej podwitryny programu SharePoint: http:// nazwa systemu/SPD2.

5. W sekcji Co to jest poziom zaufania dla tego rozwiązania programu SharePoint? wybierz przycisk Wdróż jako rozwiązanie farmy, a następnie wybierz przycisk Dalej.

   Aby uzyskać więcej informacji na temat rozwiązań w trybie piaskownicy i rozwiązań farmy, zobacz Zagadnienia dotyczące rozwiązania w trybie piaskownicy.

6. Na stronie Określanie nowego źródła projektu przejdź do lokalizacji w systemie, w którym wcześniej zapisano plik .wsp, otwórz plik, a następnie wybierz przycisk Dalej.

   Uwaga

   Wybierz przycisk Zakończ, aby zaimportować wszystkie dostępne elementy w pliku .wsp.

   Spowoduje to wyświetlenie listy przepływów pracy wielokrotnego użytku dostępnych do importowania.

7. W polu Wybierz elementy do zaimportowania wybierz przepływ pracy przepływu pracy zadania SPD, a następnie wybierz przycisk Zakończ.

   Po zakończeniu operacji importowania tworzony jest projekt o nazwie WorkflowImportProject1 zawierający przepływ pracy o nazwie SPD_Workflow_TestFT. W tym folderze znajduje się plik definicji przepływu pracy Elements.xml i plik projektanta przepływu pracy (.xoml). Projektant zawiera dwa pliki: plik reguł (.rules) i plik za kodem ( cs lub vb, w zależności od języka programowania projektu).

8. W Eksplorator rozwiązań usuń folder Inne zaimportowane pliki.

9. W pliku Elements.xml usuń plik InstantiationURL="_layouts/IniErkflIP.sspx".

10. W Eksplorator rozwiązań wybierz kolejno pozycje WorkflowImportProject1, a następnie na pasku menu wybierz pozycję Project Set as Startup Project (Ustaw projekt jako projekt> startowy), aby ustawić wartość WorkflowImportProject1 jako element startowy.

    Spowoduje to natychmiastowe wyświetlenie listy podczas debugowania projektu.

11. Ponieważ szablon przepływu pracy importu wielokrotnego użytku programu SharePoint 2010 nie importuje wartości właściwości skojarzenia dla zaimportowanych przepływów pracy, należy je wprowadzić. Czynność:

    1. W Eksplorator rozwiązań wybierz węzeł SPD_Workflow_TestFT.

    2. Wybierz przycisk wielokropka () obok jednej z właściwości listy, takich jak właściwość Lista docelowa.

    3. Wypełnij brakujące wartości w Kreatorze dostosowywania programu SharePoint, a następnie wybierz przycisk Zakończ .

12. Wybierz plik xoml, a następnie na pasku menu wybierz pozycję Widok> Projektant aby wyświetlić zaimportowany przepływ pracy w projektancie przepływu pracy.

13. W węźle Windows Workflow v3.0 przybornika wykonaj jedną z następujących czynności:

    • Otwórz menu skrótów dla działania Kod , a następnie wybierz pozycję Kopiuj. W projektancie przepływu pracy otwórz menu skrótów dla wiersza w działaniu SequenceActivity1 , a następnie wybierz pozycję Wklej.

    • Przeciągnij działanie Code (Kod ) z przybornika do projektanta przepływu pracy i połącz je z wierszem w działaniu SequenceActivity1 .

      Spowoduje to dodanie działania do projektanta przepływu pracy o nazwie CodeActivity1. W tym działaniu dodasz akcję kodu, która tworzy anons na liście Anonsy po uruchomieniu przepływu pracy przez użytkownika.

14. Wykonaj jeden z następujących zestawów czynności:

    • Kliknij dwukrotnie pozycję CodeActivity1 , aby wygenerować program obsługi zdarzeń i wyświetlić kod.

    • W oknie Właściwości dla właściwości CodeActivity1 ustaw wartość właściwości ExecuteCode na codeActivity_ExecuteCode.

15. Dodaj następujące elementy w istniejących dyrektywach using lub Import :

    C#

    using Microsoft.SharePoint;
    using System;
    

    VB

    Imports Microsoft.SharePoint
    Imports System
    

16. Zastąp codeActivity1_ExecuteCode ciąg następującymi elementami:

    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
    

Wdrażanie projektu i kojarzenie przepływu pracy

Następnie uruchom polecenie WorkflowImportProject1, aby wdrożyć go w witrynie programu SharePoint, a następnie skojarz przepływ pracy z listą Zadania, aby wyświetlić i przetestować zmodyfikowany, przekonwertowany przepływ pracy.

Aby wdrożyć projekt i skojarzyć przepływ danych

1. W programie Visual Studio wybierz klucz F5 do uruchomienia i wdrożenia przekonwertowanego projektu przepływu pracy.

2. Na pasku Szybkie uruchamianie wybierz link Zadania , aby wyświetlić listę Zadania.

3. Na karcie Narzędzia listy wybierz przycisk Elementy, a następnie wybierz przycisk Nowy element.

   Zostanie otwarte okno dialogowe Zadania — nowy element .

4. W polu Tytuł wprowadź nowe zadanie, a następnie wybierz przycisk Zapisz .

5. Na karcie Narzędzia listy wybierz przycisk Lista, a następnie wybierz przycisk Lista Ustawienia.

   Zostanie wyświetlona strona Lista Ustawienia.

6. W sekcji Uprawnienia i zarządzanie wybierz link Przepływ pracy Ustawienia.

   Zostanie wyświetlona strona Ustawienia przepływu pracy.

7. Wybierz link Dodaj przepływ pracy.

8. Na liście Przepływ pracy wybierz kolejno pozycje WorkflowImportProject1 — SPD Workflow Test.

9. W polu Nazwa wprowadź test przepływu pracy SPD, a następnie wybierz przycisk OK .

10. Na pasku Szybkie uruchamianie wybierz listę Zadania .

11. Wybierz strzałkę obok pozycji Nowe zadanie, a następnie na liście wybierz pozycję Przepływy pracy.

12. W sekcji Rozpocznij nowy przepływ pracy wybierz link testu przepływu pracy spD, a następnie wybierz przycisk Uruchom, aby zainicjować przepływ pracy.

    Uwaga

    Alternatywnie możesz automatycznie skojarzyć przepływ pracy z listą, uruchamiając kreatora ustawień przepływu pracy i ustawiając przepływ pracy na automatyczne kojarzenie.

    Zwróć uwagę, że dwa akcje są wykonywane przez przepływ pracy: Twoja nazwa jest wyświetlana w kolumnie Przypisane do zadania, a anons pojawia się na liście Anonsy.

Powiązana zawartość

• Importowanie elementów z istniejącej witryny programu SharePoint
• Opracowywanie rozwiązań programu SharePoint
• Tworzenie kontrolek wielokrotnego użytku dla składników Web Part lub stron aplikacji