Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Ş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.
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
Ücretsiz olan Visual Studio Code'u indirin ve yükleyin.
Aşağıdaki adımları izleyerek Visual Studio Code için Azure Logic Apps (Standart) uzantısını indirin ve yükleyin:
Visual Studio Code'daki Etkinlik çubuğunda Uzantılar'ı seçin. (Klavye: Ctrl+Shift+X tuşlarına basın)
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.
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.
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ı.
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.
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.
Örnek iş akışını test etmek için HTTP istekleri gönderebilen bir araç yükleyin veya kullanın, örneğin:
- Visual Studio CodeVisual Studio Marketplace'ten bir uzantı ile
- PowerShell Invoke-RestMethod
- Microsoft Edge - Ağ Konsolu aracı
- Bruno
- Curl
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
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.
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.
Dosya menüsünde Tercihler>Ayarları'na gidin.
Kullanıcı sekmesinde Özellikler>Uzantıları'na gidin.
Güncelleştirmeleri Otomatik Denetle'nin seçili olduğundan ve Otomatik Güncelleştirme'ninTüm Uzantılar olarak ayarlandığından emin olun.
Azure Logic Apps Standard: Project Runtime ayarının doğru sürüme ayarlandığını onaylayın:
Kullanıcı sekmesinde >> bölümüne gidin.
Project Runtime'ın~4 sürümüne ayarlandığından emin olun, örneğin:
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:
Visual Studio Code'daki Etkinlik Çubuğu'nda Azure simgesini seçerek Azure bölmesini açın.
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.
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:
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.
Alternatif olarak, Visual Studio Code durum çubuğunda Azure hesabınızı seçin.
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.
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.
Visual Studio Code'da tüm açık klasörleri kapatın.
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.
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.
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).
Visual Studio Code araç çubuğunda, çalışma alanınızı adlandırmanız için bir istem görüntülenir.
Çalışma alanı adı sağlayın alanında, kullanılacak çalışma alanı adını girin.
Bu örnekte Fabrikam-Workflows kullanılır.
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.
Proje şablonunuz için Mantıksal uygulama'yı seçin. Kullanılacak proje adını girin.
Bu örnekte Fabrikam-Workflows kullanılır.
İş 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.
Ş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:
İş 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.
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.
Abonelik için mantıksal uygulama projenizle kullanılacak Azure aboneliğini seçin.
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.
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.
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:
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
İş 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:
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:
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.
Uyarı
Tetikleyici bilgileri bölmesi görünmüyorsa, tasarımcıda tetikleyicinin seçili olduğundan emin olun.
İş akışınızı kaydedin. Tasarımcı araç çubuğunda Kaydet'i seçin.
Office 365 Outlook eylemini ekleme
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:
Eylemin kimlik doğrulama bölmesi görüntülendiğinde Oturum aç'ı seçerek e-posta hesabınızla bağlantı oluşturun.
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.
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.
Azure Logic Apps bir Visual Studio Code bağlantısı açmak isteyip istemediğinizi sorarsa Aç'ı seçin.
Visual Studio Code uzantının Microsoft Azure Araçları'nı açmasını isteyip istemediğinizi sorarsa Aç'ı 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ı 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.
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:
İş 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
ngrok web sitesine gidin. Yeni bir hesap için kaydolun veya hesabınız varsa hesabınızda oturum açın.
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.
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.
Kimlik Doğrulamanız kutusunda belirteci güvenli bir konuma kopyalayın.
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.
Bilgisayarınızda komut istemi aracınızı açın. ngrok.exe dosyasının bulunduğu konuma gidin.
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.
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.
Çıktıdan aşağıdaki satırı bulun:
http://<domain>.ngrok.io -> http://localhost:7071
Bu biçime sahip URL'yi kopyalayın ve kaydedin:
http://<domain>.ngrok.io
Uygulama ayarlarınızda iletme URL'sini ayarlama
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.
İ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
nesnesindeWorkflows.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 true
ayarlandığı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.
Visual Studio Code projenizde kök klasör düzeyinde local.settings.json dosyasını açın.
Workflows.<workflow-name>.operationOptions
özelliğini ekleyin ve değeriniWithStatelessRunHistory
olarak 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" } }
workflow-designtime adlı proje klasöründe local.settings.json dosyasını açın ve aynı değişikliği yapın.
Çalıştırma geçmişini devre dışı bırakmak için işiniz bittiğinde,
Workflows.<workflow-name>.OperationOptions
özelliğiniNone
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.
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.
İ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:
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:
Henüz yapmadıysanız uzantı paketi tabanlı (Node.js) projenizi NuGet paket tabanlı (.NET) projesine dönüştürün.
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:
Hata ayıklamak istediğiniz iş akışı için workflow.json dosyasını açın.
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.
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.
İş 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.
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.
Ç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.
Şimdi İstek tetikleyicisi tarafından oluşturulan uç noktanın geri çağırma URL'sini bulun.
Projenizi görüntülemek için Gezgin bölmesini yeniden açın.
workflow.json dosya kısayol menüsünden Genel Bakış'ı seçin.
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 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:
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.
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. 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:
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.
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. Her adımın girişlerini ve çıkışlarını görüntülemek için, istediğiniz adımı seçin, örneğin:
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.
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.
İş 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.
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.
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.
Dinamik içerik listesinde, E-posta gönder'in altında Gövde'yi seçin.
İş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:
İş 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.
Visual Studio Code araç çubuğunda, Çalıştırmenüsünden Hata Ayıklamayı Başlat 'ı (F5) seçin.
İstek oluşturma ve gönderme aracınızda, iş akışınızı tetikleyen başka bir istek gönderin.
İş 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.
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:
Mantıksal uygulama projenizde local.settings.json dosyasını açın.
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", } }
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.
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
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.
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.
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.
Yeni hedef mantıksal uygulama kaynağını oluşturmak için şu adımları izleyin:
Hedef mantıksal uygulama için küresel olarak benzersiz bir ad girin.
Bu örnekte Fabrikam-Workflows-App kullanılır.
Dağıtılacak konum için Azure bölgesini seçin.
Bu örnekte Orta Batı ABD kullanılır.
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.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.
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ı.
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.
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.
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>.
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.
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ğı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.
Dağıtım işlemini görüntülemek ve izlemek için Görünüm menüsünde Çıkış'ı seçin.
Çıkış penceresi araç çubuğunda, kapsam listesinden Azure Logic Apps (Standart) öğesini seçin.
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 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:
Mevcut bir Application Insights kaynağını veya Yeni Application Insights kaynağı oluştur'u seçin.
Azure portalında Application Insights kaynağınıza gidin.
Kaynak menüsünde Genel Bakış'ı seçin. İzleme Anahtarı değerini bulun ve kopyalayın.
Visual Studio Code'da, projenizin kök klasöründe local.settings.json dosyasını açın.
Values
nesnesineAPPINSIGHTS_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> } }
İş akışı tetikleyicisinin ve eylem adlarının Application Insights örneğinizde doğru görünup görünmediğini denetleyin.
Azure portalında Application Insights kaynağınıza gidin.
Kaynak menüsündeki Araştır'ın altında Uygulama haritası'nı seçin.
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.
İ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 yakalarkenInformation
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
nesnesilogLevel
özelliğini içeren birHost.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:
Azure hesabınızla Azure portalında oturum açın.
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 menüsündeki İş Akışları'nın altında İş Akışları'nı seçin.
İş Akışları sayfasında iş akışınızı seçin.
İş 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.
Artık Azure portalında bu iş akışında değişiklik yapabilirsiniz.
İş 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.
Azure portalında dağıtılan Standart mantıksal uygulama kaynağını açın.
Kaynak menüsünde, API'nin altında CORS'yi seçin.
CORS bölmesindeki İzin Verilen Çıkış Noktaları'nın altında (*) joker karakterini ekleyin.
İşiniz bittiğinde CORS araç çubuğunda Kaydet'i seçin.
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
Azure portalında dağıtılan mantıksal uygulamanızı bulun ve açın.
Mantıksal uygulama menüsündeki İzleme'nin altında Application Insights'ı seçin.
Application Insights sayfasında Application Insights'ı etkinleştir seçeneğini seçin.
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:
Application Insights kaynağınız için Azure aboneliğini seçin.
Application Insights kaynağınızı seçin.
İşiniz bittiğinde, sayfanın alt kısmında Uygula'yı seçin.
Mantıksal uygulamanızdan Application Insights'i açma
Azure portalında dağıtılan mantıksal uygulamanızı bulun ve açın.
Mantıksal uygulama menüsündeki İzleme'nin altında Application Insights'ı seçin.
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:
- Her Yerde Çalışan Azure Logic Apps - Application Insights ile İzleme - bölüm 1
- Her Yerde Çalışan Azure Logic Apps - Application Insights ile İzleme - bölüm 2
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:
Visual Studio Code'da Çıkış penceresini açın. Görünümmenüsünden Çıkış'ı seçin.
Çı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:
Çı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.Workflows
gü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.
Kaybetmek istemediğiniz tüm çalışmaları kaydedin ve Visual Studio Code'ı kapatın.
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
Ö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.
Ş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
Önceki paketin sürüm klasörünü silin.
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.
Bilgisayarınızda Çalıştır penceresini açın ve kayıt defteri düzenleyicisini
regedit
açan komutunu çalıştırın.Bilgisayarınızda yaptığınız değişikliklere izin vermek için Kullanıcı Hesabı Denetimi kutusunda Evet'i seçin.
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.
Sağ bölmede
UrlSegmentMaxCount
veUrlSegmentMaxLength
kayıt defteri anahtarlarını bulun.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:
Parametreler kısayol menüsünden Yeni>DWORD (32 bit) Değer'i seçin.
Görüntülenen düzenleme kutusuna yeni anahtar adı olarak girin
UrlSegmentMaxCount
.Yeni tuşun kısayol menüsünü açın ve Değiştir'i seçin.
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 olarak1024
ile eşdeğerdir.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:
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.
Projenizde.vscode** klasörünü genişletin ve tasks.json dosyasını açın.
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 }