Yinelenen veri dışarı aktarma uygulaması oluşturma

Şu Dynamics 365 uygulamaları için geçerlidir:
İnsan Kaynakları

Bu makalede, verileri Microsoft Dynamics 365 Human Resources'dan yinelenen bir zamanlamaya göre dışarı aktaran bir Microsoft Azure mantıksal uygulamasının nasıl oluşturulacağı açıklanmaktadır. Öğretici, verileri dışa aktarmak için İnsan Kaynakları'nın DMF Paket REST uygulama programlama arabirimini (API) kullanmaktadır. Veriler dışarı aktarıldıktan sonra mantıksal uygulama dışarı aktarılan veri paketini bir Microsoft OneDrive klasörüne kaydeder.

İş senaryosu

Microsoft Dynamics 365 tümleştirmeleri için tipik bir iş senaryosunda, yinelenen bir zamanlamaya göre verileri aşağı akış sistemine aktarmanız gerekir. Bu öğreticide, Microsoft Dynamics 365 Human Resources'deki tüm çalışan kayıtlarını dışarı aktarma ve çalışan listesinin OneDrive klasörüne kaydedilmesi gösterilmektedir.

Tip

Bu öğreticide dışarı aktardığınız belirli veriler ve dışarı aktarılan verilerin hedefi yalnızca örnektir. Bunları iş gereksinimlerinizi karşılayacak şekilde kolayca değiştirebilirsiniz.

Kullanılan teknolojiler

Bu öğretici aşağıdaki teknolojileri kullanmaktadır:

Prerequisites

Bu öğreticideki alıştırmaya başlamadan önce aşağıdaki öğelere sahip olduğunuzdan emin olun:

  • Ortamda yönetici düzeyinde izinleri olan bir İnsan Kaynakları ortamı
  • Mantık uygulamasını barındıracak bir Azure aboneliği

Alıştırma

Bu alıştırmanın sonunda İnsan Kaynakları ortamınıza ve OneDrive hesabınıza bağlı bir mantıksal uygulamanız olacak. Mantıksal uygulama bir veri paketini İnsan Kaynakları'ndan dışarı aktarır, dışarı aktarmanın tamamlanmasını bekler, dışarı aktarılan veri paketini indirir ve veri paketini belirttiğiniz OneDrive klasörüne kaydeder.

Tamamlanmış mantıksal uygulama aşağıdaki çizime benzer.

Tamamlanmış mantıksal uygulamaya genel bakış ekran görüntüsü.

Adım 1: İnsan Kaynakları'nda bir veri dışa aktarma projesi oluşturun

İnsan Kaynakları'nda çalışanları dışa aktaran bir veri dışa aktarma projesi oluşturun. Projeyi Dışarı Aktarma Çalışanları olarak adlandırın ve Veri paketi oluştur seçeneğini Evet olarak ayarlayın. Projeye tek bir varlık (Çalışan) ekleyin ve dışa aktarma biçimini seçin. (Bu öğreticide Microsoft Excel biçimi kullanılır.)

Çalışanları Dışarı Aktar veri projesinin ekran görüntüsü.

Important

Veri dışa aktarma projesinin adını unutmayın. Sonraki adımda mantıksal uygulamayı oluştururken buna ihtiyacınız vardır.

Adım 2: Mantık uygulamasını oluşturun

Bu alıştırmanın çoğu mantıksal uygulama oluşturmayı içerir.

  1. Azure portalında bir mantık uygulaması oluşturun.

    Mantıksal uygulama oluşturma sayfasının ekran görüntüsü.

  2. Logic Apps Designer'da boş bir mantık uygulamasıyla başlayın.

  3. Mantık uygulamasını 24 saatte bir çalıştırmak için (veya istediğiniz zaman çizelgesine göre) bir Yineleme Çizelgesi tetikleyicisi ekleyin.

    Yinelenme iletişim kutusunun ekran görüntüsü.

  4. Veri paketinizin dışa aktarılmasını zamanlamak için ExportToPackage DMF REST API'sını çağırın.

    1. Microsoft Entra ile HTTP bağlayıcısından Bir HTTP isteği çağır eylemini kullanın.

      • Temel Kaynak URL'si: İnsan Kaynakları ortamınızın URL'si (Yol veya ad alanı bilgilerini eklemeyin.)
      • Microsoft Entra Kaynak URI'si:http://hr.talent.dynamics.com

      Note

      İnsan Kaynakları hizmeti, DMF Paket REST API'sını oluşturan, ExportToPackage gibi tüm API'ları gösteren bir bağlayıcıyı henüz sağlamıyor. Bunun yerine, Microsoft Entra ile HTTP bağlayıcısıyla ham HTTPS isteklerini kullanarak API'ları çağırmanız gerekir. Bu bağlayıcı Human Resources'da kimlik doğrulama ve yetkilendirme için Microsoft Entra ID'yi kullanır.

    2. Microsoft Entra ile HTTP bağlayıcısını kullanarak İnsan Kaynakları ortamınızda oturum açın.

    3. ExportToPackage DMF REST API'sını çağırmak için bir HTTP POST isteği ayarlayın.

      • Yöntem: POST

      • İsteğin Url:https://<hostname>/namespaces/<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.ExportToPackage

      • İsteğin gövdesi:

        {
            "definitionGroupId":"Export Workers",
            "packageName":"talent_package.zip",
            "executionId":"",
            "reExecute":false,
            "legalEntityId":"USMF"
        }
        

    Tip

    Her adımı, varsayılan addan daha anlamlı olacak şekilde yeniden adlandırmak isteyebilirsiniz: Bir HTTP isteği çağır. Örneğin bu adımı ExportToPackage olarak yeniden adlandırabilirsiniz.

  5. ExportToPackage isteğinin yürütme durumunu depolamak için bir değişken başlatın.

    Değişken başlat eyleminin ekran görüntüsü.

  6. Veri dışa aktarmanın yürütme durumu Başarılıolana kadar bekleyin.

    1. ExecutionStatus değişkeninin değeri Başarılı olana kadar yinelenen bir Until döngüsü ekleyin.

    2. Dışa aktarmanın geçerli yürütme durumu için yoklamadan önce beş saniye bekleyen bir Gecikme eylemi ekleyin.

      Until döngüsü kapsayıcısının ekran görüntüsü.

      Note

      Dışa aktarmanın tamamlanması için maksimum 75 saniye (15 yineleme × 5 saniye) beklenmesi için limit sayısını 15 olarak ayarlayın. Dışa aktarma işleminiz daha uzun sürüyorsa, limit sayısını uygun şekilde ayarlayın.

    3. GetExecutionSummaryStatus DMF REST API'yı çağırmak için bir HTTP isteği çağır eylemi ekleyin ve ExecutionStatus değişkenini GetExecutionSummaryStatus yanıtının sonucuna ayarlayın.

      Bu örnek hata denetimi yapmaz. GetExecutionSummaryStatus API, başarılı olmayan nihai durumları (yani Başarılı dışındaki durumları) döndürebilir. Daha fazla bilgi için API belgelerine bakın.

      • Yöntem: POST

      • İsteğin Url:https://<hostname>/namespaces/<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.GetExecutionSummaryStatus

      • İsteğin gövdesi:body('Invoke_an_HTTP_request')?['value']

        Note

        İsteğin gövdesi değerini kod görünümünde veya tasarımcıdaki işlev düzenleyicisinde girmeniz gerekebilir.

      HTTP isteği 2'yi çağır eyleminin ekran görüntüsü.

      Değişken ayarla eyleminin ekran görüntüsü.

      Important

      Değişken ayarla eyleminin değeri (gövde('Invoke_an_HTTP_request_2')?[' value']), tasarımcı değerleri aynı şekilde gösterse bile HTTP isteği çağır 2 gövde değerinin değerinden farklıdır.

  7. Dışa aktarılan paketin indirme URL'sini alın.

    • GetExportedPackageUrl DMF REST API'yı çağırmak için bir HTTP isteği çağır eylemi ekleyin.

      • Yöntem: POST
      • İsteğin URL'si: https://<hostname>/namespaces/<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.GetExportedPackageUrl
      • İsteğin gövdesi: {{"executionId": body('GetExportedPackageURL')?['value']}}

      GetExportedPackageURL eyleminin ekran görüntüsü.

  8. Dışa aktarılan paketi indirin.

    • Paketi önceki adımın döndürdüğü URL'den indirmek için bir HTTP GET isteği (yerleşik BIR HTTP bağlayıcı eylemi) ekleyin.

      • Yöntem: GET

      • URI: body('Invoke_an_HTTP_request_3').value

        Note

        URI değerini kod görünümünde veya tasarımcıdaki işlev düzenleyicisinde girmeniz gerekebilir.

      HTTP GET eyleminin ekran görüntüsü.

      Note

      Bu istek herhangi bir ek kimlik doğrulaması gerektirmez çünkü GetExportedPackageUrl API'nın döndürdüğü URL, dosyayı indirmek için erişim izni veren bir paylaşılan bir erişim imzaları belirteci içerir.

  9. OneDrive bağlayıcısını kullanarak indirilen paketi kaydedin.

    • Dosya Oluştur OneDrive dosyası eylemi ekleyin.

    • gerektiği gibi OneDrive hesabınıza bağlanın.

      • Klasör Yolu: Seçtiğiniz bir klasör
      • Dosya Adı: worker_package.zip
      • Dosya İçeriği: Önceki adımdaki gövde (dinamik içerik)

      Dosya oluştur eyleminin ekran görüntüsü.

Adım 3: Mantık uygulamasını test edin

Mantıksal uygulamanızı test etmek için Tasarımcıda çalıştır'ı seçin. Mantıksal uygulamanın adımlarının çalışmaya başladığını görürsünüz. 30-40 saniye sonra mantıksal uygulamanın çalışması tamamlanır ve OneDrive klasörünüz dışarı aktarılan çalışanları içeren yeni bir paket dosyası içerir.

Herhangi bir adım için hata bildirilirse, tasarımcıda hatalı adımı seçin ve Girdiler ve Çıktılar alanlarını inceleyin. Hataları düzeltmek için adımda gerekli hata ayıklama ve düzeltme işlemlerini yapın.

Aşağıdaki çizimde, mantıksal uygulamanın tüm adımları başarıyla çalıştırıldığında Logic Apps tasarımcısının nasıl göründüğü gösterilmektedir.

Başarılı bir mantıksal uygulama çalıştırmasının ekran görüntüsü.

Summary

Bu öğreticide, İnsan Kaynakları'ndan verileri dışarı aktarmak ve dışarı aktarılan verileri bir OneDrive klasörüne kaydetmek için mantıksal uygulama kullanmayı öğrendiniz. Bu öğreticinin adımlarını, iş gereksinimlerinize uygun şekilde değiştirebilirsiniz.