Visual Studio Code kullanarak tek kiracılı Azure Logic Apps için Standart mantıksal uygulama iş akışı oluşturma
Şunlar için geçerlidir: Azure Logic Apps (Standart)
Bu nasıl yapılır kılavuzunda, Azure Logic Apps (Standart) uzantısıyla Visual Studio Code kullanarak tek kiracılı Azure Logic Apps'te çalışan örnek bir tümleştirme iş akışının nasıl oluşturulacağı gösterilmektedir. Bu iş akışını oluşturmadan önce, aşağıdaki özellikleri sağlayan bir Standart mantıksal uygulama kaynağı oluşturacaksınız:
Mantıksal uygulamanız birden çok durum bilgisi olan ve durum bilgisi olmayan iş akışı içerebilir.
Aynı mantıksal uygulama ve kiracıdaki iş akışları Azure Logic Apps çalışma zamanıyla aynı işlemde çalıştırıldığından, aynı kaynakları paylaşır ve daha iyi performans sağlar.
Visual Studio Code geliştirme ortamını kullanarak iş akışlarını yerel olarak oluşturabilir, çalıştırabilir ve test edebilirsiniz.
Hazır olduğunuzda mantıksal uygulamanızı Azure'a dağıtabilir ve burada iş akışınız tek kiracılı Azure Logic Apps ortamında veya App Service Ortamı v3'te (yalnızca Windows tabanlı App Service planları) çalıştırılabilir. Azure Logic Apps kapsayıcılı çalışma zamanı nedeniyle iş akışınızı Azure, Azure Kubernetes Service, şirket içi ve hatta diğer bulut sağlayıcıları da dahil olmak üzere Kubernetes'in çalıştırabileceği her yerde dağıtabilir ve çalıştırabilirsiniz. Tek kiracılı Azure Logic Apps hakkında daha fazla bilgi için , Tek kiracılı ve çok kiracılı ve tümleştirme hizmeti ortamı karşılaştırması bölümünü gözden geçirin.
Örnek iş akışı bulut tabanlı olsa ve yalnızca iki adıma sahip olsa da, bulut, şirket içi ve hibrit ortamlarda çok çeşitli uygulamaları, verileri, hizmetleri ve sistemleri birbirine bağlayacak yüzlerce işlemden iş akışları oluşturabilirsiniz. Örnek iş akışı yerleşik İstek tetikleyicisiyle başlar ve Office 365 Outlook eylemiyle devam eder. Tetikleyici, iş akışı için çağrılabilen bir uç nokta oluşturur ve herhangi bir çağıranın gelen HTTPS isteğini bekler. Tetikleyici bir istek aldığında ve tetiklendiğinde, bir sonraki eylem belirtilen e-posta adresine e-posta göndererek ve tetikleyiciden seçilen çıkışlarla birlikte çalıştırılır.
İpucu
Office 365 hesabınız yoksa, e-posta hesabınızdan ileti gönderebilen diğer kullanılabilir eylemleri (örneğin, Outlook.com) kullanabilirsiniz.
Bunun yerine Azure portal kullanarak bu örnek iş akışını oluşturmak için, Tek kiracılı Azure Logic Apps'i ve Azure portal kullanarak tümleştirme iş akışları oluşturma bölümündeki adımları izleyin. Her iki seçenek de mantıksal uygulama iş akışlarını aynı tür ortamlarda geliştirme, çalıştırma ve dağıtma özelliği sağlar. Ancak Visual Studio Code ile geliştirme ortamınızda iş akışlarını yerel olarak geliştirebilir, test edebilir ve çalıştırabilirsiniz.
İlerledikçe şu üst düzey görevleri tamamlayacaksınız:
- Mantıksal uygulamanız için bir proje ve durum bilgisi olan boş bir iş akışı oluşturun.
- Tetikleyici ve eylem ekleyin.
- Çalıştırma geçmişini yerel olarak çalıştırma, test etme, hata ayıklama ve gözden geçirme.
- Güvenlik duvarı erişimi için etki alanı adı ayrıntılarını bulun.
- İsteğe bağlı olarak Application Insights'ı etkinleştirmeyi de içeren Azure'a dağıtın.
- Dağıtılan mantıksal uygulamanızı Visual Studio Code ve Azure portal yönetin.
- Durum bilgisi olmayan iş akışları için çalıştırma geçmişini etkinleştirin.
- Dağıtımdan sonra Application Insights'i etkinleştirin veya açın.
Önkoşullar
Erişim ve bağlantı
Gereksinimleri indirebilmeniz, Visual Studio Code'dan Azure hesabınıza bağlanabilmeniz ve Visual Studio Code'dan Azure'da yayımlayabilmeniz için İnternet'e erişin.
Bir Azure hesabı ve aboneliği Aboneliğiniz yoksa, ücretsiz bir Azure hesabı için kaydolun.
Bu makaledeki ö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ına ihtiyacınız vardır.
Outlook.com gibi farklı bir e-posta bağlayıcısı seçerseniz yine de örneği izleyebilirsiniz ve genel adımlar aynıdır. Ancak seçenekleriniz bazı yönlerden farklılık gösterebilir. Örneğin, Outlook.com bağlayıcısını kullanıyorsanız oturum açmak için bunun yerine kişisel Microsoft hesabınızı kullanın.
Depolama gereksinimleri
Visual Studio Code'da yerel geliştirme için mantıksal uygulama projeniz ve iş akışlarınız için yerel geliştirme ortamınızda çalıştırmak üzere kullanılacak yerel bir veri deposu ayarlamanız gerekir. Azurite depolama öykünücüsünüzü yerel veri deponuz olarak kullanabilir ve çalıştırabilirsiniz.
Windows, macOS veya Linux işletim sisteminiz için Azurite 3.12.0 veya üzerini indirip yükleyin. Visual Studio Code içinden veya npm kullanarak yükleyebilirsiniz.
Mantıksal uygulama iş akışınızı çalıştırmadan önce öykünücüyü başlattığınızdan emin olun.
Daha fazla bilgi için Azurite belgelerini gözden geçirin.
Araçlar
Belirli işletim sisteminiz için aşağıdaki araçları ve sürümleri yükleyin: Windows, macOS veya Linux.
Visual Studio Code, ücretsiz. Ayrıca, Visual Studio Code için bu araçları indirin ve yükleyin( henüz yoksa):
Visual Studio Code'daki diğer tüm Azure uzantıları için tek bir ortak Azure oturum açma ve abonelik filtreleme deneyimi sağlayan Azure Hesabı uzantısı.
F5 işlevselliğinin mantıksal uygulama iş akışınızı çalıştırmasını sağlayan Visual Studio Code uzantısı için C# .
Azure Logic Apps (Standart) çalışma zamanı için önkoşul olan .NET Çalışma Zamanı 6.x.x'i içeren .NET SDK 6.x.x.
Azure İşlevleri Core Tools - 4.x sürümü
Bu araçlar, Azure Logic Apps (Standart) uzantısının Visual Studio Code kullandığı Azure İşlevleri çalışma zamanını destekleyen aynı çalışma zamanının bir sürümünü içerir.
Bu sürümlerden önceki bir yüklemeniz varsa, önce bu sürümü kaldırın veya PATH ortam değişkeninin indirdiğiniz ve yüklediğiniz sürüme işaretdiğinden emin olun.
Azure Logic Apps'te Azure İşlevleri v3 desteği 31 Mart 2023'te sona eriyor. Ekim 2022'nin ortasından itibaren, Azure portal yeni Standart mantıksal uygulama iş akışları otomatik olarak Azure İşlevleri v4 kullanır. 31 Ocak 2023'ten bu yana, Azure portal mevcut Standart iş akışları otomatik olarak Azure İşlevleri v4'e geçirildi.
Standart mantıksal uygulamalarınızı NuGet tabanlı projeler olarak dağıtmadığınız, mantıksal uygulamalarınızı belirli bir paket sürümüne sabitlemediğiniz veya Microsoft otomatik geçişten önce işlem yapmanız gerektiğini belirlemediğiniz sürece, bu yükseltme sizden hiçbir eylem gerektirmek veya çalışma zamanı etkisine sahip olmak üzere tasarlanmıştır. Ancak özel durumlar sizin için geçerliyse veya Azure İşlevleri v3 desteği hakkında daha fazla bilgi için bkz. Azure Logic Apps Standard artık Azure İşlevleri v4'i destekliyor.
Visual Studio Code için Azure Logic Apps (Standart) uzantısı.
Önemli
Önceki önizleme uzantılarıyla oluşturulan projeler artık çalışmıyor. Devam etmek için önceki sürümleri kaldırın ve mantıksal uygulama projelerinizi yeniden oluşturun.
Azure Logic Apps (Standart) uzantısını yüklemek için şu adımları izleyin:
Visual Studio Code sol araç çubuğunda Uzantılar'ı seçin.
Uzantılar arama kutusuna yazın
azure logic apps standard
. Sonuçlar listesinden Azure Logic Apps (Standart)Yükle'yi> seçin.Yükleme tamamlandıktan sonra uzantı Uzantılar: Yüklü listesinde görünür.
İpucu
Uzantı yüklü listede görünmüyorsa Visual Studio Code yeniden başlatmayı deneyin.
Şu anda, aynı anda hem Tüketim (çok kiracılı) hem de Standart (tek kiracılı) uzantıları yükleyebilirsiniz. Geliştirme deneyimleri birbirinden bazı açılardan farklıdır, ancak Azure aboneliğiniz hem Standart hem de Tüketim mantıksal uygulama türlerini içerebilir. Visual Studio Code, Azure aboneliğinizde dağıtılan tüm mantıksal uygulamaları gösterir, ancak uygulamalarınızı her uzantı altında düzenler: Azure Logic Apps (Tüketim) ve Azure Logic Apps (Standart)..
JavaScript çalıştıran Satır içi Kod İşlemleri eylemini kullanmak için Node.js 12.x.x veya 14.x.x sürümlerini yükleyin.
İpucu
Windows için MSI sürümünü indirin. Bunun yerine ZIP sürümünü kullanıyorsanız, işletim sisteminiz için bir PATH ortam değişkeni kullanarak Node.js el ile kullanılabilir hale getirmeniz gerekir.
Visual Studio Code'da yerleşik HTTP Web Kancası tetikleyicisi gibi web kancası tabanlı tetikleyicileri ve eylemleri yerel olarak çalıştırmak için geri arama URL'si için iletmeyi ayarlamanız gerekir.
Bu makaledeki örnek iş akışını test etmek için, İstek tetikleyicisi tarafından oluşturulan uç noktaya çağrı gönderebilen bir araç gerekir. Böyle bir aracınız yoksa Postman uygulamasını indirebilir, yükleyebilir ve kullanabilirsiniz.
Mantıksal uygulama kaynaklarınızı Application Insights'ı kullanmayı destekleyen ayarlarla oluşturursanız, isteğe bağlı olarak mantıksal uygulamanız için tanılama günlüğünü ve izlemeyi etkinleştirebilirsiniz. Mantıksal uygulamanızı oluştururken veya dağıtımdan sonra bunu yapabilirsiniz. Bir Application Insights örneğiniz olması gerekir, ancak bu kaynağı önceden, mantıksal uygulamanızı oluştururken veya dağıtımdan sonra oluşturabilirsiniz.
Visual Studio Code'u ayarlama
Tüm uzantıların doğru yüklendiğinden emin olmak için Visual Studio Code 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 uzantı güncelleştirmelerini otomatik olarak bulup 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.
Otomatik Denetim Güncelleştirmeler ve Otomatik Güncelleştirme'nin seçili olduğunu onaylayın.
Varsayılan olarak, Azure Logic Apps (Standart) uzantısı için aşağıdaki ayarlar etkinleştirilir ve ayarlanır:
Azure Logic Apps Standard:~3 sürümüne ayarlanmış Project Runtime
Not
Bu sürüm , Satır içi Kod İşlemleri eylemlerini kullanmak için gereklidir.
Azure Logic Apps Standart: Visual Studio Code'daki en son tasarımcıyı etkinleştiren Deneysel Görünüm Yöneticisi. Tasarımcıda öğeleri sürükleyip bırakma gibi sorunlarla karşılaşıyorsanız bu ayarı kapatın.
Bu ayarları bulmak ve onaylamak için şu adımları izleyin:
Dosya menüsünde Tercihler>Ayarları'na gidin.
Kullanıcı sekmesinde Uzantılar>Azure Logic Apps (Standart) seçeneğine > gidin.
Örneğin, Azure Logic Apps Standart: Project Runtime ayarını burada bulabilir veya diğer ayarları bulmak için arama kutusunu kullanabilirsiniz:
Azure hesabınıza bağlanma
Visual Studio Code Etkinlik Çubuğu'nda Azure simgesini seçin.
Azure bölmesindeki Azure: Logic Apps (Standart) altında Azure'da oturum aç'ı seçin. Visual Studio Code kimlik doğrulaması sayfası görüntülendiğinde Azure hesabınızla oturum açın.
Oturum açtığınızda, Azure bölmesinde Azure hesabınızdaki abonelikler gösterilir. Genel kullanıma açık uzantıya da sahipseniz, bu uzantıyla oluşturduğunuz tüm mantıksal uygulamaları Logic Apps (Standart) bölümünde değil Logic Apps bölümünde bulabilirsiniz.
Beklenen abonelikler görünmüyorsa veya bölmenin yalnızca belirli abonelikleri göstermesini istiyorsanız şu adımları izleyin:
Abonelikler listesinde, Abonelik Seç düğmesi (filtre simgesi) görünene kadar işaretçinizi ilk aboneliğin yanına getirin. Filtre simgesini seçin.
İsterseniz Visual Studio Code durum çubuğunda Azure hesabınızı da seçebilirsiniz.
Başka bir abonelik listesi görüntülendiğinde, istediğiniz abonelikleri seçin ve ardından Tamam'ı seçtiğinizden emin olun.
Yerel proje oluşturma
Mantıksal uygulamanızı oluşturmadan önce, mantıksal uygulamanızı Visual Studio Code yönetebilmeniz, çalıştırabilmeniz ve dağıtabilmeniz için yerel bir proje oluşturun. Temel alınan proje, işlev uygulaması projesi olarak da bilinen Azure İşlevleri projesine benzer. Ancak bu proje türleri birbirinden ayrı olduğundan mantıksal uygulamalar ve işlev uygulamaları aynı projede bulunamaz.
Bilgisayarınızda, daha sonra Visual Studio Code'de oluşturacağınız projede kullanmak üzere boş bir yerel klasör oluşturun.
Visual Studio Code'da tüm açık klasörleri kapatın.
Azure bölmesinde, Azure: Logic Apps (Standart) öğesinin yanındaki Yeni Proje Oluştur'u (klasör ve şimşek gösteren simge) seçin.
Windows Defender Güvenlik Duvarı, Visual Studio Code olan ve Azure İşlevleri Temel Araçları olan için
func.exe
ağ erişimiCode.exe
vermenizi isterse, Ev veya iş ağım> gibi Özel ağlarErişime izin ver'i seçin.Proje klasörünüzü oluşturduğunuz konuma gidin, bu klasörü seçin ve devam edin.
Görüntülenen şablonlar listesinde Durum Bilgisi Olan İş Akışı veya Durum Bilgisi Olmayan İş Akışı'nı seçin. Bu örnekte Durum Bilgisi Olan İş Akışı seçilir.
İş akışınız için bir ad girin ve Enter tuşuna basın. Bu örnekte ad olarak kullanılır
Fabrikam-Stateful-Workflow
.Not
azureFunctions.suppressProject kayıtlı bir yapılandırma olmadığından Çalışma Alanı Ayarlarına yazılamıyor hata iletisiyle azureLogicAppsStandard.createNewProject adlı bir hata alabilirsiniz. Bunu yaparsanız, doğrudan Visual Studio Market'ten veya Visual Studio Code içinden Visual Studio Code için Azure İşlevleri uzantısını yüklemeyi deneyin.
Visual Studio Code projenizi oluşturmayı tamamlar ve iş akışınız için workflow.json dosyasını kod düzenleyicisinde açar.
Not
Projenizi nasıl açabileceğinizi seçmeniz istenirse, projenizi geçerli Visual Studio Code penceresinde açmak istiyorsanız Geçerli pencerede aç'ı seçin. Visual Studio Code için yeni bir örnek açmak için Yeni pencerede aç'ı seçin.
Visual Studio araç çubuğunda, henüz açık değilse Gezgin bölmesini açın.
Gezgin bölmesi, otomatik olarak oluşturulan proje dosyalarını içeren projenizi gösterir. Örneğin, projede iş akışınızın adını gösteren bir klasör vardır. Bu klasörün içinde workflow.json dosyası iş akışınızın temel JSON tanımını içerir.
Visual Studio Code'da mantıksal uygulama projenizde aşağıdaki türlerden biri vardır:
- Uzantı paketi tabanlı (Node.js), bu varsayılan türdür
- NuGet paket tabanlı (.NET), varsayılan türden dönüştürebilirsiniz
Bu türlere bağlı olarak projeniz biraz farklı klasörler ve dosyalar içerir. NuGet tabanlı proje, paketleri ve diğer kitaplık dosyalarını içeren bir .bin klasörü içerir. Paket tabanlı bir proje .bin klasörünü ve diğer dosyaları içermez. Bazı senaryolar, örneğin özel yerleşik işlemler geliştirmek ve çalıştırmak istediğinizde uygulamanızın çalışması için NuGet tabanlı bir proje gerektirir. Projenizi NuGet kullanacak şekilde dönüştürme hakkında daha fazla bilgi için Bkz. Yerleşik bağlayıcı yazmayı etkinleştirme.
Varsayılan paket tabanlı proje için, projenizin aşağıdaki örneğe benzer bir klasör ve dosya yapısı vardır:
MyBundleBasedLogicAppProjectName | .vscode | Artifacts || Maps ||| MapName1 ||| ... || Schemas ||| SchemaName1 ||| ... | WorkflowName1 || workflow.json || ... | WorkflowName2 || workflow.json || ... | workflow-designtime | .funcignore | connections.json | host.json | local.settings.json
Projenizin kök düzeyinde, diğer öğelerle birlikte aşağıdaki dosya ve klasörleri bulabilirsiniz:
Name Klasör veya dosya Description .vscode Klasör extensions.json, launch.json, settings.json ve tasks.json dosyaları gibi Visual Studio Code ilgili ayarlar dosyalarını içerir. Artifacts Klasör İşletmeler arası (B2B) senaryoları destekleyen iş akışlarında tanımladığınız ve kullandığınız tümleştirme hesabı yapıtlarını içerir. Örneğin, örnek yapı XML dönüştürme ve doğrulama işlemleri için eşlemeleri ve şemaları içerir. <WorkflowName> Klasör Her iş akışı için WorkflowName> klasörü, < iş akışının temel JSON tanımını içeren bir workflow.json dosyası içerir. workflow-designtime Klasör Geliştirme ortamıyla ilgili ayarlar dosyalarını içerir. .funcignore Dosya Yüklü Azure İşlevleri Temel Araçlarınızla ilgili bilgileri içerir. connections.json Dosya İş akışlarınızın kullandığı yönetilen bağlantılar ve Azure işlevleri için meta verileri, uç noktaları ve anahtarları içerir.
Önemli: Her ortam için farklı bağlantılar ve işlevler kullanmak için bu connections.json dosyasını parametreleştirdiğinizden ve uç noktaları güncelleştirdiğinizden emin olun.host.json Dosya Tek kiracılı Azure Logic Apps platformu, mantıksal uygulamalar, iş akışları, tetikleyiciler ve eylemler için varsayılan sınırlar gibi çalışma zamanına özgü yapılandırma ayarlarını ve değerlerini içerir. Mantıksal uygulama projenizin kök düzeyinde host.json meta veri dosyası, yerel olarak veya Azure'da aynı mantıksal uygulamadaki tüm iş akışlarının çalışırken kullandığı yapılandırma ayarlarını ve varsayılan değerleri içerir.
Not: Mantıksal uygulamanızı oluşturduğunuzda, Visual Studio Code depolama kapsayıcınızda bir yedek 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ı çözmek 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ı dizelerini ve diğer ayarları içerir. Başka bir deyişle, bu ayarlar ve değerler yalnızca projelerinizi yerel geliştirme ortamınızda çalıştırdığınızda 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 tarafından değerler olarak kullanılan yerel ortam değişkenleri olarakappSettings
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.
Yerleşik bağlayıcı yazmayı etkinleştirme
Tek kiracılı Azure Logic Apps genişletilebilirlik çerçevesini kullanarak ihtiyacınız olan her 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 önce projenizi uzantı paket tabanlı (Node.js) paket tabanlı NuGet'e (.NET) dönüştürmeniz gerekir.
Önemli
Bu eylem, geri alınamaz tek yönlü bir işlemdir.
Gezgin bölmesinde, projenizin kökünde, fare işaretçinizi diğer tüm dosya ve klasörlerin altındaki boş bir alanın üzerine getirin, kısayol menüsünü açın ve Nuget tabanlı Mantıksal Uygulama projesine dönüştür'ü seçin.
İstem görüntülendiğinde proje dönüştürme işlemini onaylayın.
Devam etmek için Azure Logic Apps Running Anywhere - Yerleşik bağlayıcı genişletilebilirliği makalesindeki adımları gözden geçirin ve izleyin.
İş akışı tanım dosyasını tasarımcıda açma
İş akışınız için proje klasörünü genişletin. workflow.json dosyasının kısayol menüsünü açın ve Tasarımcıda Aç'ı seçin.
Azure'da bağlayıcıları etkinleştir listesinden Azure'dan bağlayıcıları kullan'ı seçin. Bu, yalnızca Azure hizmetlerine yönelik bağlayıcılar için değil, Azure'da kullanılabilen ve dağıtılan tüm yönetilen bağlayıcılar için geçerlidir.
Not
Durum bilgisi olmayan iş akışları şu anda yalnızca Azure'da dağıtılan yönetilen bağlayıcılar için eylemleri destekler, tetikleyicileri desteklemez. Azure'da durum bilgisi olmayan iş akışınız için bağlayıcıları etkinleştirme seçeneğiniz olsa da tasarımcı, seçmeniz için yönetilen bağlayıcı tetikleyicisi göstermez.
Abonelik seçin listesinden mantıksal uygulama projeniz için kullanılacak Azure aboneliğini seçin.
Kaynak grupları listesinden Yeni kaynak grubu oluştur'u seçin.
Kaynak grubu için bir ad girin ve Enter tuşuna basın. Bu örnekte
Fabrikam-Workflows-RG
kullanılmıştır.Konumlar listesinden kaynak grubunuzu ve kaynaklarınızı oluştururken kullanılacak Azure bölgesini seçin. Bu örnekte Orta Batı ABD kullanılır.
Bu adımı gerçekleştirdikten sonra Visual Studio Code iş akışı tasarımcısını açar.
Not
Visual Studio Code iş akışı tasarım zamanı API'sini başlattığında, başlatma işleminin birkaç saniye sürebileceğini belirten bir ileti alabilirsiniz. Bu iletiyi yoksayabilir veya Tamam'ı seçebilirsiniz.
Tasarımcı açılmazsa Tasarımcı açılamıyor sorun giderme bölümünü gözden geçirin.
Tasarımcı göründükten sonra, tasarımcıda İşlem seçin istemi görüntülenir ve eylem ekle bölmesini gösteren varsayılan olarak seçilir.
Ardından, iş akışınıza bir tetikleyici ve eylemler ekleyin .
Tetikleyici ve eylem ekleme
Tasarımcıyı açtıktan sonra tasarımcıda İşlem seçin istemi görüntülenir ve varsayılan olarak seçilir. Artık tetikleyici ve eylemler ekleyerek iş akışınızı oluşturmaya başlayabilirsiniz.
Bu örnekteki iş akışı bu tetikleyiciyi ve şu eylemleri kullanır:
Yerleşik İstek tetikleyicisi, Gelen çağrıları veya istekleri alan ve diğer hizmetlerin veya mantıksal uygulamaların çağırabileceği bir uç nokta oluşturan bir HTTP isteği alındığında tetikleyicisi.
Outlook'u Office 365 eylemi, E-posta gönder.
Yanıt göndermek ve verileri çağırana geri döndürmek için kullandığınız yerleşik Yanıt eylemi.
İstek tetikleyicisini ekleme
Tasarımcının yanındaki Tetikleyici ekle bölmesindeki İşlem seçin arama kutusunun altında, yerel olarak çalışan bir tetikleyici seçebilmeniz için Yerleşik'in seçili olduğundan emin olun.
İşlem seçin arama kutusuna yazın
when a http request
ve HTTP isteği alındığında adlı yerleşik İstek tetikleyicisini seçin.Tetikleyici tasarımcıda göründüğünde tetikleyicinin ayrıntılar bölmesi açılır ve tetikleyicinin özellikleri, ayarları ve diğer eylemleri gösterilir.
İpucu
Ayrıntılar bölmesi görünmüyorsa tasarımcıda tetikleyicinin seçili olduğundan emin olun.
Tasarımcıdan bir öğeyi silmeniz gerekiyorsa, tasarımcıdan öğe silmek için bu adımları izleyin.
Office 365 Outlook eylemini ekleme
Tasarımcıda, eklediğiniz tetikleyicinin altında artı işaretini (+) >Eylem ekle'yi seçin.
Tasarımcıda İşlem seçin istemi görüntülenir ve Eylem ekle bölmesi yeniden açılır, böylece bir sonraki eylemi seçebilirsiniz.
Eylem ekle bölmesindeki İşlem seçin arama kutusunun altında Azure'ı seçerek Azure'da dağıtılan yönetilen bağlayıcı için bir eylem seçebilirsiniz.
Bu örnekte Outlook'un e-posta gönder (V2) Office 365 eylemi seçilir ve kullanılır.
Eylemin ayrıntılar bölmesinde Oturum aç'ı seçerek e-posta hesabınızla bağlantı oluşturabilirsiniz.
Visual Studio Code e-posta hesabınıza erişmek için onay isteyip istemediğinizi sorarsa Aç'ı seçin.
İpucu
Gelecekteki istemleri önlemek için, Kimlik doğrulama sayfasını güvenilen etki alanı olarak ekleyebilmek için Güvenilen Etki Alanlarını Yapılandır'ı seçin.
Oturum açmak, erişime izin vermek ve Visual Studio Code dönmek için sonraki istemleri izleyin.
Not
İstemleri tamamlamadan önce çok fazla zaman geçerse, kimlik doğrulama işlemi zaman aşımına uysa ve başarısız olur. Bu durumda, tasarımcıya dönün ve bağlantıyı oluşturmak için oturum açmayı yeniden deneyin.
Azure Logic Apps (Standart) uzantısı e-posta hesabınıza erişmek için onay isteyip istemediğinizi sorarsa Aç'ı seçin. Erişime izin vermek için sonraki istemi izleyin.
İpucu
Gelecekteki istemleri önlemek için Bu uzantıyı bir daha sorma'yı seçin.
Visual Studio Code bağlantınızı oluşturduğunda bazı bağlayıcılar şu
The connection will be valid for {n} days only
iletiyi gösterir: . Bu süre sınırı yalnızca mantıksal uygulamanızı Visual Studio Code yazarken süre için geçerlidir. Mantıksal uygulamanız otomatik olarak etkinleştirilmiş sistem tarafından atanan yönetilen kimliğini kullanarak çalışma zamanında kimlik doğrulaması yapabileceklerinden, dağıtımdan sonra bu sınır artık geçerli olmaz. 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.Tasarımcıda , E-posta gönder eylemi seçili görünmüyorsa bu eylemi seçin.
Eylemin ayrıntılar bölmesindeki Parametreler sekmesinde eylem için gerekli bilgileri sağlayın, örneğin:
Özellik Gerekli Değer Açıklama Kime Yes <e-posta adresiniz> Test amacıyla e-posta adresiniz olabilecek e-posta alıcısı. Bu örnekte kurgusal e-posta kullanılır sophiaowen@fabrikam.com
.Konu Yes An email from your example workflow
E-posta konusu Gövde Yes Hello from your example workflow!
E-posta gövdesi içeriği Not
Ayarlar, Statik Sonuç veya Sonra Çalıştır sekmesindeki ayrıntılar bölmesinde herhangi bir değişiklik yapmak istiyorsanız, sekmeleri değiştirmeden veya odağı tasarımcıya dönüştürmeden önce bu değişiklikleri işlemek için Bitti'yi seçtiğinizden emin olun. Aksi takdirde, Visual Studio Code değişikliklerinizi korumaz.
Tasarımcıda Kaydet'i seçin.
Önemli
Web kancası tabanlı tetikleyici veya yerleşik HTTP Web Kancası tetikleyicisi veya eylemi gibi eylemler kullanan bir iş akışını yerel olarak çalıştırmak için, web kancasının geri çağırma URL'si için iletmeyi ayarlayarak bu özelliği etkinleştirmeniz gerekir.
Yerel olarak çalışan web kancalarını etkinleştirme
Azure'da çalışan bir mantıksal uygulamayla HTTP Web Kancası gibi web kancası tabanlı bir tetikleyici veya eylem kullandığınızda, Logic Apps çalışma zamanı bu uç noktaya bir geri çağırma URL'si oluşturup kaydederek hizmet uç noktasına abone olur. Tetikleyici veya eylem daha sonra hizmet uç noktasının URL'yi çağırmasını bekler. Ancak, Visual Studio Code üzerinde çalışırken oluşturulan geri çağırma URL'si ile http://localhost:7071/...
başlar. Bu URL, hizmet uç noktasının bu URL'yi çağıramamasını sağlayan özel localhost sunucunuz içindir.
Visual Studio Code'de web kancası tabanlı tetikleyicileri ve eylemleri yerel olarak çalıştırmak için, localhost sunucunuzu kullanıma sunan ve hizmet uç noktasından gelen çağrıları web kancası geri çağırma URL'sine güvenli bir şekilde ileten bir genel URL ayarlamanız gerekir. ngrok gibi bir iletme hizmeti ve aracı kullanarak localhost bağlantı noktanıza bir HTTP tüneli açabilir veya kendi eşdeğer aracınızı kullanabilirsiniz.
ngrok kullanarak arama iletmeyi ayarlama
Hesabınız yoksa ngrok hesabına kaydolun. Aksi takdirde 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 panonuzda Kimlik Doğrulaması'na genişletin ve Kimlik Doğrulamanız'ı seçin.
Authtoken'iniz kutusundan 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: Yüklemek için sıkıştırmayı açma.
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. Daha fazla bilgi için bkz . 2. Adım: Hesabınızı bağlama.
ngrok authtoken <your_auth_token>
Aşağıdaki komutu çalıştırarak LOCALHOST bağlantı noktası 7071'e HTTP tünelini açın. Daha fazla bilgi için bkz. 3. Adım: Tetikleyin.
ngrok http 7071
Çıkışta 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 tasarımcıda HTTP + Web kancası tetikleyicisini veya eylemini ekleyin.
Konak uç noktası konumu için istem görüntülendiğinde, daha önce oluşturduğunuz iletme (yeniden yönlendirme) URL'sini girin.
Not
İstemi yoksaymak, iletme URL'sini sağlamanız gerektiğini belirten bir uyarının görünmesine neden olur, bu nedenle Yapılandır'ı seçin ve URL'yi girin. Bu adımı tamamladıktan sonra, ekleyebileceğiniz sonraki web kancası tetikleyicileri veya eylemleri için istem yeniden gösterilmez.
İstemin yeniden 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 yönlendirme URL'sini sağlayabilmeniz için istem görüntülenir.
Visual Studio Code, iletme URL'sini projenizin kök klasöründeki local.settings.json dosyasına ekler. nesnesinde
Values
, adlıWorkflows.WebhookRedirectHostUri
özellik şimdi görünür ve iletme URL'sine ayarlanır, örneğin:{ "IsEncrypted": false, "Values": { "AzureWebJobsStorage": "UseDevelopmentStorage=true", "FUNCTIONS_WORKER_RUNTIME": "node", "FUNCTIONS_V2_COMPATIBILITY_MODE": "true", <...> "Workflows.WebhookRedirectHostUri": "http://xxxXXXXxxxXXX.ngrok.io", <...> } }
Not
Projeniz NuGet paket tabanlıysa (.NET), uzantı paket tabanlı (Node.js)
"FUNCTIONS_WORKER_RUNTIME"
olarak ayarlı"dotnet"
değildir. Ancak Satır içi Kod İşlemlerini"FUNCTIONS_WORKER_RUNTIME"
kullanmak için"node"
Yerel hata ayıklama oturumunu ilk kez başlattığınızda veya iş akışını hata ayıklama olmadan çalıştırdığınızda, Logic Apps çalışma zamanı iş akışını hizmet uç noktasına kaydeder ve web kancası işlemlerini bildirmek için bu uç noktaya abone olur. İş akışınız bir sonraki çalıştırıldığında, abonelik kaydı yerel depolama alanında zaten bulunduğundan çalışma zamanı kaydedilmez veya yeniden abonelikten çıkarılamaz.
Yerel olarak çalıştırılacak web kancası tabanlı tetikleyicileri veya eylemleri kullanan bir iş akışı çalıştırması için hata ayıklama oturumunu durdurduğunuzda, mevcut abonelik kayıtları silinmez. Kaydı silmek için abonelik kayıtlarını el ile kaldırmanız veya silmeniz gerekir.
Not
İş akışınız çalışmaya başladıktan sonra terminal penceresi şu örneğe benzer hatalar gösterebilir:
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ünde local.settings.json dosyasını açın ve özelliğinin olarak true
ayarlandığından emin olun:
"FUNCTIONS_V2_COMPATIBILITY_MODE": "true"
Hata ayıklama için kesme noktalarını yönetme
Hata ayıklama oturumu başlatarak mantıksal uygulama iş akışınızı çalıştırmadan ve test etmeden önce, her iş akışı için workflow.json dosyasının içinde kesme noktaları ayarlayabilirsiniz. Başka kurulum gerekmez.
Şu anda kesme noktaları yalnızca eylemler için desteklenir, tetikleyiciler için desteklenmez. Her eylem tanımının şu kesme noktası konumları vardır:
Eylemin adını gösteren satırda başlangıç kesme noktasını ayarlayın. Hata ayıklama oturumu sırasında bu kesme noktası isabet ettiğinde, değerlendirilmeden önce eylemin girişlerini gözden geçirebilirsiniz.
Eylemin kapanış küme ayracını (}) gösteren satırda bitiş kesme noktasını ayarlayın. Hata ayıklama oturumu sırasında bu kesme noktası isabet ettiğinde, eylem çalışması tamamlanmadan önce eylemin sonuçlarını gözden geçirebilirsiniz.
Kesme noktası eklemek için şu adımları izleyin:
Hata ayıklamak istediğiniz iş akışının 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.
Not
Çalıştır görünümü otomatik olarak görünmezse 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 ( yürüt düğmesi) öğesini seçin.
İş akışı çalıştırması sırasında istediğiniz zaman kesme noktaları ekleyebilir ve kaldırabilirsiniz. Ancak çalıştırma başladıktan sonra workflow.json dosyasını güncelleştirirseniz kesme noktaları otomatik olarak güncelleştiremez. Kesme noktalarını güncelleştirmek için mantıksal uygulamayı yeniden başlatın.
Genel bilgi için bkz. Kesme Noktaları - Visual Studio Code.
Yerel olarak çalıştırma, test ve hata ayıklama
Mantıksal uygulamanızı test etmek için bu adımları izleyerek hata ayıklama oturumu başlatın ve İstek tetikleyicisi tarafından oluşturulan uç noktanın URL'sini bulun. Daha sonra bu uç noktaya istek gönderebilmek için bu URL'ye ihtiyacınız vardır.
Durum bilgisi olmayan bir iş akışının hatalarını daha kolay ayıklamak için bu iş akışı için çalıştırma geçmişini etkinleştirebilirsiniz.
Visual Studio Code Etkinlik Çubuğu'nda Çalıştır menüsünü açın ve Hata Ayıklamayı Başlat (F5) öğesini seçin.
Hata ayıklama oturumunu gözden geçirebilmeniz için Terminal penceresi açılır.
Not
"PreLaunchTask 'generateDebugSymbols' çalıştırıldıktan sonra hata oluştu" hatasını alırsanız Hata ayıklama oturumu başlatılamıyor sorun giderme bölümüne bakın.
Şimdi İstek tetikleyicisinde uç noktanın geri çağırma URL'sini bulun.
Projenizi görüntüleyebilmeniz için Gezgin bölmesini yeniden açın.
workflow.json dosyasının kısayol menüsünden Genel Bakış'ı seçin.
Örnek İstek tetikleyicisi için bu URL'ye benzer şekilde görünen Geri Arama URL'si değerini bulun:
http://localhost:7071/api/<workflow-name>/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<shared-access-signature>
Mantıksal uygulama iş akışını tetikleyerek geri çağırma URL'sini test etmek için Postman'i veya istekleri oluşturmak ve göndermek için tercih ettiğiniz aracı açın.
Bu örnek Postman kullanılarak devam eder. Daha fazla bilgi için bkz. Postman Başlarken.
Postman araç çubuğunda Yeni'yi seçin.
Yeni Oluştur bölmesindeki Yapı Taşları'nın altında İstek'i seçin.
İsteği Kaydet penceresindeki İstek adı'nın altında istek için bir ad girin, örneğin,
Test workflow trigger
.Kaydedilecek koleksiyonu veya klasörü seçin'in altında Koleksiyon Oluştur'u seçin.
Tüm Koleksiyonlar'ın altında, isteklerinizi düzenlemek için koleksiyonun oluşturacağı bir ad sağlayın, Enter tuşuna basın ve Koleksiyon adına> kaydet'i <seçin. Bu örnekte koleksiyon adı olarak kullanılır
Logic Apps requests
.Postman'de istek bölmesi açılır, böylece İstek tetikleyicisi için geri çağırma URL'sine istek gönderebilirsiniz.
Visual Studio Code geri dönün. İş akışının genel bakış sayfasında Geri Çağırma URL'si özellik değerini kopyalayın.
Postman'e geri dönün. İstek bölmesinde, şu anda varsayılan istek yöntemi olarak GET'i gösteren yöntem listesinin yanında, daha önce kopyaladığınız geri çağırma URL'sini adres kutusuna yapıştırın ve Gönder'i seçin.
Örnek mantıksal uygulama iş akışı, 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.
Durum bilgisi olan bir iş akışı oluşturduysanız, gönderdiğiniz istek iş akışını tetikledikten sonra genel bakış sayfasında iş akışının çalıştırma durumu ve geçmişi gösterilir.
İpucu
Çalıştırma durumu görünmüyorsa Yenile'yi seçerek genel bakış sayfasını yenilemeyi deneyin. Karşılanmayan ölçütler veya veri bulma nedeniyle atlanan bir tetikleyici için hiçbir çalıştırma gerçekleşmez.
Aşağıdaki tabloda, her iş akışı çalıştırmasının sahip olabileceği ve Visual Studio Code'de gösterebileceği olası son durumlar gösterilmektedir:
Çalıştırma durumu Description İptal edildi Sistem kesintisi veya süresi dolmuş Azure aboneliği gibi dış sorunlar nedeniyle çalıştırma durduruldu veya tamamlanmamış. Iptal Çalıştırma tetiklendi ve başlatıldı ancak bir iptal isteği alındı. Başarısız Çalıştırmadaki en az bir eylem başarısız oldu. İş akışında sonraki hiçbir eylem hatayı işleyecek şekilde ayarlanmadı. Çalışıyor Çalıştırma tetiklendi ve devam ediyor, ancak bu durum eylem sınırları veya geçerli fiyatlandırma planı nedeniyle kısıtlanan bir çalıştırma için de görüntülenebilir. İpucu: Tanılama günlüğünü ayarlarsanız gerçekleşen kısıtlama olayları hakkında bilgi alabilirsiniz.
Başarılı Çalıştırma başarılı oldu. Herhangi bir eylem başarısız olursa, iş akışındaki sonraki bir eylem bu hatayı işledi. Zaman aşımına uğradı Geçerli süre çalıştırma süresi sınırını aştığından çalıştırma zaman aşımına uğradı ve bu sınır Gün cinsinden Çalıştırma geçmişi saklama ayarı tarafından denetlendi. Çalıştırmanın süresi, çalıştırmanın başlangıç saati ve çalıştırma süresi sınırı kullanılarak hesaplanır. Not: Çalıştırmanın süresi geçerli çalıştırma geçmişi saklama sınırını da aşarsa ve bu sınır Da Çalıştırma geçmişi saklama gün cinsinden ayarı tarafından denetlenirse, çalıştırma günlük temizleme işi tarafından çalıştırma geçmişinden temizlenir. Çalıştırma zaman aşımına uysa veya tamamlasa da, bekletme süresi her zaman çalıştırmanın başlangıç saati ve geçerli bekletme sınırı kullanılarak hesaplanır. Bu nedenle, bir uçuş içi çalıştırmanın süre sınırını azaltırsanız, çalıştırma zaman aşımına uysa. Ancak çalıştırma süresi bekletme sınırını aşıp aşmadığına bağlı olarak çalıştırma kalır veya çalıştırma geçmişinden temizlenir.
Bekleme Çalıştırma başlatılmadı veya duraklatıldı, örneğin hala çalışmakta olan önceki bir iş akışı örneği nedeniyle. Belirli bir çalıştırmadaki her adımın durumunu ve adımın giriş ve çıkışlarını gözden geçirmek için, o çalıştırmanın üç nokta (...) düğmesini ve ardından Çalıştırmayı Göster'i seçin.
Visual Studio Code izleme görünümünü açar ve çalıştırmadaki her adımın durumunu gösterir.
Not
Bir çalıştırma başarısız olduysa ve izleme görünümündeki bir adım hatayı gösteriyorsa
400 Bad Request
, 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 sahip olabileceği ve Visual Studio Code gösterebileceği olası durumlar gösterilmektedir:
Eylem durumu Description İptal edildi Sistem kesintisi veya süresi dolmuş Azure aboneliği gibi dış sorunlar nedeniyle eylem durduruldu veya tamamlanmamış. Iptal Eylem çalışıyordu ancak iptal etmek için bir istek aldı. Başarısız Eylem başarısız oldu. Çalışıyor Eylem şu anda çalışıyor. Atlandı Hemen önceki eylem başarısız olduğundan eylem atlandı. Bir eylem, geçerli eylemin çalıştırılabilmesi için önceki eylemin başarıyla tamamlandığını gerektiren 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. Bekleme Arayandan gelen isteği bekleyen bir web kancası eylemi için geçerlidir. Her adımın girişlerini ve çıkışlarını gözden geçirmek için incelemek istediğiniz adımı seçin.
Bu adımın ham girişlerini ve çıkışlarını daha fazla gözden geçirmek için Ham girişleri göster 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 (Shift + F5) öğesini seçin.
Yanıt döndürme
Mantıksal uygulamanıza istek gönderen çağırana yanıt döndürmek için, İstek tetikleyicisiyle başlayan bir iş akışı için yerleşik Yanıt eylemini kullanabilirsiniz.
İş akışı tasarımcısında, E-posta gönder eyleminin altında artı işaretini (+) >Eylem ekle'yi seçin.
Tasarımcıda İşlem seçin istemi görüntülenir ve Eylem ekle bölmesi yeniden açılır, böylece bir sonraki eylemi seçebilirsiniz.
Eylem ekle bölmesindeki Eylem seçin arama kutusunun altında Yerleşik'in seçili olduğundan emin olun. Arama kutusuna yazın
response
ve Yanıt eylemini seçin.Yanıt eylemi tasarımcıda görüntülendiğinde, eylemin ayrıntılar bölmesi otomatik olarak açılır.
Parametreler sekmesinde, çağırmak istediğiniz işlev için gerekli bilgileri sağlayın.
Bu örnek, E-posta gönder eyleminden alınan Body özellik değerini döndürür.
Dinamik içerik listesinin görüntülenmesi ve iş akışındaki önceki tetikleyici ve eylemlerden kullanılabilir çıkış değerlerini göstermesi için Gövde özellik kutusunun içine tıklayın.
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.
Tasarımcıda Kaydet'i seçin.
Mantıksal uygulamanızı yeniden test etme
Mantıksal uygulamanızda güncelleştirmeler yaptıktan sonra, Visual Studio'da hata ayıklayıcısını yeniden çalıştırarak ve güncelleştirilmiş mantıksal uygulamanızı tetikleme amacıyla başka bir istek göndererek yerel olarak çalıştırma, test etme ve hata ayıklama adımlarına benzer şekilde başka bir test çalıştırabilirsiniz.
Visual Studio Code Etkinlik Çubuğu'nda Çalıştır menüsünü açın ve Hata Ayıklamayı Başlat (F5) öğesini seçin.
Postman'de veya istek oluşturma ve gönderme aracınızda iş akışınızı tetikleyen başka bir istek gönderin.
Durum bilgisi olan bir iş akışı oluşturduysanız, iş akışının genel bakış sayfasında en son çalıştırmanın durumunu denetleyin. Bu çalıştırmadaki her adımın durumunu, girişlerini ve çıkışlarını görüntülemek için, o çalıştırmanın üç nokta (...) düğmesini ve ardından Çalıştırmayı Göster'i seçin.
Örneğin, örnek iş akışı Yanıt eylemiyle güncelleştirildikten sonra çalıştırmanın adım adım durumu aşağıda verilmiştir.
Hata ayıklama oturumunu durdurmak için Çalıştır menüsünde Hata Ayıklamayı Durdur (Shift + F5) öğesini seçin.
Güvenlik duvarı erişimi için etki alanı adlarını bulma
Mantıksal uygulama iş akışınızı Azure portal dağıtıp çalıştırmadan önce ortamınızda trafiği sınırlayan katı ağ gereksinimleri veya güvenlik duvarları varsa, iş akışınızda bulunan tetikleyici veya eylem bağlantıları için izinler ayarlamanız gerekir.
Bu bağlantıların tam etki alanı adlarını (FQDN) bulmak için şu adımları izleyin:
Mantıksal uygulama projenizde, iş akışınıza ilk bağlantı tabanlı tetikleyiciyi veya eylemi ekledikten sonra oluşturulan connections.json dosyasını açın ve nesneyi bulun
managedApiConnections
.Oluşturduğunuz her bağlantı için, güvenlik duvarınızı bu bilgilerle ayarlayabilmeniz için özellik değerini kopyalayıp güvenli bir yere kaydedin
connectionRuntimeUrl
.Bu örnek connections.json dosyası iki bağlantı içerir: AS2 bağlantısı ve şu
connectionRuntimeUrl
değerlerle Office 365 bağlantısı:AS2:
"connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/as2/11d3fec26c87435a80737460c85f42ba
Office 365:
"connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/office365/668073340efe481192096ac27e7d467f
{ "managedApiConnections": { "as2": { "api": { "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{Azure-region}/managedApis/as2" }, "connection": { "id": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{Azure-resource-group}/providers/Microsoft.Web/connections/{connection-resource-name}" }, "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/as2/11d3fec26c87435a80737460c85f42ba, "authentication": { "type":"ManagedServiceIdentity" } }, "office365": { "api": { "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{Azure-region}/managedApis/office365" }, "connection": { "id": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{Azure-resource-group}/providers/Microsoft.Web/connections/{connection-resource-name}" }, "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/office365/668073340efe481192096ac27e7d467f, "authentication": { "type":"ManagedServiceIdentity" } } } }
Azure’a dağıtın
Visual Studio Code'den projenizi doğrudan Azure'da yayımlayabilirsiniz. Bu, Mantıksal Uygulama (Standart) kaynak türünü kullanarak mantıksal uygulamanızı dağıtır. 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ılan mantıksal uygulama (Standart) kaynağında yayımlayabilir ve bu da mantıksal uygulamanın üzerine yazılabilir.
Mantıksal Uygulama (Standart) kaynak türü için dağıtım, dağıtım sırasında seçtiğiniz bir barındırma planı ve fiyatlandırma katmanı gerektirir. Daha fazla bilgi için Barındırma planlarını ve fiyatlandırma katmanlarını gözden geçirin.
Yeni bir Mantıksal Uygulama (Standart) kaynağına yayımlama
Visual Studio Code Etkinlik Çubuğu'nda Azure simgesini seçin.
Azure: Logic Apps (Standart) bölmesi araç çubuğunda Mantıksal Uygulamaya Dağıt'ı seçin.
İstenirse mantıksal uygulama dağıtımınız için kullanılacak Azure aboneliğini seçin.
Visual Studio Code açılan listeden şu seçeneklerden birini belirleyin:
- Azure'da yeni Mantıksal Uygulama (Standart) oluşturma (hızlı)
- Azure Gelişmiş'te yeni Mantıksal Uygulama (Standart) oluşturma
- Varsa, önceden dağıtılmış bir Mantıksal Uygulama (Standart) kaynağı
Bu örnek, Azure Gelişmiş'te yeni Mantıksal Uygulama (Standart) oluşturma ile devam eder.
Yeni Mantıksal Uygulama (Standart) kaynağınızı oluşturmak için şu adımları izleyin:
Yeni mantıksal uygulamanız için genel olarak benzersiz bir ad sağlayın. Bu ad Mantıksal Uygulama (Standart) kaynağı için kullanılacak addır. Bu örnekte
Fabrikam-Workflows-App
kullanılmıştır.Yeni mantıksal uygulamanız için bir barındırma planı seçin. Planınız için bir ad oluşturun veya mevcut bir planı seçin (yalnızca Windows tabanlı App Service planları). Bu örnekte Yeni App Service Planı oluştur'u seçer.
Barındırma planınız için bir ad sağlayın ve ardından seçtiğiniz plan için bir fiyatlandırma katmanı seçin.
Daha fazla bilgi için Barındırma planlarını ve fiyatlandırma katmanlarını gözden geçirin.
En iyi performans için, dağıtım için projenizle aynı kaynak grubunu seçin.
Not
Farklı bir kaynak grubu oluşturabilir veya kullanabilirsiniz ancak bunu yapmak performansı etkileyebilir. Farklı bir kaynak grubu oluşturur veya seçerseniz ancak onay istemi görüntülendiğinde iptal ederseniz dağıtımınız da iptal edilir.
Durum bilgisi olan iş akışları için Yeni depolama hesabı veya mevcut bir depolama hesabı oluştur'u seçin.
Mantıksal uygulamanızın oluşturma ve dağıtım ayarları Application Insights'ı kullanmayı destekliyorsa, isteğe bağlı olarak mantıksal uygulamanız için tanılama günlüğünü ve izlemeyi etkinleştirebilirsiniz. Mantıksal uygulamanızı Visual Studio Code veya dağıtımdan sonra dağıtırken bunu yapabilirsiniz. Bir Application Insights örneğiniz olması gerekir, ancak mantıksal uygulamanızı dağıtırken veya dağıtımdan sonra bu kaynağı önceden oluşturabilirsiniz.
Günlüğe kaydetmeyi ve izlemeyi şimdi etkinleştirmek için şu adımları izleyin:
Var olan bir Application Insights kaynağını veya Yeni Application Insights kaynağı oluştur'u seçin.
Azure portal 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 projenizin kök klasöründe local.settings.json dosyasını açın.
nesnesine
Values
özelliğini ekleyinAPPINSIGHTS_INSTRUMENTATIONKEY
ve değeri izleme anahtarı olarak ayarlayın, örneğin:{ "IsEncrypted": false, "Values": { "AzureWebJobsStorage": "UseDevelopmentStorage=true", "FUNCTIONS_WORKER_RUNTIME": "node", "APPINSIGHTS_INSTRUMENTATIONKEY": <instrumentation-key> } }
İpucu
Tetikleyici ve eylem adlarının Application Insights örneğinizde doğru görüntülenip görüntülenmediğini de kontrol edebilirsiniz.
Azure portal Application Insights kaynağınıza gidin.
Kaynak kaynağı 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 yinelemeler, biçimi kullanmak
WorkflowName.ActionName
yerine, işlem adı olarak iş akışı adını kullanır ve Azure İşlevleri ana bilgisayarından kaynaklanır.Ardından, mantıksal uygulamanızın topladığı ve Application Insights örneğine gönderdiği izleme verilerinin önem düzeyini isteğe bağlı olarak ayarlayabilirsiniz.
İş akışıyla ilgili bir olay her gerçekleştiğinde (örneğin, bir iş akışının tetiklendiğinde veya bir eylem çalıştırıldığında) çalışma zamanı çeşitli izlemeler yayar. Bu izlemeler iş akışının ömrünü kapsar ve aşağıdaki olay türlerini içerir ancak bunlarla sınırlı değildir:
- Başlatma, durdurma ve hatalar gibi hizmet etkinliği.
- İşler ve dağıtıcı etkinliği.
- Tetikleyici, eylem ve çalıştırma gibi iş akışı etkinliği.
- Başarı 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. Bu tabloda önem derecesi düzeyleri ve bunların izleme türleri açıklanmaktadır:Önem derecesi İzleme türü Kritik Mantıksal uygulamanızdaki kurtarılamaz bir hatayı açıklayan günlükler. Hata Ayıklama Geliştirme sırasında araştırma için kullanabileceğiniz günlükler, örneğin gelen ve giden HTTP çağrıları. Hata İş akışı yürütmede bir hata olduğunu ancak mantıksal uygulamanızda genel bir hata olmadığını gösteren günlükler. Bilgi Mantıksal uygulamanızdaki veya iş akışınızdaki genel etkinliği izleyen günlükler, örneğin: - Bir 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ızda 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ü filtreleme için ASP.NET Core düzenini izler.{ "version": "2.0", "logging": { "applicationInsights": { "samplingExcludedTypes": "Request", "samplingSettings": { "isEnabled": true } } } }
Nesne,
logging
özelliğini içerenHost.Triggers.Workflow
birlogLevel
nesne içermiyorsa, bu öğeleri ekleyin. özelliğini istediğiniz izleme türünün önem düzeyine ayarlayın, örneğin:{ "version": "2.0", "logging": { "applicationInsights": { "samplingExcludedTypes": "Request", "samplingSettings": { "isEnabled": true } }, "logLevel": { "Host.Triggers.Workflow": "Information" } } }
Dağıtım adımlarını tamamladığınızda Visual Studio Code mantıksal uygulamanızı yayımlamak için gereken kaynakları oluşturmaya ve dağıtmaya başlar.
Dağıtım işlemini gözden geçirmek ve izlemek için Görünüm menüsünde Çıkış'ı seçin. Çıkış penceresi araç çubuğu listesinden Azure Logic Apps'i seçin.
Visual Studio Code mantıksal uygulamanızı Azure'a dağıtmayı tamamladığında aşağıdaki ileti görüntülenir:
Tebrikler, mantıksal uygulamanız artık Azure'da canlıdır ve varsayılan olarak etkindir.
Ardından, şu görevleri gerçekleştirmeyi öğrenebilirsiniz:
dağıtılan mantıksal uygulamaları Visual Studio Code veya Azure portal kullanarak yönetin.
Durum bilgisi olmayan iş akışlarında çalıştırma geçmişini etkinleştirin.
Dağıtılan bir mantıksal uygulama için Azure portal izleme görünümünü etkinleştirin.
Projeye boş iş akışı ekleme
Mantıksal uygulama projenizde birden çok iş akışı olabilir. Projenize boş bir iş akışı eklemek için şu adımları izleyin:
Visual Studio Code Etkinlik Çubuğu'nda Azure simgesini seçin.
Azure bölmesinde, Azure: Logic Apps (Standart) öğesinin yanındaki İş Akışı Oluştur'u (Azure Logic Apps simgesi) seçin.
Eklemek istediğiniz iş akışı türünü seçin: Durum bilgisi olan veya Olmayan
İş akışınız için bir ad belirtin.
İşiniz bittiğinde, projenizde yeni bir iş akışı klasörü ve iş akışı tanımı için bir workflow.json dosyası görüntülenir.
Visual Studio Code'de dağıtılan mantıksal uygulamaları yönetme
Visual Studio Code'da, ister özgün Logic Apps ister Logic App(Standart) kaynak türü olsun, Azure aboneliğinizde dağıtılan tüm mantıksal uygulamaları görüntüleyebilir ve bu mantıksal uygulamaları yönetmenize yardımcı olacak görevleri seçebilirsiniz. Ancak her iki kaynak türüne de erişmek için hem Azure Logic Apps hem de Visual Studio Code için Azure Logic Apps (Standart) uzantılarına ihtiyacınız vardır.
Sol araç çubuğunda Azure simgesini seçin. Azure: Logic Apps (Standart) bölmesinde, bu abonelik için dağıtılan tüm mantıksal uygulamaları gösteren aboneliğinizi genişletin.
Yönetmek istediğiniz mantıksal uygulamayı açın. Mantıksal uygulamanın kısayol menüsünden gerçekleştirmek istediğiniz görevi seçin.
Örneğin, dağıtılan mantıksal uygulamanızı durdurma, başlatma, yeniden başlatma veya silme gibi görevleri seçebilirsiniz. Azure portal kullanarak bir iş akışını devre dışı bırakabilir veya etkinleştirebilirsiniz.
Not
Mantıksal uygulamayı durdurma ve mantıksal uygulama silme işlemleri iş akışı örneklerini farklı şekillerde etkiler. Daha fazla bilgi için Bkz. Mantıksal uygulamaları durdurma ile ilgili önemli noktalar ve Mantıksal uygulamaları silmeyle ilgili önemli noktalar.
Mantıksal uygulamadaki tüm iş akışlarını görüntülemek için mantıksal uygulamanızı genişletin ve ardından İş Akışları düğümünü genişletin.
Belirli bir iş akışını görüntülemek için iş akışının kısayol menüsünü açın ve İş akışını salt okunur modda açan Tasarımcıda Aç'ı seçin.
İş akışını düzenlemek için şu seçeneklere sahipsiniz:
Visual Studio Code'da projenizin workflow.json dosyasını iş akışı tasarımcısında açın, düzenlemelerinizi yapın ve mantıksal uygulamanızı Azure'a yeniden dağıtın.
Azure portal mantıksal uygulamanızı açın. Daha sonra iş akışınızı açabilir, düzenleyebilir ve kaydedebilirsiniz.
Dağıtılan mantıksal uygulamayı Azure portal açmak için mantıksal uygulamanın kısayol menüsünü açın ve Portalda Aç'ı seçin.
Azure portal tarayıcınızda açılır, Visual Studio Code oturum açtıysanız portalda otomatik olarak oturum açar ve mantıksal uygulamanızı gösterir.
Ayrıca Azure portal ayrı oturum açabilir, portal arama kutusunu kullanarak mantıksal uygulamanızı bulabilir ve ardından sonuç listesinden mantıksal uygulamanızı seçebilirsiniz.
Mantıksal uygulamaları durdurma konusunda dikkat edilmesi gerekenler
Mantıksal uygulamanın durdurulması, iş akışı örneklerini aşağıdaki yollarla etkiler:
Azure Logic Apps devam eden ve bekleyen tüm çalıştırmaları hemen iptal eder.
Azure Logic Apps yeni iş akışı örnekleri oluşturmaz veya çalıştırmaz.
Tetikleyiciler, koşulları karşılandığında tetiklemez. Ancak tetikleyici durumları mantıksal uygulamanın durdurulduğu noktaları anımsar. Bu nedenle, mantıksal uygulamayı yeniden başlatırsanız tetikleyiciler son çalıştırmadan bu yana tüm işlenmemiş öğeler için tetikler.
Son çalıştırmadan bu yana bir tetikleyicinin işlenmemiş öğelerde tetiklenmesini durdurmak için, mantıksal uygulamayı yeniden başlatmadan önce tetikleyici durumunu temizleyin:
- Visual Studio Code sol araç çubuğunda Azure simgesini seçin.
- Azure: Logic Apps (Standart) bölmesinde, bu abonelik için dağıtılan tüm mantıksal uygulamaları gösteren aboneliğinizi genişletin.
- Mantıksal uygulamanızı genişletin ve ardından İş Akışları adlı düğümü genişletin.
- Bir iş akışı açın ve bu iş akışının tetikleyicisinin herhangi bir bölümünü düzenleyin.
- Yaptığınız değişiklikleri kaydedin. Bu adım tetikleyicinin geçerli durumunu sıfırlar.
- Her iş akışı için yineleyin.
- İşiniz bittiğinde mantıksal uygulamanızı yeniden başlatın.
Mantıksal uygulamaları silme konusunda dikkat edilmesi gerekenler
Mantıksal uygulamanın silinmesi, iş akışı örneklerini aşağıdaki yollarla etkiler:
Azure Logic Apps devam eden ve bekleyen çalıştırmaları hemen iptal eder, ancak uygulama tarafından kullanılan depolama alanında temizleme görevlerini çalıştırmaz.
Azure Logic Apps yeni iş akışı örnekleri oluşturmaz veya çalıştırmaz.
Bir iş akışını silip aynı iş akışını yeniden oluşturursanız, yeniden oluşturulmuş iş akışı silinen iş akışıyla aynı meta veriye sahip olmaz. Meta verileri yenilemek için, silinen iş akışını çağıran tüm iş akışlarını yeniden kaydetmeniz gerekir. Bu şekilde, çağıran yeniden oluşturulmuş iş akışı için doğru bilgileri alır. Aksi takdirde, yeniden oluşturulmuş iş akışına yapılan çağrılar bir
Unauthorized
hatayla başarısız olur. Bu davranış, tümleştirme hesaplarında yapıtları kullanan iş akışları ve Azure işlevlerini çağıran iş akışları için de geçerlidir.
Portalda dağıtılan mantıksal uygulamaları yönetme
bir mantıksal uygulamayı Visual Studio Code'dan Azure portal dağıttıktan sonra, ister özgün Logic Apps kaynak türü ister Logic App (Standart) kaynak türü olsun, Azure aboneliğinizde bulunan tüm dağıtılan mantıksal uygulamaları görüntüleyebilirsiniz. Şu anda her kaynak türü Azure'da ayrı kategoriler olarak düzenlenmiş ve yönetilmektedir. Mantıksal Uygulama (Standart) kaynak türüne sahip mantıksal uygulamaları bulmak için şu adımları izleyin:
Azure portal arama kutusuna yazın
logic apps
. Sonuçlar listesi görüntülendiğinde Hizmetler'in altında Mantıksal uygulamalar'ı seçin.Mantıksal uygulamalar bölmesinde, Visual Studio Code dağıttığınız mantıksal uygulamayı seçin.
Azure portal, seçilen mantıksal uygulamanın tek tek kaynak sayfasını açar.
Bu mantıksal uygulamadaki iş akışlarını görüntülemek için mantıksal uygulamanın menüsünde İş Akışları'nı seçin.
İş Akışları bölmesi geçerli mantıksal uygulamadaki tüm iş akışlarını gösterir. Bu örnekte, Visual Studio Code'de oluşturduğunuz iş akışı gösterilmektedir.
Bir iş akışını görüntülemek için İş Akışları bölmesinde bu iş akışını seçin.
İş akışı bölmesi açılır ve bu iş akışında gerçekleştirebileceğiniz daha fazla bilgi ve görev gösterilir.
Örneğin, iş akışındaki adımları görüntülemek için Tasarımcı'yı seçin.
İş akışı tasarımcısı açılır ve Visual Studio Code oluşturduğunuz iş akışını gösterir. Artık Azure portal bu iş akışında değişiklik yapabilirsiniz.
Portalda başka bir iş akışı ekleme
Azure portal aracılığıyla, Visual Studio Code dağıttığınız mantıksal uygulama (Standart) kaynağına boş iş akışları ekleyebilir ve bu iş akışlarını Azure portal oluşturabilirsiniz.
Azure portal dağıtılan Mantıksal Uygulama (Standart) kaynağınızı seçin.
Mantıksal uygulama menüsünde İş Akışları'nı seçin. İş Akışları bölmesinde Ekle'yi seçin.
Yeni iş akışı bölmesinde iş akışı için ad belirtin. Durum Bilgisi Olan veya Durum Bilgisi Olmayan Oluştur'u> seçin.
Azure, İş Akışları bölmesinde görünen yeni iş akışınızı dağıtdıktan sonra tasarımcıyı veya kod görünümünü açma gibi diğer görevleri yönetebilmeniz ve gerçekleştirebilmeniz için bu iş akışını seçin.
Örneğin, tasarımcıyı yeni bir iş akışı için açtığınızda boş bir tuval gösterilir. Artık bu iş akışını Azure portal oluşturabilirsiniz.
Durum bilgisi olmayan iş akışları için çalıştırma geçmişini etkinleştirme
Durum bilgisi olmayan bir iş akışında daha kolay hata 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 çalışıyorsanız bkz. Azure portal tek kiracı tabanlı iş akışları oluşturma.
Visual Studio Code projenizde workflow-designtime adlı klasörü genişletin ve local.settings.json dosyasını açın.
Workflows.{yourWorkflowName}.operationOptions
özelliğini ekleyin ve değeriniWithStatelessRunHistory
olarak ayarlayın, örneğin:Windows
{ "IsEncrypted": false, "Values": { "AzureWebJobsStorage": "UseDevelopmentStorage=true", "FUNCTIONS_WORKER_RUNTIME": "node", "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory" } }
macOS veya Linux
{ "IsEncrypted": false, "Values": { "AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=fabrikamstorageacct; \ AccountKey=<access-key>;EndpointSuffix=core.windows.net", "FUNCTIONS_WORKER_RUNTIME": "node", "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory" } }
İşiniz bittiğinde çalıştırma geçmişini devre dışı bırakmak için özelliğini olarak
None
ayarlayınWorkflows.{yourWorkflowName}.OperationOptions
veya özelliği ve değerini silin.
Azure portal izleme görünümünü etkinleştirme
bir Mantıksal Uygulama (Standart) kaynağını Visual Studio Code Azure'a dağıttığınızda, Azure portal ve bu iş akışının İzleyici deneyimini kullanarak bu kaynaktaki bir iş akışının kullanılabilir çalıştırma geçmişini ve ayrıntılarını gözden geçirebilirsiniz. Ancak, önce bu mantıksal uygulama kaynağında İzleyici görünümü özelliğini etkinleştirmeniz gerekir.
Azure portal dağıtılan Mantıksal Uygulama (Standart) kaynağını seçin.
Bu kaynağın menüsündeki 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 uygulamanız diğer olaylarla birlikte telemetri de yayar. İş akışınızın ne kadar iyi çalıştığını ve Logic Apps çalışma zamanının çeşitli yollarla nasıl çalıştığını daha iyi görmek için bu telemetriyi kullanabilirsiniz. Neredeyse gerçek zamanlı telemetri (canlı ölçümler) sağlayan Application Insights'ı kullanarak iş akışınızı izleyebilirsiniz. Bu özellik, sorunları tanılamak, uyarıları ayarlamak ve grafikler oluşturmak için bu verileri kullandığınızda hataları ve performans sorunlarını daha kolay araştırmanıza yardımcı olabilir.
Mantıksal uygulamanızın oluşturma ve dağıtım ayarları Application Insights'ı kullanmayı destekliyorsa, isteğe bağlı olarak mantıksal uygulamanız için tanılama günlüğünü ve izlemeyi etkinleştirebilirsiniz. Mantıksal uygulamanızı Visual Studio Code veya dağıtımdan sonra dağıtırken bunu yapabilirsiniz. Bir Application Insights örneğiniz olması gerekir, ancak mantıksal uygulamanızı dağıtırken veya dağıtımdan sonra bu kaynağı önceden oluşturabilirsiniz.
Dağıtılan bir mantıksal uygulamada Application Insights'ı etkinleştirmek veya zaten etkinleştirildiğinde Application Insights verilerini gözden geçirmek için şu adımları izleyin:
Azure portal dağıtılan mantıksal uygulamanızı bulun.
Mantıksal uygulama menüsünde, Ayarlar'ın altında Application Insights'ı seçin.
Application Insights etkin değilse, Application Insights bölmesinde ApplicationInsights'ı aç'ı seçin. Bölme güncelleştirildikten sonra alt kısımda Uygula'yı seçin.
Application Insights etkinse , Application Insights bölmesinde Application Insights verilerini görüntüle'yi 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 konuları gözden geçirin:
- 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
Tasarımcıdan öğe silme
İş akışınızdaki bir öğeyi tasarımcıdan silmek için aşağıdaki adımlardan birini izleyin:
Öğeyi seçin, öğenin kısayol menüsünü (Shift+F10) açın ve Sil'i seçin. Onaylamak için Tamam’ı seçin.
Öğeyi seçin ve delete tuşuna basın. Onaylamak için Tamam’ı seçin.
Öğeyi seçerek ilgili öğe için ayrıntılar bölmesinin açılmasını sağlayın. Bölmenin sağ üst köşesinde üç nokta (...) menüsünü açın ve Sil'i seçin. Onaylamak için Tamam’ı seçin.
İpucu
Üç nokta menüsü görünmüyorsa, ayrıntılar bölmesinin sağ üst köşedeki üç nokta (...) düğmesini göstermesi için pencereyi yeterince geniş Visual Studio Code genişletin.
Hataları ve sorunları giderme
Tasarımcı açılamıyor
Tasarımcıyı açmaya çalıştığınızda "İş akışı tasarım zamanı başlatılamadı" hatasını alıyorsunuz. Daha önce tasarımcıyı açmayı denediyseniz ve ardından projenizi sonlandırdıysanız veya sildiyseniz uzantı paketi doğru indirilmiyor olabilir. Sorunun bu neden olup olmadığını denetlemek için şu adımları izleyin:
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 '{operationID}'. System.Private.CoreLib: The file 'C:\Users\{userName}\AppData\Local\Temp\Functions\ ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows\1.1.7\bin\ DurableTask.AzureStorage.dll' already exists. Value cannot be null. (Parameter 'provider') Application is shutting down... Initialization cancellation requested by runtime. Stopping host... Host shutdown completed.
Bu hatayı çözmek için bu konumdaki ExtensionBundles klasörünü silin ...\Users{kullanıcı adınız}\AppData\Local\Temp\Functions\ExtensionBundles ve workflow.json dosyasını tasarımcıda yeniden açmayı 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, Liquid İşlemleri ve XML İşlemleri için XML Doğrulama ve Dönüştürme XML gibi yerleşik eylemleri destekler. Ancak, daha önce oluşturulan mantıksal uygulamalarda bu eylemler, Visual Studio Code uzantı paketinin Microsoft.Azure.Functions.ExtensionBundle.Workflows
eski bir sürümünü kullanıp kullanmadığını seçmeniz için 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. Uygulama oluşturma sırasında Azure tarafından dağıtılan bağlayıcıları etkinleştirmediyseniz, bunları Visual Studio Code 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 bu adımları izleyerek eski paketi silin ve bu da Visual Studio Code uzantı paketini en son sürüme otomatik olarak güncelleştirmesini sağlar.
Not
Bu çözüm, Azure portal 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 tasarımcıda desteklenen tetikleyiciler ve eylemler eksik.
Kaybetmek istemediğiniz tüm çalışmaları kaydedin ve Visual Studio'yu kapatın.
Bilgisayarınızda, mevcut paket için sürümü oluşturulan klasörleri içeren aşağıdaki klasöre göz atın:
...\Users\{your-username}\.azure-functions-core-tools\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows
Ö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ümü oluşturulan klasörleri içeren aşağıdaki klasöre göz atın:
...\Users\{your-username}\.nuget\packages\microsoft.azure.workflows.webjobs.extension
Önceki paketin sürüm klasörünü silin.
tasarımcıda Visual Studio Code, projenizi 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, 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 ada sahip bir tetikleyicide veya eylemde görünebilir.
Bu sorunu çözmek ve daha uzun URI'ye göre ayarlamak için, aşağıdaki adımları izleyerek bilgisayarınızdaki ve UrlSegmentMaxLength
kayıt defteri anahtarlarını düzenleyinUrlSegmentMaxCount
. Bu anahtarın varsayılan değerleri, Windows için kayıt defteri ayarlarıHttp.sys bu konu başlığında 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.Kullanıcı Hesabı Denetimi kutusunda, bilgisayarınızda yaptığınız değişikliklere izin vermek için Evet'i seçin.
Sol bölmedeki Bilgisayar'ın altında yol üzerindeki düğümleri genişletin ,HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP\Parametersve ardından Parametreler'i seçin.
Sağ bölmede ve
UrlSegmentMaxLength
kayıt defteri anahtarlarını bulunUrlSegmentMaxCount
.URI'lerin kullanmak istediğiniz adları barındırabilmesi 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çimde girin. Örneğin,
400
onaltılık olarak ondalık ile1024
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 oluştu" 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 adlı klasörü genişletin ve tasks.json dosyasını açın.
Aşağıdaki görevde,
"dependsOn: "generateDebugSymbols"
önceki satırı sona erdiren virgülle birlikte satırını silin, örneğin:Önce:
{ "type": "func", "command": "host start", "problemMatcher": "$func-watch", "isBackground": true, "dependsOn": "generateDebugSymbols" }
Sonra:
{ "type": "func", "command": "host start", "problemMatcher": "$func-watch", "isBackground": true }
Sonraki adımlar
Azure Logic Apps (Standart) uzantısıyla yaşadığınız deneyimler hakkında sizden bilgi almak istiyoruz!
- Hatalar veya sorunlar için Sorunlarınızı GitHub'da oluşturun.
- Sorular, istekler, yorumlar ve diğer geri bildirimler için bu geri bildirim formunu kullanın.