Aracılığıyla paylaş


Visual Studio Code ile Standart mantıksal uygulama iş akışları oluşturma

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

Bu kılavuzda, Visual Studio Code'u Azure Logic Apps (Standart) uzantısıyla kullanırken tek kiracılı Azure Logic Apps'te çalıştırabileceğiniz örnek bir Standart mantıksal uygulama iş akışının nasıl yerel olarak oluşturulacağı gösterilmektedir.

Bu kılavuzda bir Standart mantıksal uygulama çalışma alanı ve projesi oluşturacak, iş akışınızı oluşturacak ve projenizi Azure'da standart mantıksal uygulama kaynağı olarak dağıtacak ve burada iş akışınız tek kiracılı Azure Logic Apps'te veya App Service Ortamı v3'te (yalnızca Windows tabanlı App Service planları) çalıştırılabilir. Azure Logic Apps için kapsayıcılı çalışma zamanı (Standart) nedeniyle iş akışınızı Azure, Azure Kubernetes Service, şirket içi ve hatta diğer bulut sağlayıcıları gibi Kubernetes'in çalıştırabileceği her yere dağıtabilir ve çalıştırabilirsiniz.

Standart mantıksal uygulamaların sağladığı bazı avantajlar şunlardır:

  • Yerel Visual Studio Code geliştirme ortamında iş akışlarını yerel olarak oluşturabilir, hatalarını ayıklayabilir, çalıştırabilir ve test edebilirsiniz. Hem Azure portalı hem de Visual Studio Code, Standart mantıksal uygulama kaynakları ve iş akışları oluşturma, çalıştırma ve dağıtma özelliği sağlar. Ancak Visual Studio Code ile bu görevleri yerel olarak gerçekleştirebilirsiniz.

  • Standart mantıksal uygulama projeniz hem durum bilgisi olan hem de durum bilgisi olmayan iş akışları içerebilir.

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

Bu kılavuzun örnek iş akışı başlangıçta bir İstek tetikleyicisi ve ardından bir Office 365 Outlook eylemiyle başlar. İstek tetikleyicisi, 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 etkinleştiğinde, bir sonraki işlem, seçtiğiniz tetikleyici çıktılarıyla birlikte belirtilen alıcıya e-posta göndererek devreye girer. Daha sonra, çağırana yanıt ve işlenen veriler döndüren bir Yanıt eylemi ekleyebilirsiniz.

Visual Studio Code, mantıksal uygulama çalışma alanı, proje ve iş akışını gösteren ekran görüntüsü.

Bu kılavuzun örneği bulut tabanlı olsa da ve yalnızca birkaç adımı olsa da bulut, şirket içi ve hibrit ortamlar arasında çok çeşitli hizmetleri, sistemleri, uygulamaları ve verileri tümleştirmenize yardımcı olan 1.400'den fazla bağlayıcıdaki işlemleri kullanarak iş akışları oluşturabilirsiniz.

Kılavuzda ilerledikçe aşağıdaki üst düzey görevleri tamamlarsınız:

  • Boş bir durum bilgisi olan iş akışı ile bir Standart mantık uygulaması çalışma alanı ve proje oluşturun.
  • İş akışınıza tetikleyici ve eylemler ekleyin.
  • Yerel olarak çalıştırın, hata ayıklayıp test edin.
  • İş akışı çalıştırma geçmişini gözden geçirin.
  • Güvenlik duvarı erişimi için etki alanı adı ayrıntılarını bulun.
  • Durum bilgisi olmayan iş akışları için çalıştırma geçmişini etkinleştirin.
  • İsteğe bağlı olarak Application Insights'ı etkinleştirmeyi de içeren Azure'a dağıtın.
  • Dağıtımdan sonra Application Insights'i etkinleştirin veya açın.
  • Visual Studio Code'da ve Azure portalında dağıtılan mantıksal uygulama kaynağınızı yönetin.

Önkoşullar

Erişim ve bağlantı gereksinimleri

İş akışlarını yalnızca Azure Logic Apps (Standart) çalışma zamanında yerel olarak çalışan yerleşik işlemleri kullanarak yerel olarak oluşturmayı ve çalıştırmayı planlıyorsanız, bu bölümdeki erişim ve bağlantı gereksinimlerine ihtiyacınız yoktur. Ancak, aşağıdaki senaryolar için şu gereksinimleri karşılamanız gerekir:

  • Visual Studio Code'dan mantıksal uygulamanızı Azure'a dağıtın.
  • Genel Azure'da çalışan yönetilen bağlayıcı işlemlerini kullanan bir iş akışı oluşturun.
  • Azure'da veya dağıtılan diğer Azure kaynaklarında mevcut Standart mantıksal uygulama kaynaklarına ve iş akışlarına erişin.

Bu gereksinimler aşağıdaki öğeleri içerir:

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

  • Gerekli uzantıyı indirmek, Visual Studio Code'dan Azure hesabınıza bağlanmak, yönetilen bağlayıcı işlemlerini içeren iş akışlarını test etmek ve Visual Studio Code'dan Azure'a dağıtmak için İnternet'e erişim.

  • Bu kılavuzda 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.

    Office 365 hesabınız yoksa, e-posta hesabınızdan ileti gönderebilen başka herhangi bir eylemi kullanabilirsiniz, örneğin Outlook.com. 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, deneyiminiz ve seçenekleriniz bazı yönlerden farklılık gösterebilir. Örneğin, Outlook.com bağlayıcısıyla oturum açmak için kişisel Microsoft hesabınızı kullanın.

Araçlar

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

  2. Aşağıdaki adımları izleyerek Visual Studio Code için Azure Logic Apps (Standart) uzantısını indirin ve yükleyin:

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

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

      Uzantı, aşağıdaki çerçeveler için gerekli tüm bağımlılıkları ve doğru sürümleri indirir ve yükler:

      • Azure Functions Çekirdek Araçlar
      • .NET SDK
      • Node.js

      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ü.

    3. Uzantının ve tüm bağımlılıkların doğru yüklendiğinden emin olmak için Visual Studio Code'u yeniden yükleyin veya yeniden başlatın.

    4. Uzantının ve tüm bağımlılıkların doğru yüklendiğini onaylamak için bkz. Uzantı yüklemesini denetleme.

    Ş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 uygulaması kaynak türlerini içerebilir. Visual Studio Code'da Azure bölmesi, 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:

    • Kaynaklar bölümü: Aboneliğinizdeki tüm Standart mantıksal uygulamalar.
    • Logic Apps (Tüketim) bölümü: Aboneliğinizdeki tüm Tüketim mantığı uygulamaları.
  3. Yerleşik HTTP Web Kancası tetikleyicisi gibi web kancası tabanlı tetikleyicileri ve eylemleri yerel olarak çalıştırmak için Visual Studio Code'da geri çağırma URL'si için iletmeyi ayarlamanız gerekir.

  4. Standart mantıksal uygulamanız için Application Insights ile tanılama günlüğünü ve izlemeyi etkinleştirmek için bu görevi mantıksal uygulama dağıtımı sırasında veya dağıtımdan sonra tamamlayabilirsiniz. Application Insights kaynağınız olması gerekir, ancak bu kaynağı önceden, dağıtım sırasında veya dağıtımdan sonra oluşturabilirsiniz.

  5. Örnek iş akışını test etmek için HTTP istekleri gönderebilen bir araç yükleyin veya kullanın, örneğin:

    Dikkat

    Kimlik bilgileri, gizli diziler, erişim belirteçleri, API anahtarları ve diğer benzer bilgiler gibi hassas verileriniz olduğu senaryolarda, verilerinizi gerekli güvenlik özellikleriyle koruyan bir araç kullandığınızdan emin olun. Araç çevrimdışı veya yerel olarak çalışmalı ve çevrimiçi bir hesapta oturum açmayı veya verileri bulutla eşitlemeyi gerektirmemelidir. Bu özelliklere sahip bir araç kullandığınızda, hassas verileri genel kullanıma çıkarma riskini azaltırsınız.

Uzantı yüklemesini denetleme

  1. Uzantının ve tüm bağımlılıkları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ı'na gidin.

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

    3. Güncelleştirmeleri Otomatik Denetle'nin seçili olduğundan ve Otomatik Güncelleştirme'ninTüm Uzantılar olarak ayarlandığından emin olun.

  3. Azure Logic Apps Standard: Project Runtime ayarının doğru sürüme ayarlandığını onaylayın:

    1. Kullanıcı sekmesinde >> bölümüne gidin.

    2. Project Runtime'ın~4 sürümüne ayarlandığından emin olun, örneğin:

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

      Uyarı

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

Azure hesabınıza bağlanma

Azure hesabınıza henüz bağlı değilseniz bağlanmak için şu adımları izleyin:

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

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

  2. Azure bölmesindeki 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 seçili bağlantının gösterildiği Azure bölmesini gösteren ekran görüntüsü.

    Oturum açtığınızda, Azure bölmesinde 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 bölmesini gösteren ekran görüntüsü.

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

    2. Güncelleştirilmiş abonelikler listesi görüntülendiğinde, istediğiniz abonelikleri seçin ve Tamam'ı seçtiğinizden emin olun.

Yerel çalışma alanı oluşturma

Mantıksal uygulama projesi her zaman bir çalışma alanı gerektirir. Bu nedenle, mantıksal uygulamanızı oluşturabilmeniz için önce mantıksal uygulama projenizi tuttuğunuz bir çalışma alanı oluşturmanız gerekir. Daha sonra mantıksal uygulamanızı Visual Studio Code'dan dağıtım ortamınıza yönetmek, çalıştırmak ve dağıtmak için bu çalışma alanını ve projeyi kullanırsınız. Temel proje, işlev uygulaması projesi olarak da bilinen Azure İşlevleri projesine benzer.

  1. Bilgisayarınızda, daha sonra çalışma alanı ve proje için kullanmak üzere boş bir yerel klasör oluşturun.

    Bu örnek fabrikam-workflows adlı bir klasör oluşturur.

  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 Appsmenüsünden Yeni mantıksal uygulama çalışma alanı oluştur'u seçin.

    Azure bölmesini, Çalışma Alanı araç çubuğunu, Azure Logic Apps menüsünü ve Yeni mantıksal uygulama çalışma alanı oluştur öğesini gösteren ekran görüntüsü.

    Windows Defender Güvenlik Duvarı, Code.exe olan Visual Studio Code ve func.exe olan Azure İşlevleri Temel Araçları için ağ erişimi vermenizi isterse, Özel ağlar, örneğin ev veya iş ağım>Erişime izin ver seçeneğini seçin.

  4. Klasör Seç penceresinde, klasörünüzü oluşturduğunuz konuma gidin, klasörü seçin ve Seç'i seçin (klasörü iki kez seçmeyin).

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

    Visual Studio Code araç çubuğunda, çalışma alanınızı adlandırmanız için bir istem görüntülenir.

  5. Çalışma alanı adı sağlayın alanında, kullanılacak çalışma alanı adını girin.

    Bu örnekte Fabrikam-Workflows kullanılır.

    Çalışma alanı adı sağlama istemini gösteren ekran görüntüsü.

Ardından mantıksal uygulama projenizi oluşturun.

Mantıksal uygulama projenizi oluşturma

Gerekli çalışma alanını oluşturduktan sonra, projenizi oluşturmak için istemleri izleyin.

  1. Proje şablonunuz için Mantıksal uygulama'yı seçin. Kullanılacak proje adını girin.

    Bu örnekte Fabrikam-Workflows kullanılır.

    Mantıksal uygulama için seçili seçenekle bir proje şablonu seçme istemini gösteren ekran görüntüsü.

  2. İş akışı şablonunuz için senaryonuza göre Durum Bilgisi Olan İş Akışı veya Durum Bilgisi Olmayan İş Akışı'yı seçin. Kullanılacak bir iş akışı adı girin.

    Bu örnek, çalışma geçmişini, girişleri ve çıkışları depolayan Durum Bilgisi Olan İş Akışı seçer ve ad olarak Stateful-Workflow kullanır.

    Durum bilgisi olmayan iş akışları bu verileri depolamaz ve şu anda tetikleyicileri değil yalnızca yönetilen bağlayıcı eylemlerini destekler. 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.

    Uyarı

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

  3. Şimdi, projenizi geçerli Visual Studio Code penceresinde mi yoksa yeni bir pencerede mi açmak istediğinizi seçin. Tercihinize bağlı olarak Geçerli penceredeaç'ı veya Yeni pencerede aç'ı seçin.

    Çalışma alanınızı, projenizi ve otomatik olarak açılan workflow.json dosyasını göstermek için Gezgin bölmesi açılır. Bu dosya Stateful-Workflow adlı klasörde bulunur ve tasarımcıda oluşturduğunuz iş akışı için temel JSON tanımını depolar. Proje yapınız hakkında bilgi için bkz. Standart mantıksal uygulama proje yapısı.

    Ayrıca çok kiracılı Azure tarafından barındırılan "paylaşılan" bağlayıcıları etkinleştirmek için bir istem alırsınız, örneğin:

    Azure tarafından barındırılan bağlayıcıları etkinleştirme istemiyle açılmış mantıksal uygulama projesini gösteren ekran görüntüsü.

  4. İş akışınızda görüntüleyebilmeniz ve kullanmayı seçebilmeniz için çok kiracılı Azure'da çalışan tüm yönetilen "paylaşılan" bağlayıcıları etkinleştirmek için Azure'dan bağlayıcıları kullan'ı seçin.

    Uyarı

    Bu seçeneği belirtmezseniz ve daha sonra iş akışınızı oluştururken yönetilen bir bağlayıcı işlemi eklemeye çalışırsanız, işlem bilgileri bölmesinde durmayan dönen bir daire gösterildiğinden devam edemezsiniz.

  5. Azure kaynak grubu için Yeni kaynak grubu oluştur'u seçin. Kullanılacak kaynak grubu adını girin.

    Bu örnekte Fabrikam-Workflows-RG kullanılır.

  6. Abonelik için mantıksal uygulama projenizle kullanılacak Azure aboneliğini seçin.

  7. Grubunuzu ve kaynaklarınızı oluşturacağınız konum için Azure bölgesini seçin.

    Bu örnekte Orta Batı ABD kullanılır.

  8. Projenizin geliştirme için başka bir kuruluma veya iş akışınızı oluşturmak için destekleyici yapıtlara ihtiyacı varsa aşağıdaki senaryolara ve ilgili görevlere bakın:

    Senaryo Görev
    Web kancası tabanlı tetikleyicileri veya eylemleri yerel olarak çalıştırın. Webhook geri çağırma URL'leri için yönlendirmeyi ayarlayın.
    Durumsuz iş akışı geçmişini ayarlayın. Durum bilgisi olmayan iş akışları için çalıştırma geçmişini etkinleştirin.
    Haritalar, şemalar ve derlemeler gibi yapıtlar ve bağımlılıklar ekleyin. Yapıtlar ve bağımlılıklar ekleyin.
    NuGet tabanlı (.NET) projeyle çalışma Uzantı tabanlı paket (Node.js) projesini NuGet paket tabanlı (.NET) projesine dönüştürün.

    Not: Derlemeler desteklenmeden önce oluşturduğunuz bir uzantı paketi tabanlı (Node.js) projeyi dönüştürmek için ayrıca bkz. lib klasöründeki derlemeleri kullanmak için NuGet paket tabanlı projeleri geçirme.
    Kendi yerleşik bağlayıcılarınızı oluşturun. 1. Uzantı paket tabanlı (Node.js) projesini NuGet paket tabanlı (.NET) projesine dönüştürün .

    2. Yerleşik bağlayıcı oluşturmayı etkinleştirin.

Şimdi iş akışı tasarımcısını açın.

İş akışı tasarımcısını açma

Projeniz Gezgin bölmesinde açıldıktan sonra iş akışınızı oluşturabilmeniz için tasarımcıyı açın.

workflow.json dosya kısayol menüsünde Tasarımcıyı Aç'ı seçin.

Gezgin bölmesini, workflow.json dosya kısayol menüsünü ve Tasarımcıyı Aç'ın seçili olduğunu gösteren ekran görüntüsü.

Uyarı

Bu seçeneği seçtikten sonra, "iş akışı tasarım zamanı API'sini başlatma" nedeniyle başlatmanın birkaç saniye sürebileceğini belirten bir ileti alabilirsiniz. Bu iletiyi yoksayabilir veya Tamam'ı seçebilirsiniz.

Visual Studio Code iş akışı tasarımcısını açar ve Tetikleyici ekle istemini gösterir, örneğin:

Boş iş akışı olan tasarımcıyı gösteren ekran görüntüsü.

Uyarı

Tasarımcı açılmazsa Tasarımcı açılamıyor sorun giderme bölümüne bakın.

Ardından, iş akışınızı oluşturmak için bir tetikleyici ve eylemler ekleyin.

Tetikleyici ve eylem ekleme

İş akışınızı oluşturmak için, iş akışınızı bir tetikleyiciyle başlatın ve başlangıçta tek bir eylem ekleyin. Bu şekilde, sonraki eylemi eklemeden önce iş akışınızı test edebilirsiniz. Örnek iş akışı, toplu olarak işlemler olarak bilinen aşağıdaki tetikleyiciyi ve eylemleri kullanır:

Bağlayıcı veya işlem grubu Operasyon adı İşlem türü Açıklama
İstek HTTP isteği alındığında Tetikleyici (yerleşik) Diğer hizmetlerden veya mantıksal uygulama iş akışlarından gelen çağrıları veya istekleri almak için iş akışında bir uç nokta URL'si oluşturur.

Daha fazla bilgi için bkz. İş akışlarına gelen HTTP çağrılarını alma ve yanıtlama.
Office 365 Outlook E-posta gönderme Eylem (yönetilen) Office 365 Outlook hesabı kullanarak e-posta gönderin. Bu kılavuzdaki adımları izlemek için bir Office 365 Outlook e-posta hesabınız olmalıdır. Daha fazla bilgi için bkz. Azure Logic Apps'ten Office 365 Outlook'a bağlanma.

Not: Farklı bir bağlayıcı tarafından desteklenen bir e-posta hesabınız varsa, bu bağlayıcıyı kullanabilirsiniz, ancak bu bağlayıcının kullanıcı deneyimi bu örnekteki adımlardan farklıdır.
İstek Yanıt Eylem (yerleşik) Bir yanıt gönderin ve verileri arayana geri gönderin.

Daha fazla bilgi için bkz Bir Yanıt ekleme eylemi.

İstek tetikleyicisini ekleme

  1. İş akışı tasarımcısında, henüz seçili değilse Tetikleyici ekle'yi seçin.

    Tetikleyici ekle bölmesi açılır ve kullanılabilir bağlayıcılar ve işlem grupları arasından seçim yapabileceğiniz bir galeri gösterilir, örneğin:

    İş akışı tasarımcısını, Tetikleyici ekle adlı seçili istemi ve tetikleyicileri olan bağlayıcılar ve işlem grupları galerisini gösteren ekran görüntüsü.

  2. Tetikleyici ekle bölmesinde, HTTP isteği alındığında adlı İstek tetikleyicisini eklemek için bu genel adımları izleyin.

    Aşağıdaki örnek, yalnızca yerleşik tetikleyicilerin görünmesi için Yerleşik seçeneğini seçer:

    İş akışı tasarımcısını, Tetikleyici ekle bölmesini ve

    Tetikleyici tasarımcıda görüntülendiğinde tetikleyici bilgileri 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ü.

    Uyarı

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

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

Office 365 Outlook eylemini ekleme

  1. Tasarımcıda, İstek tetikleyicisinin altında, e-posta gönder (V2) adlı Office 365 Outlook eylemini eklemek için bu genel adımları izleyin.

    Eylem ilk sonuçlarda görünmüyorsa bağlayıcı adının yanında Daha fazlası'nı seçin, örneğin:

    Ekran görüntüsü, iş akışı tasarımcısını ve eylem arama sonuçlarıyla eylem ekleme bölmesini ve

  2. Eylemin kimlik doğrulama bölmesi görüntülendiğinde Oturum aç'ı seçerek e-posta hesabınızla bağlantı oluşturun.

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

  3. Kimlik bilgilerinizin kimliğini doğrulamak, erişime izin vermek ve Visual Studio Code'a geri dönmek için sonraki istemleri izleyin.

    Uyarı

    İstemleri tamamlamadan önce çok fazla zaman geçerse, kimlik doğrulama işlemi zaman aşımına uğrar 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 kimlik doğrulama istemi görüntülendiğinde, Office 365 Outlook için kullanıcı hesabınızı seçin. Açılan onay gerekli sayfasında 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 uzantının Microsoft Azure Araçları'nı açmasını isteyip istemediğinizi sorarsa Aç'ı seçin.

      Microsoft Azure araçlarını açmak için uzantı istemini gösteren ekran görüntüsü.

    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ı dizesinden 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.

  4. Açılan E-posta bilgileri gönder bölmesinde , Parametreler sekmesinde eylem için gerekli bilgileri sağlayın.

    Uyarı

    Eylem bilgileri bölmesi otomatik olarak açılmadıysa tasarımcıda E-posta gönder eylemini seçin.

    Mülkiyet Gerekli Değer Açıklama
    'dan'e Evet < e-posta 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 Evet Örnek iş akışınızdan bir e-posta E-posta konusu
    Vücut Evet Örnek iş akışınızdan merhaba! E-posta gövdesi içeriği

    Örneğin:

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

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

Standart mantıksal uygulama proje yapı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 veya dosyalar içerebilir. Örneğin, Nuget paket tabanlı bir proje, paketleri ve diğer kitaplık dosyalarını içeren bir .bin klasörüne sahiptir. Paket tabanlı bir uzantı projesi bu .bin klasörünü 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 paket 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 uzantı paket tabanlı proje, aşağıdaki örneğe benzer bir klasör ve dosya yapısına sahiptir:

MyWorkspaceName
| MyBundleBasedLogicAppProjectName
  || .vscode
  || Artifacts
     ||| Maps 
         |||| MapName1
         |||| ...
     ||| Rules
     ||| Schemas
         |||| SchemaName1
         |||| ...
  || lib
     ||| builtinOperationSdks
         |||| JAR
         |||| net472
     ||| custom
  || WorkflowName1
     ||| workflow.json
     ||| ...
  || WorkflowName2
     ||| workflow.json
     ||| ...
  || workflow-designtime
     ||| host.json
     ||| local.settings.json
  || .funcignore
  || connections.json
  || host.json
  || local.settings.json

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

İsim 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.
Objeler 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ı aşağıdaki klasörleri içerir:

- Haritalar: XML dönüştürme işlemleri için kullanılacak eşlemeleri içerir.

- Şemalar: XML doğrulama işlemleri için kullanılacak şemaları içerir.

- Kurallar: Kurallara dayalı motor projelerinde iş kuralları için unsurlar.
Lib Klasör Mantıksal uygulamanızın kullanabileceği veya başvurabileceği desteklenen derlemeleri içerir. Bu derlemeleri Visual Studio Code'da projenize yükleyebilirsiniz, ancak bunları projenizdeki belirli klasörlere eklemeniz gerekir.

Örneğin, bu klasör aşağıdaki klasörleri içerir:

- builtinOperationSdks: Sırasıyla Java ve .NET Framework derlemeleri için JAR ve net472 klasörlerini içerir.

- custom: .NET Framework özel derlemelerini içerir.

Desteklenen derleme türleri ve bunları projenize nereye yerleştireceğiniz hakkında daha fazla bilgi için bkz. Projenize derleme ekleme.
< WorkflowName> Klasör Her iş akışı için WorkflowName klasörü, iş akışının <>
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. Referans bilgileri için bkz. Uygulama ayarlarını ve konak ayarlarını düzenleme.

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. Bu ayarlar ve değerler yalnızca projelerinizi yerel geliştirme ortamınızda çalıştırdığınızda geçerlidir. 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ın değerler için kullandığı yerel appSettings olarak 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. Bu dosya, mantıksal uygulamanızın düzgün çalışması için gereken uygulama ayarlarını da içerir. Referans bilgileri için bkz. Uygulama ayarlarını ve konak ayarlarını düzenleme.

Diğer geliştirme kurulum görevleri

Projenizi oluşturduktan sonra Visual Studio Code kullanarak Standart mantıksal uygulamalar oluşturma, çalıştırma ve dağıtma ile ilgili belirli yerel geliştirme senaryolarını desteklemek için başka kurulum görevleriniz de olabilir. Aşağıdaki bölümlerde bu senaryoların görevleri açıklanmaktadır.

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

Web kancası işlemi, işlemin yürütülebilmesi için bir olayın gerçekleşmesini bekleyen bir iş akışı tetikleyicisi veya eylemidir. Özellikle, web kancası işlemi, işlemin devam etmesi için bir arayan hizmetinden veya iş akışından HTTPS isteğinin gelmesini bekler. Örneğin, web kancaları İstek tetikleyicisi ve HTTP + Web kancası tetikleyicisi gibi işlemleri içerir.

Azure portalında, Azure Logic Apps çalışma zamanı web kancasını çağıran hizmete veya iş akışına otomatik olarak abone olur. Çalışma zamanı, çağıran hizmetine veya iş akışına web kancası için bir geri çağırma URL'si kaydeder. Ardından web kancası, çağıranın geri arama URL'sini kullanarak isteği göndermesini bekler.

Ancak Visual Studio Code'da web kancası işlemlerinin düzgün çalışması için bazı kurulum görevlerini tamamlamanız gerekir. Bu senaryoda, geri çağırma URL'si özel olan localhost sunucunuzu ()http://localhost:7071/... kullanır, bu nedenle çağıran bu URL'ye İnternet üzerinden doğrudan istek gönderemez.

Yerel olarak çalışan iş akışlarında web kancası işlemleri için localhost sunucunuzu kullanıma sunan ve arayandan gelen aramaları geri arama 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: Kurmak için sıkıştırmayı açın.

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

  5. Aşağıdaki komutu çalıştırarak ngrok istemcisini ngrok hesabınıza bağlayın:

    ngrok authtoken <your-authentication-token>

    Daha fazla bilgi için bkz. 2. Adım: Hesabınızı bağlama.

  6. Aşağıdaki komutu çalıştırarak HTTP tünelini localhost bağlantı noktası 7071'e açın:

    ngrok http 7071

    Daha fazla bilgi için bkz . 3. Adım: Tetikleyin.

  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 iş akışınızda kullanmak istediğiniz web kancası işlemini ekleyin.

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

  2. İstem, ana uç nokta konumu için görüntülendiğinde, önceden oluşturduğunuz iletme (yeniden yönlendirme) URL’sini girin.

    Uyarı

    İstemi yoksaymak, iletme URL'sini sağlamanız gerektiğini gösteren 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ı işlemleri için istem görüntülenmez.

    İ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. Values nesnesinde Workflows.WebhookRedirectHostUri adlı özellik artık görünür ve örneğin iletme URL'sine ayarlanmıştır:

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

    Bu uygulama ayarları hakkında daha fazla bilgi için bkz. Standart Logic Apps için uygulama ayarlarını ve konak ayarlarını düzenleme.

Yerel hata ayıklama oturumunu ilk kez başlattığınızda veya iş akışını hata ayıklamadan çalıştırdığınızda, Azure Logic Apps çalışma zamanı iş akışını çağırana kaydeder ve web kancası işlemlerini bildiren arayan uç noktasına 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ıştırılacak web kancası işlemlerini kullanan bir iş akışı 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.

Uyarı

İş 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ündekilocal.settings.json dosyasını açın ve özelliğinin olarak trueayarlandığından emin olun:

"FUNCTIONS_V2_COMPATIBILITY_MODE": "true"

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.<workflow-name>.operationOptions özelliğini ekleyin ve değerini WithStatelessRunHistoryolarak ayarlayın, örneğin:

    Windows

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "UseDevelopmentStorage=true",
          "FUNCTIONS_WORKER_RUNTIME": "dotnet",
          "Workflows.<workflow-name>.OperationOptions": "WithStatelessRunHistory"
       }
    }
    

    macOS veya Linux

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=fabrikamstorageacct; \
              AccountKey=<access-key>;EndpointSuffix=core.windows.net",
          "FUNCTIONS_WORKER_RUNTIME": "dotnet",
          "Workflows.<workflow-name>.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. Çalıştırma geçmişini devre dışı bırakmak için işiniz bittiğinde, Workflows.<workflow-name>.OperationOptions özelliğini None olarak ayarlayın veya özelliği ve değerini silin.

Projenize yapıtlar ve bağımlılıklar ekleme

Belirli senaryolarda, iş akışınız derlemeler gibi bağımlılıklar veya haritalar, şemalar veya kurallar gibi yapıtlar gerektiren işlemleri içerebilir. Visual Studio Code'da bu öğeleri projenizdeki ilgili klasörlere ekleyebilirsiniz, örneğin:

Ürün Dosya türü Açıklama
Haritalar .xslt Daha fazla bilgi için bkz. İş akışlarında dönüşümler için haritalar ekleme.
Şemalar .xsd Daha fazla bilgi için bkz. Doğrulama için şema ekleme.
Kurallar .xml Daha fazla bilgi için bkz. Azure Logic Apps Kural Altyapısı projesi oluşturma.
Bileşenler - .dll (.NET Framework veya .NET 8)

- .jar (Java)
Standart mantıksal uygulama kaynağı, Visual Studio Code'da projenize yükleyebileceğiniz belirli derleme türlerini kullanabilir veya bunlara başvurabilir. Ancak, bunları belirli proje klasörlerine eklemeniz gerekir. Daha fazla bilgi için bkz. Başvurulan derlemeleri ekleyin.

Not: Derleme desteği sunulmadan önce NuGet paket tabanlı (.NET) mantıksal uygulama projeniz varsa, bkz. Lib klasöründeki derlemeleri kullanmak için NuGet paket tabanlı projeleri derlemeler kullanacak şekilde taşıma.

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

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

Önemli

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

  1. Gezgin bölmesinde, fare işaretçinizi projenizin klasörlerinin ve dosyalarının 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 altındaki 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.

NuGet paket tabanlı projeleri "lib" klasöründeki derlemeleri kullanacak şekilde geçirme

Önemli

Bu görev yalnızca derleme desteği kullanıma sunulmadan önce oluşturulan NuGet paket tabanlı (.NET) 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 < 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, < 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ü.

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 uzantı paketi tabanlı (Node.js) projenizi NuGet paket tabanlı (.NET) projesine 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.

İş akışlarını yerel olarak çalıştırma, hata ayıklama ve test

Aşağıdaki bölümlerde, iş akışınızı yerel olarak çalıştırmak ve test etmek için kesme noktaları ayarlama ve hata ayıklama oturumu başlatma adımları gösterilmektedir.

Hata ayıklama için kesme noktaları ayarlama

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.

Kesme noktaları şu anda sadece eylemler için desteklenmektedir, tetikleyiciler için değil. 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 sırasında kesme noktası tetiklendiğinde, değerlendirme öncesinde 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ı gerçekleştiğinde, eylemin tamamlanması bitmeden önce eylemin sonuçlarını inceleyebilirsiniz.

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

  1. Hata ayıklamak istediğiniz iş akışı için 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.

    Uyarı

    Ç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ışma başladıktan sonra workflow.json dosyasını güncelleştirirseniz, kesme noktaları otomatik olarak güncellenmez. 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.

İş akışınızda hata ayıklama ve test

İş akışınızı test etmek için bu adımları izleyerek bir hata ayıklama oturumu çalıştırı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. Eğer durum bilgisi olmayan bir iş akışınız varsa, hata düzeltmesini kolaylaştırmak için iş akışı için çalıştırma geçmişini etkinleştirin.

  2. Çalıştır menüsünden Hata Ayıklamayı Başlat (F5) seçin.

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

    Uyarı

    "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.

  3. Şimdi İstek tetikleyicisi tarafından oluşturulan uç noktanın geri çağırma URL'sini bulun.

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

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

      workflow.json dosyasının kısayol menüsünde Genel Bakış seçeneğinin seçili olduğu Gezgin bölmesini gösteren ekran görüntüsü.

    3. Bu örnekte http isteği alındığında tetikleyicisi için aşağıdaki URL'ye benzer şekilde görünen Geri Arama URL'sini kopyalayın ve kaydedin:

      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ü.

  4. Geri çağırma URL'sini test etmek ve iş akışını tetiklamak için HTTP isteği aracınızı ve yönergelerini kullanarak, tetikleyicinin beklediği yöntem de dahil olmak üzere URL'ye bir HTTP isteği gönderin.

    Bu örnekte, aşağıdaki örneğe benzer şekilde kopyalanan URL ile GET yöntemi kullanılmaktadır:

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

    Tetikleyici tetiklendiğinde, örnek iş akışı çalıştırılır ve bu örneğe benzer bir e-posta gönderir:

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

  5. Visual Studio Code'da iş akışınızın genel bakış sayfasına dönün. Çalıştırma geçmişi altında iş akışının çalıştırılma durumunu kontrol edin.

    Tavsiye

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

    Çalışma durumu ve geçmişiyle iş akışının genel bakış sayfasını 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
    Durduruldu 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 iptal isteği alındı.
    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ı.
    Koşuyor Ç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. Koşunun süresi, koşunun başlangıç saati ve başlangıç anındaki süre 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 süresi zaman aşımına uğrasa da tamamlansa da, bekletme süresi her zaman çalıştırmanın başlangıç saati ve geçerli bekletme sınırı kullanılarak hesaplanır. Bu nedenle, çalıştırmanın uçuş sırasında süre sınırını azaltırsanız, çalıştırma zaman aşımına uğrar. Ancak, çalıştırmanın süresi bekletme sınırını aşıp aşmadığına bağlı olarak ya çalışmaya devam eder ya da ç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.
  6. Belirli bir iş akışı çalıştırması için her adımın durumunu, girişlerini ve çıkışlarını görüntülemek için iki adımdan birini seçin:

    • Tanımlayıcı sütununda iş akışı çalıştırma kimliğini seçin.

    • Süre sütununun yanında, bir iş akışı çalıştırması için üç nokta (...) menüsünü açın ve Çalıştırmayı göster'i seçin, örneğ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 çalıştırma ayrıntıları görünümünü açar ve iş akışı çalıştırmasında her adımın durumunu gösterir.

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

    Uyarı

    Bir çalıştırma başarısız olduysa ve çalıştırma ayrıntıları 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
    Durduruldu 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.
    Koşuyor İşlem şu anda devam ediyor.
    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.
  7. Her adımın girişlerini ve çıkışlarını görüntülemek için, istediğiniz adımı seçin, örneğ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ü.

    Ham girişleri ve çıkışları görüntülemek için Ham girişleri göster'i veya Ham çıkışları göster'i seçin.

  8. 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

HTTP isteği alındığında tetikleyicisiyle başlayan bir iş akışınız olduğunda, iş akışınız Yanıt adlı İstek eylemini kullanarak ilk isteği gönderen çağırana bir yanıt döndürebilir.

  1. İş akışı tasarımcısında, E-posta gönder eyleminin altında, Yanıt adlı İstek eylemini eklemek için bu genel adımları izleyin.

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

  2. Yanıt eyleminin bilgi bölmesindeki Parametreler sekmesinde, arayana yanıt vermek 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, örneğin:

      Ekran görüntüsü, iş akışı tasarımcısını, Yanıt bilgileri bölmesini ve Gövde parametresinin, E-posta gönder adını taşıyan eylemden alınan Gövde çıktısına ayarlandığını göstermektedir.

  3. İş akışınızı kaydedin.

İş akışınızı yeniden test etme

Güncelleştirmelerinizi test etmek için hata ayıklayıcısını yeniden çalıştırabilir ve iş akışınızı tetikleyen başka bir istek gönderebilirsiniz. Örneğin, iş akışlarını yerel olarak çalıştırma, hata ayıklama ve test etme adımlarına benzer.

  1. Visual Studio Code araç çubuğunda, Çalıştırmenüsünden Hata Ayıklamayı Başlat 'ı (F5) seçin.

  2. İstek oluşturma ve gönderme aracınızda, iş akışınızı tetikleyen başka bir istek gönderin.

  3. İş akışının genel bakış sayfasındaki Çalıştırma geçmişi'nin altında en son çalıştırmanın durumunu denetleyin ve çalıştırma ayrıntıları görünümünü açın.

    Ö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.

Dağıtıma hazırlanma

Standart mantıksal uygulamanızı Azure portalına dağıtmadan önce, yapmanız gerekebilecek hazırlıklar için bu bölümü gözden geçirin.

Güvenlik duvarı erişimini ayarlama

Ortamınızda trafiği sınırlayan katı ağ gereksinimleri veya güvenlik duvarları varsa Azure tarafından yönetilen, barındırılan ve paylaşılan bağlayıcılar tarafından oluşturulan ve iş akışınızda kullanılan tüm 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 local.settings.json dosyasını açın.

  2. Oluşturduğunuz her bağlantı için, aşağıdaki söz dizimini kullanan adlı <connection-name>-ConnectionRuntimeUrlözelliğini bulun:

    "<connection-name>-ConnectionRuntimeUrl": <connection-runtime-URL>

    Örneğin, şu bağlantıları içeren örnek bir local.settings.json dosyanız olduğunu varsayalım: Office 365 bağlantısı ve AS2 bağlantısı. Bu bağlantılar, <connection-name>-ConnectionRuntimeUrl özellikleri için aşağıdaki ilgili örnek değerleri kullanır.

    • Office 365: "office365-ConnectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/office365/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1"

    • AS2: "as2-ConnectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/as2/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2

    Örnek local.settings.json dosyası aşağıdaki sürüme benzer:

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "UseDevelopmentStorage=true",
          "FUNCTIONS_WORKER_RUNTIME": "node",
          "APP_KIND": "workflowapp",
          "ProjectDirectoryPath": "c:\\Users\\<local-username>\\Desktop\\Visual Studio Code projects\\Azure Logic Apps\fabrikam-workflows\\Fabrikam-Workflows\\Fabrikam-Workflows",
          "WORKFLOWS_TENANT_ID": "<Microsoft-Entra-tenant-ID>",
          "WORKFLOWS_SUBSCRIPTION_ID": "<Azure-subscription-ID>",
          "WORKFLOWS_RESOURCE_GROUP_NAME": "Fabrikam-Workflows-RG",
          "WORKFLOWS_LOCATION_NAME": "westcentralus",
          "WORKFLOWS_MANAGEMENT_BASE_URI": "https://management.azure.com/",
          "as2-connectionKey": "<connection-key>",
          "as2-ConnectionRuntimeUrl": "https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/as2/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
          "office365-connectionKey": "<connection-key>",
          "office365-ConnectionRuntimeUrl": "https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/office365/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
       }
    }
    
  3. Güvenlik duvarınızı bu bilgilerle ayarlayabilmeniz için bu bağlantı çalışma zamanı URL'lerini kopyalayıp güvenli bir yere kaydedin.

  4. Hazır olduğunuzda, kaydedilen URL'leri kullanarak güvenlik duvarınızı ayarlayın. Daha fazla bilgi için, aşağıdaki belgelere bakın:

Azure’a dağıtın

Visual Studio Code'dan Standart mantıksal uygulamanı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. Veya mantıksal uygulamanızı, daha önce dağıtılmış olan Standart mantıksal uygulama kaynağına yayımlayarak mevcut sürümün üzerine yazabilirsiniz.

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 bkz . Barındırma planları ve fiyatlandırma katmanları.

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

  1. Gezgin bölmesinde, fare işaretçinizi projenizin klasör ve dosyalarının altındaki boş bir alanın üzerine getirin, kısayol menüsünü açın ve Mantıksal uygulamaya dağıt'ı seçin.

    Dağıtmak için açık dosyanız olmasına gerek olmasa da, dağıtmayı planladığınız her şeyi kaydettiğinizden emin olun.

    Ekran görüntüsü Gezgin bölmesini, proje altındaki boş alandan açılan kısayol menüsünü ve Mantıksal uygulamaya dağıt seçeneğini gösterir.

    Hedef Standart mantıksal uygulama kaynağı için aşağıdaki seçenekler istenir. Yeni bir Standart mantıksal uygulama oluşturabilir veya Azure'da dağıtılan mevcut bir Standart mantıksal uygulamayı seçebilirsiniz:

    • 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ılan Standart mantıksal uygulama kaynaklarından birini seçin.
  2. Dağıtım seçenekleri için var olan bir hedef mantıksal uygulama kaynağının oluşturulup oluşturulmayacağını veya kullanılacağını seçin.

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

    Özel adımlarla yeni bir standart mantıksal uygulama kaynağı oluşturmak için dağıtım seçenekleri listesini ve seçili seçeneği gösteren ekran görüntüsü.

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

    1. Hedef mantıksal uygulama için küresel olarak benzersiz bir ad girin.

      Bu örnekte Fabrikam-Workflows-App kullanılır.

      Hedef mantık uygulaması için benzersiz bir ad girme istemini gösteren ekran görüntüsü.

    2. Dağıtılacak konum için Azure bölgesini seçin.

      Bu örnekte Orta Batı ABD kullanılır.

    3. Barındırma planı için aşağıdaki seçeneklerden birini seçin:

      Barındırma planı Açıklama
      İş Akışı Standardı Tek kiracılı Azure Logic Apps'te barındırılan yeni bir Standart mantıksal uygulama kaynağı olarak dağıtın.
      Melez Kendi altyapınızda barındırılan bir Standart mantıksal uygulama olarak dağıtın.

      Not: Bu seçeneği belirlemeden önce gerekli altyapıyı ayarladığınızdan emin olun. Daha fazla bilgi için bkz. Karma dağıtımı kullanarak Standart mantıksal uygulamalar için kendi altyapınızı ayarlama.
    4. Windows App Service planı için aşağıdaki seçeneklerden birini belirleyin:

      • Yeni bir Uygulama Hizmeti planı oluştur
      • Varsa, seçili Azure bölgesindeki mevcut App Service planlarından birini seçin (yalnızca Windows tabanlı planlar).

      Bu örnek Yeni App Service planı oluştur'u seçer.

    5. Yeni plan için genel olarak benzersiz bir ad sağlayın ve bir fiyatlandırma katmanı seçin.

      Bu örnekte Fabrikam-Workflows-App-Service-Plan kullanılır ve WS1 İş Akışı Standart katmanı seçilir.

      Daha fazla bilgi için bkz . Barındırma planları ve fiyatlandırma katmanları.

    6. Hedef Azure kaynak grubu için en iyi performans için projenizle aynı kaynak grubunu seçin.

      Bu örnek, Fabrikam-Workflows-RG adlı daha önce oluşturulmuş aynı grubu kullanır.

      Uyarı

      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.

    7. Azure depolama hesabının çalıştırma geçmişi bilgilerinin kaydedilmesini sağlayan iş akışlarıyla kullanması için aşağıdaki seçeneklerden birini seçin:

      • Yeni depolama hesabı oluşturma
      • Varsa mevcut Azure depolama hesaplarından seçim yapın.

      Bu örnek , Yeni depolama hesabı oluştur'u seçer.

    8. Depolama hesabı için genel olarak benzersiz bir ad girin. Yalnızca küçük harfler ve sayılar kullanabilirsiniz.

      Bu örnekte fabrikamstorageaccount<number kullanılır>.

    9. Bu örnekte SQL depolama kullanma seçeneği için Hayır'ı seçin.

      Standart mantıksal uygulama iş akışları için SQL veritabanı depolama alanını ayarlama'yı izleyerek depolama için kullanılacak bir SQL veritabanı ayarladıysanız Evet'i seçebilirsiniz.

    10. Mantıksal uygulamanız için tanılama günlüğünü ve izlemeyi etkinleştiren Application Insights kaynağı için aşağıdaki seçeneklerden birini seçin:

      • Yeni Application Insights kaynağı oluşturma
      • Şimdilik atlayın. Dağıtımdan sonra Application Insights'i ayarlayabilirsiniz.
      • Varsa mevcut bir Application Insights kaynağını seçin.

      Bu örnek şimdilik Atla'yı seçer.

      Uyarı

      • Kullanmak istediğiniz bir Application Insights kaynağınız varsa bu kaynağı seçebilirsiniz.

      • Diagnostik günlükleme ve izlemeyi etkinleştirebilmeniz için şu anda yeni bir Application Insights kaynağı oluşturmak istiyorsanız, Dağıtım sırasında Application Insights'ı etkinleştirme bölümüne bakın.

      Application Insights hakkında daha fazla bilgi için aşağıdaki belgelere bakın:

      Şimdilik atla'yı veya mevcut bir Application Insights kaynağını seçtikten sonra, Visual Studio Code dağıtımı başlatmak için bir onay iletisi gösterir. İleti ayrıca en iyi performans için yönetilen işlemler için bağlantı kaynaklarını mantıksal uygulama kaynağınız ve iş akışlarınızla aynı kaynak grubuna yerleştirmenizi önerir. Azure Logic Apps'te yönetilen işlem bağlantıları tek tek Azure kaynakları olarak bulunur.

      Dağıt ve İptal seçeneklerini içeren onay iletisini gösteren ekran görüntüsü.

  4. Dağıtmaya hazır olduğunuzda, onay iletisinde Dağıt'ı seçin.

    Visual Studio Code, mantıksal uygulamanızı Azure'da yayımlamak için gerekli kaynakları oluşturmaya ve dağıtmaya başlar.

  5. Dağıtım işlemini görüntülemek ve izlemek için Görünüm menüsünde Çıkış'ı seçin.

  6. Çıkış penceresi araç çubuğunda, kapsam listesinden Azure Logic Apps (Standart) öğesini seçin.

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

    Visual Studio Code mantıksal uygulamanızı Azure'a dağıtmayı tamamladığında, mantıksal uygulama oluşturma işleminin başarıyla tamamlandığını belirten bir ileti görüntülenir, örneğin:

    Mantıksal uygulama oluşturma işleminin başarıyla tamamlandığını belirten bir iletiyi gösteren ekran görüntüsü.

    Mantıksal uygulama kaynağınız ve iş akışınız artık Azure'da canlı, etkin ve çalışıyor.

Dağıtım sırasında Application Insights'i etkinleştirme

Mantıksal uygulamanızın dağıtımı sırasında Application Insights ile tanılama günlüğünü ve izlemeyi etkinleştirmek için şu adımları izleyin:

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

  2. Azure portalında Application Insights 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.

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

      {
         "IsEncrypted": false,
         "Values": {
            "AzureWebJobsStorage": "UseDevelopmentStorage=true",
            "FUNCTIONS_WORKER_RUNTIME": "dotnet",
            "APPINSIGHTS_INSTRUMENTATIONKEY": <instrumentation-key>
         }
      }
      
    2. İş akışı tetikleyicisinin ve eylem adlarının Application Insights örneğinizde doğru görünup görünmediğini denetleyin.

      1. Azure portalında Application Insights 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 kopyalar, WorkflowName.ActionName biçimini kullanmaktan ziyade iş akışı adını işlem adı olarak kullanır ve Azure İşlevleri konağından kaynaklanır.

    3. İsteğe bağlı olarak mantıksal uygulamanızın topladığı ve Application Insights örneğine gönderdiği izleme verilerinin önem düzeyini ayarlayın.

      İş 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.
      • İş akışı etkinlikleri, tetikleme, eylem ve çalışma gibi unsurları içerir.
      • Başarı veya başarısızlık gibi depolama isteği etkinliği.
      • 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.

      Aşağıdaki tabloda önem düzeyleri ve bunların izleme türleri açıklanmaktadır:

      Önem derecesi İzleme türü
      Kritik Mantıksal uygulama iş akışını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ı).
      Hatası İş akışı yürütülmesinde bir hata olduğunu ancak mantıksal uygulamanızda genel bir hata olmadığını gösteren günlükler.
      Bilgi 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 nesnesini bulun logging . 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
               }
            }
         }
      }
      

      Eğer logging nesnesi logLevel özelliğini içeren bir Host.Triggers.Workflow nesnesi 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 sonrası görevler

Aşağıdaki bölümlerde mantıksal uygulamanız dağıtımı tamamladıktan sonra gerçekleştirilecek görevler açıklanmaktadır.

Azure portalında dağıtımı onaylama

Mantıksal uygulamanızı Visual Studio Code'dan Azure portalına dağıttığınızda mantıksal uygulamanızın portalda göründüğünü onaylayın. Azure kaynakları portalda kendi kaynak türlerine göre düzenlenir ve gruplandırılır. Standart mantıksal uygulamaları bulmak için şu adımları izleyin:

  1. Azure hesabınızla Azure portalında oturum açın.

  2. Azure başlığı arama kutusuna mantıksal uygulamanızın adını girin. Bu, Kaynaklar bölümünde sonuç olarak görünür. Kaynağı açmak için mantıksal uygulamanızı seçin.

    Mantıksal uygulama adının girilmiş olduğu Azure arama kutusunu gösteren ekran görüntüsü.

  3. Mantıksal uygulama menüsündeki İş Akışları'nın altında İş Akışları'nı seçin.

  4. İş Akışları sayfasında iş akışınızı seçin.

  5. İş akışı menüsündeki Araçlar'ın altında Tasarımcı'yı seçin. İş akışının beklendiği gibi göründüğünü onaylayın.

    Ekran görüntüsü, Visual Studio Code ve tasarımcıdan dağıtılan mantıksal uygulamayı ve daha önce oluşturulmuş iş akışını gösteriyor.

    Artık Azure portalında bu iş akışında değişiklik yapabilirsiniz.

  6. İş akışı çalıştırma geçmişini, girişleri, çıkışları ve diğer ilgili bilgileri görüntüleyebilmek için dağıtılan mantıksal uygulamanız için izleme deneyimini etkinleştirdiğinizden emin olun.

Dağıtılan mantıksal uygulama için izleme deneyimini etkinleştirme

Azure portalında izleme deneyimiyle dağıtılan Standart mantıksal uygulama kaynağının iş akışı çalıştırma geçmişini, girişlerini, çıkışlarını ve ilgili bilgilerini gözden geçirebilmeniz için önce mantıksal uygulama kaynağında bu deneyimi etkinleştirmeniz gerekir.

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

  2. 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 Application Insights'i etkinleştirme veya açma

İş akışı yürütme sırasında mantıksal uygulama iş akışınız diğer olaylarla birlikte telemetri de yayar. İş akışınızın ne kadar iyi çalıştığına ve Azure Logic Apps çalışma zamanının nasıl çalıştığına ilişkin daha iyi görünürlük elde etmek için bu telemetriyi kullanabilirsiniz. Application Insights, neredeyse gerçek zamanlı telemetri (canlı metrikler) kullanarak mantıksal uygulamanızda tanılama günlüğünü, izlemeyi ve gözlemi etkinleştirmenizi sağlar. Bu özellik, sorunları tanılamak, uyarıları ayarlamak ve grafikler oluşturmak için telemetri verilerini kullandığınızda hataları ve performans sorunlarını daha kolay araştırmanıza yardımcı olur.

  • Application Insights'ı daha önce ayarlamadıysanız Visual Studio Code'dan mantıksal uygulama dağıtımından sonra Azure portalında bu özelliği etkinleştirebilirsiniz. Azure'da bir Application Insights kaynağınız olması gerekir, ancak bu kaynağı önceden veya dağıtımdan sonra etkinleştirdiğinizde ayrı ayrı oluşturabilirsiniz.

  • Daha önce Visual Studio Code'dan dağıtım sırasında Application Insights'ı ayarladıysanız Azure portalında mantıksal uygulamanızdan Application Insights kaynağınızı açabilirsiniz.

Dağıtılan bir mantıksal uygulama için Application Insights'i etkinleştirme

  1. Azure portalında dağıtılan mantıksal uygulamanızı bulun ve açın.

  2. Mantıksal uygulama menüsündeki İzleme'nin altında Application Insights'ı seçin.

  3. Application Insights sayfasında Application Insights'ı etkinleştir seçeneğini seçin.

  4. Application Insights sayfası güncelleştirildikten sonra Kaynağınızı değiştirin bölümünde aşağıdaki seçeneklerden birini belirleyin:

    • Yeni kaynak oluşturma

      Azure, geçerli aboneliği ve kaynak grubunu kullanarak Application Insights ve Log Analytics çalışma alanı için kaynaklar oluşturur. Farklı bir abonelik ve kaynak grubu kullanmak istiyorsanız bkz. Yeni Application Insights kaynağı oluşturma ve bu sayfaya geri dönme.

      Mülkiyet Açıklama
      Yeni kaynak adı Oluşturulan adı kabul edin veya başka bir ad girin.
      Konum Bir Azure bölgesi seçin.
      Log Analytics çalışma alanı Varsa var olan bir çalışma alanını seçin. Aksi takdirde, sizin için varsayılan bir çalışma alanı oluşturulur. Daha fazla bilgi için bkz . Log Analytics çalışma alanına genel bakış.
    • Mevcut kaynağı seçin:

      1. Application Insights kaynağınız için Azure aboneliğini seçin.

      2. Application Insights kaynağınızı seçin.

  5. İşiniz bittiğinde, sayfanın alt kısmında Uygula'yı seçin.

Mantıksal uygulamanızdan Application Insights'i açma

  1. Azure portalında dağıtılan mantıksal uygulamanızı bulun ve açın.

  2. Mantıksal uygulama menüsündeki İzleme'nin altında Application Insights'ı seçin.

  3. Application Insights sayfasında Application Insights kaynağınızın bağlantısını seçin.

Application Insights açıldıktan sonra mantıksal uygulamanız için çeşitli ölçümleri gözden geçirebilirsiniz. Daha fazla bilgi için şu makalelere bakın:

Hataları ve sorunları giderme

Tasarımcı 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çmaya çalıştıysanız ancak projenizi sonlandırdıysanız veya sildiyseniz uzantı paketi doğru indirilmeyebilir. Nedeninin bu olup olmadığını denetlemek için şu adımları izleyin:

  1. Visual Studio Code'da Çıkış penceresini açın. Görünümmenü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:

    Kapsam listesinin ve Azure Logic Apps'in (Standart) seçili olduğu Çıkış penceresini gösteren ekran görüntüsü.

  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 '<operation-ID>'.
    System.Private.CoreLib: The file 'C:\Users\<user-name>\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\<user-name>\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ğlayıcıları 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.

Uyarı

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 Code'ı 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\<user-name>\.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\<user-name>\.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'ye göre ayarlamak için, aşağıdaki adımları izleyerek bilgisayarınızdaki UrlSegmentMaxCount ve UrlSegmentMaxLength kayıt defteri anahtarlarını düzenleyin. Bu anahtarın varsayılan değerleri windows için kayıt defteri ayarlarıHttp.sys bu makalede 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ölmedeki Bilgisayar'ın altında, yol boyunca düğümleri genişletin ,HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP\Parametersve ardından Parametreler'i seçin.

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

  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, onaltılık olarak 400, ondalık olarak 1024 ile 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** klasörünü 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
     }