Azure Logic Apps'te değerleri depolamak ve yönetmek için değişkenler oluşturma
Şunlar için geçerlidir: Azure Logic Apps (Tüketim + Standart)
Bu nasıl yapılır kılavuzunda, mantıksal uygulama iş akışınızda değerleri depolayıp kullanabilmek için değişkenler oluşturma ve bunlarla çalışma gösterilmektedir. Örneğin, değişkenler bir döngünün kaç kez çalıştırıldığını izlemenize yardımcı olabilir. Bir diziyi yinelemek veya belirli bir öğenin dizisini denetlemek için, her dizi öğesinin dizin numarasına başvurmak için bir değişken kullanabilirsiniz.
Tamsayı, kayan, Boole, dize, dizi ve nesne gibi veri türleri için değişkenler oluşturabilirsiniz. Bir değişken oluşturduktan sonra, diğer görevleri gerçekleştirebilirsiniz, örneğin:
- Değişkenin değerini alın veya bu değere başvuru yapın.
- Değişkeni artış ve azalma olarak da bilinen sabit bir değerle artırın veya azaltın.
- Değişkene farklı bir değer atayın.
- Bir dizeye veya diziye, değişkenin değerini son öğe olarak yerleştirin veya ekleyin.
Değişkenler vardır ve yalnızca bunları oluşturan iş akışı örneğinde geneldir. Ayrıca, bir iş akışı örneği içindeki tüm döngü yinelemelerinde kalıcı olur. Bir değişkene başvuru yaptığınızda belirteç olarak, genellikle eylemin çıktılarına başvurmak için kullanılan eylem adı yerine değişken adını kullanın.
Önemli
Varsayılan olarak, her döngü için içindeki yinelemeler paralel olarak çalıştırılır. Döngülerde değişkenleri kullandığınızda, değişkenlerin tahmin edilebilir sonuçlar döndürmesi için döngünü sıralı olarak çalıştırın.
Önkoşullar
Bir Azure hesabı ve aboneliği Aboneliğiniz yoksa ücretsiz bir Azure hesabına kaydolun.
Değişkenini oluşturmak istediğiniz mantıksal uygulama iş akışı ve iş akışını başlatan bir tetikleyici.
Değişkenler oluşturmaya ve değişkenlerle çalışmaya yönelik eylemler ekleyebilmeniz için önce iş akışınızın ilk adımı olarak bir tetikleyiciyle başlamanız gerekir. Daha fazla bilgi için bkz . Tetikleyici veya eylemle iş akışı oluşturma.
Aşağıdaki adımlarda Azure portalı kullanılır, ancak uygun Azure Logic Apps uzantısıyla mantıksal uygulama iş akışları oluşturmak için aşağıdaki araçları da kullanabilirsiniz:
- Tüketim iş akışları: Visual Studio Code
- Standart iş akışları: Visual Studio Code
Tüketim veya Standart iş akışınız olup olmadığına bağlı olarak, ilgili adımları izleyin:
Değişkeni başlat
Bir değişken oluşturabilir ve iş akışınızda tek bir eylem kullanarak veri türünü ve ilk değerini bildirebilirsiniz. Değişkenleri kapsamlar, koşullar ve döngülerde değil, yalnızca genel düzeyde belirtebilirsiniz.
Tasarımcıda, Değişkeni başlat adlı bir eylem eklemek için bu genel adımları izleyin.
Değişkeniniz hakkında aşağıdaki bilgileri sağlayın:
Özellik Zorunlu Değer Açıklama Adı Evet <variable-name> Artırılacak değişkenin adı Tür Evet <variable-type> Değişkenin veri türü Değer Hayı <start-value> Değişkeninizin başlangıç değeri
İpucu: İsteğe bağlı olsa da, değişkeninizin başlangıç değerini her zaman bilmeniz için değeri en iyi yöntem olarak ayarlayın.Aşağıdaki örnekte bu örnek değişkenin başlangıç değerleri gösterilmektedir:
Şimdi senaryonuz için istediğiniz eylemleri eklemeye devam edin. İşlemi tamamladığınızda tasarımcı araç çubuğunda Kaydet'i seçin.
Tasarımcıdan kod görünümüne geçerseniz, aşağıdaki örnekte Değişken başlatma eyleminin JavaScript Nesne Gösterimi (JSON) biçimindeki iş akışı tanımınızda nasıl göründüğü gösterilir:
"actions": {
"Initialize_variable": {
"type": "InitializeVariable",
"inputs": {
"variables": [
{
"name": "Count",
"type": "Integer",
"value": 0
}
]
},
"runAfter": {}
}
},
Not
Değişken başlat eyleminde dizi olarak yapılandırılmış bir "variables"
nesne olsa da, eylem aynı anda yalnızca bir değişken oluşturabilir. Her yeni değişken, ayrı bir Değişkeni başlat eylemi gerektirir.
Aşağıdaki örneklerde diğer değişken türleri gösterilmektedir:
Boole değişkeni
"actions": {
"Initialize_variable": {
"type": "InitializeVariable",
"inputs": {
"variables": [
{
"name": "myBooleanVariable",
"type": "boolean",
"value": false
}
]
},
"runAfter": {}
}
},
Kayan değişken
"actions": {
"Initialize_variable": {
"type": "InitializeVariable",
"inputs": {
"variables": [
{
"name": "myFloatVariable",
"type": "float",
"value": 1.99999
}
]
},
"runAfter": {}
}
},
Dize değişkeni
"actions": {
"Initialize_variable": {
"type": "InitializeVariable",
"inputs": {
"variables": [
{
"name": "myStringVariable",
"type": "string",
"value": "lorem ipsum"
}
]
},
"runAfter": {}
}
},
Nesne değişkeni
"actions": {
"Initialize_variable": {
"type": "InitializeVariable",
"inputs": {
"variables": [
{
"name": "MyObjectVariable",
"type": "object",
"value": {
"ProductItem": {
"Name": "myProductName",
"ProductID": "000000"
}
}
}
]
},
"runAfter": {}
}
},
Tamsayılar içeren dizi
"actions": {
"Initialize_variable": {
"type": "InitializeVariable",
"inputs": {
"variables": [
{
"name": "myArrayVariable",
"type": "array",
"value": [1, 2, 3]
}
]
},
"runAfter": {}
}
},
Dizeler içeren dizi
"actions": {
"Initialize_variable": {
"type": "InitializeVariable",
"inputs": {
"variables": [
{
"name": "myArrayVariable",
"type": "array",
"value": ["red", "orange", "yellow"]
}
]
},
"runAfter": {}
}
},
Değişkenin değerini alma
Bir değişkenin içeriğini almak veya bunlara başvurmak için iş akışı tasarımcısında ve kod görünümü düzenleyicisinde variables() işlevini kullanabilirsiniz. Bir değişkene başvuru yaptığınızda belirteç olarak, genellikle eylemin çıktılarına başvurmak için kullanılan eylem adı yerine değişken adını kullanın.
Örneğin, aşağıdaki ifade işlevi kullanılarak bu kılavuzda oluşturulan dizi değişkenindeki variables()
öğeleri alır. string()
işlevi, değişkenin içeriklerini dize biçiminde döndürür: "1, 2, 3, red"
@{string(variables('myArrayVariable'))}
Değişkeni artırma
Bir değişkeni belirli bir sabit değere göre artırmak veya artırmak için, değişkenini artırma eylemini iş akışınıza ekleyin. Bu eylem yalnızca tamsayı ve kayan değişkenlerle çalışır.
İş akışı tasarımcısında, Increment değişkeni adlı bir eylem eklemek için bu genel adımları izleyin.
Bu eylem için aşağıdaki bilgileri sağlayın:
Özellik Zorunlu Değer Açıklama Adı Evet <variable-name> Artırılacak değişkenin adı Değer Hayır <increment-value> Değişkeni artırmak için kullanılan değer. Varsayılan değer şudur: 1
.
İpucu: İsteğe bağlı olsa da, değişkeninizi artırmaya yönelik belirli değeri her zaman bilmeniz için bu değeri en iyi yöntem olarak ayarlayın.Aşağıdaki örnekte bu eylemin örnek değerleri gösterilmektedir:
Tamamladığınızda, iş akışınızı kaydedin. Tasarımcı araç çubuğunda Kaydet'i seçin.
Tasarımcıdan kod görünümüne geçerseniz aşağıdaki örnekte, JSON biçimindeki iş akışı tanımınızda Artış değişkeni eyleminin nasıl göründüğü gösterilir:
"actions": {
"Increment_variable": {
"type": "IncrementVariable",
"inputs": {
"name": "Count",
"value": 1
},
"runAfter": {}
}
},
Örnek: Döngü sayacı oluşturma
Değişkenler, yaygın olarak bir döngünün kaç kez çalışacağını saymak için kullanılır. Bu örnek, e-postadaki ekleri sayan bir döngü oluşturarak bu görev için değişkenleri nasıl oluşturabileceğinizi ve kullanabileceğinizi gösterir.
Azure portalında Boş bir iş akışıyla Tüketim mantığı uygulaması kaynağınızı oluşturun. Yeni e-postaları ve ekleri denetleyen bir tetik ekleyin.
Bu örnekte, Yeni bir e-posta geldiğinde seçeneği için Office 365 Outlook tetikleyicisi kullanılır. Bu tetikleyiciyi yalnızca e-postada ek olduğunda tetiklenecek şekilde ayarlayabilirsiniz. Bununla birlikte, Outlook.com bağlayıcısı gibi ek içeren yeni e-postaları denetleyen herhangi bir bağlayıcıyı kullanabilirsiniz.
Tetikleyicide, ekleri denetlemek ve bu ekleri iş akışınıza geçirmek için aşağıdaki özellikler için Evet'i seçin:
- Yalnızca Ek ile
- Ekleri Ekle
Her ekte yineleme yapmak için bu genel adımları izleyerek Her döngü için adlı bir eylem ekleyin.
Döngüde, Önceki adımlardan bir çıkış seçin adlı kutunun içini seçin. Dinamik içerik listesi göründükten sonra, Yeni bir e-posta geldiğinde altında Ekler'i seçin.
Ekler özelliği, tetikleyicinin çıkışındaki e-posta eklerini içeren bir diziyi iş akışınızın yinelemesi için döngüye geçirir.
Her döngü için bölümünde Eylem ekle'yi seçin.
Döngüye Increment değişkeni adlı bir eylem eklemek için bu genel adımları izleyin.
Not
Artım değişkeni eyleminin döngünün içinde göründüğünden emin olun. Eylem döngünün dışında görünüyorsa, eylemi döngüye sürükleyin.
Değişkeni artır eyleminde Ad listesinden Count değişkenini seçin. Value özelliğini olarak
1
ayarlayın.Döngünün altında, size ek sayısını gönderen bir eylem ekleyin. Eyleminizde Count değişkeninin değerini ekleyin. Örneğin:
Tamamladığınızda, iş akışınızı kaydedin. Tasarımcı araç çubuğunda Kaydet'i seçin.
İş akışınızı test etme
İş akışınızı el ile tetikleme için ilgili adımı izleyin:
Tüketim iş akışı
İş akışınızı el ile çalıştırmak için tasarımcı iş akışı araç çubuğunda Tetikleyici>Çalıştırmayı Çalıştır'ı seçin.
Standart iş akışı
İş akışı menüsünde Genel Bakış'ı seçin. Araç çubuğunda Çalıştır'ı> seçin.
Bu örnekte kullandığınız e-posta hesabına bir veya daha fazla ek içeren bir e-posta gönderin.
Bu adım, bir iş akışı örneği oluşturan ve çalıştıran iş akışı tetikleyicisini tetikler. Sonuç olarak, iş akışı size gönderdiğiniz e-postadaki ek sayısını gösteren bir ileti veya e-posta gönderir.
Tasarımcıdan kod görünümüne geçerseniz, aşağıdaki örnekte Her için döngüsünün iş akışı tanımınızdaki JSON biçimindeki Artım değişkeni eylemiyle birlikte nasıl göründüğü gösterilir:
"actions": {
"For_each": {
"type": "Foreach",
"actions": {
"Increment_variable": {
"type": "IncrementVariable",
"inputs": {
"name": "Count",
"value": 1
},
"runAfter": {}
}
},
"foreach": "@triggerBody()?['Attachments']",
"runAfter": {
"Initialize_variable": [ "Succeeded" ]
}
}
},
Değişkeni azaltma
Bir değişkeni belirli bir sabit değere göre azaltmak veya azaltmak için, değişkeni artırma adımlarını izleyin; bunun yerine iş akışınıza Azaltma değişkeni eylemini eklemeniz dışında. Bu eylem yalnızca tamsayı ve kayan değişkenlerle çalışır.
Aşağıdaki tabloda, Azaltma değişkeni eyleminin bilgileri açıklanmaktadır:
Özellik | Zorunlu | Değer | Açıklama |
---|---|---|---|
Adı | Evet | <variable-name> | Azaltılacak değişkenin adı |
Değer | Hayır | <increment-value> | Değişkeni azaltmak için kullanılan değer. Varsayılan değer birdir. İpucu: İsteğe bağlı olmakla birlikte en iyi uygulama bu değerin ayarlanmasıdır. Böylece, her zaman değişkeninizi azaltmak için kullanılacak belirli değeri bilirsiniz. |
Tasarımcıdan kod görünümüne geçerseniz, aşağıdaki örnekte Azaltma değişkeni eyleminin JSON biçimindeki iş akışı tanımınızda nasıl göründüğü gösterilir:
"actions": {
"Decrement_variable": {
"type": "DecrementVariable",
"inputs": {
"name": "Count",
"value": 1
},
"runAfter": {}
}
},
Değişken ayarla
Var olan bir değişkene farklı bir değer atamak için aşağıdaki özel durumlarla bir değişkeni artırma adımlarını izleyin:
Bunun yerine, Değişkeni ayarla eylemini bulun ve seçin.
Atamak istediğiniz değişken adını ve değerini girin. Yeni değer ve değişken aynı veri türünde olmalıdır. Bu eylemin varsayılan bir değeri olmadığından değer gereklidir.
Aşağıdaki tabloda, Değişken ayarla eyleminin bilgileri açıklanmaktadır:
Özellik | Zorunlu | Değer | Açıklama |
---|---|---|---|
Adı | Evet | <variable-name> | Değiştirilecek değişkenin adı |
Değer | Evet | <new-value> | Değişkene atamak istediğiniz değer. Her ikisi de aynı veri türünde olmalıdır. |
Not
Değişkenleri artırmadığınız veya azaltmadığınız sürece döngülerin içindeki değişkenleri değiştirmek beklenmeyen sonuçlara neden olabilir çünkü döngüler varsayılan olarak paralel veya eşzamanlı olarak çalıştırılır. Bu gibi durumlarda döngünüzü sırayla çalışacak şekilde ayarlamayı deneyin. Örneğin, döngünün içindeki değişken değerine başvurmak ve döngü örneğinin başında ve sonunda aynı değeri beklemek istediğinizde, döngünün çalışma biçimini değiştirmek için şu adımları izleyin:
Döngünüzde döngü ayarlarını bulun ve açın.
İş akışı türünüz temelinde ilgili adımları izleyin:
Tüketim: Eşzamanlılık Denetimi ayarını Kapalı olan Açık olarak değiştirin.
Standart: Genel'in altında Eşzamanlılık Denetimi ayarını Kapalı olan Açık olarak değiştirin.
Paralellik Derecesi kaydırıcısını 1'e sürükleyin.
Tasarımcıdan kod görünümüne geçerseniz, aşağıdaki örnekte Değişken ayarla eyleminin JSON biçimindeki iş akışı tanımınızda nasıl göründüğü gösterilir:
Aşağıdaki örnek değişkenin Count
geçerli değerini başka bir değerle değiştirir:
"actions": {
"Initialize_variable": {
"type": "InitializeVariable",
"inputs": {
"variables": [ {
"name": "Count",
"type": "Integer",
"value": 0
} ]
},
"runAfter": {}
},
"Set_variable": {
"type": "SetVariable",
"inputs": {
"name": "Count",
"value": 100
},
"runAfter": {
"Initialize_variable": [ "Succeeded" ]
}
}
},
Değişkene ekleme
Dizeleri veya dizileri saklayan değişkenler için bu dizelere veya dizilere son öğe olarak bir değişken değeri ekleyebilirsiniz. Aşağıdaki özel durumlarla bir değişkeni artırma adımlarını izleyebilirsiniz:
Değişkeninizin dize mi yoksa dizi mi olduğuna bağlı olarak bu eylemlerden birini bulun ve seçin:
- Dize değişkenine ekle
- Dizi değişkenine ekle
Dizede veya dizide son öğe olarak eklenecek değeri girin. Bu değer gereklidir.
Aşağıdaki tabloda, Ekleme... eylemleriyle ilgili bilgiler açıklanmaktadır:
Özellik | Zorunlu | Değer | Açıklama |
---|---|---|---|
Adı | Evet | <variable-name> | Değiştirilecek değişkenin adı |
Değer | Evet | <append-value> | Eklemek istediğiniz değer; herhangi bir türde olabilir |
Tasarımcıdan kod görünümüne geçerseniz, aşağıdaki örnekte dizi değişkenine ekle eyleminin iş akışı tanımınızda nasıl göründüğü (JSON biçimindedir) gösterilir.
Aşağıdaki örnek bir dizi değişkeni oluşturur ve dizideki son öğe olarak başka bir değer ekler. Sonucunuz şu diziyi içeren güncelleştirilmiş bir değişkendir: [1,2,3,"red"]
"actions": {
"Initialize_variable": {
"type": "InitializeVariable",
"inputs": {
"variables": [ {
"name": "myArrayVariable",
"type": "Array",
"value": [1, 2, 3]
} ]
},
"runAfter": {}
},
"Append_to_array_variable": {
"type": "AppendToArrayVariable",
"inputs": {
"name": "myArrayVariable",
"value": "red"
},
"runAfter": {
"Initialize_variable": [ "Succeeded" ]
}
}
},