Udostępnij za pośrednictwem


Wskazówki: tworzenie i debugowanie rozwiązania przepływu pracy SharePoint

W tym instruktażu przedstawiono sposób tworzenia szablonu podstawowy sekwencyjny przepływ pracy.Przepływ pracy sprawdza właściwości biblioteki dokumentów udostępnionych do ustalenia, czy dokument poddane przeglądowi.Jeśli dokonano przeglądu dokumentu kończy przepływu pracy.

Ten instruktaż ilustruje następujące zadania:

  • Tworzenie projektu sekwencyjny przepływ pracy definicji listy programu SharePoint w Visual Studio.

  • Tworzenie działań przepływu pracy.

  • Obsługa zdarzeń aktywności przepływu pracy.

[!UWAGA]

Chociaż w tym instruktażu używany projekt sekwencyjny przepływ pracy, proces jest identyczny dla projektów przepływu pracy maszyny stanu.

Ponadto komputer może wykazują różne nazwy lub lokalizacje dla niektórych użytkowników programu Visual Studio elementów interfejsu następujące instrukcje.Program Visual Studio, że masz i ustawień, które można używać określenia tych elementów.Aby uzyskać więcej informacji, zobacz Dostosowywanie ustawień środowiska deweloperskiego w Visual Studio.

Wymagania wstępne

Potrzebne do przeprowadzenia tego instruktażu następujące składniki:

Dodawanie właściwości do programu SharePoint współużytkowane biblioteki dokumentów

Aby śledzić stan przeglądu dokumentów w Dokumenty udostępnione biblioteki, zostanie utworzony trzy nowe właściwości dokumentów udostępnionych w naszej witrynie programu SharePoint: Status, Assignee, i Review Comments.Możemy zdefiniować te właściwości w Dokumenty udostępnione biblioteki.

Aby dodać właściwości do programu SharePoint udostępnione dokumenty biblioteki

  1. Otwieranie witryny programu SharePoint, na przykład http:// < nazwa systemu > / SitePages/Home.aspx w przeglądarce sieci Web.

  2. Na pasek szybkiego uruchamiania wybierz Shareddokumenty.

  3. Wybierz biblioteki na Bibliotekę narzędzi Wstążka, a następnie wybierz polecenie Utwórz kolumnę przycisk na Wstążce, aby utworzyć nową kolumnę.

  4. Nazwa kolumny Stan dokumentu, ustaw jej typ Wybór (menu, aby wybrać z), należy określić następujące trzy opcje, a następnie wybierz OK przycisku:

    • Przegląd potrzebne

    • Zakończenie przeglądu

    • Żądane zmiany

  5. Tworzenie dwóch kolumn i ich nazwy cesjonariusza oraz komentarzy.Ustaw typ kolumny cesjonariusza jako pojedynczy wiersz tekstu i typ kolumny komentarzy jako wiele wierszy tekstu.

Włączanie dokumentów do edycji bez konieczności Wyewidencjonuj

Łatwiej można przetestować szablon przepływu pracy podczas edytowania dokumentów bez konieczności je wyewidencjonować.W następnej procedurze skonfigurować witryny programu SharePoint, aby umożliwić.

Aby włączyć edytować bez ich wyewidencjonowywania dokumentów

  1. Na pasek szybkiego uruchamiania wybierz Dokumenty udostępnione łącze.

  2. Na Bibliotekę narzędzi Wstążka, wybierz polecenie biblioteki tab, a następnie wybierz polecenie Ustawienia biblioteki przycisk, aby wyświetlić Ustawienia biblioteki dokumentów strony.

  3. W Ogólne ustawienia sekcji, wybierz Ustawienia przechowywania wersji łącze, aby wyświetlić Ustawienia przechowywania wersji strony.

  4. Sprawdź, czy ustawienie dla wymagają wyewidencjonowany przed można edytować dokumenty jest nr.Jeśli nie jest, aby zmienić nr i wybierz polecenie OK przycisku.

  5. Zamknij przeglądarkę.

Tworzenie projektu sekwencyjny przepływ pracy programu SharePoint

Sekwencyjny przepływ pracy jest zestaw kroków wykonuje się w kolejności, przed zakończeniem ostatniego działania.W tej procedurze tworzymy sekwencyjny przepływ pracy, który będzie stosowany do naszej listy dokumenty udostępnione.Kreator przepływu pracy pozwala skojarzyć z definicji witryny lub listy definicji przepływu pracy i pozwala określić, kiedy rozpocznie się przepływu pracy.

Aby utworzyć projekt sekwencyjny przepływ pracy programu SharePoint

  1. Start Visual Studio.

  2. Na pasku menu wybierz pliku, Nowy, projektu do wyświetlania Nowy projekt okno dialogowe.

  3. Rozwiń SharePoint albo węzeł Visual C# lub programu Visual Basic, a następnie wybierz polecenie 2010 węzła.

  4. W szablonów okienku wybierz SharePoint 2010 projektu szablonu.

  5. W Nazwa polu, wpisz MySharePointWorkflow, a następnie wybierz polecenie OK przycisku.

    Kreator dostosowania programu SharePoint pojawi się.

  6. W Określ witrynę i poziom zabezpieczeń dla debugowania wybierz Wdroż jako roztwór farmy przycisk opcji, a następnie wybierz Zakończ przycisk, aby zaakceptować zaufania witryny poziom i domyślne.

    W tym kroku ustawia poziom zaufania dla roztworu jako roztwór farmy, opcja dostępna tylko dla projektów przepływu pracy.Aby uzyskać więcej informacji, zobacz Uwagi dotyczące rozwiązania typu piaskownica.

  7. W Solution Explorer, wybierz węzeł projektu i następnie na pasku menu wybierz projektu, Dodaj nowy element.

  8. Pod Visual C# lub języka Visual Basic, rozwiń SharePoint węzeł, a następnie wybierz polecenie 2010 węzła.

  9. W szablonów okienku wybierz Sekwencyjny przepływ pracy (tylko farmy roztwór) szablonu, a następnie wybierz polecenie Dodaj przycisku.

    Kreator dostosowania programu SharePoint pojawi się.

  10. W Określ nazwę przepływu pracy do debugowania strony, zaakceptuj domyślną nazwę (MySharePointWorkflow - Workflow1).Zachować wartość domyślną przepływ pracy szablonu typu Listy przepływu pracy, a następnie wybierz polecenie Dalej przycisku.

  11. W czy Visual Studio automatycznie skojarzyć przepływu pracy podczas sesji debugowania? wybierz Dalej przycisk, aby zaakceptować wszystkie ustawienia domyślne.

    Krok ten automatycznie kojarzy przepływu pracy z biblioteki Dokumenty udostępnione.

  12. W określić warunki sposób uruchamiania przepływu pracy strony, należy pozostawić domyślne opcje wybrane w jak chcesz uruchamianie przepływu? sekcji i wybierz polecenie Zakończ przycisku.

    Ta strona umożliwia określenie, po uruchomieniu przepływu pracy.Domyślnie uruchamiania przepływu pracy albo gdy użytkownik ręcznie uruchamia go w SharePoint lub podczas tworzenia elementu skojarzonego przepływu pracy.

Tworzenie działań przepływu pracy

Przepływy pracy zawierają jedną lub więcej działalności reprezentują akcje do wykonania.Organizuje działania przepływu pracy za pomocą projektanta przepływu pracy.W tej procedurze dwa działania będą dodawane do przepływu pracy: działanie HandleExternalEventActivity i OnWorkFlowItemChanged.Działania te monitorować stan przeglądu dokumentów w Dokumenty udostępnione listy

Aby utworzyć działania przepływów pracy

  1. Przepływ pracy powinny być wyświetlane w projektancie przepływów pracy.Jeśli nie jest, otwórz albo Workflow1.cs lub Workflow1.vb w Solution Explorer.

  2. Wybierz projektanta, OnWorkflowActivated1 działalności.

  3. W Właściwości okna, obok wprowadź onWorkflowActivated Invoked właściwość, a następnie wybierz klawisz Enter.

    Otwiera edytor kodu i metody obsługi zdarzenia, o nazwie onWorkflowActivated jest dodawany do pliku kod Workflow1.

  4. Powrócić do projektanta przepływów pracy, Otwórz przybornik, a następnie rozwiń Windows Workflow v3.0 węzła.

  5. W Windows Workflow v3.0 węzeł Przybornik, wykonaj jedną z następujących czynności:

    1. Otwórz menu skrótów dla podczas działalności, a następnie wybierz polecenie kopię.W projektancie przepływów pracy należy otworzyć menu skrótów dla linii pod onWorkflowActivated1 działalności, a następnie wybierz polecenie Wklej.

    2. Przeciągnij podczas działalności z Przybornik do projektanta przepływów pracy i działania połączyć się z linii pod onWorkflowActivated1 działalności.

  6. Wybierz WhileActivity1 działalności.

  7. W Właściwości ustawiony w oknie warunek do kodu stanu.

  8. Rozwiń warunek właściwość, wprowadź isWorkflowPending obok dziecko warunek właściwość, a następnie wybierz klawisz Enter.

    Otwiera edytor kodu i metodę o nazwie isWorkflowPending jest dodawany do pliku kod Workflow1.

  9. Powrócić do projektanta przepływów pracy, Otwórz przybornik, a następnie rozwiń Przepływu pracy programu SharePoint węzła.

  10. W Przepływu pracy programu SharePoint węzeł Przybornik, wykonaj jedną z następujących czynności:

    • Otwórz menu skrótów dla OnWorkflowItemChanged działalności, a następnie wybierz polecenie kopię.W projektancie przepływów pracy należy otworzyć menu skrótów dla wiersza wewnątrz whileActivity1 działalności, a następnie wybierz polecenie Wklej.

    • Przeciągnij OnWorkflowItemChanged działalności z Przybornik do projektanta przepływów pracy i działania połączyć się z linii wewnątrz whileActivity1 działalności.

  11. Wybierz onWorkflowItemChanged1 działalności.

  12. W Właściwości okna, ustaw właściwości, jak pokazano w poniższej tabeli.

    Właściwość

    Wartość

    CorrelationToken

    workflowToken

    Wywoływany

    onWorkflowItemChanged

Obsługa zdarzeń aktywności

Wreszcie Sprawdź stan dokumentu z każdego działania.Dokonała dokumentu jest zakończone przepływu pracy.

Do obsługi zdarzeń aktywności

  1. W Workflow1.cs lub Workflow1.vb, Dodaj następujące pole do góry Workflow1 klasy.To pole jest używane w działalność do ustalenia, czy przepływ pracy jest zakończone.

    Dim workflowPending As Boolean = True
    
    Boolean workflowPending = true;
    
  2. Dodaj następującą metodę do Workflow1 klasy.Metoda ta sprawdza wartość Document Status właściwości listy dokumentów do ustalenia, czy dokument poddane przeglądowi.Jeśli Document Status właściwość jest ustawiona na Review Complete, a następnie checkStatus Ustawia metodę workflowPending pola do false , aby wskazać, że przepływ pracy jest gotowy do zakończenia.

    Private Sub checkStatus()
        If CStr(workflowProperties.Item("Document Status")) = "Review Complete" Then
            workflowPending = False
        End If
    End Sub 
    
    private void checkStatus()
    {
        if ((string)workflowProperties.Item["Document Status"] == "Review Complete")
        workflowPending = false;
    }
    
  3. Dodaj następujący kod do onWorkflowActivated i onWorkflowItemChanged wywołania metody checkStatus metody.Po uruchomieniu przepływu pracy, onWorkflowActivated wywołania metody checkStatus metody, aby ustalić, czy dokument już poddane przeglądowi.Jeśli nie zostało poddane przeglądowi, nadal przepływu pracy.Po zapisaniu dokumentu onWorkflowItemChanged wywołania metody checkStatus metody ponownie, aby określić, czy dokument poddane przeglądowi.Podczas gdy workflowPending pole jest ustawione na true, przepływ pracy kontynuuje działanie.

    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
    
    private void onWorkflowActivated(object sender, ExternalDataEventArgs e)
    {
        // Check the status.
        checkStatus();
    }
    
    private void onWorkflowItemChanged(object sender, ExternalDataEventArgs e)
    {
        // Check the status.
        checkStatus();
    }
    
  4. Dodaj następujący kod do isWorkflowPending metody sprawdzania stanu workflowPending właściwości.Po każdym zapisaniu dokumentu whileActivity1 wywołania aktywności isWorkflowPending metody.Metoda ta sprawdza Result właściwość ConditionalEventArgs obiekt, aby ustalić, czy WhileActivity1 działania należy kontynuować lub Zakończ.Jeśli właściwość jest ustawiona na true, kontynuuje działanie.W przeciwnym razie zakończy działanie i zakończeniu przepływu pracy.

    Private Sub isWorkflowPending(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ConditionalEventArgs)
        e.Result = workflowPending
    End Sub
    
    private void isWorkflowPending(object sender, ConditionalEventArgs e)
    {
        e.Result = workflowPending;
    }
    
  5. Zapisz projekt.

Testowanie szablon przepływu pracy programu SharePoint

Podczas uruchamiania debugera, Visual Studio wdraża szablon przepływu pracy do serwera programu SharePoint i skojarzenie przepływu pracy z Dokumenty udostępnione listy.Aby przetestować przepływ pracy, należy uruchomić wystąpienie przepływu pracy z dokumentu w Dokumenty udostępnione listy.

Aby przetestować szablon przepływu pracy programu SharePoint

  1. W Workflow1.cs lub Workflow1.vb, ustaw punkt przerwania dalej, aby onWorkflowActivated metody.

  2. Wybierz klawisz F5, aby skompilować i uruchomić roztwór.

    Pojawia się w witrynie programu SharePoint.

  3. W okienku nawigacji w programie SharePoint wybierz Dokumenty udostępnione łącze.

  4. W Dokumenty udostępnione wybierz dokumenty łącze Narzędzia biblioteki tab, a następnie wybierz polecenie Przekaż dokument przycisku.

  5. W Przekaż dokument okno dialogowe Wybierz Przeglądaj przycisku, wybierz dowolny plik dokumentu, wybierz Otwórz przycisk, a następnie wybierz OK przycisku.

    To wysyła wybrany dokument do Dokumenty udostępnione listy i uruchamia przepływ pracy.

  6. W Visual Studio, sprawdź, że debuger zatrzymuje się na punkt przerwania dalej, aby onWorkflowActivated metody.

  7. Wybierz klawisz F5, aby kontynuować wykonywanie.

  8. Zmienianie ustawień w tym miejscu dokumentu, ale pozostawić je na wartości domyślne teraz wybierając zapisać przycisku.

    Nastąpi powrót do Dokumenty udostępnione strony domyślnej witryny sieci Web programu SharePoint.

  9. W Dokumenty udostępnione stronie sprawdź, czy wartość pod MySharePointWorkflow — Workflow1 ustawić kolumnę Postępu W.Oznacza to, że przepływ pracy jest w toku, i że dokument oczekuje na Przegląd.

  10. W Dokumenty udostępnione strony, wybierz dokument, wybierz strzałkę, która pojawia się, a następnie wybierz Edytuj właściwości elementu menu.

  11. Ustaw Stan dokumentu do Zakończenie przeglądu, a następnie wybierz polecenie zapisać przycisku.

    Nastąpi powrót do Dokumenty udostępnione strony domyślnej witryny sieci Web programu SharePoint.

  12. W Dokumenty udostępnione stronie sprawdź, czy wartość pod Stan dokumentu ustawić kolumnę Kompletny przegląd.Odśwież Dokumenty udostępnione strony i sprawdź, czy wartość pod MySharePointWorkflow — Workflow1 ustawić kolumnę zakończone.Wskazuje, że przepływ pracy jest zakończone i poddane przeglądowi dokumentu.

Następne kroki

Można uzyskać więcej informacji na temat tworzenia szablonów przepływu pracy z tych tematów:

Zobacz też

Inne zasoby

Tworzenie rozwiązań przepływu pracy SharePoint

Projekt SharePoint oraz szablony elementów projektu

Kompilowanie i debugowanie rozwiązań SharePoint