Aracılığıyla paylaş

Değişken veri türleri

  • Makale

Akışlarınızda değişkenler oluşturduğunuzda Power Automate bunları içeriklerine bağlı olarak belirli bir türe dönüştürür.

Bu veri türlerinden bazıları, örneğin, sayılar gibi tüm uygulamada yaygın olarak kullanılırken tarayıcı örnekleri gibi diğerleri açık eylemler veya eylem grupları gerektirir.

Basit veri türleri

Basit veri türleri, metin ve sayı gibi tek değerleri temsil eder. Bu veri türlerini bağımsız olarak kullanabilir veya bunlardan listeler ve veri tabloları gibi daha karmaşık veri yapıları oluşturmak için yararlanabilirsiniz.

Metin değeri

Bu e-posta adreslerinden bir. txt dosyasının metin içeriğine kadar herhangi bir metin türüdür.

Metin veri türü özellikleri

Metin değeri değişkeni oluşturmak için Değişken ayarla eylemini kullanın ve giriş parametresini herhangi bir gösterim yapmadan istediğiniz metinle doldurun.

Metin değeri değişkeni oluşturan Değişken ayarla eyleminin ekran görüntüsü.

Sayısal değer

Sayılara uygulanan tür sayısaldır. Yalnızca bu veri türü matematik işlemlerinde kullanılabilir.

Sayısal değer değişkeni oluşturmak için Değişken ayarla eylemini kullanın ve giriş parametresini herhangi bir gösterim yapmadan istediğiniz sayıyla doldurun.

Sabit kodlanmış sayısal değerler hariç, matematik ifadelerini yüzde işaretleri içinde değişkenlerle kullanabilirsiniz. Matematiksel ifadelerle ilgili daha fazla bilgi için bkz. Değişkenleri ve % gösterimini kullanma.

Sayısal değer değişkeni oluşturan Değişken ayarla eyleminin ekran görüntüsü.

Boole değeri

Değer Doğru veya Yanlış olabilir.

Boole değeri değişkeni oluşturmak için Değişken ayarla eylemini kullanın ve giriş parametresini %True% veya %False% ifadesiyle doldurun.

Ayrıca, mantıksal işleçler, değişkenler ve yüzde gösterimini kullanarak karmaşık ifadeler de oluşturabilirsiniz. Mantıksal ifadelerle ilgili daha fazla bilgi için bkz. Değişkenleri ve % gösterimini kullanma.

Boole değeri değişkeni oluşturan Değişken ayarla eyleminin ekran görüntüsü.

Gelişmiş veri türleri

Gelişmiş veri türleri karmaşık veri yapılarını temsil eder. Bunlar, tek bir varlık olarak erişebileceğiniz başka veri türü koleksiyonları olarak çalışır.

Liste

Listeler, öğe koleksiyonlarıdır. Her bir liste öğesinin türüne bağlı olarak, metin değerleri listeleri, sayısal değerler listesi vb. olabilir. Liste veri türü, programlama terimlerinde tek boyutlu bir dizinin eşdeğeridir.

Yeni Liste Oluştur eylemi aracılığıyla bir liste oluşturabilir ve Listeye Öğe Ekle eylemine göre bu listeye bir öğe ekleyebilirsiniz.

Liste oluşturan bir akışın ekran görüntüsü.

Ayrıca, çıktı olarak listeler üreten eylemler üzerinden bir liste de oluşturabilirsiniz. Örneğin, metni dosyadan oku eylemi bir metin değerleri listesi döndürebilir ve klasördeki dosyaları al eylemi, bir dosya listesi döndürür.

Bir listedeki belirli bir öğeyi almak için şu gösterimi kullanın: %VariableName[ItemNumber]

Aşağıdaki örnekte akış, daha önce görüntülenen listenin ilk numarasını yeni bir değişkene depolar. Listenin ilk öğesi için dizinin 0 olması gerektiğini unutmayın.

Listenin ilk öğesine erişen bir ifadenin ekran görüntüsü.

Yaygın olarak kullanılan bir uygulama, bir listenin öğelerini yinelemek için her bir eylemini kullanmaktır.

Listenin yalnızca belirli bir bölümüne erişmeniz gerekirse, %VariableName[StartIndex:StopIndex]% gösterimini kullanın. Örneğin %List[2:4]% ifadesi listenin üçüncü ve dördüncü öğelerini alır. StopIndex konumundaki öğe dilimleme sınırıdır ve alınamaz.

Bir listeyi başlangıçtan belirli bir öğeye ayırmak için StartIndex değeri (%List[:4]%) ayarlamayın. Bir listeyi belirli bir dizinden sona kadar ayırmak için StopIndex değeri (%List[2:]%) ayarlamayın.

Liste veri türü özellikleri

Veri tablosu

Veri tabloları, tablo biçiminde veri içerir ve programlama terimlerinde iki boyutlu dizilerin eşdeğeridir.

Bir veri tablosu her öğenin konumunu benzersiz olarak tanımlayan satır ve sütunları içerir. Veri tabloları, veri satırlarını öğe olarak içeren listeler olarak kabul edilebilir.

Veri tablosu değişkeninin içeriğinin ekran görüntüsü.

Power Automate, yeni veri tabloları oluşturmak için Yeni veri tablosu oluştur eylemini sağlar. Eylemi dağıttıktan sonra, değerleri doldurmak ve sütun başlıklarını yeniden adlandırmak için görsel oluşturucuyu kullanabilirsiniz.

Yeni veri tablosu oluşturma eyleminin görsel oluşturucusunun ekran görüntüsü.

Yeni veri tablosu oluştur eyleminin dışında ayıklanan verileri saklamak için veri tabloları oluşturan üç adet daha eylem vardır: Excel çalışma sayfasını oku eylemi, SQL deyimini yürüt eylemi ve Web sayfasından veri ayıkla eylemleri.

Alternatif olarak, değişken ayarla eylemi ve programlama dizisi gösterimini kullanarak bir veri tablosu oluşturabilirsiniz. Bu gösterim, virgüllerle ayrılmış ve küme ayracı içine alınmış birden çok tek boyutlu dizi içerir. İfadenin son hali şu olmalıdır: %{['Product1', '10 USD'], ['Product2', '20 USD']}%.

Veri tablosu oluşturan Değişken ayarla eyleminin ekran görüntüsü.

Dizi gösterimini kullanarak yeni bir veri tablosu oluştururken sütun başlıkları eklemek isterseniz ilk satır için ^['ColumnName1', 'ColumnName2'] ifadesini kullanın.

Sütun başlıkları içeren yeni bir veri tablosu oluşturan Değişken ayarla eyleminin ekran görüntüsü.

Varolan bir tabloya yeni satır eklemek için, Veri tablosunda satır ekle eylemini kullanın. Alternatif olarak veri tablosunun değişken adını, bir artı karakterini (+) ve ayraç içinde eklemek istediğiniz değerleri içeren bir ifade oluşturun.

Veri tablosuna yeni bir satır ekleyen Değişken ayarla eyleminin ekran görüntüsü.

Masaüstü akışları, veri tablosuna satır eklemenin yanı sıra, veri tablosunu yöneten çeşitli eylemler de sunar. Değişken eylemleri başvurusu bölümünde, tüm bu eylemlerin listesini bulabilirsiniz.

Veri satırına ait belirli bir öğeyi getirmek için şu gösterimi kullanın: %VariableName[RowNumber][ColumnNumber]% RowNumber ve ColumnNumber ifadelerinin ilk öğe oldukları için (satır veya sütun) 0 olması gerektiğini unutmayın.

Örneğin, bir akışın Excel çalışma sayfasının içeriğini aldığını ve bunları ExcelData değişkendiğinde depoladığını varsayalım. Alınan tablonun ikinci satırındaki ilk hücreye erişmek için, aşağıda görüntülenen ifadeyi kullanın.

Okunan bir Excel dosyasının ilk satırının ikinci hücresine erişen ifadenin ekran görüntüsü.

Not

ExcelData değişkeni, Excel çalışma sayfasından oku eylemini kullanarak Excel çalışma sayfasından ayıklanan değerlerin tablosunu içerir. Tüm Excel dosyasını değil, belirli bir çalışma sayfasının değerlerini içerir.

Sütun başlıkları içeren bir veri tablosunda belirli bir sütuna erişmek istiyorsanız %ExcelData[rowNumber]['ColumnName']% gösterimini kullanın.

Bir Her Biri İçin eylemiyle bir veri tablosunda döngü yaparsanız, geçerli yinelemenin verilerini içeren değişken bir veri satırı olarak kabul edilir.

Listelere benzer şekilde, veri tablosunun belirli bir bölümüne erişmek için %VariableName[StartRow:StopRow]% gösterimi kullanırsınız. İfade yalnızca iki dizin tarafından tanımlanan satırları alır ancak StopRow konumu, dilimleme sınırıdır ve alınamaz.

Bir veri tablosunu ilk satırdan belirli bir satıra kadar ayırmak için bir StartRow değeri (örneğin %Datatable[:4]%) kullanmayın. Aynı şekilde, bir veri tablosunu belirli bir satırdan sonuna kadar ayırmak için bir StopRow değeri (örneğin %Datatable[2:]%) kullanmayın.

Veri tablosu veri türü özellikleri

Veri satırı

Veri satırı, bir veri tablosunun tek bir satırının değerlerini içerir. Her Biri eylemiyle bir veri tablosunda döngü oluşturduğunuzda geçerli yinelemeye ait verileri içeren değişken bir veri satırı olur.

Veri satırına ait belirli bir öğeyi getirmek için şu gösterimi kullanın: %VariableName[ItemNumber]%

Bunun yerine, %VariableName['ColumnName']% gösterimini de kullanabilirsiniz. Her sütunun adı, veri satırını aldığınız veri tablosu tarafından tanımlanır.

Veri satırı veri türü özellikleri

Veri satırı değişkeninin içeriğinin ekran görüntüsü.

Özel nesne

Kolaylıkla JSON biçimine dönüştürülebilen özellik ve değer çiftlerini içerir.

Yeni bir boş Özel nesne oluşturmak için Değişken ayarla eylemini kullanın ve şu ifadeyi doldurun: %{{ }}%. Yeni bir Özel nesne oluşturmak ve bunu özellikleri ve değerleriyle başlatmak için şu yapıyla bir ifade kullanın: %{ 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2' }%.

Yeni özel nesne oluşturan Değişken ayarla eyleminin ekran görüntüsü.

Önemli

Ayrılmış anahtar kelimeler özel nesne özellikleri olarak kullanılamaz. Ayrılmış anahtar kelimelerin tam listesi için Masaüstü akışlarında ayrılmış anahtar kelimeler'e gidin.

Mevcut bir özelliğin değerini güncelleştirmek veya yeni bir özellik eklemek için Değişken ayarla eylemi dağıtın, Ayarla alanını özelliğin adıyla doldurun ve değerini Alıcı alanına girin.

Özel nesneye yeni bir özellik ekleyen Değişken ayarla eyleminin ekran görüntüsü.

Sabit değerlerden ayrı olarak, özel nesnelerin özelliklerini ve değerlerini dinamik olarak ayarlamak için değişkenler kullanabilirsiniz. Örneğin, aşağıdaki akışta yeni bir boş özel nesneye yeni bir özellik eklemek için iki değişken kullanılmaktadır.

Özel nesneye yeni bir özellik eklemek için değişkenler kullanan bir akışın ekran görüntüsü.

Bağlayıcı nesnesi

Bağlayıcı nesneleri bulut bağlayıcılarının bilgilerini depolar ve özel nesnelere benzer şekilde çalışır. Özellikleri genellikle diğer bağlayıcı nesnelerinin listelerini içerir. Değerlere erişim, özel nesnelerde olduğu gibi çalışır, ancak iç içe geçmiş değerlere erişim daha karmaşık ifadeler gerektirebilir.

Değişken görüntüleyicideki özel nesne değişkeninin ekran görüntüsü.

PDF tablo bilgilerinin listesi

Bu veri türündeki bir değişken yalnızca PDF'den tabloları ayıkla eylemi aracılığıyla üretilebilir.

Listedeki her öğe, ayıklanmış bir tabloyu tanımlar ve bu tabloyla ilgili tüm gerekli bilgileri sağlar. Belirli bir veri tablosu bilgisi öğesine erişmek için %VariableName[ItemNumber]% gösterimini kullanın.

PDF tablo bilgilerinin listesinin ekran görüntüsü.

Her liste öğesi, belirli bir ayrıntıyı bağımsız olarak almanızı sağlayan dört özellik sunar. Kullanılabilir özellikler şunlardır:

  • DataTable - Ayıklanmış tabloyu döndürür.
  • TableStartingPage - Tablonun başlangıcını içeren dosya sayfasının dizinini döndürür.
  • TableEndingPage - Tablonun bitişini içeren dosya sayfasının dizinini döndürür.
  • TableOrderInPage - Sayfadaki tablo sırasını döndürür.

Bu veri türünün özellikleriyle ilgili daha fazla bilgiyi Değişken veri türü özellikleri bölümünde bulabilirsiniz.

PDF tablo bilgilerinin listesi özelliklerinin ekran görüntüsü.

Belirli bir özelliğin değerine erişmek için %VariableName[ItemNumber].PropertyName% gösterimini kullanın. Örneğin, aşağıdaki ifade ExtractedPDFTables değişkeninin ilk öğesinin veri tablosu değerini döndürür.

PDF tablo bilgileri değişkenleri listesinde yer alan veri tablosunun ekran görüntüsü.

Bilinen sorunlar ve sınırlamalar

  • Sorun: Veri tablosu veya veri satırı hücresi çok satırlı bir giriş içerdiğinde değişken görüntüleyicide yalnızca ilk satır görüntüleniyor.
  • Geçici çözümler: Yok.

Örnekler

Bağlantılar

Diğerleri

Bu bölüm, önceki kategorilerden hiçbirine ait olmayan kullanılabilir tüm veri türlerini gösterir.

Genel değer

  • Genel değer - Bu veri türü, tasarım zamanı sırasında Power Automate bir değişkenin veya giriş parametresinin veri türünü tanımlayamadığı zaman kullanılır. Genel değerler, çalışma zamanı sırasında verilerine dayalı olarak diğer veri türlerine dönüştürülür.

Active Directory

  • Active Directory girişi - Sunucuya Bağlan eylemiyle kurulan bir Active Directory sunucusu bağlantısı içerir.
  • Grup Bilgileri - Adı, görünen adı, açıklamayı ve belirli bir Active Directory grubunun üyelerini içerir.
  • Grup üyesi - Belirli bir Active Directory grubunun bir üyesini temsil eder.
  • Kullanıcı bilgileri: Belirli bir Active Directory kullanıcısı hakkında ad ve soyadı, baş harfler ve ayırt edici ad, iş ayrıntıları (şirket, departman ve unvan), iletişim bilgileri (telefon numarası, dahili numara ve e-posta) ve konum (ülke/bölge, şehir, eyalet, açık adres ve posta kodu) gibi bilgileri içerir.

Active Directory veri türü özellikleri

Amazon Web Services (AWS)

  • EC2 istemcisi - EC2 oturumu oluştur eylemi aracılığıyla oluşturulan bir EC2 oturumu içerir.
  • EC2 örneği - Alınan bir EC2 örneğini temsil eder.
  • EC2 örnekleri bilgileri - Bir EC2 örneğiyle ilgili bilgiler içerir.
  • Örnek durum değişikliği - Başlatılan veya durdurulan bir EC2 örneği hakkında bilgiler içerir.
  • EBS anlık görüntüsü - Bir EBS anlık görüntüsünü temsil eder.
  • EBS birimi - EBS birimini temsil eder.

AWS veri türü özellikleri

Azure

  • Azure istemcisi - Oturum oluştur eylemi aracılığıyla oluşturulan bir Azure oturumu içerir.
  • Azure Kaynak grubu - Alınan bir Azure kaynak grubunu temsil eder.
  • Azure yönetilen disk - Alınan bir Azure diskini temsil eder.
  • Azure anlık görüntüsü - Bir Azure anlık görüntüsünü temsil eder.
  • Azure sanal makinesi - Alınan bir Azure sanal makinesini temsil eder.
  • Azure sanal makine bilgileri - Azure sanal makinesi hakkında bilgiler içerir.
  • Azure aboneliği - Alınan bir Azure aboneliğini temsil eder.

Azure veri türü özellikleri

CMD

  • CMD oturumu - CMD oturumu aç eylemi aracılığıyla oluşturulan bir CMD oturumu içerir.

CMD veri türü özellikleri

Kimlik bilgileri

  • Kimlik Bilgisi – Kimlik bilgilerini al (önizleme) eylemi aracılığıyla alınan bir kimlik bilgisi içerir.

Kimlik bilgisi veri türü özellikleri

Tarihler ve saat

  • Tarih Saat - Tarih ve saat bilgilerini içerir. Değişken Ayarla eylemi üzerinden bir datetime değişkeni oluşturmak için input parametresini %d"yyyy-MM-dd HH:mm:ss.ff+zzz"% ifadeleriyle doldurun. Bu ifadelerde:

    Gösterim Açıklama
    yyyy Yıl
    MM Ay
    dd Gün
    HH Saat
    dd Dakika
    ss Saniye
    ff Milisaniye
    zzz UTC Farkı

    Örneğin, %d"2022-03-25"% ifadesi hedef değişkene 25 Mart 2022 tarihini atar.

Tarihler ve saat veri türü özellikleri

E-posta adresi

  • Posta iletisi - Bir e-posta iletisini temsil eder. E-postaları al eylemi bu değişkenleri doldurur.

E-posta veri türü özellikleri

Exchange

  • Exchange posta iletisi - Exchange Server'dan alınan bir e-posta iletisini temsil eder. Exchange e-posta iletileri al eylemi bu değişkenleri doldurur.

Exchange veri türü özellikleri

Dosyalar ve klasörler

  • Dosya - Bir dosyayı temsil eder.
  • Klasör - Bir klasörü temsil eder.
  • FileSystemObject - Bir klasör veya dosyayı temsil eder. Bu veri türü, dosya ve klasörleri kabul eden giriş parametrelerinde kullanılır.

Dosyalar ve klasörler veri türü özellikleri

FTP

  • FTP dosyası - Bir FTP dosyasını temsil eder.
  • FTP dizini - Bir FTP dizinini temsil eder

FTP veri türü özellikleri

OCR

  • OCR Altyapısı: OCR altyapısı oluştur eylemi aracılığıyla oluşturulan bir OCR altyapısı içerir.

Outlook

  • Outlook posta iletisi - Bir e-posta Outlook iletisini temsil eder. Outlook'tan e-posta iletileri al eylemi bu değişkenleri doldurur.

Outlook veri türü özellikleri

Terminal

  • Terminal oturumu - Terminal oturumu aç eylemi aracılığıyla oluşturulan bir terminal oturumu içerir.

Terminal veri türü özellikleri

XML

  • XML düğümü - Bir XML belgesinin içeriğini içerir. Dosyadan XML oku eylemi bu değişkenleri doldurur.

XML veri türü özellikleri

Error

  • Hata - Masaüstü akışında gerçekleşen son hata hakkında bilgi içerir. Son hatayı al eylemi, bu tür değişkeni oluşturur.

Hata özellikleri