Visual Studio Code kullanarak tek kiracılı Azure Logic Apps'te Standart mantıksal uygulama iş akışı oluşturma

  • Makale

Şunlar için geçerlidir: Azure Logic Apps (Standart)

Bu nasıl yapılır kılavuzunda, Visual Studio Code'u Azure Logic Apps (Standart) uzantısıyla kullanarak tek kiracılı Azure Logic Apps'te çalışan örnek bir tümleştirme iş akışının nasıl oluşturulacağı gösterilmektedir. Bu iş akışını oluşturmadan önce aşağıdaki özellikleri sağlayan bir Standart mantıksal uygulama kaynağı oluşturacaksınız:

  • Mantıksal uygulamanız durum bilgisi olan ve durum bilgisi olmayan birden çok iş akışı içerebilir.

  • Aynı mantıksal uygulama ve kiracıdaki iş akışları Azure Logic Apps çalışma zamanıyla aynı işlemde çalıştırıldığından, aynı kaynakları paylaşır ve daha iyi performans sağlar.

  • Visual Studio Code geliştirme ortamını kullanarak iş akışlarını yerel olarak oluşturabilir, çalıştırabilir ve test edebilirsiniz.

    Hazır olduğunuzda, iş akışınızın tek kiracılı Azure Logic Apps ortamında veya bir App Service Ortamı v3'te (yalnızca Windows tabanlı App Service planları) çalışabileceği mantıksal uygulamanızı Azure'a dağıtabilirsiniz. Azure Logic Apps kapsayıcılı çalışma zamanı nedeniyle iş akışınızı Azure, Azure Kubernetes Service, şirket içi ve hatta diğer bulut sağlayıcıları dahil olmak üzere Kubernetes'in çalıştırabileceği her yere dağıtabilir ve çalıştırabilirsiniz.

    Not

    Mantıksal uygulamanızı bir Kubernetes kümesine dağıtma işlemi şu anda genel önizleme aşamasındadır.

    Tek kiracılı Azure Logic Apps hakkında daha fazla bilgi için Tek kiracılı ile çok kiracılı ve tümleştirme hizmeti ortamını gözden geçirin.

Örnek iş akışı bulut tabanlı olsa da ve yalnızca iki adımı olsa da, bulut, şirket içi ve hibrit ortamlar arasında çok çeşitli uygulamalar, veriler, hizmetler ve sistemler arasında bağlantı kurabilen yüzlerce işlemden iş akışları oluşturabilirsiniz. Örnek iş akışı yerleşik İstek tetikleyicisiyle başlar ve bir Office 365 Outlook eylemiyle devam eder. Tetikleyici, iş akışı için çağrılabilir bir uç nokta oluşturur ve herhangi bir arayandan gelen HTTPS isteğini bekler. Tetikleyici bir istek aldığında ve tetiklendiğinde, bir sonraki eylem tetikleyiciden seçilen çıkışlarla birlikte belirtilen e-posta adresine e-posta göndererek çalışır.

İpucu

Office 365 hesabınız yoksa, e-posta hesabınızdan ileti gönderebilen başka herhangi bir eylemi kullanabilirsiniz, örneğin Outlook.com.

Bunun yerine Azure portalını kullanarak bu örnek iş akışını oluşturmak için Tek kiracılı Azure Logic Apps'i ve Azure portalını kullanarak tümleştirme iş akışları oluşturma adımlarını izleyin. Her iki seçenek de mantıksal uygulama iş akışlarını aynı tür ortamlarda geliştirme, çalıştırma ve dağıtma özelliği sağlar. Ancak Visual Studio Code ile geliştirme ortamınızda iş akışlarını yerel olarak geliştirebilir, test edebilir ve çalıştırabilirsiniz.

Visual Studio Code, mantıksal uygulama projesi ve iş akışını gösteren ekran görüntüsü.

İlerledikçe şu üst düzey görevleri tamamlayacaksınız:

  • Mantıksal uygulamanız için bir proje ve durum bilgisi olan boş bir iş akışı oluşturun.
  • Tetikleyici ve eylem ekleyin.
  • Çalıştırma geçmişini yerel olarak çalıştırın, test edin, hata ayıklayıp gözden geçirin.
  • Güvenlik duvarı erişimi için etki alanı adı ayrıntılarını bulun.
  • İsteğe bağlı olarak Uygulama Analizler etkinleştirmeyi de içeren Azure'a dağıtın.
  • Visual Studio Code'da ve Azure portalında dağıtılan mantıksal uygulamanızı yönetin.
  • Durum bilgisi olmayan iş akışları için çalıştırma geçmişini etkinleştirin.
  • Dağıtımdan sonra Uygulama Analizler etkinleştirin veya açın.

Önkoşullar

Erişim ve bağlantı

  • Standart mantıksal uygulama projelerini yerel olarak oluşturmayı ve iş akışlarını yalnızca Azure Logic Apps çalışma zamanında yerel olarak çalışan yerleşik bağlayıcıları kullanarak çalıştırmayı planlıyorsanız, aşağıdaki gereksinimlere ihtiyacınız yoktur. Ancak, Visual Studio Code'dan Azure'a projenizi yayımlamak veya dağıtmak, genel Azure'da çalışan yönetilen bağlayıcıları kullanmak veya Azure'da zaten dağıtılmış standart mantıksal uygulama kaynaklarına ve iş akışlarına erişmek için aşağıdaki bağlantı ve Azure hesabı kimlik bilgilerine sahip olduğunuzdan emin olun:

    • Gereksinimleri indirebilmeniz, Visual Studio Code'dan Azure hesabınıza bağlanabilmeniz ve Visual Studio Code'dan Azure'a yayımlamanız için İnternet'e erişin.

    • Bir Azure hesabı ve aboneliği Aboneliğiniz yoksa, ücretsiz bir Azure hesabı için kaydolun.

  • Bu makalede aynı örnek iş akışını oluşturmak için, oturum açmak için Microsoft iş veya okul hesabı kullanan bir Office 365 Outlook e-posta hesabınız olmalıdır.

    Outlook.com gibi farklı bir e-posta bağlayıcısı seçerseniz, yine de örneği izleyebilirsiniz ve genel genel adımlar aynıdır. Ancak seçenekleriniz bazı yönlerden farklılık gösterebilir. Örneğin, Outlook.com bağlayıcısını kullanıyorsanız oturum açmak için bunun yerine kişisel Microsoft hesabınızı kullanın.

Araçlar

  1. Ücretsiz olan Visual Studio Code'u indirin ve yükleyin.

  2. Visual Studio Code'daki tüm Azure uzantılarında Azure oturum açma ve abonelik filtreleme için tek bir ortak deneyim elde edebilmeniz için Visual Studio Code için Azure Hesabı uzantısını indirin ve yükleyin. Bu nasıl yapılır kılavuzu, bu deneyimi kullanan adımları içerir.

  3. Herhangi bir yöntemi kullanarak belirli işletim sisteminiz için aşağıdaki Visual Studio Code bağımlılıklarını indirin ve yükleyin:

    Tüm bağımlılıkları otomatik olarak yükleme (önizleme)

    Önemli

    Bu özellik önizleme aşamasındadır ve Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları'na tabidir.

    2.81.5 sürümünden başlayarak Visual Studio Code için Azure Logic Apps (Standart) uzantısı, gerekli tüm bağımlılıkları yeni bir ikili klasöre otomatik olarak yükleyen ve mevcut bağımlılıkları değiştirmeden bırakan bir bağımlılık yükleyicisi içerir. Daha fazla bilgi için bkz . Visual Studio Code için Azure Logic Apps (Standart) uzantısını daha kolay kullanmaya başlama.

    Bu uzantı aşağıdaki bağımlılıkları içerir:

    Dependency Açıklama
    Visual Studio Code için C# İş akışınızı çalıştırmak için F5 işlevselliğini etkinleştirir.
    Visual Studio Code için Azurite Mantıksal uygulama projenizde çalışabilmeniz ve iş akışlarınızı yerel geliştirme ortamınızda çalıştırabilmeniz için Visual Studio Code ile birlikte kullanılacak yerel bir veri deposu ve öykünücü sağlar. Azurite'nin otomatik olarak başlatılmasını istemiyorsanız şu seçeneği devre dışı bırakabilirsiniz:

    1. Dosya menüsünde Tercihler> Ayarlar'i seçin.

    2. Kullanıcı sekmesinde Uzantılar>Azure Logic Apps (Standart)'ı seçin.

    3. Azure Logic Apps Standard: Auto Start Azurite adlı ayarı bulun ve seçili onay kutusunu temizleyin.
    .NET SDK 6.x.x Azure Logic Apps (Standart) çalışma zamanı önkoşulu olan .NET Runtime 6.x.x'i içerir.
    Azure İşlevleri Core Tools - 4.x sürümü sürümü işletim sisteminize (Windows, macOS veya Linux) göre yükler.

    Bu araçlar, Azure Logic Apps (Standart) uzantısının Visual Studio Code'da kullandığı Azure İşlevleri çalışma zamanını destekleyen aynı çalışma zamanının bir sürümünü içerir.
    Daha yeni bir sürüm zaten yüklü değilse Node.js sürüm 16.x.x JavaScript çalıştıran Satır içi Kod İşlemleri eylemini etkinleştirmek için gereklidir.

    Yükleyici aşağıdaki görevleri gerçekleştirmez:

    • Gerekli bağımlılıkların zaten mevcut olup olmadığını denetleyin.
    • Yalnızca eksik bağımlılıkları yükleyin.
    • Mevcut bağımlılıkların eski sürümlerini güncelleştirin.

    1. 2.81.5 sürümünden başlayarak Visual Studio Code için Azure Logic Apps (Standart) uzantısını indirin ve yükleyin.

    2. Visual Studio Code'daki Etkinlik çubuğunda Uzantılar'ı seçin. (Klavye: Ctrl+Shift+X tuşlarına basın)

    3. Uzantılar bölmesinde üç nokta (...) menüsünü açın ve VSIX'ten yükle'yi seçin.

    4. İndirilen VSIX dosyasını bulun ve seçin.

      Kurulum tamamlandıktan sonra uzantı otomatik olarak etkinleştirilir ve Bağımlılık ikili dosyalarını doğrula ve yükle komutunu çalıştırır. İşlem günlüklerini görüntülemek için Çıkış penceresini açın.

    5. Aşağıdaki istem görüntülendiğinde, gerekli bağımlılıkları otomatik olarak yüklemek istediğinizi onaylamak için Evet (Önerilen) seçeneğini belirleyin:

      Bağımlılıkları otomatik olarak yükleme istemini gösteren ekran görüntüsü.

    6. Gerekirse Visual Studio Code'un yükünü yeniden yükleyin.

    7. Bağımlılıkların aşağıdaki klasörde doğru göründüğünden emin olun:

      C:\Users\<your-user-name>\.azurelogicapps\dependencies\<dependency-name>

    8. Visual Studio Code'da aşağıdaki uzantı ayarlarını onaylayın:

      1. Dosya menüsünde Tercihler> Ayarlar'i seçin.

      2. Kullanıcı sekmesinde Uzantılar>Azure Logic Apps (Standart)'ı seçin.

      3. Aşağıdaki ayarları gözden geçirin:

        Uzantı ayarı Değer
        Bağımlılıklar Yolu C:\Users\<your-user-name>\.azurelogicapps\dependencies
        Bağımlılık Zaman Aşımı 60 saniye
        Dotnet İkili Yolu C:\Users\<your-user-name>\.azurelogicapps\dependencies\DotNetSDK\dotnet.exe
        Func Core Araçları İkili Yolu C:\Users\<your-user-name>\.azurelogicapps\dependencies\FuncCoreTools\func
        Düğüm JS İkili Yolu C:\Users\<your-user-name>\.azurelogicapps\dependencies\NodeJs\node
        Otomatik Başlat Azurite Etkin
        Otomatik Başlangıç Tasarım Zamanı Etkin

    9. .vscode/tasks.json dosyasında depolanan özel tanımlı görevler içeren bir mantıksal uygulama projeniz varsa, projenizi açmadan önce tasks.json dosyasını başka bir yere kaydettiğinizden emin olun.

      Projenizi açtığınızda, tasks.json dosyasını gerekli bağımlılıkları kullanacak şekilde güncelleştirmeniz istenir. Devam etmeyi seçerseniz, uzantı tasks.json dosyasının üzerine yazar.

    10. Mantıksal uygulama projenizi açtığınızda aşağıdaki bildirimler görüntülenir:

      Bildirim Eylem
      Arka plan tasarım zamanı işlemini her zaman başlatma sırasında mı başlatılasın? İş akışı tasarımcısını daha hızlı açmak için Evet (Önerilen) seçeneğini belirleyin.
      Azurite proje başlatıldığında otomatik olarak başlatacak şekilde yapılandırılasın mı? Proje açıldığında Azurite depolamanın otomatik olarak başlatılmasını sağlamak için Otomatik Başlangıcı Etkinleştir'i seçin. Visual Studio Code'un en üstündeki komut penceresinde, varsayılan yolu kabul etmek için Enter tuşuna basın:

      C\Users\<your-user-name>\.azurelogicapps\.azurite

    Önizlemeyle ilgili bilinen sorunlar

    • .NET Core SDK'sının herhangi bir sürümü olmayan bir bilgisayara tüm bağımlılıkları otomatik olarak yüklemeyi kabul ettiyseniz, aşağıdaki ileti görüntülenir:

      ".NET Core SDK'sı bulunamıyor: Dotnet çalıştırılırken hata oluştu -- bilgi: Hata: Komut başarısız oldu: dotnet --info 'dotnet iç veya dış komut, çalıştırılabilir program veya toplu iş dosyası olarak tanınmıyor. 'dotnet' iç veya dış komut, çalıştırılabilir program veya toplu iş dosyası olarak tanınmaz. . .NET Core hata ayıklaması etkinleştirilmez. .NET Core SDK'sının yüklü olduğundan ve yolda olduğundan emin olun."

      Uzantı etkinleştirildiğinde .NET Core çerçevesi yüklenmeye devam ettiğinden bu iletiyi alırsınız. Bu iletiyi devre dışı bırakmayı güvenle seçebilirsiniz.

      Var olan bir mantıksal uygulama projesini açarken veya func konak başlangıcı için hata ayıklama görevini (tasks.json) başlatırken sorun yaşıyorsanız ve bu ileti görüntülenirse, sorunu çözmek için şu adımları izleyin:

      1. Ortam PATH değişkeninize dotnet ikili yolunu ekleyin.

        1. Windows görev çubuğundaki arama kutusuna ortam değişkenleri yazın ve Sistem ortam değişkenlerini düzenle'yi seçin.

        2. Sistem Özellikleri kutusunun Gelişmiş sekmesinde Ortam Değişkenleri'ni seçin.

        3. Ortam Değişkenleri kutusunda, kullanıcı adınız> için <Kullanıcı değişkenleri listesinden PATH'i ve ardından Düzenle'yi seçin.

        4. Listede aşağıdaki değer görünmüyorsa, aşağıdaki değeri eklemek için Yeni'yi seçin:

          C:\Users\<your-user-name>\.azurelogicapps\dependencies\DotNetSDK

        5. Bitirdiğinizde Tamam'ı seçin.

      2. Tüm Visual Studio Code pencerelerini kapatın ve projenizi yeniden açın.

    • İkili bağımlılıkları yükleme ve doğrulama konusunda sorun yaşıyorsanız, örneğin:

      • Linux izin sorunları
      • Şu hatayı alıyorsunuz: <Dosya veya yol> yok
      • Doğrulama, bağımlılık-adında> takılıyor<.

      İkili bağımlılıkları doğrula ve yükle komutunu yeniden çalıştırmak için şu adımları izleyin:

      1. Görünüm menüsünden Komut Paleti'ni seçin.

      2. Komut penceresi görüntülendiğinde İkili bağımlılıkları doğrula ve yükle komutunu girin ve çalıştırın.

    • .NET Core 7 veya sonraki bir sürümünü yüklemediyseniz ve Azure İşlevleri proje içeren bir Azure Logic Apps çalışma alanını açarsanız aşağıdaki iletiyi alırsınız:

      [function-name].csproj projesi yüklenirken sorun oluştu. Ayrıntılar için bkz. günlük.

      Bu eksik bileşen Azure İşlevleri projesini etkilemez, bu nedenle bu iletiyi güvenle yoksayabilirsiniz.

    Her bağımlılığı ayrı olarak yükleme

    Dependency Açıklama
    .NET SDK 6.x.x Azure Logic Apps (Standart) çalışma zamanı önkoşulu olan .NET Runtime 6.x.x'i içerir.
    Azure İşlevleri Core Tools - 4.x sürümü - Windows: Microsoft Installer (MSI) sürümünü func-cli-X.X.XXXX-x*.msikullanın.
    - macOS
    - Linux

    Bu araçlar, Azure Logic Apps (Standart) uzantısının Visual Studio Code'da kullandığı Azure İşlevleri çalışma zamanını destekleyen aynı çalışma zamanının bir sürümünü içerir.

    Bu sürümlerden önceki bir yüklemeniz varsa, önce bu sürümü kaldırın veya PATH ortam değişkeninin indirdiğiniz ve yüklediğiniz sürüme işaretdiğinden emin olun.
    Daha yeni bir sürüm zaten yüklü değilse Node.js sürüm 16.x.x JavaScript çalıştıran Satır içi Kod İşlemleri eylemini etkinleştirmek için gereklidir.

    Not: Windows için MSI sürümünü indirin. Bunun yerine ZIP sürümünü kullanıyorsanız, işletim sisteminiz için bir PATH ortam değişkeni kullanarak Node.js el ile kullanılabilir hale getirmeniz gerekir.

  4. Azure Logic Apps (Standart) uzantısının tüm bağımlılıkları (önizleme) otomatik olarak yükleyen sürümünü zaten yüklediyseniz bu adımı atlayın. Aksi takdirde Visual Studio Code için Azure Logic Apps (Standart) uzantısını indirip yükleyin.

    1. Visual Studio Code'da sol araç çubuğunda Uzantılar'ı seçin.

    2. Uzantılar arama kutusuna azure logic apps standard yazın. Sonuçlar listesinden Azure Logic Apps (Standart)Yükle'yi> seçin.

      Yükleme tamamlandıktan sonra uzantı Uzantılar: Yüklü listesinde görünür.

      Azure Logic Apps (Standart) uzantısının yüklü olduğu Visual Studio Code'u gösteren ekran görüntüsü.

      İpucu

      Uzantı yüklü listede görünmüyorsa Visual Studio Code'u yeniden başlatmayı deneyin.

    Şu anda hem Tüketim (çok kiracılı) hem de Standart (tek kiracılı) uzantıları aynı anda yükleyebilirsiniz. Geliştirme deneyimleri birbirinden bazı açılardan farklılık gösterir, ancak Azure aboneliğiniz hem Standart hem de Tüketim mantıksal uygulama türlerini içerebilir. Visual Studio Code'da Azure penceresi, Azure aboneliğinizdeki tüm Azure tarafından dağıtılan ve barındırılan mantıksal uygulamaları gösterir, ancak uygulamalarınızı aşağıdaki yollarla düzenler:

    • Logic Apps (Tüketim) bölümü: Aboneliğinizdeki tüm Tüketim mantığı uygulamaları.

    • Kaynaklar bölümü: Aboneliğinizdeki tüm Standart mantıksal uygulamalar. Daha önce, bu mantıksal uygulamalar Artık Kaynaklar bölümüne taşınan Logic Apps (Standart) bölümünde görünüyordu.

  5. Visual Studio Code'da yerleşik HTTP Web Kancası tetikleyicisi gibi web kancası tabanlı tetikleyicileri ve eylemleri yerel olarak çalıştırmak için geri arama URL'si için iletmeyi ayarlamanız gerekir.

  6. Bu makaledeki örnek iş akışını test etmek için İstek tetikleyicisi tarafından oluşturulan uç noktaya çağrı gönderebilen bir araç gerekir. Böyle bir aracınız yoksa Postman uygulamasını indirebilir, yükleyebilir ve kullanabilirsiniz.

  7. Mantıksal uygulama kaynaklarınızı Uygulama Analizler kullanmayı destekleyen ayarlarla oluşturursanız, mantıksal uygulama kaynağınız için isteğe bağlı olarak tanılama günlüğünü ve izlemeyi etkinleştirebilirsiniz. Mantıksal uygulamanızı oluştururken veya dağıtımdan sonra bunu yapabilirsiniz. Bir Application Analizler örneğiniz olması gerekir, ancak bu kaynağı önceden, mantıksal uygulamanızı oluştururken veya dağıtımdan sonra oluşturabilirsiniz.

Visual Studio Code'u ayarlama

  1. Tüm uzantıların doğru yüklendiğinden emin olmak için Visual Studio Code'u yeniden yükleyin veya yeniden başlatın.

  2. Tüm uzantılarınızın en son güncelleştirmeleri alması için Visual Studio Code'un uzantı güncelleştirmelerini otomatik olarak bulduğunu ve yüklediğini onaylayın. Aksi takdirde, eski sürümü el ile kaldırmanız ve en son sürümü yüklemeniz gerekir.

    1. Dosya menüsünde Tercihler> Ayarlar'e gidin.

    2. Kullanıcı sekmesinde Özellikler>Uzantıları'na gidin.

    3. Otomatik Denetim Güncelleştirmeler'nin seçili olduğunu ve Otomatik Güncelleştirme'nin Tüm Uzantılar olarak ayarlandığını onaylayın.

  3. Azure Logic Apps (Standart) uzantısı için Azure Logic Apps Standard: Project Runtime ayarının ~4 sürümüne ayarlandığını onaylayın:

    Not

    Bu sürüm Satır içi Kod İşlemleri eylemlerini kullanmak için gereklidir.

    1. Dosya menüsünde Tercihler> Ayarlar'e gidin.

    2. Kullanıcı sekmesinde Uzantılar>Azure Logic Apps (Standart) bölümüne gidin>.

      Örneğin, Azure Logic Apps Standart: Project Çalışma Zamanı ayarını burada bulabilir veya diğer ayarları bulmak için arama kutusunu kullanabilirsiniz:

      Azure Logic Apps (Standart) uzantısı için Visual Studio Code ayarlarını gösteren ekran görüntüsü.

Azure hesabınıza bağlanma

  1. Visual Studio Code Etkinlik Çubuğu'nda Azure simgesini seçin.

    Visual Studio Code Etkinlik Çubuğu'nu ve seçili Azure simgesini gösteren ekran görüntüsü.

  2. Azure penceresindeki Kaynaklar'ın altında Azure'da oturum aç'ı seçin. Visual Studio Code kimlik doğrulama sayfası görüntülendiğinde Azure hesabınızla oturum açın.

    Azure oturum açma için Azure penceresini ve seçili bağlantıyı gösteren ekran görüntüsü.

    Oturum açıldıktan sonra Azure penceresinde Azure hesabınızla ilişkili Azure abonelikleri gösterilir. Beklenen abonelikler görünmüyorsa veya bölmenin yalnızca belirli abonelikleri göstermesini istiyorsanız şu adımları izleyin:

    1. Abonelikler listesinde, abonelikleri seç düğmesi (filtre simgesi) görünene kadar işaretçinizi ilk aboneliğin yanına taşıyın. Filtre simgesini seçin.

      Aboneliklerin ve seçili filtre simgesinin gösterildiği Azure penceresini gösteren ekran görüntüsü.

      Alternatif olarak, Visual Studio Code durum çubuğunda Azure hesabınızı seçin.

    2. Başka bir abonelik listesi görüntülendiğinde, istediğiniz abonelikleri seçin ve ardından Tamam'ı seçtiğinizden emin olun.

Yerel proje oluşturma

Mantıksal uygulamanızı oluşturmadan önce, Visual Studio Code'dan mantıksal uygulamanızı yönetebilmeniz, çalıştırabilmeniz ve dağıtabilmeniz için yerel bir proje oluşturun. Temel alınan proje, işlev uygulaması projesi olarak da bilinen bir Azure İşlevleri projesine benzer. Ancak bu proje türleri birbirinden ayrı olduğundan mantıksal uygulamalar ve işlev uygulamaları aynı projede bulunamaz.

  1. Bilgisayarınızda, daha sonra Visual Studio Code'da oluşturacağınız proje için kullanmak üzere boş bir yerel klasör oluşturun.

  2. Visual Studio Code'da tüm açık klasörleri kapatın.

  3. Azure penceresinde, Çalışma Alanı bölüm araç çubuğunda, Azure Logic Apps menüsünden Yeni Proje Oluştur'u seçin.

    Yeni Proje Oluştur'un seçili olduğu Azure penceresini, Çalışma Alanı araç çubuğunu ve Azure Logic Apps menüsünü gösteren ekran görüntüsü.

  4. Windows Defender Güvenlik Duvarı, Visual Studio Code olan ve Azure İşlevleri Temel Araçları olan için ağ erişimi Code.exevermenizi isterse, Ev veya iş ağım>gibi Özel ağlar Erişime izin ver'i seçin.func.exe

  5. Proje klasörünüzü oluşturduğunuz konuma gidin, bu klasörü seçin ve devam edin.

    Klasör Seç kutusunu ve Seç düğmesinin seçili olduğu yeni proje klasörünü gösteren ekran görüntüsü.

  6. Görüntülenen şablonlar listesinde Durum Bilgisi Olan İş Akışı veya Durum Bilgisi Olmayan İş Akışı'nı seçin. Bu örnekte Durum Bilgisi Olan İş Akışı seçilir.

    Durum Bilgisi Olan İş Akışı'nın seçili olduğu iş akışı şablonları listesini gösteren ekran görüntüsü.

  7. İş akışınız için bir ad girin ve Enter tuşuna basın. Bu örnekte ad olarak Stateful-Workflow kullanılır.

    Yeni Durum Bilgisi Olan İş Akışı Oluştur (3/4) kutusunu ve durum bilgisi olan iş akışı adını gösteren ekran görüntüsü.

    Not

    azureFunctions.suppressProject kayıtlı bir yapılandırma olmadığından Çalışma Alanı Ayarlar yazılamıyor hata iletisiyle azureLogicAppsStandard.createNewProject adlı bir hata alabilirsiniz. Bunu yaparsanız, Visual Studio Code için doğrudan Visual Studio Market'ten veya Visual Studio Code'un içinden Azure İşlevleri uzantısını yüklemeyi deneyin.

  8. Visual Studio Code, projenizi geçerli Visual Studio Code'da veya yeni bir Visual Studio Code penceresinde açmanızı isterse Geçerli pencerede aç'ı seçin. Aksi takdirde Yeni pencerede aç'ı seçin.

    Visual Studio Code projenizi oluşturmayı tamamlar.

  9. Visual Studio Etkinlik Çubuğu'ndan, henüz açık değilse Gezgin bölmesini açın.

    Gezgin bölmesi, otomatik olarak oluşturulan proje dosyalarını içeren projenizi gösterir. Örneğin, projede iş akışınızın adını gösteren bir klasör vardır. bu klasörün içinde, workflow.json dosyası iş akışınızın temel JSON tanımını içerir.

    Proje klasörü, iş akışı klasörü ve workflow.json dosyası içeren Gezgin bölmesini gösteren ekran görüntüsü.

    Visual Studio Code'da mantıksal uygulama projenizde aşağıdaki türlerden biri vardır:

    • Varsayılan tür olan uzantı paketi tabanlı (Node.js)
    • NuGet paket tabanlı (.NET), varsayılan türden dönüştürebilirsiniz

    Bu türlere bağlı olarak projeniz biraz farklı klasörler ve dosyalar içerir. NuGet tabanlı proje, paketleri ve diğer kitaplık dosyalarını içeren bir .bin klasörü içerir. Paket tabanlı proje, .bin klasörünü ve diğer dosyaları içermez. Bazı senaryolar, örneğin özel yerleşik işlemler geliştirmek ve çalıştırmak istediğinizde uygulamanızın çalışması için NuGet tabanlı bir proje gerektirir. Projenizi NuGet kullanacak şekilde dönüştürme hakkında daha fazla bilgi için Bkz . Yerleşik bağlayıcı yazmayı etkinleştirme.

    Varsayılan paket tabanlı proje için, projenizin aşağıdaki örneğe benzer bir klasör ve dosya yapısı vardır:

    MyBundleBasedLogicAppProjectName
| .vscode
| Artifacts
  || Maps 
     ||| MapName1
     ||| ...
  || Schemas
     ||| SchemaName1
     ||| ...
| WorkflowName1
  || workflow.json
  || ...
| WorkflowName2
  || workflow.json
  || ...
| workflow-designtime
| .funcignore
| connections.json
| host.json
| local.settings.json

    Projenizin kök düzeyinde, aşağıdaki dosya ve klasörleri diğer öğelerle bulabilirsiniz:

    Veri Akışı Adı Klasör veya dosya Açıklama
    .vscode Klasör extensions.json, launch.json, settings.json ve tasks.json dosyaları gibi Visual Studio Code ile ilgili ayarlar dosyalarını içerir.
    Yapı Klasör İşletmeler arası (B2B) senaryoları destekleyen iş akışlarında tanımladığınız ve kullandığınız tümleştirme hesabı yapıtlarını içerir. Örneğin, örnek yapı XML dönüştürme ve doğrulama işlemleri için haritaları ve şemaları içerir.
    <WorkflowName> Klasör Her iş akışı için WorkflowName klasörü, iş akışının <temel aldığı JSON tanımını içeren bir workflow.json dosyası içerir.>
    workflow-designtime Klasör Geliştirme ortamıyla ilgili ayarlar dosyalarını içerir.
    .funcignore Dosya Yüklü Azure İşlevleri Temel Araçlarınızla ilgili bilgileri içerir.
    connections.json Dosya İş akışlarınızın kullandığı yönetilen bağlantılar ve Azure işlevleri için meta verileri, uç noktaları ve anahtarları içerir.

    Önemli: Her ortam için farklı bağlantılar ve işlevler kullanmak için bu connections.json dosyasını parametreleştirdiğinizden ve uç noktaları güncelleştirdiğinizden emin olun.
    host.json Dosya Tek kiracılı Azure Logic Apps platformu, mantıksal uygulamalar, iş akışları, tetikleyiciler ve eylemler için varsayılan sınırlar gibi çalışma zamanına özgü yapılandırma ayarlarını ve değerlerini içerir. Mantıksal uygulama projenizin kök düzeyinde host.json meta veri dosyası, aynı mantıksal uygulamadaki tüm iş akışlarının çalışırken kullandığı yapılandırma ayarlarını ve varsayılan değerleri (yerel olarak veya Azure'da) içerir.

    Not: Mantıksal uygulamanızı oluşturduğunuzda, Visual Studio Code depolama kapsayıcınızda bir yedekleme host.snapshot.*.json dosyası oluşturur. Mantıksal uygulamanızı silerseniz, bu yedekleme dosyası silinmez. Aynı ada sahip başka bir mantıksal uygulama oluşturursanız, başka bir anlık görüntü dosyası oluşturulur. Aynı mantıksal uygulama için en fazla 10 anlık görüntüye sahip olabilirsiniz. Bu sınırı aşarsanız aşağıdaki hatayı alırsınız:

    Microsoft.Azure.WebJobs.Script.WebHost: Repository has more than 10 non-decryptable secrets backups (host))

    Bu hatayı düzeltmek için depolama kapsayıcınızdan ek anlık görüntü dosyalarını silin.
    local.settings.json Dosya İş akışlarınızın yerel olarak çalışırken kullandığı uygulama ayarlarını, bağlantı dizesi ve diğer ayarları içerir. Başka bir deyişle, bu ayarlar ve değerler yalnızca projelerinizi yerel geliştirme ortamınızda çalıştırdığınızda uygulanır. Azure'a dağıtım sırasında dosya ve ayarlar yoksayılır ve dağıtımınıza dahil değildir.

    Bu dosya, ayarları ve değerleri , yerel geliştirme araçlarınız tarafından değerler olarak kullanılan yerel ortam değişkenleri olarak appSettings depolar. Uygulama ayarlarını ve parametrelerini kullanarak bu ortam değişkenlerini hem çalışma zamanında hem de dağıtım zamanında çağırabilir ve bunlara başvurabilirsiniz.

    Önemli: local.settings.json dosyası gizli diziler içerebilir, bu nedenle bu dosyayı proje kaynak denetiminizden de dışladığınızdan emin olun.

Projenizi NuGet paket tabanlı (.NET) dönüştürme

Varsayılan olarak Visual Studio Code, NuGet paket tabanlı (.NET) değil uzantı paketi tabanlı (Node.js) bir mantıksal uygulama projesi oluşturur. NuGet paket tabanlı (.NET) bir mantıksal uygulama projesine ihtiyacınız varsa, örneğin, yerleşik bağlayıcı yazmayı etkinleştirmek için projenizi uzantı paket tabanlı (Node.js) nuGet paket tabanlı (.NET) olarak dönüştürmeniz gerekir.

Önemli

Bu eylem, geri alınamaz tek yönlü bir işlemdir.

  1. Gezgin bölmesinde, projenizin kökünde, fare işaretçinizi diğer tüm dosya ve klasörlerin altındaki boş bir alanın üzerine getirin, kısayol menüsünü açın ve NuGet tabanlı Mantıksal Uygulama projesine Dönüştür'ü seçin.

    Proje penceresindeki boş alandan açılan proje kısayol menüsünün bulunduğu Gezgin bölmesini gösteren ekran görüntüsü.

  2. İstem görüntülendiğinde proje dönüştürmeyi onaylayın.

Yerleşik bağlayıcı yazmayı etkinleştirme

Tek kiracılı Azure Logic Apps genişletilebilirlik çerçevesini kullanarak ihtiyacınız olan herhangi bir hizmet için kendi yerleşik bağlayıcılarınızı oluşturabilirsiniz. Azure Service Bus ve SQL Server gibi yerleşik bağlayıcılara benzer şekilde, bu bağlayıcılar daha yüksek aktarım hızı, düşük gecikme süresi, yerel bağlantı sağlar ve tek kiracılı Azure Logic Apps çalışma zamanıyla aynı işlemde yerel olarak çalışır.

Yazma özelliği şu anda yalnızca Visual Studio Code'da kullanılabilir, ancak varsayılan olarak etkin değildir. Bu bağlayıcıları oluşturmak için şu adımları izleyin:

  1. Henüz yapmadıysanız, projenizi uzantı paketi tabanlı (Node.js) paket tabanlı NuGet'e (.NET) dönüştürün.

  2. Azure Logic Apps Running Anywhere - Yerleşik bağlayıcı genişletilebilirliği makalesindeki adımları gözden geçirin ve izleyin.

Projenize özel yapıtlar ekleme

Mantıksal uygulama iş akışında, bazı bağlayıcıların haritalar, şemalar veya derlemeler gibi yapıtlara bağımlılıkları vardır. Visual Studio Code'da bu yapıtları mantıksal uygulama projenize yükleyebilirsiniz; örneğin, Yapıtlar'ın altındaki mantıksal uygulama kaynak menüsü aracılığıyla Bu yapıtları Azure portalında nasıl karşıya yükleyebileceğinize benzer:

Yapıtlar bölümünün vurgulandığı Azure portalı ve Standart mantıksal uygulama kaynak menüsünü gösteren ekran görüntüsü.

Projenize haritalar ekleme

Projenize harita eklemek için proje hiyerarşinizde, haritalarınızı yerleştirebileceğiniz klasör olan Yapıtlar> Haritalar'ı genişletin.

Yapıtlar ve Haritalar klasörleri genişletilmiş Visual Studio Code proje hiyerarşisi gösteren ekran görüntüsü.

Projenize şema ekleme

Projenize şema eklemek için, proje hiyerarşinizde şemalarınızı yerleştirebileceğiniz klasör olan Yapıt>Şemaları'nı genişletin.

Yapıtlar ve Şemalar klasörleri genişletilmiş Visual Studio Code proje hiyerarşisi gösteren ekran görüntüsü.

Projenize derlemeler ekleme

Standart mantıksal uygulama, Visual Studio Code'da projenize yükleyebileceğiniz belirli derleme türlerini kullanabilir veya bunlara başvurabilir. Ancak, bunları projenizdeki belirli klasörlere eklemeniz gerekir. Aşağıdaki tabloda her derleme türü ve bunları projenize tam olarak nereye yerleştireceğiniz hakkında daha fazla bilgi sağlanmaktadır.

Derleme türü Açıklama
İstemci/SDK Derlemesi (.NET Framework) Bu derleme türü, .NET Framework için istemci ve özel SDK'nın depolanmasını ve dağıtımını sağlar. Örneğin SAP yerleşik bağlayıcısı, SAP NCo yeniden dağıtılamayan DLL dosyalarını yüklemek için bu derlemeleri kullanır.

Bu derlemeleri şu klasöre eklediğinizden emin olun: \lib\builtinOperationSdks\net472
İstemci/SDK Derlemesi (Java) Bu derleme türü, Java için özel SDK'nın depolanmasını ve dağıtımını sağlar. Örneğin, JDBC yerleşik bağlayıcısı özel ilişkisel veritabanlarının (RDB) JDBC sürücülerini bulmak için bu JAR dosyalarını kullanır.

Bu derlemeleri şu klasöre eklediğinizden emin olun: \lib\builtinOperationSdks\JAR
Özel Derleme (.NET Framework) Bu derleme türü, özel DLL'lerin depolanmasını ve dağıtımını sağlar. Örneğin Dönüştürme XML'i işlemi, XML dönüşümü sırasında gerekli olan özel dönüştürme işlevleri için bu derlemeleri kullanır.

Bu derlemeleri şu klasöre eklediğinizden emin olun: \lib\custom\net472

Aşağıdaki görüntüde, projenizde her derleme türünün nereye yerleştirileceği gösterilmektedir:

Visual Studio Code, mantıksal uygulama projesi ve derlemelerin karşıya yüklendiği yeri gösteren ekran görüntüsü.

Derlemeleri Azure portalında mantıksal uygulama kaynağınıza yükleme hakkında daha fazla bilgi için bkz . Başvuruda bulunan derlemeleri ekleme.

NuGet tabanlı projeleri "lib\*" derlemelerini kullanacak şekilde geçirme

Önemli

Bu görev yalnızca NuGet tabanlı mantıksal uygulama projeleri için gereklidir.

Mantıksal uygulama projenizi derleme desteği Standart mantıksal uygulama iş akışlarında kullanılamadığında oluşturduysanız, derlemeleri kullanan projelerle çalışmak için project-name.csproj> dosyanıza <aşağıdaki satırları ekleyebilirsiniz:

  <ItemGroup>
    <LibDirectory Include="$(MSBuildProjectDirectory)\lib\**\*"/>
  </ItemGroup>
  <Target Name="CopyDynamicLibraries" AfterTargets="_GenerateFunctionsExtensionsMetadataPostPublish">
    <Copy SourceFiles="@(LibDirectory)" DestinationFiles="@(LibDirectory->'$(MSBuildProjectDirectory)\$(PublishUrl)\lib\%(RecursiveDir)%(Filename)%(Extension)')"/>
  </Target>

Önemli

Linux veya MacOS üzerinde çalışan bir proje için dizin ayırıcısını güncelleştirdiğinden emin olun. Örneğin, project-name.csproj> dosyasına eklenen <önceki kodu gösteren aşağıdaki görüntüyü gözden geçirin.

Geçirilen derlemeleri ve CSPROJ dosyasına eklenen kodu gösteren ekran görüntüsü.

İş akışı tanım dosyasını tasarımcıda açma

  1. Bu örnekte Stateful-Workflow adlı iş akışınızın proje klasörünü genişletin ve workflow.json dosyasını açın.

  2. workflow.json dosyasının kısayol menüsünü açın ve Tasarım Aracı aç'ı seçin.

    Gezgin bölmesini, workflow.json dosya kısayol menüsünü ve Seçili Tasarım Aracı aç'ı gösteren ekran görüntüsü.

  3. Azure'da bağlayıcıları etkinleştir listesi açıldıktan sonra Azure'da barındırılan ve çalıştırılan tüm yönetilen veya "paylaşılan" bağlayıcılara ve doğrudan Azure Logic Apps çalışma zamanıyla çalışan yerleşik, yerel veya "uygulama içi" bağlayıcılara göre geçerli olan Azure'dan bağlayıcıları kullan'ı seçin.

    Gezgin bölmesini, Azure'da bağlayıcıları etkinleştir adlı açık listeyi ve Azure'dan bağlayıcıları kullan seçeneğini gösteren ekran görüntüsü.

    Not

    Durum bilgisi olmayan iş akışları şu anda yalnızca yönetilen bağlayıcıların eylemlerini destekler, tetikleyicileri desteklemez. Durum bilgisi olmayan iş akışınız için Azure'da bağlayıcıları etkinleştirme seçeneğiniz olsa da tasarımcı, seçmeniz için yönetilen bağlayıcı tetikleyicileri göstermez.

  4. Abonelik seçin listesi açıldıktan sonra mantıksal uygulama projeniz için kullanılacak Azure aboneliğini seçin.

    Abonelik seç adlı liste ve seçili bir abonelik içeren Gezgin bölmesini gösteren ekran görüntüsü.

  5. Kaynak grupları listesi açıldıktan sonra Yeni kaynak grubu oluştur'u seçin.

    Yeni kaynak grubu oluşturmak için kaynak grupları listesinin ve seçili seçeneğin yer aldığı Gezgin bölmesini gösteren ekran görüntüsü.

  6. Kaynak grubu için bir ad girin ve Enter tuşuna basın. Bu örnekte Fabrikam-Workflows-RG kullanılır.

    Gezgin bölmesini ve kaynak grubu adı kutusunu gösteren ekran görüntüsü.

  7. Konumlar listesinden kaynak grubunuzu ve kaynaklarınızı oluştururken kullanılacak Azure bölgesini seçin. Bu örnekte Orta Batı ABD kullanılır.

    Konum listesi ve

    Bu adımı gerçekleştirdikten sonra Visual Studio Code iş akışı tasarımcısını açar.

    Not

    Visual Studio Code iş akışı tasarım zamanı API'sini başlattığında, başlatma işleminin birkaç saniye sürebileceğini belirten bir ileti alabilirsiniz. Bu iletiyi yoksayabilir veya Tamam'ı seçebilirsiniz.

    Tasarımcı açılmıyorsa sorun giderme bölümünü gözden geçirin Tasarım Aracı açılamıyor.

    Tasarımcı göründükten sonra tasarımcıda Tetikleyici ekle istemi görüntülenir.

  8. Tasarımcıda Tetikleyici ekle'yi seçerek Tetikleyici ekle bölmesini ve seçmeniz için tetikleyicileri olan tüm bağlayıcıları gösteren bir galeriyi açın.

    İş akışı tasarımcısı, Tetikleyici ekle adlı seçili istem ve tetikleyicileri olan bağlayıcılar için galeriyi gösteren ekran görüntüsü.

  9. Ardından, iş akışınıza bir tetikleyici ve eylemler ekleyin.

Tetikleyici ve eylem ekleme

Tasarımcıda boş bir iş akışı açtıktan sonra tasarımcıda Tetikleyici ekle istemi görüntülenir. Artık tetikleyici ve eylemler ekleyerek iş akışınızı oluşturmaya başlayabilirsiniz.

Önemli

Web kancası tabanlı tetikleyici veya yerleşik HTTP Web Kancası tetikleyicisi veya eylemi gibi eylemler kullanan bir iş akışını yerel olarak çalıştırmak için, web kancasının geri çağırma URL'si için iletmeyi ayarlayarak bu özelliği etkinleştirmeniz gerekir.

Bu örnekteki iş akışı aşağıdaki tetikleyiciyi ve eylemleri kullanır:

İstek tetikleyicisini ekleme

  1. İş akışı tasarımcısında, Tetikleyici ekle bölmesinde Çalışma Zamanı listesini açın ve Yalnızca kullanılabilir yerleşik bağlayıcı tetikleyicilerini görüntülemek için Uygulama İçi'ni seçin.

  2. Arama kutusunu kullanarak HTTP isteği alındığında adlı İstek tetikleyicisini bulun ve bu tetikleyiciyi iş akışınıza ekleyin. Daha fazla bilgi için bkz . Tetikleyici ve eylemlerle iş akışı oluşturma.

    İş akışı tasarımcısı, Tetikleyici ekle bölmesi ve HTTP isteği alındığında adlı seçili tetikleyiciyi gösteren ekran görüntüsü.

    Tetikleyici tasarımcıda görüntülendiğinde, tetikleyicinin bilgi bölmesi açılır ve tetikleyicinin parametreleri, ayarları ve diğer ilgili görevleri gösterilir.

    Http isteği alındığında adlı tetikleyicinin bilgi bölmesini gösteren ekran görüntüsü.

    İpucu

    Bilgi bölmesi görünmüyorsa, tetikleyicinin tasarımcıda seçili olduğundan emin olun.

  3. İş akışınızı kaydedin. Tasarımcı araç çubuğunda Kaydet'i seçin.

Tasarımcıdan bir öğeyi silmeniz gerekiyorsa, tasarımcıdan öğe silmek için aşağıdaki adımları izleyin.

Office 365 Outlook eylemini ekleme

  1. Tasarımcıda, İstek tetikleyicisinin altında artı işaretini (+) >Eylem ekle'yi seçin.

  2. Açılan eylem ekle bölmesinde, Çalışma Zamanı listesinde Paylaşılan'ı seçerek yalnızca kullanılabilir yönetilen bağlayıcı eylemlerini görüntüleyin.

  3. Arama kutusunu kullanarak E-posta gönder (V2) adlı Office 365 Outlook yönetilen bağlayıcı eylemini bulun ve bu eylemi iş akışınıza ekleyin. Daha fazla bilgi için bkz . Tetikleyici ve eylemlerle iş akışı oluşturma.

    İş akışı tasarımcısı ve E-posta gönder adlı seçili Office 365 Outlook eylemiyle eylem ekle bölmesini gösteren ekran görüntüsü.

  4. Eylemin kimlik doğrulama bölmesi açıldığında Oturum aç'ı seçerek e-posta hesabınıza bağlantı oluşturun.

    Seçili oturum açma düğmesiyle E-posta gönder (V2) adlı eylemi gösteren ekran görüntüsü.

  5. Hesabınızı seçmek, erişime izin vermek ve Visual Studio Code'a geri dönmek için sonraki istemleri izleyin.

    Not

    İstemleri tamamlamadan önce çok fazla zaman geçerse, kimlik doğrulama işlemi zaman aşımına uysa ve başarısız olur. Bu durumda, tasarımcıya dönün ve bağlantıyı oluşturmak için oturum açmayı yeniden deneyin.

    1. Microsoft istemi görüntülendiğinde, Office 365 Outlook için kullanıcı hesabını seçin ve ardından Erişime izin ver'i seçin.

    2. Azure Logic Apps bir Visual Studio Code bağlantısı açmak isteyip istemediğinizi sorarsa Aç'ı seçin.

      Visual Studio Code bağlantısını açma istemini gösteren ekran görüntüsü.

    3. Visual Studio Code Microsoft Azure Araçları'nı açmak isteyip istemediğinizi sorarsa Aç'ı seçin.

      Microsoft Azure araçlarını açma istemini gösteren ekran görüntüsü.

    İpucu

    Gelecekteki bu tür istemleri atlamak için, ilişkili istemler görüntülendiğinde aşağıdaki seçenekleri belirleyin:

    • Visual Studio Code bağlantısını açma izni: logic-apis-westcentralus.consent.azure-apim.net bu tür bağlantıları ilişkili uygulamada açmasına her zaman izin ver'i seçin. Bu etki alanı, mantıksal uygulama kaynağınız için seçtiğiniz Azure bölgesine göre değişir.

    • Microsoft Azure Araçları'nı açma izni: Bu uzantıyı bir daha isteme'yi seçin.

    Visual Studio Code bağlantınızı oluşturduğunda, bazı bağlayıcılar Bağlantının yalnızca {n} gün boyunca geçerli olacağını belirten iletiyi gösterir. Bu süre sınırı yalnızca Visual Studio Code'da mantıksal uygulama iş akışınızı yazarken süre için geçerlidir. Dağıtımdan sonra, iş akışınız otomatik olarak etkinleştirilmiş sistem tarafından atanan yönetilen kimliğini kullanarak çalışma zamanında kimlik doğrulaması yapabilecek olduğundan bu sınır artık geçerli değildir. Bu yönetilen kimlik, bağlantı oluştururken kullandığınız kimlik doğrulama kimlik bilgilerinden veya bağlantı dizesi farklıdır. Sistem tarafından atanan bu yönetilen kimliği devre dışı bırakırsanız, bağlantılar çalışma zamanında çalışmaz.

  6. Tasarımcıda, E-posta gönder eylemi seçili görünmüyorsa bu eylemi seçin.

  7. Eylem bilgileri bölmesindeki Parametreler sekmesinde eylem için gerekli bilgileri sağlayın, örneğin:

    Ekran görüntüsü, E-posta gönder adlı Office 365 Outlook eyleminin bilgilerini gösterir.

    Özellik Zorunlu Değer Açıklama
    İşlem Yes <eposta-adresiniz> E-posta alıcısı, test amacıyla e-posta adresiniz olabilir. Bu örnekte kurgusal e-postası sophia.owen@fabrikam.comkullanılır.
    Konu Yes Örnek iş akışınızdan bir e-posta E-posta konusu
    Gövde Yes Örnek iş akışınızdan merhaba! E-posta gövdesi içeriği

    Not

    Test sekmesinde herhangi bir değişiklik yaparsanız, sekmeleri değiştirmeden veya odağı tasarımcıya değiştirmeden önce bu değişiklikleri kaydetmek için Kaydet'i seçtiğinizden emin olun. Aksi takdirde, Visual Studio Code değişikliklerinizi tutmaz.

  8. İş akışınızı kaydedin. Tasarımcıda Kaydet'i seçin.

Yerel olarak çalışan web kancalarını etkinleştirme

Azure'da çalışan bir mantıksal uygulama iş akışıyla HTTP Web Kancası gibi bir web kancası tabanlı tetikleyici veya eylem kullandığınızda, Azure Logic Apps çalışma zamanı bu uç noktaya bir geri çağırma URL'si oluşturup kaydederek hizmet uç noktasına abone olur. Tetikleyici veya eylem daha sonra hizmet uç noktasının URL'yi çağırmasını bekler. Ancak, Visual Studio Code'da çalışırken, oluşturulan geri çağırma URL'si ile http://localhost:7071/...başlar. Bu URL, hizmet uç noktasının bu URL'yi çağıramaması için özel olan localhost sunucunuza yöneliktir.

Visual Studio Code'da web kancası tabanlı tetikleyicileri ve eylemleri yerel olarak çalıştırmak için localhost sunucunuzu kullanıma sunan ve hizmet uç noktasından gelen çağrıları web kancası geri çağırma URL'sine güvenli bir şekilde ileten genel bir URL ayarlamanız gerekir. Localhost bağlantı noktanıza HTTP tüneli açan ngrok gibi bir iletme hizmeti ve aracı kullanabilir veya kendi eşdeğer aracınızı kullanabilirsiniz.

ngrok kullanarak arama iletmeyi ayarlama

  1. ngrok web sitesine gidin. Yeni bir hesap için kaydolun veya hesabınız varsa hesabınızda oturum açın.

  2. Ngrok istemcinizin hesabınıza bağlanması ve erişimin kimliğini doğrulaması için gereken kişisel kimlik doğrulama belirtecinizi alın.

    1. Kimlik doğrulama belirteci sayfanızı bulmak için hesap panonuzun menüsünde Kimlik Doğrulama'yı genişletin ve Authtoken'iniz'i seçin.

    2. Kimlik Doğrulamanız kutusunda belirteci güvenli bir konuma kopyalayın.

  3. ngrok indirme sayfasından veya hesap panonuzdan istediğiniz ngrok sürümünü indirin ve .zip dosyasını ayıklayın. Daha fazla bilgi için bkz . 1. Adım: Yükleme sıkıştırmasını açma.

  4. Bilgisayarınızda komut istemi aracınızı açın. ngrok.exe dosyasının bulunduğu konuma göz atın.

  5. Aşağıdaki komutu çalıştırarak ngrok istemcisini ngrok hesabınıza Bağlan. Daha fazla bilgi için bkz. 2. Adım: hesabınızı Bağlan.

    ngrok authtoken <your_auth_token>

  6. Aşağıdaki komutu çalıştırarak HTTP tünelini localhost bağlantı noktası 7071'e açın. Daha fazla bilgi için bkz . 3. Adım: Tetikleyin.

    ngrok http 7071

  7. Çıktıdan aşağıdaki satırı bulun:

    http://<domain>.ngrok.io -> http://localhost:7071

  8. Bu biçime sahip URL'yi kopyalayın ve kaydedin: http://<domain>.ngrok.io

Uygulama ayarlarınızda iletme URL'sini ayarlama

  1. Visual Studio Code'da tasarımcıda, kullanmak istediğiniz web kancası tabanlı tetikleyiciyi veya eylemi ekleyin.

    Bu örnek HTTP + Web Kancası tetikleyicisiyle devam eder.

  2. Konak uç noktası konumu için istem görüntülendiğinde, daha önce oluşturduğunuz iletme (yeniden yönlendirme) URL'sini girin.

    Not

    İstemi yoksaymak, iletme URL'sini sağlamanız gerektiğini belirten bir uyarının görünmesine neden olur, bu nedenle Yapılandır'ı seçin ve URL'yi girin. Bu adımı tamamladıktan sonra, ekleyebileceğiniz sonraki web kancası tetikleyicileri veya eylemleri için istem görünmez.

    İstemin görünmesini sağlamak için projenizin kök düzeyinde local.settings.json dosyasının kısayol menüsünü açın ve Web Kancası Yeniden Yönlendirme Uç Noktasını Yapılandır'ı seçin. artık iletme URL'sini sağlayabilmeniz için istem görüntülenir.

    Visual Studio Code, iletme URL'sini projenizin kök klasöründeki local.settings.json dosyasına ekler. nesnesinde Values , adlı Workflows.WebhookRedirectHostUri özellik şimdi görünür ve iletme URL'sine ayarlanır, örneğin:

    {
   "IsEncrypted": false,
   "Values": {
      "AzureWebJobsStorage": "UseDevelopmentStorage=true",
      "FUNCTIONS_WORKER_RUNTIME": "node",
      "FUNCTIONS_V2_COMPATIBILITY_MODE": "true",
      <...>
      "Workflows.WebhookRedirectHostUri": "http://xxxXXXXxxxXXX.ngrok.io",
      <...>
   }
}

Yerel hata ayıklama oturumunu ilk kez başlattığınızda veya hata ayıklama yapmadan iş akışını çalıştırdığınızda Azure Logic Apps çalışma zamanı iş akışını hizmet uç noktasına kaydeder ve web kancası işlemlerini bildirmek için bu uç noktaya abone olur. İş akışınız bir sonraki çalıştırıldığında, abonelik kaydı yerel depolama alanında zaten mevcut olduğundan çalışma zamanı kaydedilmez veya yeniden abone olmaz.

Yerel olarak çalışan web kancası tabanlı tetikleyicileri veya eylemleri kullanan bir iş akışı çalıştırması için hata ayıklama oturumunu durdurduğunuzda, mevcut abonelik kayıtları silinmez. Kaydı kaldırmak için abonelik kayıtlarını el ile kaldırmanız veya silmeniz gerekir.

Not

İş akışınız çalışmaya başladıktan sonra terminal penceresinde şu örneğe benzer hatalar gösterebilirsiniz:

message='Http request failed with unhandled exception of type 'InvalidOperationException' and message: 'System.InvalidOperationException: Synchronous operations are disallowed. Call ReadAsync or set AllowSynchronousIO to true instead.'

Bu durumda, projenizin kök klasöründeki local.settings.json dosyasını açın ve özelliğinin olarak trueayarlandığından emin olun:

"FUNCTIONS_V2_COMPATIBILITY_MODE": "true"

Hata ayıklama için kesme noktalarını yönetme

Hata ayıklama oturumu başlatarak mantıksal uygulama iş akışınızı çalıştırmadan ve test etmeden önce, her iş akışı için workflow.json dosyasının içinde kesme noktaları ayarlayabilirsiniz. Başka kurulum gerekmez.

Şu anda kesme noktaları yalnızca eylemler için desteklenir, tetikleyiciler için desteklenmez. Her eylem tanımının şu kesme noktası konumları vardır:

  • Eylemin adını gösteren satırda başlangıç kesme noktasını ayarlayın. Hata ayıklama oturumu sırasında bu kesme noktası isabet ettiğinde, değerlendirilmeden önce eylemin girişlerini gözden geçirebilirsiniz.

  • Eylemin kapanış küme ayracı (}) gösteren satırda bitiş kesme noktasını ayarlayın. Hata ayıklama oturumu sırasında bu kesme noktası isabet ettiğinde, eylemin çalışması tamamlanmadan önce eylemin sonuçlarını gözden geçirebilirsiniz.

Kesme noktası eklemek için şu adımları izleyin:

  1. Hata ayıklamak istediğiniz iş akışının workflow.json dosyasını açın.

  2. Kesme noktasını ayarlamak istediğiniz satırda, sol sütunda bu sütunun içini seçin. Kesme noktasını kaldırmak için bu kesme noktasını seçin.

    Hata ayıklama oturumunuzu başlattığınızda, Kod penceresinin sol tarafında Çalıştır görünümü görüntülenirken Hata Ayıklama araç çubuğu üst kısımda görünür.

    Not

    Çalıştır görünümü otomatik olarak görünmüyorsa Ctrl+Shift+D tuşlarına basın.

  3. Bir kesme noktası isabet ettiğinde kullanılabilir bilgileri gözden geçirmek için, Çalıştır görünümünde Değişkenler bölmesini inceleyin.

  4. İş akışı yürütmeye devam etmek için Hata Ayıklama araç çubuğunda Devam (oynat düğmesi) öğesini seçin.

İş akışı çalıştırması sırasında istediğiniz zaman kesme noktaları ekleyebilir ve kaldırabilirsiniz. Ancak, çalıştırma başladıktan sonra workflow.json dosyasını güncelleştirirseniz kesme noktaları otomatik olarak güncelleştiremez. Kesme noktalarını güncelleştirmek için mantıksal uygulamayı yeniden başlatın.

Genel bilgi için bkz . Kesme Noktaları - Visual Studio Code.

Yerel olarak çalıştırma, test ve hata ayıklama

Mantıksal uygulama iş akışınızı test etmek için bu adımları izleyerek hata ayıklama oturumu başlatın ve İstek tetikleyicisi tarafından oluşturulan uç noktanın URL'sini bulun. Daha sonra bu uç noktaya istek gönderebilmek için bu URL'ye ihtiyacınız vardır.

  1. Durum bilgisi olmayan bir iş akışının hatalarını daha kolay ayıklamak için bu iş akışının çalıştırma geçmişini etkinleştirebilirsiniz.

  2. Azurite öykünücünüz zaten çalışıyorsa sonraki adıma geçin. Aksi takdirde, iş akışınızı çalıştırmadan önce öykünücüyü başlattığınızdan emin olun:

    1. Visual Studio Code'da Görünüm menüsünden Komut Paleti'ni seçin.

    2. Komut paleti göründükten sonra Azurite: Başlat yazın.

    Azurite komutları hakkında daha fazla bilgi için Visual Studio Code'daki Azurite uzantısının belgelerine bakın.

  3. Visual Studio Code Etkinlik Çubuğu'nda Çalıştır menüsünü açın ve Hata Ayıklamayı Başlat (F5) öğesini seçin.

    Hata ayıklama oturumunu gözden geçirebilmeniz için Terminal penceresi açılır.

    Not

    "preLaunchTask 'generateDebugSymbols' çalıştırıldıktan sonra hata oluştu" hatasını alırsanız Hata ayıklama oturumu başlatılamıyor sorun giderme bölümüne bakın.

  4. Şimdi, İstek tetikleyicisinde uç noktanın geri çağırma URL'sini bulun.

    1. Projenizi görüntüleyebilmeniz için Gezgin bölmesini yeniden açın.

    2. workflow.json dosyasının kısayol menüsünden Genel Bakış'ı seçin.

      Gezgin bölmesinin, workflow.json dosyanın kısayol menüsünün seçili seçeneği olan Genel Bakış'ı gösteren ekran görüntüsü.

    3. İstek tetikleyicisi örneği için bu URL'ye benzer şekilde görünen Geri Arama URL'si değerini bulun:

      http://localhost:7071/api/<workflow-name>/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<shared-access-signature>

      Geri çağırma URL'sini içeren iş akışına genel bakış sayfasını gösteren ekran görüntüsü.

  5. Mantıksal uygulama iş akışını tetikleyerek geri çağırma URL'sini test etmek için Postman'i veya istek oluşturmak ve göndermek için tercih ettiğiniz aracı açın.

    Bu örnek Postman kullanılarak devam eder. Daha fazla bilgi için bkz . Postman Başlarken.

    1. Postman araç çubuğunda Yeni'yi seçin.

      Yeni düğmesinin seçili olduğu Postman'i gösteren ekran görüntüsü

    2. Yeni Oluştur bölmesindeki Yapı Taşları'nın altında İstek'i seçin.

    3. İsteği Kaydet penceresindeki İstek adı'nın altında istek için bir ad girin; örneğin, Test iş akışı tetikleyicisi.

    4. Kaydedilecek koleksiyon veya klasör seçin altında Koleksiyon Oluştur'u seçin.

    5. Tüm Koleksiyonlar'ın altında, isteklerinizi düzenlemek için oluşturulacak koleksiyon için bir ad sağlayın, Enter tuşuna< basın ve Koleksiyon adına> kaydet'i seçin. Bu örnekte koleksiyon adı olarak Logic Apps istekleri kullanılmaktadır.

      Postman'de istek bölmesi açılır, böylece İstek tetikleyicisi için geri arama URL'sine istek gönderebilirsiniz.

      Açılan istek bölmesini içeren Postman'i gösteren ekran görüntüsü.

    6. Visual Studio Code'a geri dönün. İş akışının genel bakış sayfasından Geri Çağırma URL'si özellik değerini kopyalayın.

    7. Postman'e geri dönün. İstek bölmesinde, şu anda varsayılan istek yöntemi olarak GET değerini gösteren yöntem listesinin yanındaki adres kutusuna daha önce kopyaladığınız geri çağırma URL'sini yapıştırın ve Gönder'i seçin.

      Gönder düğmesinin seçili olduğu adres kutusunda Postman ve geri arama URL'sini gösteren ekran görüntüsü.

      Örnek mantıksal uygulama iş akışı, şu örneğe benzer bir e-posta gönderir:

      Örnekte açıklandığı gibi Outlook e-postasını gösteren ekran görüntüsü.

  6. Visual Studio Code'da iş akışınızın genel bakış sayfasına dönün.

    Durum bilgisi olan bir iş akışı oluşturduysanız, gönderdiğiniz istek iş akışını tetikledikten sonra genel bakış sayfasında iş akışının çalıştırma durumu ve geçmişi gösterilir.

    İpucu

    Çalıştırma durumu görünmüyorsa Yenile'yi seçerek genel bakış sayfasını yenilemeyi deneyin. Karşılanmamış ölçütler veya veri bulma nedeniyle atlanan bir tetikleyici için hiçbir çalıştırma gerçekleşmez.

    İş akışının genel bakış sayfasını çalıştırma durumu ve geçmişiyle gösteren ekran görüntüsü

    Aşağıdaki tabloda, her iş akışı çalıştırmasının Visual Studio Code'da sahip olabileceği ve gösterebileceği olası son durumlar gösterilmektedir:

    Çalıştırma durumu Açıklama
    Iptal Sistem kesintisi veya süresi dolmuş Azure aboneliği gibi dış sorunlar nedeniyle çalıştırma durduruldu veya tamamlanmamış.
    İptal edildi Çalıştırma tetiklendi ve başlatıldı ancak bir iptal isteği aldı.
    Başarısız oldu Çalıştırmadaki en az bir eylem başarısız oldu. İş akışında sonraki hiçbir eylem hatayı işlemek için ayarlanmadı.
    Çalışıyor Çalıştırma tetiklendi ve devam ediyor, ancak bu durum eylem sınırları veya geçerli fiyatlandırma planı nedeniyle kısıtlanan bir çalıştırma için de görüntülenebilir.

    İpucu: Tanılama günlüğünü ayarlarsanız gerçekleşen kısıtlama olayları hakkında bilgi alabilirsiniz.
    Başarılı Çalıştırma başarılı oldu. Herhangi bir eylem başarısız olursa, iş akışındaki sonraki bir eylem bu hatayı işledi.
    Zaman aşımına uğradı Geçerli süre çalıştırma süresi sınırını aştığından çalıştırma zaman aşımına uğradı. Bu sınır, Gün cinsinden çalıştırma geçmişi saklama ayarı tarafından denetlendi. Çalıştırmanın süresi, çalıştırmanın başlangıç saati ve bu başlangıç zamanındaki çalıştırma süresi sınırı kullanılarak hesaplanır.

    Not: Çalıştırmanın süresi geçerli çalıştırma geçmişi saklama sınırını da aşarsa ve bu sınır Gün cinsinden çalıştırma geçmişi saklama ayarı tarafından da denetlenirse, çalıştırma günlük temizleme işi tarafından çalıştırma geçmişinden temizlenir. Çalıştırma zaman aşımına uysa veya tamamlasa da, bekletme süresi her zaman çalıştırmanın başlangıç zamanı ve geçerli bekletme sınırı kullanılarak hesaplanır. Bu nedenle, bir uçuş içi çalıştırmanın süre sınırını azaltırsanız, çalıştırma zaman aşımına uysa. Ancak, çalıştırmanın süresinin bekletme sınırını aşıp aşmadığına bağlı olarak çalıştırma çalışır durumda kalır veya çalıştırma geçmişinden temizlenir.
    Bekliyor Çalıştırma başlatılmadı veya duraklatıldı, örneğin, hala çalışmakta olan önceki bir iş akışı örneği nedeniyle.

  7. Belirli bir çalıştırmadaki her adımın durumlarını ve adımın giriş ve çıkışlarını gözden geçirmek için, o çalıştırmanın üç nokta (...) düğmesini seçin ve Çalıştırmayı göster'i seçin.

    Seçili üç nokta düğmesi ve Çalıştırmayı Göster ile iş akışının çalıştırma geçmişi satırını gösteren ekran görüntüsü.

    Visual Studio Code izleme görünümünü açar ve çalıştırmadaki her adımın durumunu gösterir.

    İş akışı çalıştırmalarındaki her adımı ve bunların durumunu gösteren ekran görüntüsü.

    Not

    Bir çalıştırma başarısız olduysa ve izleme görünümündeki bir adım 400 Hatalı İstek hatasını gösteriyorsa, bu sorun temel alınan Tekdüzen Kaynak Tanımlayıcısı'nın (URI) varsayılan karakter sınırını aşmasına neden olan daha uzun bir tetikleyici adı veya eylem adından kaynaklanabilir. Daha fazla bilgi için bkz . "400 Hatalı İstek".

    Aşağıdaki tabloda, her iş akışı eyleminin Visual Studio Code'da sahip olabileceği ve gösterebileceği olası durumlar gösterilmektedir:

    Eylem durumu Açıklama
    Iptal Sistem kesintisi veya süresi dolmuş Azure aboneliği gibi dış sorunlar nedeniyle eylem durduruldu veya tamamlanmamış.
    İptal edildi Eylem çalışıyordu ancak iptal etmek için bir istek aldı.
    Başarısız oldu Eylem başarısız oldu.
    Çalışıyor Eylem şu anda çalışıyor.
    Atlandı Önceki eylem hemen başarısız olduğundan eylem atlandı. Bir eylem, geçerli eylemin çalıştırılabilmesi için önceki eylemin başarıyla tamamlanması gereken bir runAfter koşula sahiptir.
    Başarılı Eylem başarılı oldu.
    Yeniden denemeler başarılı oldu Eylem başarılı oldu, ancak yalnızca bir veya daha fazla yeniden denemeden sonra. Yeniden deneme geçmişini gözden geçirmek için çalıştırma geçmişi ayrıntıları görünümünde bu eylemi seçerek girişleri ve çıkışları görüntüleyebilirsiniz.
    Zaman aşımına uğradı Eylem, bu eylemin ayarları tarafından belirtilen zaman aşımı sınırı nedeniyle durduruldu.
    Bekliyor Arayandan gelen isteği bekleyen bir web kancası eylemi için geçerlidir.

  8. Her adımın girişlerini ve çıkışlarını gözden geçirmek için incelemek istediğiniz adımı seçin. Bu adımın ham girişlerini ve çıkışlarını daha fazla gözden geçirmek için Ham girişleri göster'i veya Ham çıkışları göster'i seçin.

    İş akışındaki her adımın durumunu ve E-posta gönder adlı genişletilmiş eylemdeki girişleri ve çıkışları gösteren ekran görüntüsü.

  9. Hata ayıklama oturumunu durdurmak için Çalıştır menüsünde Hata Ayıklamayı Durdur 'u (Shift + F5) seçin.

Yanıt döndürme

İstek tetikleyicisiyle başlayan bir iş akışınız olduğunda, Yanıt adlı yerleşik İstek eylemini kullanarak iş akışınıza istek gönderen çağırana bir yanıt döndürebilirsiniz.

  1. İş akışı tasarımcısında, E-posta gönder eyleminin altında artı işaretini (+) >Eylem ekle'yi seçin.

    Sonraki eylemi seçebilmeniz için Eylem ekle bölmesi açılır.

  2. Eylem ekle bölmesindeki Çalışma Zamanı listesinden Uygulama İçi'yi seçin. Yanıt eylemini bulun ve ekleyin.

    Yanıt eylemi tasarımcıda göründükten sonra, eylemin ayrıntılar bölmesi otomatik olarak açılır.

    İş akışı tasarımcısı ve Yanıt bilgileri bölmesini gösteren ekran görüntüsü.

  3. Parametreler sekmesinde, çağırmak istediğiniz işlev için gerekli bilgileri sağlayın.

    Bu örnek, E-posta gönder eyleminin çıktısı olan Gövde parametresi değerini döndürür.

    1. Gövde parametresi için düzenleme kutusunun içini seçin ve dinamik içerik listesini açan şimşek simgesini seçin. Bu liste, iş akışındaki önceki tetikleyiciden ve eylemlerden kullanılabilir çıkış değerlerini gösterir.

    2. Dinamik içerik listesinde, E-posta gönder'in altında Gövde'yi seçin.

      Ekran görüntüsü, E-posta üst bilgisi gönder altında Gövde çıkış değerinin seçili olduğu açık dinamik içerik listesini gösterir.

      İşiniz bittiğinde, Yanıt eyleminin Gövde özelliği artık E-posta gönder eyleminin Gövde çıkış değerine ayarlanır.

      E-posta gönder adlı eylem için iş akışı tasarımcısı, Yanıt bilgileri bölmesi ve Gövde parametresinin Gövde değeri olarak ayarlandığını gösteren ekran görüntüsü.

  4. Tasarımcıda Kaydet'i seçin.

Mantıksal uygulamanızı yeniden test etme

Mantıksal uygulamanızda güncelleştirmeler yaptıktan sonra, Visual Studio'da hata ayıklayıcısını yeniden çalıştırarak ve güncelleştirilmiş mantıksal uygulamanızı tetikleyen başka bir istek göndererek, yerel olarak çalıştırma, test etme ve hata ayıklama adımlarına benzer şekilde başka bir test çalıştırabilirsiniz.

  1. Visual Studio Code Etkinlik Çubuğu'nda Çalıştır menüsünü açın ve Hata Ayıklamayı Başlat (F5) öğesini seçin.

  2. Postman'de veya istek oluşturma ve gönderme aracınızda iş akışınızı tetikleyen başka bir istek gönderin.

  3. Durum bilgisi olan bir iş akışı oluşturduysanız, iş akışının genel bakış sayfasında en son çalıştırmanın durumunu denetleyin. Bu çalıştırmadaki her adımın durumunu, girişlerini ve çıkışlarını görüntülemek için, o çalıştırmanın üç nokta (...) düğmesini seçin ve Çalıştırmayı göster'i seçin.

    Örneğin, örnek iş akışı Yanıt eylemiyle güncelleştirildikten sonra çalıştırmanın adım adım durumu aşağıda verilmiştir.

    Güncelleştirilmiş iş akışındaki her adımın durumunu ve genişletilmiş Yanıt eylemindeki girişleri ve çıkışları gösteren ekran görüntüsü.

  4. Hata ayıklama oturumunu durdurmak için Çalıştır menüsünde Hata Ayıklamayı Durdur 'u (Shift + F5) seçin.

Güvenlik duvarı erişimi için etki alanı adlarını bulma

Mantıksal uygulama iş akışınızı Azure portalında dağıtmadan ve çalıştırmadan önce ortamınızda trafiği sınırlayan katı ağ gereksinimleri veya güvenlik duvarları varsa, iş akışınızda bulunan tetikleyici veya eylem bağlantıları için izinler ayarlamanız gerekir.

Bu bağlantıların tam etki alanı adlarını (FQDN) bulmak için şu adımları izleyin:

  1. Mantıksal uygulama projenizde, iş akışınıza ilk bağlantı tabanlı tetikleyiciyi veya eylemi ekledikten sonra oluşturulan connections.json dosyasını açın ve nesneyi bulun managedApiConnections .

  2. Oluşturduğunuz her bağlantı için, güvenlik duvarınızı bu bilgilerle ayarlayabilmeniz için özellik değerini kopyalayıp güvenli bir yere kaydedin connectionRuntimeUrl .

    Bu örnek connections.json dosyası, as2 bağlantısı ve şu connectionRuntimeUrl değerlerle bir Office 365 bağlantısı olmak üzere iki bağlantı içerir:

    • AS2: "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/as2/11d3fec26c87435a80737460c85f42ba

    • Office 365: "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/office365/668073340efe481192096ac27e7d467f

    {
   "managedApiConnections": {
      "as2": {
         "api": {
            "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{Azure-region}/managedApis/as2"
         },
         "connection": {
            "id": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{Azure-resource-group}/providers/Microsoft.Web/connections/{connection-resource-name}"
         },
         "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/as2/11d3fec26c87435a80737460c85f42ba,
         "authentication": {
            "type":"ManagedServiceIdentity"
         }
      },
      "office365": {
         "api": {
            "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{Azure-region}/managedApis/office365"
         },
         "connection": {
            "id": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{Azure-resource-group}/providers/Microsoft.Web/connections/{connection-resource-name}"
         },
         "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/office365/668073340efe481192096ac27e7d467f,
         "authentication": {
            "type":"ManagedServiceIdentity"
         }
      }
   }
}

Azure’a dağıtın

Visual Studio Code'dan, Standart mantıksal uygulama kaynağınızı dağıtmak için projenizi doğrudan Azure'da yayımlayabilirsiniz. Mantıksal uygulamanızı yeni bir kaynak olarak yayımlayabilirsiniz. Bu kaynak, işlev uygulaması gereksinimlerine benzer şekilde Azure Depolama hesabı gibi gerekli kaynakları otomatik olarak oluşturur. Ya da mantıksal uygulamanızı daha önce dağıtılan ve bu mantıksal uygulamanın üzerine yazan bir Standart mantıksal uygulama kaynağında yayımlayabilirsiniz.

Standart mantıksal uygulama kaynağı için dağıtım, dağıtım sırasında seçtiğiniz bir barındırma planı ve fiyatlandırma katmanı gerektirir. Daha fazla bilgi için Barındırma planlarını ve fiyatlandırma katmanlarını gözden geçirin.

Yeni bir Standart mantıksal uygulama kaynağında yayımlama

  1. Visual Studio Code Etkinlik Çubuğu'nda Azure simgesini seçerek Azure penceresini açın.

  2. Azure penceresinde, Çalışma Alanı bölüm araç çubuğunda, Azure Logic Apps menüsünden Logic App'e Dağıt'ı seçin.

    Çalışma Alanı araç çubuğunun ve Mantıksal Uygulamaya Dağıt'ın seçili olduğu Azure Logic Apps kısayol menüsünün seçili olduğu Azure penceresini gösteren ekran görüntüsü.

  3. İstenirse mantıksal uygulama dağıtımınız için kullanılacak Azure aboneliğini seçin.

  4. Visual Studio Code'un açtığı listeden şu seçeneklerden birini belirleyin:

    • Azure'da yeni Mantıksal Uygulama (Standart) oluşturma (hızlı)
    • Azure Gelişmiş'te yeni Mantıksal Uygulama (Standart) oluşturma
    • Varsa, önceden dağıtılmış bir Mantıksal Uygulama (Standart) kaynağı

    Bu örnek, Azure Gelişmiş'te yeni Mantıksal Uygulama (Standart) oluşturma ile devam eder.

    Dağıtım seçenekleri listesini ve Azure Gelişmiş'te yeni Mantıksal Uygulama (Standart) oluştur seçeneğini gösteren ekran görüntüsü.

  5. Yeni Standart mantıksal uygulama kaynağınızı oluşturmak için şu adımları izleyin:

    1. Mantıksal Uygulama (Standart) kaynağı için kullanılacak ad olan yeni mantıksal uygulamanız için genel olarak benzersiz bir ad sağlayın. Bu örnekte Fabrikam-Workflows-App kullanılır.

      Oluşturulacak yeni mantıksal uygulama için bir ad sağlama istemini gösteren ekran görüntüsü.

    2. Yeni mantıksal uygulamanız için bir barındırma planı seçin. Planınız için bir ad oluşturun veya mevcut bir planı seçin (yalnızca Windows tabanlı App Service planları). Bu örnek Yeni App Service Planı oluştur'u seçer.

    3. Barındırma planınız için bir ad belirtin ve ardından seçtiğiniz plan için bir fiyatlandırma katmanı seçin.

      Daha fazla bilgi için Barındırma planlarını ve fiyatlandırma katmanlarını gözden geçirin.

    4. En iyi performans için, dağıtım için projenizle aynı kaynak grubunu seçin.

      Not

      Farklı bir kaynak grubu oluşturabilir veya kullanabilirsiniz ancak bunu yapmak performansı etkileyebilir. Farklı bir kaynak grubu oluşturur veya seçerseniz, ancak onay istemi göründükten sonra iptal ederseniz dağıtımınız da iptal edilir.

    5. Durum bilgisi olan iş akışları için Yeni depolama hesabı veya mevcut depolama hesabı oluştur'u seçin.

    6. Mantıksal uygulamanızın oluşturma ve dağıtım ayarları Uygulama Analizler kullanmayı destekliyorsa, mantıksal uygulamanız için isteğe bağlı olarak tanılama günlüğünü ve izlemeyi etkinleştirebilirsiniz. Bunu Visual Studio Code'dan mantıksal uygulamanızı dağıtırken veya dağıtımdan sonra yapabilirsiniz. Bir Application Analizler örneğiniz olması gerekir, ancak mantıksal uygulamanızı dağıtırken veya dağıtımdan sonra bu kaynağı önceden oluşturabilirsiniz.

      Günlüğe kaydetmeyi ve izlemeyi şimdi etkinleştirmek için şu adımları izleyin:

      1. Mevcut bir Uygulama Analizler kaynağını veya Yeni Uygulama Analizler kaynağı oluştur'u seçin.

      2. Azure portalında Uygulama Analizler kaynağınıza gidin.

      3. Kaynak menüsünde Genel Bakış'ı seçin. İzleme Anahtarı değerini bulun ve kopyalayın.

      4. Visual Studio Code'da, projenizin kök klasöründe local.settings.json dosyasını açın.

      5. nesnesine Values özelliğini ekleyin APPINSIGHTS_INSTRUMENTATIONKEY ve değerini izleme anahtarına ayarlayın, örneğin:

        {
   "IsEncrypted": false,
   "Values": {
      "AzureWebJobsStorage": "UseDevelopmentStorage=true",
      "FUNCTIONS_WORKER_RUNTIME": "node",
      "APPINSIGHTS_INSTRUMENTATIONKEY": <instrumentation-key>
   }
}

        İpucu

        Tetikleyici ve eylem adlarının Uygulama Analizler örneğinizde doğru görünup görünmediğini de kontrol edebilirsiniz.

        1. Azure portalında Uygulama Analizler kaynağınıza gidin.

        2. Kaynak menüsündeki Araştır'ın altında Uygulama haritası'nı seçin.

        3. Haritada görünen işlem adlarını gözden geçirin.

        Yerleşik tetikleyicilerden gelen bazı istekler Uygulama Haritası'nda yinelenen olarak görünebilir. Bu yinelemeler, biçimi kullanmak WorkflowName.ActionName yerine, işlem adı olarak iş akışı adını kullanır ve Azure İşlevleri konağından kaynaklanır.

      6. Ardından, mantıksal uygulamanızın topladığı ve Uygulama Analizler örneğine gönderdiği izleme verilerinin önem düzeyini isteğe bağlı olarak ayarlayabilirsiniz.

        İş akışıyla ilgili bir olay her gerçekleştiğinde (örneğin, bir iş akışının tetiklendiğinde veya bir eylem çalıştırıldığında) çalışma zamanı çeşitli izlemeler yayar. Bu izlemeler iş akışının ömrünü kapsar ve aşağıdaki olay türlerini içerir ancak bunlarla sınırlı değildir:

        • Başlatma, durdurma ve hatalar gibi hizmet etkinliği.
        • İşler ve dağıtıcı etkinliği.
        • Tetikleyici, eylem ve çalıştırma gibi iş akışı etkinliği.
        • başarılı veya başarısız gibi istek etkinliğini Depolama.
        • Gelen, giden, başarılı ve başarısız gibi HTTP isteği etkinliği.
        • Hata ayıklama iletileri gibi geliştirme izlemeleri.

        Her olay türü bir önem düzeyine atanır. Örneğin, Trace düzey en ayrıntılı iletileri yakalarken Information düzey mantıksal uygulamanızın, iş akışınızın, tetikleyicinizin ve eylemlerinizin başlatılıp durdurulması gibi iş akışınızdaki genel etkinliği yakalar. Bu tabloda önem derecesi düzeyleri ve bunların izleme türleri açıklanmaktadır:

        Önem derecesi İzleme türü
        Kritik Mantıksal uygulamanızda kurtarılamaz bir hatayı açıklayan günlükler.
        Hata Ayıklama Geliştirme sırasında araştırma için kullanabileceğiniz günlükler( örneğin, gelen ve giden HTTP çağrıları).
        Hata İş akışı yürütmede bir hata olduğunu ancak mantıksal uygulamanızda genel bir hata olmadığını belirten günlükler.
        Bilgiler Mantıksal uygulamanızda veya iş akışınızda genel etkinliği izleyen günlükler, örneğin:

        - Tetikleyici, eylem veya çalıştırma başlatıldığında ve sona erdiğinde.
        - Mantıksal uygulamanız başladığında veya sona erdiğinde.
        İzleme Depolama istekleri veya dağıtıcı etkinliği gibi en ayrıntılı iletilerin yanı sıra iş akışı yürütme etkinliğiyle ilgili tüm iletileri içeren günlükler.
        Uyarı Mantıksal uygulamanızdaki anormal bir durumu vurgulayan ancak çalışmasını engellemeyen günlükler.

        Önem düzeyini ayarlamak için projenizin kök düzeyinde host.json dosyasını açın ve nesneyi bulunlogging. Bu nesne mantıksal uygulamanızdaki tüm iş akışları için günlük filtrelemesini denetler ve günlük türü filtrelemesi için ASP.NET Çekirdek düzenini izler.

        {
   "version": "2.0",
   "logging": {
      "applicationInsights": {
         "samplingExcludedTypes": "Request",
         "samplingSettings": {
            "isEnabled": true
         }
      }
   }
}

        Nesne özelliğini logging içeren Host.Triggers.Workflow bir logLevel nesne içermiyorsa, bu öğeleri ekleyin. özelliğini istediğiniz izleme türünün önem düzeyine ayarlayın, örneğin:

        {
   "version": "2.0",
   "logging": {
      "applicationInsights": {
         "samplingExcludedTypes": "Request",
         "samplingSettings": {
            "isEnabled": true
         }
      },
      "logLevel": {
         "Host.Triggers.Workflow": "Information"
      }
   }
}

    Dağıtım adımlarını tamamladığınızda Visual Studio Code, mantıksal uygulamanızı yayımlamak için gerekli kaynakları oluşturmaya ve dağıtmaya başlar.

  6. Dağıtım işlemini gözden geçirmek ve izlemek için Görünüm menüsünde Çıkış'ı seçin. Çıkış penceresi araç çubuğu listesinden Azure Logic Apps'i seçin.

    Dağıtım ilerleme durumu ve durumlarıyla birlikte araç çubuğu listesinde Azure Logic Apps'in seçili olduğu Çıkış penceresini gösteren ekran görüntüsü.

    Visual Studio Code mantıksal uygulamanızı Azure'a dağıtmayı tamamladığında aşağıdaki ileti görüntülenir:

    Azure'a dağıtımın başarıyla tamamlandığını belirten bir iletiyi gösteren ekran görüntüsü.

    Tebrikler, mantıksal uygulamanız artık Azure'da canlıdır ve varsayılan olarak etkindir.

Ardından, şu görevleri gerçekleştirmeyi öğrenebilirsiniz:

Projeye boş iş akışı ekleme

Mantıksal uygulama projenizde birden çok iş akışı olabilir. Projenize boş bir iş akışı eklemek için şu adımları izleyin:

  1. Visual Studio Code Etkinlik Çubuğu'nda Azure simgesini seçin.

  2. Azure penceresinde, Çalışma Alanı bölüm araç çubuğunda, Azure Logic Apps menüsünden İş akışı oluştur'u seçin.

  3. Eklemek istediğiniz iş akışı türünü seçin: Durum bilgisi olan veya Durum Bilgisi Olmayan

  4. İş akışınız için bir ad belirtin.

İşiniz bittiğinde, projenizde iş akışı tanımı için bir workflow.json dosyasıyla birlikte yeni bir iş akışı klasörü görüntülenir.

Visual Studio Code'da dağıtılan mantıksal uygulamaları yönetme

Visual Studio Code'da, Tüketim veya Standart mantıksal uygulama kaynakları olsun, Azure aboneliğinizde dağıtılan tüm mantıksal uygulamaları görüntüleyebilir ve bu mantıksal uygulamaları yönetmenize yardımcı olacak görevleri seçebilirsiniz. Ancak her iki kaynak türüne de erişmek için hem Azure Logic Apps (Tüketim) hem de Visual Studio Code için Azure Logic Apps (Standart) uzantılarına ihtiyacınız vardır.

  1. Visual Studio Code Etkinlik Çubuğu'nda Azure simgesini seçin. Kaynaklar'da aboneliğinizi genişletin ve ardından bu abonelik için Azure'da dağıtılan tüm mantıksal uygulamaları gösteren Mantıksal Uygulama'yı genişletin.

  2. Yönetmek istediğiniz mantıksal uygulamayı açın. Mantıksal uygulamanın kısayol menüsünden gerçekleştirmek istediğiniz görevi seçin.

    Örneğin, dağıtılan mantıksal uygulamanızı durdurma, başlatma, yeniden başlatma veya silme gibi görevleri seçebilirsiniz. Azure portalını kullanarak bir iş akışını devre dışı bırakabilir veya etkinleştirebilirsiniz.

    Not

    Mantıksal uygulamayı durdurma ve mantıksal uygulama silme işlemleri, iş akışı örneklerini farklı şekillerde etkiler. Daha fazla bilgi için mantıksal uygulamaları durdurma ile ilgili önemli noktalar ve mantıksal uygulamaları silmeyle ilgili önemli noktalar konularını gözden geçirin.

    Kaynaklar bölümü ve dağıtılan mantıksal uygulama kaynağı ile Visual Studio Code'un ekran görüntüsü.

  3. Mantıksal uygulamadaki tüm iş akışlarını görüntülemek için mantıksal uygulamanızı genişletin ve ardından İş Akışları düğümünü genişletin.

  4. Belirli bir iş akışını görüntülemek için iş akışının kısayol menüsünü açın ve İş akışını salt okunur modda açan Tasarım Aracı aç'ı seçin.

    İş akışını düzenlemek için şu seçeneklere sahipsiniz:

    • Visual Studio Code'da projenizin workflow.json dosyasını iş akışı tasarımcısında açın, düzenlemelerinizi yapın ve mantıksal uygulamanızı Azure'a yeniden dağıtın.

    • Azure portalında mantıksal uygulamanızı açın. Daha sonra iş akışınızı açabilir, düzenleyebilir ve kaydedebilirsiniz.

  5. Dağıtılan mantıksal uygulamayı Azure portalında açmak için mantıksal uygulamanın kısayol menüsünü açın ve Portalda Aç'ı seçin.

    Azure portalı tarayıcınızda açılır, Visual Studio Code'da oturum açtıysanız otomatik olarak portalda oturum açar ve mantıksal uygulamanızı gösterir.

    Visual Studio Code'da mantıksal uygulamanızın Azure portal sayfasını gösteren ekran görüntüsü.

    Ayrıca Azure portalında ayrı olarak oturum açabilir, mantıksal uygulamanızı bulmak için portal arama kutusunu kullanabilir ve ardından sonuçlar listesinden mantıksal uygulamanızı seçebilirsiniz.

    Dağıtılan mantıksal uygulama için arama sonuçlarının seçili olarak gösterildiği Azure portalını ve arama çubuğunu gösteren ekran görüntüsü.

Mantıksal uygulamaları durdurmak için dikkat edilmesi gerekenler

Mantıksal uygulamanın durdurulması, iş akışı örneklerini aşağıdaki yollarla etkiler:

  • Azure Logic Apps devam eden ve bekleyen tüm çalıştırmaları hemen iptal eder.

  • Azure Logic Apps yeni iş akışı örnekleri oluşturmaz veya çalıştırmaz.

  • Tetikleyiciler, koşulları karşılandığında tetiklenmez. Ancak tetikleyici durumları mantıksal uygulamanın durdurulduğu noktaları anımsar. Bu nedenle, mantıksal uygulamayı yeniden başlatırsanız, tetikleyiciler son çalıştırmadan bu yana tüm işlenmemiş öğeler için tetikler.

    Son çalıştırmadan bu yana bir tetikleyicinin işlenmemiş öğelerde tetiklenmesini durdurmak için, mantıksal uygulamayı yeniden başlatmadan önce tetikleyici durumunu temizleyin:

    1. Visual Studio Code Etkinlik Çubuğu'nda Azure simgesini seçerek Azure penceresini açın.

    2. Kaynaklar bölümünde aboneliğinizi genişletin ve bu abonelik için dağıtılan tüm mantıksal uygulamaları gösterir.

    3. Mantıksal uygulamanızı genişletin ve ardından İş Akışları adlı düğümü genişletin.

    4. Bir iş akışı açın ve bu iş akışının tetikleyicisinin herhangi bir bölümünü düzenleyin.

    5. Değişikliklerinizi kaydedin. Bu adım tetikleyicinin geçerli durumunu sıfırlar.

    6. Her iş akışı için yineleyin.

    7. İşiniz bittiğinde mantıksal uygulamanızı yeniden başlatın.

Mantıksal uygulamaları silmeyle ilgili dikkat edilmesi gerekenler

Mantıksal uygulamanın silinmesi, iş akışı örneklerini aşağıdaki yollarla etkiler:

  • Azure Logic Apps devam eden ve bekleyen çalıştırmaları hemen iptal eder, ancak uygulama tarafından kullanılan depolama alanında temizleme görevlerini çalıştırmaz.

  • Azure Logic Apps yeni iş akışı örnekleri oluşturmaz veya çalıştırmaz.

  • Bir iş akışını silip aynı iş akışını yeniden oluşturursanız, yeniden oluşturulmuş iş akışı silinen iş akışıyla aynı meta veriye sahip olmaz. Meta verileri yenilemek için silinen iş akışını çağıran iş akışlarını yeniden kaydetmeniz gerekir. Bu şekilde, arayan yeniden oluşturulmuş iş akışı için doğru bilgileri alır. Aksi takdirde, yeniden oluşturulmuş iş akışına yapılan çağrılar bir Unauthorized hatayla başarısız olur. Bu davranış, tümleştirme hesaplarında yapıtları kullanan iş akışları ve Azure işlevlerini çağıran iş akışları için de geçerlidir.

Portalda dağıtılan mantıksal uygulamaları yönetme

Visual Studio Code'dan Azure portalına bir mantıksal uygulama dağıttıktan sonra, Tüketim veya Standart mantıksal uygulama kaynakları olsun, Azure aboneliğinizdeki tüm dağıtılan mantıksal uygulamaları görüntüleyebilirsiniz. Şu anda her kaynak türü Azure'da ayrı kategoriler olarak düzenlenmiş ve yönetilmektedir. Standart mantıksal uygulamaları bulmak için şu adımları izleyin:

  1. Azure portalı arama kutusuna mantıksal uygulamalar girin. Sonuçlar listesi görüntülendiğinde Hizmetler'in altında Mantıksal uygulamalar'ı seçin.

    Mantıksal uygulamaların arama metni olarak gösterildiği Azure portalı arama kutusunu gösteren ekran görüntüsü.

  2. Mantıksal uygulamalar bölmesinde Visual Studio Code'dan dağıttığınız mantıksal uygulamayı seçin.

    Azure portalı ve Azure'da dağıtılan Standart mantıksal uygulama kaynaklarını gösteren ekran görüntüsü.

    Azure portalı, seçilen mantıksal uygulama için tek tek kaynak sayfasını açar.

    Azure portalını ve mantıksal uygulama kaynak sayfanızı gösteren ekran görüntüsü.

  3. Bu mantıksal uygulamadaki iş akışlarını görüntülemek için mantıksal uygulamanın menüsünde İş Akışları'nı seçin.

    İş Akışları bölmesi, geçerli mantıksal uygulamadaki tüm iş akışlarını gösterir. Bu örnekte Visual Studio Code'da oluşturduğunuz iş akışı gösterilmektedir.

    Açık İş Akışları bölmesi ve iş akışları içeren mantıksal uygulama kaynak sayfanızı gösteren ekran görüntüsü.

  4. bir iş akışını görüntülemek için İş Akışları bölmesinde bu iş akışını seçin.

    İş akışı bölmesi açılır ve bu iş akışında gerçekleştirebileceğiniz daha fazla bilgi ve görev gösterilir.

    Örneğin, iş akışındaki adımları görüntülemek için Tasarım Aracı'ı seçin.

    Ekran görüntüsü seçili iş akışının Genel Bakış bölmesini gösterirken, iş akışı menüsünde seçili

    İş akışı tasarımcısı açılır ve Visual Studio Code'da oluşturduğunuz iş akışını gösterir. Artık Azure portalında bu iş akışında değişiklik yapabilirsiniz.

    Visual Studio Code'dan dağıtılan iş akışı tasarımcı ve iş akışını gösteren ekran görüntüsü.

Portalda başka bir iş akışı ekleme

Azure portalı aracılığıyla Visual Studio Code'dan dağıttığınız Standart mantıksal uygulama kaynağına boş iş akışları ekleyebilir ve bu iş akışlarını Azure portalında oluşturabilirsiniz.

  1. Azure portalında dağıtılan Standart mantıksal uygulama kaynağınızı seçin.

  2. Mantıksal uygulama kaynak menüsünde İş Akışları'nı seçin. İş Akışları bölmesinde Ekle'yi seçin.

    Seçili mantıksal uygulamanın İş Akışları bölmesini ve Ekle komutunun seçili olduğu araç çubuğunu gösteren ekran görüntüsü.

  3. Yeni iş akışı bölmesinde iş akışı için ad belirtin. Durum Bilgisi Olan veya Durum Bilgisi Olmayan Oluştur'u> seçin.

    Azure, İş Akışları bölmesinde görünen yeni iş akışınızı dağıttığınızda tasarımcıyı veya kod görünümünü açma gibi diğer görevleri yönetebilmeniz ve gerçekleştirebilmeniz için bu iş akışını seçin.

    Yönetim ve gözden geçirme seçenekleriyle seçilen iş akışını gösteren ekran görüntüsü.

    Örneğin, yeni bir iş akışı için tasarımcı açıldığında boş bir tuval gösterilir. Artık bu iş akışını Azure portalında oluşturabilirsiniz.

    İş akışı tasarımcılarını ve boş iş akışını gösteren ekran görüntüsü.

Durum bilgisi olmayan iş akışları için çalıştırma geçmişini etkinleştirme

Durum bilgisi olmayan bir iş akışının hatalarını daha kolay ayıklamak için, bu iş akışının çalıştırma geçmişini etkinleştirebilir ve işiniz bittiğinde çalıştırma geçmişini devre dışı bırakabilirsiniz. Visual Studio Code için bu adımları izleyin veya Azure portalında çalışıyorsanız bkz . Azure portalında tek kiracı tabanlı iş akışları oluşturma.

  1. Visual Studio Code projenizde kök klasör düzeyinde local.settings.json dosyasını açın.

  2. Workflows.{yourWorkflowName}.operationOptions özelliğini ekleyin ve değerini WithStatelessRunHistoryolarak ayarlayın, örneğin:

    Windows

    {
   "IsEncrypted": false,
   "Values": {
      "AzureWebJobsStorage": "UseDevelopmentStorage=true",
      "FUNCTIONS_WORKER_RUNTIME": "node",
      "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory"
   }
}

    macOS veya Linux

    {
   "IsEncrypted": false,
   "Values": {
      "AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=fabrikamstorageacct; \
          AccountKey=<access-key>;EndpointSuffix=core.windows.net",
      "FUNCTIONS_WORKER_RUNTIME": "node",
      "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory"
   }
}

  3. workflow-designtime adlı proje klasöründe local.settings.json dosyasını açın ve aynı değişikliği yapın.

  4. İşiniz bittiğinde çalıştırma geçmişini devre dışı bırakmak için özelliğini olarak Noneayarlayın Workflows.{yourWorkflowName}.OperationOptionsveya özelliği ve değerini silin.

Azure portalında izleme görünümünü etkinleştirme

Visual Studio Code'dan Azure'a Mantıksal Uygulama (Standart) kaynağı dağıttığınızda, Azure portalını ve bu iş akışının İzleyici deneyimini kullanarak bu kaynaktaki bir iş akışının kullanılabilir çalıştırma geçmişini ve ayrıntılarını gözden geçirebilirsiniz. Ancak, önce bu mantıksal uygulama kaynağında İzleyici görünümü özelliğini etkinleştirmeniz gerekir.

  1. Azure portalında Standart mantıksal uygulama kaynağını açın.

  2. Mantıksal uygulama kaynak menüsünde, API'nin altında CORS'yi seçin.

  3. CORS bölmesindeki İzin Verilen Çıkış Noktaları'nın altında (*) joker karakterini ekleyin.

  4. İşiniz bittiğinde CORS araç çubuğunda Kaydet'i seçin.

    Dağıtılan Standart mantıksal uygulama kaynağının gösterildiği Azure portalını gösteren ekran görüntüsü. Kaynak menüsünde CORS, İzin Verilen Kaynaklar için joker karakter * karakterine ayarlanmış yeni bir girişle seçilir.

Dağıtımdan sonra Uygulama Analizler etkinleştirme veya açma

İş akışı yürütme sırasında mantıksal uygulamanız diğer olaylarla birlikte telemetri de yayar. İş akışınızın ne kadar iyi çalıştığına ve Logic Apps çalışma zamanının çeşitli yollarla nasıl çalıştığına ilişkin daha iyi görünürlük elde etmek için bu telemetriyi kullanabilirsiniz. Gerçek zamanlıya yakın telemetri (canlı ölçümler) sağlayan Uygulama Analizler kullanarak iş akışınızı izleyebilirsiniz. Bu özellik, sorunları tanılamak, uyarıları ayarlamak ve grafikler oluşturmak için bu verileri kullandığınızda hataları ve performans sorunlarını daha kolay araştırmanıza yardımcı olabilir.

Mantıksal uygulamanızın oluşturma ve dağıtım ayarları Uygulama Analizler kullanmayı destekliyorsa, mantıksal uygulamanız için isteğe bağlı olarak tanılama günlüğünü ve izlemeyi etkinleştirebilirsiniz. Bunu Visual Studio Code'dan mantıksal uygulamanızı dağıtırken veya dağıtımdan sonra yapabilirsiniz. Bir Application Analizler örneğiniz olması gerekir, ancak mantıksal uygulamanızı dağıtırken veya dağıtımdan sonra bu kaynağı önceden oluşturabilirsiniz.

Dağıtılan bir mantıksal uygulamada Uygulama Analizler etkinleştirmek veya zaten etkinleştirildiğinde Uygulama Analizler verilerini gözden geçirmek için şu adımları izleyin:

  1. Azure portalında dağıtılan mantıksal uygulamanızı bulun.

  2. Mantıksal uygulama menüsündeki Ayarlar altında Uygulama Analizler'ı seçin.

  3. Uygulama Analizler etkinleştirilmediyse, Uygulama Analizler bölmesinde Uygulama Analizler aç'ı seçin. Bölme güncelleştirildikten sonra alt kısımda Uygula'yı seçin.

    Uygulama Analizler etkinse, Uygulama Analizler bölmesinde Uygulama Analizler verilerini görüntüle'yi seçin.

Uygulama Analizler açıldıktan sonra mantıksal uygulamanız için çeşitli ölçümleri gözden geçirebilirsiniz. Daha fazla bilgi için şu konuları gözden geçirin:

Tasarımcıdan öğe silme

İş akışınızdaki bir öğeyi tasarımcıdan silmek için aşağıdaki adımlardan birini izleyin:

  • Öğeyi seçin, öğenin kısayol menüsünü (Shift+F10) açın ve Sil'i seçin. Onaylamak için Tamam’ı seçin.

  • Öğeyi seçin ve delete tuşuna basın. Onaylamak için Tamam’ı seçin.

  • Öğeyi seçerek ilgili öğenin ayrıntılar bölmesinin açılmasını sağlayın. Bölmenin sağ üst köşesinde üç nokta (...) menüsünü açın ve Sil'i seçin. Onaylamak için Tamam’ı seçin.

    Açık bilgi bölmesi ve seçili üç nokta düğmesi ve

    İpucu

    Üç nokta menüsü görünmüyorsa, Ayrıntılar bölmesinde sağ üst köşedeki üç nokta (...) düğmesinin görünmesi için Visual Studio Code penceresini yeterince genişletin.

Hataları ve sorunları giderme

Tasarım Aracı açılamıyor

Tasarımcıyı açmaya çalıştığınızda şu hatayı alıyorsunuz: "İş akışı tasarım zamanı başlatılamadı". Daha önce tasarımcıyı açmayı denediyseniz ve ardından projenizi sonlandırdıysanız veya sildiyseniz uzantı paketi doğru indirilmiyor olabilir. Sorunun bu neden olup olmadığını denetlemek için şu adımları izleyin:

  1. Visual Studio Code'da Çıkış penceresini açın. Görünüm menüsünden Çıkış'ı seçin.

  2. Çıktı penceresinin başlık çubuğundaki listeden Azure Logic Apps (Standart) öğesini seçerek uzantının çıkışını gözden geçirin, örneğin:

  3. Çıktıyı gözden geçirin ve bu hata iletisinin görünüp görünmediğini denetleyin:

    A host error has occurred during startup operation '{operationID}'.
System.Private.CoreLib: The file 'C:\Users\{userName}\AppData\Local\Temp\Functions\
ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows\1.1.7\bin\
DurableTask.AzureStorage.dll' already exists.
Value cannot be null. (Parameter 'provider')
Application is shutting down...
Initialization cancellation requested by runtime.
Stopping host...
Host shutdown completed.

Bu hatayı düzeltmek için bu konumdaki ExtensionBundles klasörünü silin ...\Users{kullanıcıadı}\AppData\Local\Temp\Functions\ExtensionBundles ve workflow.json dosyasını tasarımcıda açmayı yeniden deneyin.

Daha önce oluşturulan iş akışları için tasarımcı seçicide yeni tetikleyiciler ve eylemler eksik

Tek kiracılı Azure Logic Apps, Azure İşlev İşlemleri, Sıvı İşlemleri ve XML İşlemleri için XML Doğrulama ve Dönüştürme XML'si gibi yerleşik eylemleri destekler. Ancak, daha önce oluşturulan mantıksal uygulamalar için, Visual Studio Code'un uzantı paketinin Microsoft.Azure.Functions.ExtensionBundle.Workflowsgüncel olmayan bir sürümünü kullanıp kullanmadığını seçmeniz için bu eylemler tasarımcı seçicide görünmeyebilir.

Ayrıca mantıksal uygulamanızı oluştururken Azure'dan bağlayıcıları kullan seçeneğini etkinleştirmediğiniz veya seçmediğiniz sürece Azure İşlev İşlemleri bağlayıcısı ve eylemleri tasarımcı seçicide görünmez. Azure tarafından dağıtılan bağlayıcıları uygulama oluşturma zamanında etkinleştirmediyseniz, Visual Studio Code'da projenizden etkinleştirebilirsiniz. workflow.json kısayol menüsünü açın ve Azure'dan Bağlan or kullan'ı seçin.

Güncel olmayan paketi düzeltmek için, Visual Studio Code'un uzantı paketini en son sürüme otomatik olarak güncelleştirmesini sağlayan eski paketi silmek için bu adımları izleyin.

Not

Bu çözüm, Azure portalını kullanarak oluşturduğunuz mantıksal uygulamalar için değil, yalnızca Azure Logic Apps (Standart) uzantısıyla Visual Studio Code kullanarak oluşturduğunuz ve dağıttığınız mantıksal uygulamalar için geçerlidir. Bkz . Azure portalında tasarımcıda desteklenen tetikleyiciler ve eylemler eksik.

  1. Kaybetmek istemediğiniz tüm çalışmaları kaydedin ve Visual Studio'yu kapatın.

  2. Bilgisayarınızda, mevcut paket için sürümlenmiş klasörleri içeren aşağıdaki klasöre göz atın:

    ...\Users\{your-username}\.azure-functions-core-tools\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows

  3. Önceki paketin sürüm klasörünü silin; örneğin, sürüm 1.1.3 için bir klasörünüz varsa bu klasörü silin.

  4. Şimdi, gerekli NuGet paketi için sürümlenmiş klasörleri içeren aşağıdaki klasöre göz atın:

    ...\Users\{your-username}\.nuget\packages\microsoft.azure.workflows.webjobs.extension

  5. Önceki paketin sürüm klasörünü silin.

  6. Tasarımcıda Visual Studio Code'un, projenizin ve workflow.json dosyasını yeniden açın.

Eksik tetikleyiciler ve eylemler artık tasarımcıda görünür.

Tetikleyicide veya eylemde "400 Hatalı İstek" görünüyor

Bir çalıştırma başarısız olduğunda ve çalıştırmayı izleme görünümünde incelediğinizde, bu hata daha uzun bir ada sahip bir tetikleyicide veya eylemde görünebilir ve bu da temel alınan Tekdüzen Kaynak Tanımlayıcısı'nın (URI) varsayılan karakter sınırını aşmasına neden olur.

Bu sorunu çözmek ve daha uzun URI'yi ayarlamak için aşağıdaki adımları izleyerek bilgisayarınızdaki ve UrlSegmentMaxLength kayıt defteri anahtarlarını düzenleyinUrlSegmentMaxCount. Bu anahtarın varsayılan değerleri, Windows için kayıt defteri ayarları Http.sys bu konuda açıklanmıştır.

Önemli

Başlamadan önce çalışmanızı kaydettiğinizden emin olun. Bu çözüm, değişikliklerin etkili olabilmesi için işiniz bittikten sonra bilgisayarınızı yeniden başlatmanızı gerektirir.

  1. Bilgisayarınızda Çalıştır penceresini açın ve kayıt defteri düzenleyicisini regedit açan komutunu çalıştırın.

  2. Bilgisayarınızda yaptığınız değişikliklere izin vermek için Kullanıcı Hesabı Denetimi kutusunda Evet'i seçin.

  3. Sol bölmede, Bilgisayar'ın altında, yol boyunca düğümleri genişletin, HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP\Parameters ve ardından Parametreler'i seçin.

  4. Sağ bölmede ve UrlSegmentMaxLength kayıt defteri anahtarlarını bulunUrlSegmentMaxCount.

  5. URI'lerin kullanmak istediğiniz adlara uyum sağlayabilmesi için bu anahtar değerlerini yeterince artırın. Bu anahtarlar yoksa, aşağıdaki adımları izleyerek bunları Parametreler klasörüne ekleyin:

    1. Parametreler kısayol menüsünden Yeni>DWORD (32 bit) Değer'i seçin.

    2. Görüntülenen düzenleme kutusuna yeni anahtar adı olarak girin UrlSegmentMaxCount .

    3. Yeni tuşun kısayol menüsünü açın ve Değiştir'i seçin.

    4. Görüntülenen Dizeyi Düzenle kutusuna, istediğiniz Değer veri anahtarı değerini onaltılık veya ondalık biçiminde girin. Örneğin, 400 onaltılık olarak ondalık ile 1024 eşdeğerdir.

    5. Anahtar değerini eklemek UrlSegmentMaxLength için bu adımları yineleyin.

    Bu anahtar değerlerini artırdıktan veya ekledikten sonra kayıt defteri düzenleyicisi şu örneğe benzer:

    Kayıt defteri düzenleyicisini gösteren ekran görüntüsü.

  6. Hazır olduğunuzda, değişikliklerin etkili olabilmesi için bilgisayarınızı yeniden başlatın.

Hata ayıklama oturumu başlatılamıyor

Bir hata ayıklama oturumu başlatmayı denediğinizde, "'generateDebugSymbols' preLaunchTask çalıştırıldıktan sonra hata var" hatasını alırsınız. Bu sorunu çözmek için projenizdeki tasks.json dosyasını düzenleyerek sembol oluşturmayı atlayın.

  1. Projenizde .vscode adlı klasörü genişletin ve tasks.json dosyasını açın.

  2. Aşağıdaki görevde, "dependsOn: "generateDebugSymbols"yukarıdaki satırı sona erdiren virgülle birlikte satırını silin, örneğin:

    Önce:

     {
   "type": "func",
   "command": "host start",
   "problemMatcher": "$func-watch",
   "isBackground": true,
   "dependsOn": "generateDebugSymbols"
 }

    Sonra:

     {
   "type": "func",
   "command": "host start",
   "problemMatcher": "$func-watch",
   "isBackground": true
 }

Sonraki adımlar

Azure Logic Apps (Standart) uzantısıyla ilgili deneyimleriniz hakkında sizden bilgi almak istiyoruz!