JSON işlevi

Şunlar için geçerlidir: Tuval uygulamaları Model yönetimli uygulamalar Power Pages

Bir tablo, kayıt veya değer için JSON metin dizesi oluşturur.

Açıklama

JSON işlevi bir veri yapısının JavaScript Nesne Gösterimi (JSON) gösterimini metin olarak döndürür; böylece, ağ üzerinden depolama veya aktarım için uygun olur. [ECMA-404](https://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf ve IETF RFC 8259, JavaScript ve diğer programlama dilleri tarafından yaygın olarak kullanılan biçimi açıklar.

Tuval uygulamaları, bu tabloda kendi metin temsilleriyle ilgili ayrıntılarla beraber listelenen veri türlerini destekler:

Sonucun ne kadar okunabilir olacağını ve desteklenmeyen ve ikili veri türlerinin nasıl işleneceğini denetlemek için isteğe bağlı Biçim bağımsız değişkenini belirtin. Varsayılan olarak, çıktı gereksiz boşluk veya yeni satır olmadan mümkün olduğunca kompakt olur ve desteklenmeyen veri türleri ve ikili verilere izin verilmez. & işlecini belirtirseniz birden fazla biçimi birleştirebilirsiniz.

ShowColumns ve DropColumns işlevlerini, sonucun hangi verileri içerdiğini denetlemek ve desteklenmeyen veri türlerini kaldırmak için kullanın.

JSON hem yoğum bellek kullanabileceğinden hem de yoğun işlem gerektirebileceğinden, bu işlevi yalnızca davranış işlevlerinde kullanabilirsiniz. JSON'dan gelen sonuçları bir değişken içinde yakalayabilir ve bu değişkeni daha sonra veri akışında kullanabilirsiniz.

Bir sütunun hem görünen adı hem de mantıksal adı varsa sonuç mantıksal adı içerir. Görünen adlar uygulama kullanıcısının dilini yansıtır ve bu nedenle ortak bir hizmete veri aktarımı yapmak için uygun değildir.

Sözdizimi

JSON( Veri Yapısı [, Biçim ] )

• DataStructure – Gerekli. JSON'a dönüştürülecek veri yapısı. Tablolar, kayıtlar ve temel değerler desteklenir ve isteğe bağlı şekilde iç içe geçmiş olarak kullanılır.
• Biçim - İsteğe bağlı. JSONFormatsabit listesi değeri. Varsayılan değer JSONFormat.Compact'tır; bu değer, yeni satırlar ve boşluklar eklemez ve ikili verileri ve desteklenmeyen sütunları engeller.

Örnekler

Hiyerarşik veriler

1. Button denetimi ekleyin ve OnSelect özelliğini şu formül olarak ayarlayın.

   ClearCollect( CityPopulations,
       { City: "London",    Country: "United Kingdom", Population: 8615000 },
       { City: "Berlin",    Country: "Germany",        Population: 3562000 },
       { City: "Madrid",    Country: "Spain",          Population: 3165000 },
       { City: "Hamburg",   Country: "Germany",        Population: 1760000 },
       { City: "Barcelona", Country: "Spain",          Population: 1602000 },
       { City: "Munich",    Country: "Germany",        Population: 1494000 }
   );
   ClearCollect( CitiesByCountry, GroupBy( CityPopulations, "Country", "Cities" ) )
   

2. Alt tuşunu basılı tutarak düğmeyi seçin.

   CitiesByCountry koleksiyonu bu veriyapısıyla oluşturulur; bu koleksiyonu Dosya menüsünde Koleksiyonları seçip ardından koleksiyon adını seçerek görüntüleyebilirsiniz.

   

   Bu koleksiyonu ayrıca Ayarlar>Yaklaşan özellikler>Formül çubuğu sonuç görünümünü etkinleştir'i seçerek, formül çubuğunda koleksiyon adını seçerek ve sonra formül çubuğu altında koleksiyon adının yanındaki aşağı okunu seçerek de gösterebilirsiniz.

   

3. Başka bir düğme ekleyin ve düğmenin OnSelect özelliğini şu formül olarak ayarlayın:

   Set( CitiesByCountryJSON, JSON( CitiesByCountry ) )
   

   Bu formül, CitiesByCountryJSON genel değişkenini CitiesByCountry için JSON gösterimine ayarlar.

4. Alt tuşunu basılı tutarak düğmeyi seçin.

5. Label denetimi ekleyin ve Text özelliğini bu değişkene ayarlayın.

   CitiesByCountryJSON
   

   Etiket bu sonucu, tümü boşluk içermeyen tek bir satırda, ağ üzerinden iletilmek üzere uygun şekilde gösterir:

   [
     {
       "Cities": [{ "City": "London", "Population": 8615000 }],
       "Country": "United Kingdom"
     },
     {
       "Cities": [
         { "City": "Berlin", "Population": 3562000 },
         { "City": "Hamburg", "Population": 1760000 },
         { "City": "Munich", "Population": 1494000 }
       ],
       "Country": "Germany"
     },
     {
       "Cities": [
         { "City": "Madrid", "Population": 3165000 },
         { "City": "Barcelona", "Population": 1602000 }
       ],
       "Country": "Spain"
     }
   ]
   

6. Çıktıyı daha okunaklı hale getirmek için ikinci düğmenin formülünü değiştirin.

   Set( CitiesByCountryJSON, JSON(CitiesByCountry, JSONFormat.IndentFour ))
   

7. Alt tuşunu basılı tutarak ikinci düğmeyi seçin.

   Etiket daha okunaklı sonucu gösterir.

   [
     {
       "Cities": [
         {
           "City": "London",
           "Population": 8615000
         }
       ],
       "Country": "United Kingdom"
     },
     {
       "Cities": [
         {
           "City": "Berlin",
           "Population": 3562000
         },
         {
           "City": "Hamburg",
           "Population": 1760000
         },
         {
           "City": "Munich",
           "Population": 1494000
         }
       ],
       "Country": "Germany"
     },
     {
       "Cities": [
         {
           "City": "Madrid",
           "Population": 3165000
         },
         {
           "City": "Barcelona",
           "Population": 1602000
         }
       ],
       "Country": "Spain"
     }
   ]
   

base64 olarak görüntüler ve ortam

1. Image denetimi ekleyin.

   Bu denetim beraberinde SampleImage öğesini getirir.

2. Button denetimi ekleyin ve OnSelect özelliğini şu formül olarak ayarlayın.

   Set( ImageJSON, JSON( SampleImage, JSONFormat.IncludeBinaryData ) )
   

3. Alt tuşunu basılı tutarak düğmeyi seçin.

4. Bir etiket ekleyin ve Text özelliğini bu değişkene ayarlayın.

   ImageJSON
   

5. Denetimi yeniden boyutlandırın ve sonucun büyük bölümünü göstermek için gerektiği gibi yazı tipi boyutunu küçültün.

   Etiket, JSON işlevinin yakaladığı metin dizesini gösterir.

   "data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjxzdmcgdmVyc2lvbj0iMS4xIg0KCSB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB4bWxuczphPSJodHRwOi8vbnMuYWRvYmUuY29tL0Fkb2JlU1ZHVmlld2VyRXh0ZW5zaW9ucy8zLjAvIg0KCSB4PSIwcHgiIHk9IjBweCIgd2lkdGg9IjI3MHB4IiBoZWlnaHQ9IjI3MHB4IiBlbmFibGUtYmFja2dyb3VuZD0ibmV3IDAgMCAyNzAgMjcwIiB4bWw6c3BhY2U9InByZXNlcnZlIj4NCgk8ZyBjbGFzcz0ic3QwIj4NCgkJPHJlY3QgeT0iMC43IiBmaWxsPSIjRTlFOUU5IiB3aWR0aD0iMjY5IiBoZWlnaHQ9IjI2OS4zIi8+DQoJCTxwb2x5Z29uIGZpbGw9IiNDQkNCQ0EiIHBvaW50cz0iMjc3LjksMTg3LjEgMjQ1LDE0My40IDE4OC42LDIwMi44IDc1LDgwLjUgLTQuMSwxNjUuMyAtNC4xLDI3MiAyNzcuOSwyNzIiLz4NCgkJPGVsbGlwc2UgZmlsbD0iI0NCQ0JDQSIgY3g9IjIwMi40IiBjeT0iODQuMSIgcng9IjI0LjQiIHJ5PSIyNC4zIi8+DQoJPC9nPg0KPC9zdmc+"
   

Değer tabloları

Bu formül:

JSON( [1,2,3] )

[{"Value":1},{"Value":2},{"Value":3}] metin dizesini üretir.

JSONFormat.FlattenValueTables seçeneğiyle aynı formül:

JSON( [1,2,3], JSONFormat.FlattenValueTables )

[1,2,3] metin dizesini üretir.

FlattenValueTables seçeneğinin, Bu tablolar Değer tabloları olmadığından, JSON'un CityPopulations veya CitiesByCountry koleksiyonlarıyla kullanılmasında etkisi olmadığını unutmayın. Değer tablosu tek bir sütun içerir ve "Değer" olarak adlandırılmalıdır.