İzlenecek yol: SharePoint iş akışı çözümü oluşturma ve hatalarını ayıklama

Bu kılavuzda temel sıralı iş akışı şablonunun nasıl oluşturulacağı gösterilmektedir. İş akışı, bir belgenin gözden geçirilip geçirildiğini belirlemek için paylaşılan belge kitaplığının bir özelliğini denetler. Belge gözden geçirildiyse iş akışı tamamlanır.

Bu izlenecek yol aşağıdaki görevleri gösterir:

  • Visual Studio'da SharePoint liste tanımı sıralı iş akışı projesi oluşturma.

  • İş akışı etkinlikleri oluşturma.

  • İş akışı etkinlik olaylarını işleme.

Not

Bu izlenecek yol sıralı iş akışı projesi kullansa da, durum makinesi iş akışı projesi için işlem aynıdır.

Ayrıca, bilgisayarınız aşağıdaki yönergelerde bazı Visual Studio kullanıcı arabirimi öğeleri için farklı adlar veya konumlar gösterebilir. Sahip olduğunuz Visual Studio sürümü ve kullandığınız ayarlar bu öğeleri belirler. Daha fazla bilgi için bkz . Visual Studio IDE'yi kişiselleştirme.

Önkoşullar

Bu izlenecek yolu tamamlamak için aşağıdaki bileşenlere ihtiyacınız vardır:

  • Microsoft Windows ve SharePoint'in desteklenen sürümleri.

  • Visual Studio.

SharePoint paylaşılan belgeler kitaplığına özellikler ekleme

Paylaşılan Belgeler kitaplığındaki belgelerin gözden geçirme durumunu izlemek için, SharePoint sitemizde paylaşılan belgeler için üç yeni özellik oluşturacağız: Status, Assigneeve Review Comments. Bu özellikleri Paylaşılan Belgeler kitaplığında tanımlarız.

SharePoint paylaşılan belgeler kitaplığına özellikler eklemek için

  1. Web tarayıcısında http://< sistem adı>/SitePages/Home.aspx gibi bir SharePoint sitesi açın.

  2. QuickLaunch çubuğunda SharedDocuments'ı seçin.

  3. Kitaplık Araçları şeridinde Kitaplık'ı seçin ve sonra yeni bir sütun oluşturmak için şeritteki Sütun Oluştur düğmesini seçin.

  4. Sütunu Belge Durumu olarak adlandırın, türünü Seçim olarak ayarlayın (seçebileceğiniz menü), aşağıdaki üç seçeneği belirtin ve ardından Tamam düğmesini seçin:

    • Gözden Geçirme Gerekiyor

    • Gözden Geçirme Tamamlandı

    • İstenen Değişiklikler

  5. İki sütun daha oluşturun ve bunları Atanan ve Açıklamaları Gözden Geçir olarak adlandırabilirsiniz. Atanan sütun türünü tek bir metin satırı olarak, Açıklamaları Gözden Geçir sütun türünü de birden çok metin satırı olarak ayarlayın.

Kullanıma alma gerektirmeden belgelerin düzenlenmesini etkinleştirme

Belgeleri kullanıma almak zorunda kalmadan düzenleyebildiğiniz durumlarda iş akışı şablonunu test etmek daha kolaydır. Sonraki yordamda, SharePoint sitesini bunu etkinleştirecek şekilde yapılandıracaksınız.

Belgelerin kullanıma alınmadan düzenlenmesini sağlamak için

  1. QuickLaunch çubuğunda Paylaşılan Belgeler bağlantısını seçin.

  2. Kitaplık Araçları şeridinde Kitaplık sekmesini seçin ve ardından Kitaplık Ayarlar düğmesini seçerek Belge Kitaplığı Ayarlar sayfasını görüntüleyin.

  3. Genel Ayarlar bölümünde Sürüm Oluşturma Ayarlar bağlantısını seçerek Sürüm Oluşturma Ayarlar sayfasını görüntüleyin.

  4. Belgelerin düzenlenmeden önce kullanıma alınması gerektir ayarının Hayır olduğunu doğrulayın. Değilse, Hayır olarak değiştirin ve ardından Tamam düğmesini seçin.

  5. Tarayıcıyı kapatın.

SharePoint sıralı iş akışı projesi oluşturma

Sıralı iş akışı, son etkinlik bitene kadar sırayla yürütülen bir dizi adımdır. Bu yordamda, Paylaşılan Belgeler listemize uygulanacak sıralı bir iş akışı oluşturacağız. İş akışı sihirbazı, iş akışını site tanımı veya liste tanımıyla ilişkilendirmenize ve iş akışının ne zaman başlayacağını belirlemenize olanak tanır.

SharePoint sıralı iş akışı projesi oluşturmak için

  1. Visual Studio’yu çalıştırın.

  2. Yeni Proje iletişim kutusunu görüntülemek için menü çubuğunda Dosya Yeni>Proje'yi seçin>.

  3. Visual C# veya Visual Basic altında SharePoint düğümünü genişletin ve ardından 2010 düğümünü seçin.

  4. Şablonlar bölmesinde SharePoint 2010 Proje şablonunu seçin.

  5. Ad kutusuna MySharePointWorkflow yazın ve Tamam düğmesini seçin.

    SharePoint Özelleştirme Sihirbazı görüntülenir.

  6. Hata ayıklama için site ve güvenlik düzeyini belirtin sayfasında Grup çözümü olarak dağıt seçenek düğmesini seçin ve ardından güven düzeyini ve varsayılan siteyi kabul etmek için Son düğmesini seçin.

    Bu adım, iş akışı projeleri için kullanılabilen tek seçenek olan grup çözümü olarak çözümün güven düzeyini ayarlar. Daha fazla bilgi için bkz . Korumalı çözümle ilgili önemli noktalar.

  7. Çözüm Gezgini proje düğümünü seçin ve ardından menü çubuğunda Proje>Yeni Öğe Ekle'yi seçin.

  8. Visual C# veya Visual Basic altında SharePoint düğümünü genişletin ve 2010 düğümünü seçin.

  9. Şablonlar bölmesinde Sıralı İş Akışı (yalnızca Grup Çözümü) şablonunu ve ardından Ekle düğmesini seçin.

    SharePoint Özelleştirme Sihirbazı görüntülenir.

  10. Hata ayıklama için iş akışı adını belirtin sayfasında varsayılan adı kabul edin (MySharePointWorkflow - workflow1). Varsayılan iş akışı şablonu türü değerini (İş Akışını Listele) tutun ve İleri düğmesini seçin.

  11. Visual Studio'nun bir hata ayıklama oturumunda iş akışını otomatik olarak ilişkilendirmesini ister misiniz? sayfasında, tüm varsayılan ayarları kabul etmek için İleri düğmesini seçin.

    Bu adım, iş akışını Paylaşılan Belgeler kitaplığıyla otomatik olarak ilişkilendirir.

  12. İş akışınızın nasıl başlatılacağını belirtin sayfasında, İş akışının nasıl başlamasını istiyorsunuz? bölümünde varsayılan seçenekleri seçili bırakın ve Son düğmesini seçin.

    Bu sayfa, iş akışınızın ne zaman başlayacağını belirtmenizi sağlar. Varsayılan olarak iş akışı, kullanıcı SharePoint'te el ile başlattığında veya iş akışının ilişkilendirildiği bir öğe oluşturulduğunda başlar.

İş akışı etkinlikleri oluşturma

İş akışları, gerçekleştirilecek eylemleri temsil eden bir veya daha fazla etkinlik içerir. bir iş akışına yönelik etkinlikleri düzenlemek için iş akışı tasarımcısını kullanın. Bu yordamda iş akışına iki etkinlik ekleyeceğiz: HandleExternalEventActivity ve OnWorkFlowItemChanged. Bu etkinlikler, Paylaşılan Belgeler listesindeki belgelerin gözden geçirme durumunu izler

İş akışı etkinlikleri oluşturmak için

  1. İş akışı iş akışı tasarımcısında görüntülenmelidir. Değilse, Çözüm Gezgini'de Workflow1.cs veya Workflow1.vb dosyasını açın.

  2. Tasarımcıda OnWorkflowActivated1 etkinliğini seçin.

  3. Özellikler penceresinde, Invoked özelliğinin yanına onWorkflowActivated yazın ve Enter tuşunu seçin.

    Kod Düzenleyicisi açılır ve workflow1 kod dosyasına onWorkflowActivated adlı bir olay işleyici yöntemi eklenir.

  4. İş akışı tasarımcısına dönün, araç kutusunu açın ve ardından Windows İş Akışı v3.0 düğümünü genişletin.

  5. Araç Kutusu'nun Windows İş Akışı v3.0 düğümünde aşağıdaki adım kümelerinden birini gerçekleştirin:

    1. While etkinliğinin kısayol menüsünü açın ve kopyala'yı seçin. İş akışı tasarımcısında onWorkflowActivated1 etkinliğinin altındaki çizginin kısayol menüsünü açın ve yapıştır'ı seçin.

    2. Araç Kutusu'ndan While etkinliğini iş akışı tasarımcısına sürükleyin ve etkinliği onWorkflowActivated1 etkinliğinin altındaki satıra bağlayın.

  6. WhileActivity1 etkinliğini seçin.

  7. Özellikler penceresinde Koşul'u Kod Koşulu olarak ayarlayın.

  8. Condition özelliğini genişletin, alt Koşul özelliğinin yanına isWorkflowPending yazın ve enter tuşunu seçin.

    Kod Düzenleyicisi açılır ve workflow1 kod dosyasına isWorkflowPending adlı bir yöntem eklenir.

  9. İş akışı tasarımcısına dönün, araç kutusunu açın ve SharePoint İş Akışı düğümünü genişletin.

  10. Araç Kutusu'nun SharePoint İş Akışı düğümünde aşağıdaki adım kümelerinden birini gerçekleştirin:

    • OnWorkflowItemChanged etkinliğinin kısayol menüsünü açın ve kopyala'yı seçin. İş akışı tasarımcısında whileActivity1 etkinliğinin içindeki çizginin kısayol menüsünü açın ve yapıştır'ı seçin.

    • OnWorkflowItemChanged etkinliğini Araç Kutusu'ndan iş akışı tasarımcısına sürükleyin ve etkinliği whileActivity1 etkinliğinin içindeki çizgiye bağlayın.

  11. onWorkflowItemChanged1 etkinliğini seçin.

  12. Özellikler penceresinde, aşağıdaki tabloda gösterildiği gibi özellikleri ayarlayın.

    Özellik Değer
    Correlationtoken workflowToken
    Çağrılan onWorkflowItemChanged

Etkinlik olaylarını işleme

Son olarak, her etkinlikten belgenin durumunu denetleyin. Belge gözden geçirildiyse iş akışı tamamlanır.

Etkinlik olaylarını işlemek için

  1. Workflow1.cs veya Workflow1.vb içinde aşağıdaki alanı sınıfın Workflow1 en üstüne ekleyin. Bu alan, iş akışının tamamlanıp tamamlanmadığını belirlemek için bir etkinlikte kullanılır.

    Boolean workflowPending = true;

  2. Sınıfına aşağıdaki yöntemi Workflow1 ekleyin. Bu yöntem, belgenin Document Status gözden geçirilip geçirildiğini belirlemek için Belgeler listesinin özelliğinin değerini denetler. Document Status özelliği olarak ayarlanırsa checkStatus Review Completeyöntemi, iş akışının workflowPending tamamlanmaya hazır olduğunu belirtmek için alanı false olarak ayarlar.

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

  3. yöntemini çağırmak checkStatus için onWorkflowActivated ve onWorkflowItemChanged yöntemlerine aşağıdaki kodu ekleyin. İş akışı başladığında yöntemi, onWorkflowActivated belgenin checkStatus zaten gözden geçirilip geçirilmemiş olup olmadığını belirlemek için yöntemini çağırır. Gözden geçirilmemişse iş akışı devam eder. Belge kaydedildiğinde yöntemi, onWorkflowItemChanged belgenin checkStatus gözden geçirilip geçirildiğini belirlemek için yöntemini yeniden çağırır. workflowPending Alan true olarak ayarlanmış olsa da iş akışı çalışmaya devam eder.

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

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

  4. Özelliğinin durumunu workflowPending denetlemek için yöntemine aşağıdaki kodu isWorkflowPending ekleyin. Belge her kaydedildiğinde whileActivity1 etkinliği yöntemini çağırırisWorkflowPending. Bu yöntem, WhileActivity1 etkinliğinin ConditionalEventArgs devam etmesi mi yoksa bitmesi mi gerektiğini belirlemek için nesnesinin özelliğini incelerResult. özelliği true olarak ayarlanırsa etkinlik devam eder. Aksi takdirde etkinlik biter ve iş akışı biter.

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

  5. Projeyi kaydedin.

SharePoint iş akışı şablonunu test edin

Hata ayıklayıcıyı başlattığınızda, Visual Studio iş akışı şablonunu SharePoint sunucusuna dağıtır ve iş akışını Paylaşılan Belgeler listesiyle ilişkilendirir . İş akışını test etmek için Paylaşılan Belgeler listesindeki bir belgeden iş akışının bir örneğini başlatın.

SharePoint iş akışı şablonunu test etmek için

  1. workflow1.cs veya Workflow1.vb içinde onWorkflowActivated yönteminin yanında bir kesme noktası ayarlayın.

  2. Çözümü derlemek ve çalıştırmak için F5 anahtarını seçin.

    SharePoint sitesi görüntülenir.

  3. SharePoint'teki gezinti bölmesinde Paylaşılan Belgeler bağlantısını seçin.

  4. Paylaşılan Belgeler sayfasında, Kitaplık Araçları sekmesinde Belgeler bağlantısını seçin ve ardından Belgeyi Karşıya Yükle düğmesini seçin.

  5. Belgeyi Karşıya Yükle iletişim kutusunda Gözat düğmesini seçin, herhangi bir belge dosyasını seçin, Aç düğmesini ve ardından Tamam düğmesini seçin.

    Bu işlem seçili belgeyi Paylaşılan Belgeler listesine yükler ve iş akışını başlatır.

  6. Visual Studio'da hata ayıklayıcının yöntemin yanındaki onWorkflowActivated kesme noktasında durduğunu doğrulayın.

  7. Yürütmeye devam etmek için F5 anahtarını seçin.

  8. Belgenin ayarlarını burada değiştirebilirsiniz, ancak Kaydet düğmesini seçerek şimdilik varsayılan değerlerde bırakabilirsiniz.

    Bu, sizi varsayılan SharePoint Web sitesinin Paylaşılan Belgeler sayfasına döndürür.

  9. Paylaşılan Belgeler sayfasında MySharePointWorkflow - Workflow1 sütununun altındaki değerin Devam Ediyor olarak ayarlandığını doğrulayın. Bu, iş akışının devam ettiğini ve belgenin gözden geçirmeyi beklediğini gösterir.

  10. Paylaşılan Belgeler sayfasında, belgeyi seçin, görüntülenen oku seçin ve ardından Özellikleri Düzenle menü öğesini seçin.

  11. Belge Durumu'nu Gözden Geçirme Tamamlandı olarak ayarlayın ve kaydet düğmesini seçin.

    Bu, sizi varsayılan SharePoint Web sitesinin Paylaşılan Belgeler sayfasına döndürür.

  12. Paylaşılan Belgeler sayfasında, Belge Durumu sütununun altındaki değerin Gözden Geçirme Tamamlandı olarak ayarlandığını doğrulayın. Paylaşılan Belgeler sayfasını yenileyin ve MySharePointWorkflow - Workflow1 sütununun altındaki değerin Tamamlandı olarak ayarlandığını doğrulayın. Bu, iş akışının tamamlandığını ve belgenin gözden geçirildiğini gösterir.

Sonraki adımlar

İş akışı şablonları oluşturma hakkında daha fazla bilgiyi şu konulardan öğrenebilirsiniz:

İlgili içerik

  • Last updated on