Azure Logic Apps için iş akışı şablonları oluşturma ve yayımlama

Şunlar için geçerlidir: Azure Logic Apps (Tüketim + Standart)

Azure Logic Apps, tümleştirme uygulamaları oluşturma sürecini hızlandırmak için kullanabileceğiniz önceden oluşturulmuş, yeniden kullanılabilir otomasyon ve tümleştirme iş akışı şablonları sağlar. Bu şablonlar yaygın olarak kullanılan desenleri izler ve önceden tanımlanmış iş mantığı ve yapılandırmalarıyla bir başlangıç noktası veya temel sağlayarak geliştirmeyi kolaylaştırmanıza yardımcı olur.

Şablonlar, bağlantıları, parametreleri ve belgeleriyle birlikte bir veya daha fazla iş akışı içerebilir. Azure Logic Apps aşağıdaki şablon türlerini sunar:

Şablon türü	Açıklama
İş Akışı	Tek iş akışları oluşturan yeniden kullanılabilir şablonlar.
Hızlandırıcılar	Birden çok ilgili iş akışı içeren paketlenmiş çözümler.

Bu şablonları şablon galerisinde bulabilirsiniz. Şablonla başlayarak iş akışı oluşturmayı seçtiğinizde açılır. Galeri, ortak tasarım ve tümleştirme desenleri için Microsoft tarafından yazılmış şablonları zaten içerir.

İş akışı şablonlarını kullanarak geliştirmeye başlamakla kalmaz, aynı zamanda kuruluşunuzun azure aboneliğinde tek başına kullanımı için iş akışı şablonları oluşturup yayımlayabilir veya bunları başkalarıyla paylaşabilirsiniz. Şablonunuz şemalar, haritalar ve özel derlemeler gibi yapıtlar içerebilir.

Kuruluş şablonları tümleştirme desenlerini standartlaştırmanıza, en iyi yöntemleri paylaşmanıza ve çözümleri genel kullanıma açmadan kuruluşunuz genelinde yeniden kullanmanıza olanak sağlar. Bu özellik, esneklik için seçenekleri açık tutarken tutarlılığı artırmak isteyen işletmeler için özellikle yararlıdır. Senaryolarınız arasında iç API'leri ekleme, etki alanına özgü mantığı işleme veya mimari desenleri zorlama yer alırsa, kuruluş şablonları denetiminizi koruyarak ölçeklendirmenize ve büyütmenize yardımcı olur.

Azure Logic Apps şablonları size aşağıdaki özellikleri de sağlar:

• Şablonları test ya da üretim modunda yayımlayarak güvenli bir şekilde denemeler yapmanızı ve sürümleri kontrol etmenizi sağlar.

• API'leri ve iç sistemleri dışlaştırmaya gerek kalmadan doğrudan şablonlarda kullanın.

• Şablon paketlerini indirin ve isteğe bağlı olarak GitHub'daki Azure Logic Apps için genel iş akışı şablonu deposuna ekleyin.

• Azure DevOps'ta ekibinizin yapısını sağlayan ancak çevikliği koruyan yerleşik yaşam döngüsü yönetimini kullanarak şablonlarınızı testten üretim aşamasına geçirin.

• Azure'da birinci sınıf kaynaklar olarak şablonlar, Azure rol tabanlı erişim denetimini (RBAC) destekler.

  • Şablon izinlerini diğer Azure kaynakları gibi yönetebilirsiniz.

    Bu izinler abonelik ve rol kapsamlarına saygı gösterir. Bu, geliştiricilerin yalnızca geliştiricilerin erişimi olan aboneliklerde bu şablonları görebileceği ve bunlara erişebileceği anlamına gelir.

    Bu özellik, şablonları kimlerin yazabileceği, görüntüleyebileceği ve dağıtabileceği üzerinde kurumsal düzeyde denetim sağlar. Şablonları düzenleme yöntemi üzerinde tam denetim sahibi olursunuz, böylece doğru ekiplerin ihtiyaç duydukları otomasyon desenlerine erişmesini sağlayabilirsiniz.

Aşağıdaki ekran görüntüsünde, test ve üretim gibi durum etiketlerini gösteren örnek şablonlarla bir kuruluş ve Azure aboneliği kapsamındaki iş akışı şablonları galerisi gösterilmektedir:

Bu kılavuzda, bir iş akışı şablonunun nasıl oluşturulacağı ve yayımlanması aşağıdaki yollarla gösterilir:

• Yalnızca kuruluşunuzun kullanması için. Bkz. İş akışı şablonu oluşturma - Azure portalı.

  Bu yol, kaynak mantıksal uygulama iş akışlarını, şablonunuz hakkındaki bilgileri ve şablonu üretim ortamına bırakmadan önce test için yayımlama seçeneklerini belirtmek için Azure portalındaki sihirbazı kullanarak şablonunuzu oluşturmanıza neden oldu.

• Tüm Azure müşterilerinin kullanması için. Bkz. İş akışı şablonu oluşturma - El ile.

  Bu yol, şablon paketi oluşturmanızı ve paketi GitHub'daki Azure Logic Apps için genel iş akışı şablonu deposuna çekme isteği olarak göndermenizi gerektirir.

Önkoşullar

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

• Şablon için kaynak iş akışı tanımı olarak kullanılacak olan dağıtılmış Tüketim veya Standart mantıksal uygulama kaynağı ve iş akışı.

  Şablonunuzu oluşturmadan önce mantıksal uygulama kaynağınız ve iş akışınız dağıtılmalıdır. bu değerleri sabit kodlamak yerine iş akışının son kullanıcısının sağlaması gereken tüm değerleri doğru parametreleştirdiğinizden emin olun.

  Bu kaynak ve iş akışına sahip değilseniz aşağıdaki makalelere bakın:

  • Örnek tüketim mantıksal uygulaması iş akışı oluşturma

  • Örnek bir Standart mantıksal uygulama iş akışı oluşturma

• Şablonun oluşturduğu iş akışı için salt okunur önizleme görüntülerini gösteren ekran görüntüleri. Bu ekran görüntüleri için .png dosya adı uzantısını kullanın. Şablon için bu önizleme görüntüleri, şablon galerisindeki şablona genel bakış bölmesinde görünür.

  Şablonunuzun kullanabilmesi için bu görüntüleri depolamak için bir Azure depolama hesabına ve blob kapsayıcısına ihtiyacınız vardır.

  Bu görüntüleri oluşturmak için şu adımları izleyin:

  1. Azure portalında kaynak mantıksal uygulama kaynağını ve iş akışını tasarımcıda açın.

  2. İki ekran görüntüsü oluşturmak için iş akışını ayarlayın: bir web tarayıcısının açık temasıyla çalışan bir sürüm ve web tarayıcısının koyu temasıyla çalışan başka bir sürüm.

  3. Tercih ettiğiniz ekran yakalama aracını kullanarak ekran görüntülerini oluşturun. İş akışının çevresine çok fazla boşluk eklemeyin.

  4. .png dosya adı uzantısını ve Adlar ve stil kurallarına uygun bir ad kullanarak her görüntüyü kaydedin; örneğin, <görüntü-adı>-light.png ve <görüntü-adı>-dark.png.

  5. Görüntülerinizi Azure depolama hesabınızdaki blob kapsayıcısına ekleyin. Daha sonra şablonunuzdaki görüntülere başvurabilmeniz için her görüntünün blob URL'sini kopyalayın ve kaydedin.

     Önemli

     URL, depolama hizmetlerine izinler veren bir Paylaşılan Erişim İmzası (SAS) anahtarı veya belirteci içerir. Bir hesap anahtarını yetkisiz kullanıma karşı koruduğunuz gibi SAS anahtarınızı da koruduğunuzdan emin olun.

En iyi yöntemler

Bu liste, iş akışı şablonunuzu oluştururken izleyebileceğiniz en iyi yöntemleri sağlar:

• Tetikleyici ve eylem tanımlarında sabit kodlanmış özellikleri ve bunların değerlerini kullanmayın.

• Açıklayıcı ve yararlı açıklamalar ekleyerek tetikleyici ve eylem tanımları hakkında daha fazla bağlam sağlayın.

• Standart mantıksal uygulama kaynağı ve iş akışları

  • Yerleşik işlemleri mümkün olduğunca kullanın. Örneğin, Azure Blob Depolama bağlayıcısı Standart iş akışları için aşağıdaki sürümlere sahiptir:

    • Yerleşik hizmet sağlayıcısı işlemleri, Yerleşik filtresi altında bağlayıcılar galerisinde görünür. Bu sürümler, tek kiracılı Azure Logic Apps çalışma zamanıyla barındırılır ve çalıştırılır ve daha iyi performans, aktarım hızı ve diğer avantajlar sunar.

    • Azure tarafından barındırılan yönetilen API bağlayıcısı işlemleri , Paylaşılan filtresinin altındaki bağlayıcılar galerisinde görünür. Bu sürümler paylaşılan genel kaynaklar kullanılarak çok kiracılı Azure'da barındırılır ve çalıştırılır.

İş akışı şablonu oluşturma

İş akışı şablonunuzu yalnızca kuruluşunuz için mi yoksa Azure'daki herkes için mi kullanılabilir hale getirmek istediğinize bağlı olarak, ilgili adımları izleyin:

Sadece kuruluş

Bu adımlarda, yalnızca belirli bir Azure aboneliğindeki üyeler için kullanılabilen bir iş akışı şablonunun nasıl oluşturulacağı ve yayımlandığı açıklanır.

1. Azure portalı arama kutusunda logic apps şablonlarını bulun ve seçin.

2. Logic Apps Şablonları sayfa araç çubuğunda Oluştur'u seçin.

3. Azure Logic Apps şablonu oluşturma sayfasının Temel Bilgiler sekmesinde aşağıdaki bilgileri sağlayın:

   Parametre	Zorunlu	Değer	Açıklama
   Abonelik	Evet	< Azure aboneliği-adı>	İş akışı şablonuyla kullanılacak Azure aboneliği.
   Kaynak Grubu	Evet	< kaynak-grup-adı>	Şablonla kullanılacak Azure kaynak grubunun adı.
   İsim	Evet	< şablon-adı>	İş akışı şablonu kaynağının adı.
   Bölge	Evet	< Azure bölgesi>	İş akışı şablonu kaynağının oluşturulacağı Azure bölgesi.

4. İşiniz bittiğinde Gözden geçir ve oluştur'u seçin. Sağlanan bilgileri gözden geçirin ve Oluştur'u seçin.

   Azure şablon kaynağını oluşturur.

Ardından, şablonunuz için kullanılacak kaynak iş akışı tanımını seçin.

Kaynak iş akışı tanımını seçin

1. Şablon kaynağı menüsünde, Şablon'un altında Şablon'a tıklayın.

2. Şablon sayfasındaki İş Akışları sekmesinde Ekle'yi seçin.

3. Bu şablondaki iş akışlarını yönet bölmesindeki İş akışlarını seç sekmesinde aşağıdaki bilgileri sağlayın:

   Parametre	Zorunlu	Değer	Açıklama
   Abonelik	Evet	< Azure aboneliği-adı>	Azure aboneliğindeki kaynak mantıksal uygulamanın adı.
   Kaynak Grubu	Evet	< kaynak-grup-adı>	Azure kaynak grubunun kaynak mantıksal uygulaması için adı.
   Mantıksal uygulama örneği	Evet	< source-logic-app>	Kullanmak istediğiniz iş akışına sahip kaynak mantıksal uygulamanın adı.
   İş akışları	Evet	< kaynak-iş akışları>	Tüketim mantığı uygulaması için, şablonunuzda kullanılacak tek mevcut iş akışını seçin. Standart mantıksal uygulama için, şablonunuzda kullanmak üzere en az bir iş akışı seçin.

4. İşiniz bittiğinde İleriöğesini seçin.

5. İş akışlarını ayarla sekmesinde, seçilen her kaynak iş akışı için aşağıdaki bilgileri sağlayın:

   Parametre	Zorunlu	Değer	Açıklama
   İş akışı adı	Evet	< JSON-workflow-name>	yalnızca küçük harf, sayı ve kısa çizgi kullanabilen ve yalnızca bir kez yeniden adlandırabileceğiniz iş akışının JSON adı.
   Eyalet	Evet	Durumlu veya Durumsuz	varsayılan olarak iş akışı çalıştırma geçmişinin, işlem girişlerinin ve işlem çıkışlarının kaydedilip depolanmayacağı.
   Özet	Evet	< kısa açıklama>	Şablonun amacı hakkında kısa bir üst düzey özet.
   Açıklama	Hayır	< ayrıntılı açıklama>	Şablon hakkında daha ayrıntılı bilgi içeren bir açıklama.
   Önkoşullar	Hayır	< Önkoşullar>	Şablonu kullanabilmeniz için ihtiyacınız olan tüm gereksinimler.

6. İş akışı görüntüleri bölümünde, şablon galerisindeki şablona genel bakış bölmesi için kullanılacak iş akışı önizleme görüntülerini sağlayın. Bu bölme diğer şablon bilgilerini içerir.

   İş akışı görüntüsü	Açıklama
   Açık mod SAS URL'si	Azure depolama hesabınızdan bir blob kapsayıcısında depolanan basit temalı iş akışı önizleme görüntüsünün SAS URL'si.
   Koyu mod SAS URL'si	Azure depolama hesabınızdan bir blob kapsayıcısında depolanan koyu temalı iş akışı önizleme görüntüsünün SAS URL'si.

7. Bitirdiğinizde, Kaydet'i seçin.

   Şablonunuzu oluşturma işlemi sırasında istediğiniz zaman kaydedebilirsiniz. İlerlemenizi her kaydettiğinizde doğrulama, desteklenmeyen eylemler veya parametrelenmemiş değerler gibi hataların olup olmadığını belirlemek için otomatik olarak çalıştırılır. Hataları bulduğunuzda hemen düzeltmeniz gerekmez, ancak yayımlamadan önce düzeltmeniz gerekir.

8. Bağlantılar sekmesinde Azure'ın kaynak iş akışlarından otomatik olarak çektiği bağlantıları gözden geçirin ve onaylayın.

   Başka bir işlem yapmak zorunda değilsiniz.

9. Hazır olduğunuzda İleri'yi seçin.

Parametreleri özelleştirme

Parametreler sekmesinde, iş akışı için istediğiniz parametreler için özelleştirme ekleyin.

1. Parametreler sekmesinde parametrenin düzenle simgesini seçin.

2. parametresi için aşağıdaki bilgileri sağlayın:

   Mülkiyet	Zorunlu	Açıklama
   Görüntü adı	Evet	Azure portalında görüntülenen parametre adı.
   Varsayılan değer	Hayır	parametresi için varsayılan değer.
   Açıklama	Hayır	Parametrenin amacına yönelik açıklama.
   Gerekli Alan	Hayır	İş akışının parametresini gerektirip gerektirmediği.

3. Bitirdiğinizde, Kaydet'i seçin.

Şablon bilgilerini sağlayın

Profil sekmesi şablon galerisinde görüntülenen şablonunuz hakkındaki bilgileri (örneğin, şablonun görünen adı, yayımcı adı, bağlayıcılar ve diğer meta veriler) belirtir.

1. Profil sekmesinde şablonunuz hakkında aşağıdaki bilgileri sağlayın:

   Mülkiyet	Zorunlu	Açıklama
   Görüntü adı	Evet	Şablon galerisinde görünen iş akışı şablonunun adı.
   Tarafından	Evet	İş akışı şablonu yayımcı adı.
   Özet	Evet	Şablonun oluşturduğu iş akışının açıklaması.
   Öne çıkan bağlayıcılar	Evet	İş akışı şablonunda birincil bağlayıcı türlerini seçin.
   Kategori	Hayır	Şablonun ait olduğu kategori.
   Etiketler	Hayır	İş akışını etiketlemek için kullanmak istediğiniz etiketler.

2. Hazır olduğunuzda İleri'yi seçin.

3. Özet sekmesinde, sağlanan tüm bilgileri gözden geçirin ve onaylayın.

Test için yayımlama

Şablonunuzu test etmeye hazır olduğunuzda, şablonunuzu test için yayımlayabilirsiniz.

1. Özet sekmesinde veya önceki bir sekmede, sekmenin alt kısmındaki Kaydet listesinden Kaydet+ test için yayımla'yı seçin.

   

   Azure, Test etiketini görüntüleyen şablonu şablonlar galerisinde yayımlar.

2. Yeni şablonunuzu test etmek için , Önceden oluşturulmuş şablonlardan iş akışı oluşturma bölümünde yer alan adımları izleyin ancak şu adımları izleyin:

   1. Durum listesinden Test için yayımlandı seçeneğini seçin. Filtreler satırının altında Şablonlarım'ı seçin.

      Şablonunuz Test etiketiyle birlikte görünür, örneğin:

      

   2. İş akışınızı oluşturmayı, şablonunuzu test etme ve gerekli ayarlamaları yapmayı tamamlayın.

Üretim için yayınla

Şablon galerisinde şablon etiketini Test'tenÜretim'e değiştirmek için şu adımları izleyin:

1. Azure portalında şablon kaynağınızı bulun ve açın.

2. Şablon kenar çubuğundaki Şablon'un altında Şablon'a tıklayın.

3. Şablon sayfasında İleri'yi seçin ve Profil sekmesini açana kadar yineleyin.

4. Kaydet listesindenKaydet + üretim için yayımla'yı seçin.

   

Galeriden şablonu kaldırma

Özel iş akışı şablonunuzu şablon galerisinden geçici veya kalıcı olarak kaldırmak istiyorsanız, şablonu yayımdan kaldırabilirsiniz.

1. Azure portalında şablon kaynağınızı bulun ve açın.

2. Şablon kenar çubuğundaki Şablon'un altında Şablon'a tıklayın.

3. Şablon sayfasında İleri'yi seçin ve Profil sekmesini açana kadar yineleyin.

4. Kaydet listesinde Kaydet + şablonu yayımdan kaldır'ı seçin.

   

Tüm Azure

Bu adımlarda, Azure'da herkesin kullanabileceği bir iş akışı şablonu oluşturma ve yayımlama açıklanmaktadır. Bu yaklaşım için bir şablon paketi oluşturmanız gerekir.

Şablon paketinde ne var?

Aşağıdaki tabloda bir şablon paketindeki gerekli ve isteğe bağlı dosyalar açıklanmaktadır:

Dosya adı	Zorunlu	Açıklama
workflow.json	Evet	İş akışı tanımınıza sahip bir JSON dosyası.
manifest.json	Evet	İş akışınız ve ilgili bileşenler hakkında bilgi içeren bir JSON dosyası.
< resim-adı>-dark.png	Evet	İş akışını salt okunur bir ekran görüntüsü olarak içeren, .png biçiminde ve tarayıcının koyu temasıyla uyumlu bir görüntü dosyası.
< resim-adı>-light.png	Evet	İş akışını salt okunur bir ekran görüntüsü olarak içeren, .png biçiminde ve tarayıcının açık temasıyla uyumlu olan bir görüntü dosyası.
< map-name>.json, .xml veya .xslt	Hayır	İş akışı şablonunuzu destekleyen haritalar ve şemalar gibi her türlü öğe.
< Özel montaj>.dll	Hayır	İş akışı şablonunuzu destekleyen tüm özel derlemeler.
readme.md	Hayır	İş akışı şablonunuz için yönergeler, yordamlar veya diğer bilgileri içeren bir Markdown dosyası.

Ayrıca, şablonunuzu korumak ve desteklemek için başka dosyalar da ekleyebilirsiniz; örneğin, test veya örnek veri içeren dosyalar.

Şablon paketi klasörü oluşturma

• Şablon paketi klasörünü oluşturmadan önce Adlar ve stil kuralları hakkında bilgi edinin.

• Şablon deposuna göz atılmasını, düzenlenmesini ve bakımının daha kolay olmasını sağlamak için, dosya yollarının karakter sınırını aşmamak için klasör adınız için aşağıdaki söz dizimini ve en az sayıda sözcüğü kullanın:

  < workflow-task>-<product>-<pattern-or-protocol, varsa>

  Örnekler için GitHub'da Azure Logic Apps için iş akışı şablonu deposuna bakın.

• Şablon paketi klasörünüzü doğru kaydetmek için klasör adını deponun kök düzeyindeki manifest.json dosyasına eklemeniz gerekir.

workflow.json dosyası oluşturma

workflow.json dosyası, JSON biçiminde bir iş akışının temel tanımını içerir. workflow.json dosyasını oluşturmak için iş akışı tanımınızı kopyalayıp workflow.json adlı bir dosya olarak kaydetmeniz gerekir.

İş akışı tanımını almanın en kolay ve en iyi yolu için tasarımcıyı kullanarak iş akışınızı oluşturun. Adlar ve stil kurallarıyla birlikte İş akışı en iyi yöntemlerini gözden geçirmeyi unutmayın. Veya başlangıç noktası olarak, Azure portalındaki şablonlar galerisinden önceden oluşturulmuş iş akışı şablonlarını kullanabilirsiniz.

İş akışınızı oluştururken tasarımcı, temel alınan iş akışı tanımında eklenen yerleşik, hizmet sağlayıcısı bağlantıları, yönetilen API bağlantıları veya kitaplıklara otomatik olarak başvurular içerir.

İşiniz bittiğinde, temel alınan iş akışı tanımını boş bir workflow.json dosyasına kopyalayın.

Temel iş akışı tanımını kopyalayın

1. Azure portalında, iş akışı menüsündeki Geliştirici'nin altında Kod'a tıklayın.

2. Kod görünümü penceresinden iş akışı tanımının tamamını kopyalayın, örneğin:

   

3. workflow.json adlı boş bir dosyaya iş akışı tanımını kaydedin.

workflow.json içindeki parametre referansları

workflow.json dosyasındaki parametrelere başvururken, _#workflowname# sonekini kullanan parametre adlarını aşağıdaki şekilde yansıtmanız gerekir:

"name": "@parameters('<parameter-name>_#workflowname#')"

Örneğin:

"name": "@parameters('sharepoint-folder-path_#workflowname#')"

workflow.json içindeki bağlantı referansları

workflow.json dosyasındaki bağlantılara başvurduğunuz zaman, _#workflowname# son ekini kullanan bağlantı adlarını aşağıdaki şekilde yansıtmalısınız:

"referenceName": "<connector-ID>_#workflowname#",
"connectionName": "<connector-ID>_#workflowname#"

Örneğin:

"referenceName": "azureaisearch_#workflowname#",
"connectionName": "azureaisearch_#workflowname#"

Bağlayıcı kimliği hakkında daha fazla bilgi için bkz . Bağlayıcı kimliğini bulma.

manifest.json dosyası oluşturma

manifest.json dosyası, bir iş akışı ile ilgili bileşenler arasındaki ilişkiyi açıklar. Şu anda bu dosyayı el ile oluşturmanız gerekir veya GitHub'daki Azure Logic Apps iş akışı şablonu deposundaki önceden oluşturulmuş mevcut bir şablondan manifest.json dosyasını yeniden kullanabilirsiniz. manifest.json dosyasını oluştururken adları ve stil kurallarını gözden geçirmeyi unutmayın.

Aşağıdaki tabloda manifest.json dosyasındaki öznitelikler açıklanmaktadır:

Öznitelik adı	Zorunlu	Değer	Açıklama
title	Evet	< şablon başlığı>	Azure portalında bir şablondan iş akışı eklediğinizde açılan şablonlar galerisinde görüntülenen başlık.
description	Evet	< şablon açıklaması>	Şablon galerisindeki şablonun genel bakış bölmesinde görünen şablon açıklaması.
prerequisites	Hayır	< şablon önkoşulları>	Şablonu kullanmak için karşılanması gereken tüm önkoşullar. Şablonun genel bakış bölmesinde görünür. Bu bölümden diğer belgelere bağlanabilirsiniz.
tags	Hayır	< template-tags-array>	Şablonları aramak veya filtrelemek için kullanılacak şablon etiketleri.
skus	Evet	standard, consumption	Şablon tarafından desteklenen mantıksal uygulama iş akışı türü. Emin değilseniz kullanın standard.
kinds	Hayır	stateful, stateless	Çalıştırma geçmişi ve işlem durumlarının depolanıp depolanmadığını belirleyen iş akışı modu. Varsayılan olarak, tüm iş akışları hem durum bilgisi olan hem de durum bilgisi olmayan modda kullanılabilir. İş akışınız yalnızca durum bilgisi olan modda çalışıyorsa, bu gereksinimi açık hale getirmek için bu özniteliği kullanın.
detailsDescription	Hayır	Açıklamaya bakın.	Şablonla ilgili diğer ayrıntılı açıklama bilgileri.
details	Hayır	Açıklamaya bakın.	Şablon galerisini filtrelemek için kullanılacak şablon bilgileri. - By: Şablon yayımcısı, örneğin, Microsoft. - Type: Workflow - Trigger: Tetikleyici türü, örneğin, Recurrence, Eventveya Request.
artifacts	Evet	< artifakt-dizisi>	Şablon paketindeki tüm ilgili dosyalar ve aşağıdaki öznitelikleri içerir: - type: Dosyanın kopyalanması için uygun konumu belirleyen dosya türü, örneğin, workflow. - file: Dosya adı ve uzantısı, örneğin workflow.json.
images	Evet	Açıklamaya bakın.	Tarayıcının hem açık hem de koyu temaları için iş akışı görüntüsü dosya adları: - light: Açık tema için görüntü adı, örneğin workflow-light - dark: Koyu tema için görüntü adı, örneğin workflow-dark.
parameters	Evet, ancak hiçbiri mevcut değilse boş olabilir	< iş akışı-parametreleri-dizi>	İş akışı şablonundaki eylemlerin parametreleri. Her parametre için aşağıdaki özellikleri belirtmeniz gerekir: - name: Parametre adının _#workflowname# son ekine sahip olması gerekir. Yalnızca alfasayısal karakterleri, kısa çizgileri veya alt çizgileri kullanın ve şu biçimi izleyin: <parameter-name>_#workflowname# - displayName: Parametrenin kolay görünen adı. Bkz. Adlar ve stil kuralları. - type: Parametrenin veri türü, örneğin veya StringInt. - default: Varsa parametrenin varsayılan değeri. Yoksa, bu değeri boş bir dize olarak bırakın. - description Parametrenin ayrıntıları ve diğer önemli veya yararlı bilgiler. - required: true veya false
connections	Evet, ancak hiçbiri yoksa boş olabilir.	< bağlantılar-dizisi>	İş akışı şablonu kullanılarak oluşturulacak bağlantılar. Her bağlantı aşağıdaki özelliklere sahiptir: - connectorId: Bağlayıcı kimliği son ekine _#workflowname#sahip olmalıdır. Yalnızca alfasayısal karakterleri, kısa çizgileri veya alt çizgileri kullanın ve şu biçimi izleyin: <connector-ID>_#workflowname# Bağlayıcı kimliğini bulmak için bkz . Bağlayıcı kimliğini bulma. - kind: Bağlayıcının çalışma zamanı ana bilgisayar türüdür; bu tür, yerleşik işlemler ve hizmet sağlayıcısı bağlayıcıları için inapp ya da yönetilen, Azure tarafından barındırılan bağlayıcılar için shared olabilir. Bağlayıcılar galerisinde, yerleşik işlemler ve hizmet sağlayıcısı bağlayıcıları Uygulamada olarak, yönetilen bağlayıcılar ise Paylaşılan olarak etiketlenir.
featuredConnections	Hayır	< öne çıkan bağlantılar dizisi>	Şablonlar galerisi varsayılan olarak, her şablon tarafından kullanılan Azure Logic Apps'te önceden oluşturulmuş işlemlerin ve bağlayıcıların simgelerini gösterir. Diğer işlemlerin simgelerini eklemek için özniteliğini featuredConnections kullanabilirsiniz. Her işlemin aşağıdaki öznitelikleri olmalıdır: - kind: İşlem türü - type: İşlem türü Bu değerleri bulmak için featuredConnections bölümü için işlem çeşidi ve türünü bulma konusuna bkz.

İş akışı şablonu paketiniz için manifest.json dosyasında, aynı görüntü adlarını images bölümüne .png dosya adı uzantısı olmadan ekleyin, örneğin:

"images": {
    "dark": "workflow-dark",
    "light": "workflow-light"
}

Bağlayıcı kimliğini bulma

manifest.json dosyasındaki bir bağlantı veya workflow.json dosyasında bağlantı başvurusu için kullanılacak bağlayıcı kimliğini bulmak için şu adımları izleyin:

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

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

3. JSON Görünümü sekmesini seçin.

4. Bağlantı türüne bağlı olarak şu adımları izleyin:

   • Azure’da barındırılan ve çalıştırılan yönetilen, "paylaşılan" bir API bağlantısı için:

     1. managedApiConnections Bölümünü bulun.

     2. connection özniteliğinde, id değerini kopyalayıp kaydedin, ancak abonelik kimliği, kaynak grubu adı gibi kişisel veya hassas verileri #<item># ile değiştirin:

        /subscriptions/#subscription#/providers/Microsoft.Web/locations/#location#/managedApis/<connection-name>

        Örneğin, aşağıdaki metinde SharePoint bağlayıcısının bağlayıcı kimliği gösterilir:

        /subscriptions/#subscription#/providers/Microsoft.Web/locations/#location#/managedApis/sharepointonline

   • Tek kiracılı Azure Logic Apps çalışma zamanında barındırılan bir hizmet sağlayıcı bağlantısı için:

     1. serviceProviderConnections Bölümünü bulun.

     2. Her bağlantı için, id özniteliğinde serviceProvider özniteliğini bulun.

     3. Aşağıdaki değeri kopyalayın ve kaydedin:

        /serviceProviders/<connection-name>

        Örneğin, aşağıdaki metinde Azure Yapay Zeka Arama bağlayıcısının bağlayıcı kimliği gösterilmektedir:

        /serviceProviders/azureaisearch.

FeaturedConnections için 'kind' ve 'type' işleminin özelliklerini bulun

manifest.json dosyasındaki bölüm, Azure portalındaki featuredConnections şablonlar galerisine eklemek istediğiniz diğer işlemlerin simgelerini içerebilir. Bir dizi olan bu bölüm için, her işlemde kind ve type özniteliklerini sağlamanız gerekir.

Bu öznitelik değerlerini almak için Azure portalında açık iş akışınızla şu adımları izleyin:

1. İş akışı menüsündeki Geliştirici'nin altında Kod'a tıklayın.

2. Kod görünümü penceresinde, actions bölümünde istediğiniz işlemi bulun ve ardından kind ile type değerlerini bulun.

GitHub deposuna şablon paketi ekleme

Şablon paketinizi Azure portalındaki iş akışı şablonları galerisinde yayımlamak için GitHub hesabınızı ayarlamanız, Azure Logic Apps için GitHub'daki iş akışı şablonu deposunu ziyaret etmeniz ve Azure Logic Apps ekibinin çekme isteğinizi gözden geçirebilmesi ve doğrulayabilmesi için şablon paketiniz için bir çekme isteği oluşturmanız gerekir

1. Hesabınız yoksa bir GitHub hesabı oluşturun.

   Daha fazla bilgi için bkz . GitHub hesabınızı kullanmaya başlama.

2. GitHub'da Azure Logic Apps için LogicAppsTemplates adlı iş akışı şablonu deposuna gidin.

3. GitHub'daki LogicAppsTemplates deposunun uzak kopyası olan kendi çatalınızı oluşturun.

   Daha fazla bilgi için bkz . Depo oluşturma.

4. Yerel olarak çalışmak için çatalınızı bilgisayarınıza kopyalayın.

   1. Git'i indirmek, yüklemek ve ayarlamak için bu adımları izleyin.

   2. Aşağıdaki URL'ye sahip çatalınıza gidin:

      https://github.com/<your-username>/LogicAppsTemplates

   3. Yerel bilgisayarınızda, henüz yoksa GitHub adlı bir klasör oluşturun. OneDrive ile eşitlenen bir klasöre klonlamayın.

   4. Üretim deposunu değil, kendi fork’unuzu klonlamak için bu adımları izleyin.

   5. Yerel deponuzda, çalışma dalı oluşturmak için bu adımları izleyin.

   6. Çalışma dalınıza geçtikten sonra yerel deponuzun kök dizinine gidin ve şablon paketi klasörünü oluşturun.

   7. Şablon dosyalarınızı şablon paketi klasörüne ekleyin ve kök düzeyindeki manifest.json dosyasını klasör adıyla güncelleştirin.

   8. Değişikliklerinizi yerel deponuza (anlık görüntü kaydetme gibi) işlemeye hazır olduğunuzda Git komut satırı aracını veya diğer araçları kullanarak aşağıdaki komutları çalıştırın:

      git add .

      git commit -m "<commit-short-description>"

   9. Anlık görüntünüzü uzak fork'unuza yüklemek için aşağıdaki komutu çalıştırın:

      git push origin <your-working-branch>

5. GitHub'da, < deposunda > dalını main dalıyla karşılaştırmak için bir çekme isteği oluşturun.

   1. Deponun Pull requests sayfasına gidin ve New pull request seçeneğini belirleyin.

   2. Değişiklikleri karşılaştır altında, Çatallar arasında karşılaştır seçeneğini belirleyin.

   3. Çekme isteğinizin aşağıdaki ayarlara sahip olduğundan emin olun ve çekme isteği oluştur'u seçin.

      Temel depo	Temel	Baş depo	Karşılaştır
      Azure/LogicAppsTemplates	ana işlev	< kullanıcı adı>/LogicAppsTemplates	< çalışma dalınız>

      

   4. Pull request’iniz için bir başlık ve açıklama girin. Tamamlamak için Pull request oluştur'u seçin.

   5. Azure Logic Apps ekibinin çekme talebinizi gözden geçirmesini bekleyin.

   Daha fazla bilgi için çatallanmış bir depodan çekme isteği oluşturma bölümüne bakın.

Adlar ve stil kuralları

Alan	Uzlaşım
Hassas veriler	Şablon dosyalarına, ekran görüntülerine, açıklamalara veya test verilerine kişisel ve hassas veriler eklemeyin veya karşıya yüklemeyin. Örneğin, bu veriler abonelik kimliklerini, kullanıcı adlarını, parolaları vb. içerir.
Klasör adları	Daha kolay okunabilirlik için mümkün olduğunda küçük harf ve kısa çizgi kullanın. Bkz. Büyük Harf Kullanımı – Microsoft Stil Kılavuzu.
Resim dosyası adları	Dosya adı uzantısı olarak .png, küçük harfler ve kısa çizgiler kullanın; örneğin, workflow-light.png.
Ürün, hizmet, teknoloji ve marka adları	Resmi yazım ve büyük harf kullanımını izleyin. Örneğin: - Hizmet adına veya platforma başvurarak "Logic Apps" yerine "Azure Logic Apps" kullanın. - Kaynağa veya örneğe başvurarak "Logic App" veya "Logic Apps" yerine "logic apps" veya "logic app" kullanın. - Tetikleyici ve eylem dizisine atıfta bulunurken "logic app workflow" veya "workflow" ifadelerini kullanın.
Kısaltmalar ve akronimler	Ürün, hizmet, teknoloji ve marka adları ile alışılmadık teknik terimler için kısaltmalar veya akronimler yerine açık biçimlerini kullanın. "HTTP" ve "URL" gibi yaygın kısaltmalar kabul edilebilir. Örneğin, "VS Code" yerine "Visual Studio Code" kullanın. Bkz . Kısaltmalar – Microsoft Stil Kılavuzu.
Diğer metin	- Başlıklar, alt başlıklar ve gövde metni için cümle düzenini kullanın; yani ürün, hizmet, teknoloji veya marka adı söz konusu olmadıkça yalnızca ilk harfi büyük yazın. - "a", "an", "and", "or", "the" gibi sıradan isimleri ve makaleleri büyük harfle yazmayın.
Ses	- Belirli rollere başvurmanız gerekmediği sürece üçüncü kişi (kullanıcılar, geliştiriciler, müşteriler) yerine ikinci kişi sesini (siz ve sizin) kullanın. Bkz. Kişi – Microsoft Stil Kılavuzu. - Mümkün olduğunda aktif, doğrudan ama kolay bir ton kullanın. Etkin ses metindeki konuya ve fiillere odaklanırken, pasif ses metindeki nesneye odaklanır.
Lügatçe	- "istifade etmek" veya "yararlanmak" yerine "kullanmak" gibi basit, yaygın, gündelik sözcükler kullanın. - Diller arasında iyi çevrilmemiş sözcükler, ifadeler, jargon, kollokializmler, deyimler veya argo kullanmayın. - Yalnızca belirli senaryolar için "lütfen" kullanın. Bkz. lütfen – Microsoft Stil Kılavuzu. - "e.g." veya "i.e." değil, "örneğin" ya da "gibi" kullanın. - Erişilebilir olmayan "here", "above", "below", "right" ve "left" gibi yön terimlerini kullanmayın.
Noktalama işaretleri	- Bir dizi öğe için, "ve" gibi bağlamadan önceki son virgülleri ekleyin. Örneğin, "elmalar, portakallar ve muzlar". Bkz. Virgüller – Microsoft Stil Kılavuzu. - Tümceleri uygun noktalama işaretleriyle sonlandır. Ünlem işareti kullanmayın. Bkz. Noktalama – Microsoft Stil Kılavuzu.
Biçimlendirme	- Kodda, ilgili programlama dilinin stil kurallarına uyun. - URL'ler değişirse kesilen sabit kodlanmış bağlantıları kullanmayın. PR isteğinizde, bunun yerine kullanabileceğiniz bir yönlendirme bağlantısı talep edin. - Bağlantılar için aşağıdaki biçimi kullanın: For more information, see [descriptive-link-text](URL)]. - "See [here](URL)" gibi genel veya belirsiz bağlantı metni yerine açıklayıcı bağlantı metni kullanın. - Sayıları yalnızca yordamdaki adımlar için kullanın, belirli bir sırası olmayan listeler için kullanmayın. Bkz. Listeler – Microsoft Stil Kılavuzu. - Kodu girintilemediğiniz sürece noktalama işaretlerinden sonra yalnızca bir boşluk kullanın.

Daha fazla kılavuz için bkz . Microsoft Stil Kılavuzu ve Genel yazma ipuçları.

İlgili içerik

Önceden oluşturulmuş şablonlardan mantıksal uygulama iş akışları oluşturma