Dataverse uygulamasında az kodlu eklentileri kullanma (önizleme)

[Bu konu, yayın öncesi belgesine dahildir ve değiştirilebilir.]

Microsoft Dataverse, daha etkili veri mimarisi sağlamak ve istemci tarafı iş yükünü az kodlu eklentilerle azaltmak için güçlü bir çözüm sunar. Bu eklentiler, sunucu tarafı çalıştıran ve kişiselleştirilmiş olay işleyicileri tarafından tetiklenen ve Dataverse içinde belirli bir komut kümesini yürüten yeniden kullanılabilir, gerçek zamanlı iş akışlarıdır.

Geleneksel olarak eklentiler, daha sonra yüklenen ve Dataverse içinde kayıtlı olan bir .NET Framework derlemesinde derlenmiş özel sınıflar olarak oluşturulmuştur. Ancak, az kodlu eklentilerin eklenmesiyle kullanıcılar minimum düzeyde veya kodlama gerektirmeden ve el ile kayıt gerektirmeden bu olay işleyicilerini oluşturabilir.

Az kodlu eklentiler bir Dataverse veritabanında depolanarak Power Apps ve Power Automate ile sorunsuz bir şekilde tümleştirilebilir. İş akışının davranışı, Power Fx ifade dili kullanılarak tanımlanır ve Dataverse iş verilerine ve dış veri kaynaklarına Power Platform bağlayıcılar aracılığıyla doğrudan bağlanabilir. Az kodlu eklentiler sayesinde yapımcılar minimum kodlama uzmanlığıyla karmaşık iş akışlarını hızlı bir şekilde yapılandırarak daha akıcı ve etkili bir veri mimarisine neden olabilir.

Sunucu tarafı mantığının yararları

Sunucu tarafı iş mantığını tanımlamak, aşağıdakiler de dahil, çeşitli yararlar sunar:

• Artan güvenlik. Sunucu tarafı mantığı sunucuda yürütüldüğünden, hassas verilere veya işlemlere yetkisiz erişimin önlenmesine yardımcı olabilir.
• Artan performans. İş mantığı, sunucuda yürütülerek, istemci ve sunucu arasında aktarılması gereken veri miktarını azaltabilir ve böylece işleme sürelerinin daha kısa olmasını sağlar.
• Tutarlılık ve güvenilirlik. Sunucu tarafı mantığı, iş kurallarının tüm istemciler genelinde tutarlı bir şekilde uygulanmasını sağlayarak hata veya tutarsızlık risklerini azaltır.
• Daha kolay bakım ve yükseltmeler. Sunucuda iş mantığını merkezileştirerek, birden çok istemciyi güncelleştirmek yerine tek bir yerde değişiklik yapılabileceğinden, bakımını yapmak ve güncelleştirmek kolaylaşır.
• Ölçeklenebilirlik. Sunucu tarafı mantığı, istemci tarafı mantığına göre daha kolay ölçeklenebilir ve böylece daha büyük iş yüklerinin daha iyi performansa ve ele alınmasına olanak sağlanabilir.

Az kodlu eklentiler

Dataverse'de desteklenen iki tür az kodlu eklenti bulunur:

Tüm az kodlu eklentiler aşağıdaki genel özelliklere sahiptir:

Eklenti izinleri

Az kodlu eklenti oluşturmak için ön koşullar

Dataverse hızlandırıcıyı güncelleştirme

1. Yönergeleri izleyerek ortamınızdaki lisanslı uygulamaları görüntüleyin.
2. Dataverse Hızlandırıcı zaten yüklüyse ve bir güncelleştirme kullanılabiliyorsa bu, öğenin yanındaki tabloda gösterilir.
3. Dataverse Hızlandırıcı'yı seçin ve ardından komut çubuğunda Güncelleştir öğesini seçin.

Anlık bir az kodlu eklenti oluşturma

1. Dataverse hızlandırıcı uygulamasını çalıştırın.
2. Anında eklenti kartı oluştur kartını seçin.
3. Görünen ad sağlayın.
4. İsteğe bağlı olarak parametreler tanımlayın:
   • Yeni giriş parametresi veya Yeni çıkış parametresi seçin, ardından etiketi ve veri türünü girin.
   • Gerektiğinde daha fazla giriş ve çıkış parametresi ekleyin.
5. İfade düzenleyicisine Power Fx ifadesi girin.
   • Formüldeki giriş parametrelerine etiket adına göre başvurur.
   • Çıkış parametrelerine, { Out: "Return value" } gibi köşeli ayraçların içinde başvuruda bulunulmalıdır.
   • Dataverse tablolarına Filter() ve LookUp() gibi veri toplama işlevleri kullanılarak başvuruda bulunulmalıdır.
   • Kapsam varlığa ayarlanmışsa, ThisRecord.'Account Name' gibi eklenti çalıştırmasıyla ilişkilendirilmiş tablo satırındaki sütun değerlerine erişmek için ThisRecord kullanın.

   İpucu

   İfade kutusunda IntelliSense'e dikkat edin. Kırmızıyla altı çizili geçersizdir. Dalgalı sarı, mantığınızın aracı sınırlamalarından etkilenebileceği anlamına gelir. aracı seçilebilen işlevler kullanarak aracı sorunlarını önleyin.

6. İsteğe bağlı olarak, çözüm, kapsam ya da tanım değiştirmek için Advanced options seçeneğini genişletin.
7. Kaydet'i seçin.
8. Anlık az kodlu eklentinizi sınayın.

Örnek: İki tamsayının özetini hesaplayın.

• İki giriş parametresi X ve Y (her ikisi de tamsayı türünde) ve bir çıkış parametresi Z (tür dizesi) oluşturun.
• Şu formülü kullanın: {Z: X + Y }

Otomatik bir az kodlu eklenti oluşturma

1. Dataverse hızlandırıcı uygulamasını çalıştırın.
2. Otomatik eklenti oluştur kartını seçin.
3. Aşağıdaki değerleri girin:
   • Ad: Eklenti için Giriş doğrulama gibi bir ad girin.
   • Tablo: Eklentiyi ilişkilendirmek için Firma gibi bir tablo seçin.
   • Satır şu durumdayken bu eklenti kuralını çalıştır. Eklentiyi çağıran veri olayını belirtin.
4. İfade düzenleyicisine Power Fx ifadesi girin.
   • Dataverse tablolarına Filter() ve LookUp() gibi veri toplama işlevleri kullanılarak başvuruda bulunulmalıdır.
   • ThisRecord.'Account Name' gibi eklenti çalıştırmasıyla ilişkilendirilmiş tablo satırındaki sütun değerlerine erişmek için ThisRecord kullanın.
5. İsteğe bağlı olarak, Gelişmiş seçenekler öğesini genişleterek aşama (ne zaman çalıştırılmalı) ve eklentinin kaydedildiği çözüm öğesini değiştirin.
6. Kaydet'i seçin.
7. Otomatik az kodlu eklentinizi sınayın.

Az kodlu eklentilerde Power Platform bağlayıcıları kullanma

Power Platform bağlayıcıları, SQL Server, Salesforce ve SharePoint gibi Dataverse dışındaki sistemlerden verileri ve işlevleri karmaşık kodlama veya özel geliştirme gerekmeden kolayca tümleştirmek için az kodlu eklentilerde kullanılabilir.

Az kodlu eklentilerde bağlayıcıları kullanmanın ön koşulları

Az kodlu eklentilerde bağlayıcı eylemlerini kullanma

Bir Power Fx formülde az kodlu bir eklentiden bağlayıcıları ve özel bağlayıcıları kolayca kullanabilirsiniz.

1. Kullanmak istediğiniz bağlayıcıyla bağlantı oluşturun.
2. Dataverse ortamındaki bağlantıya bir bağlantı başvurusu ekleyin.
3. Power Fx ifade düzenleyicisinde az kodlu eklentide, bağlantı başvurusunun adını (görünen ad değil new_connectorName gibi bir önek ve bir alt çizgiden oluşan dahili ad) yazın.
4. Intellisense, kullanılabilir eylemleri size gösterir. İstediğiniz eylemi seçin ve gerekli parametreleri girin.

Az kodlu bir eklentide bağlayıcı kullanmadan önce, giriş ve çıkış parametrelerini doğru şekilde aktardığınızdan emin olmak için bağlayıcının belgelerini gözden geçirin.

Daha fazla bilgi: örnek

Az kodlu bir eklentiyi test etme

Anlık eklentileri sınama

1. Giriş ekranındaki, listeden bir anlık eklenti seçin ve sonra komut çubuğundan Test öğesini seçin. Ayrıca kaydedildikten sonra bu ekrana komut çubuğundaki anlık eklenti düzenleyicisinden de ulaşabilirsiniz.

2. Az kodlu eklentide tanımlanmış giriş parametrelerinin değerlerini sağlayın ve sonra Çalıştır'ı seçin.

Yanıtı gözlemleyin.

Otomatik eklentileri sınayın

Veri olayını çağırarak otomatik eklentileri sınayın. Eklentinin başarıyla çalışıp çalışmadığını, formülde tanımlanmış olan beklenen değişiklikleri doğrulayarak gözleyin.

Az kodlu bir eklentiyi tümleştirme

Tuval uygulamasından veya özel sayfadan anlık eklenti çağırma

1. Dataverse Hızlandırıcı uygulamasında:
   1. Listede anında eklentiyi seçin.
   2. Komut çubuğunda Kod parçacığını kopyala'yı seçin.
   3. Kopyalanan formülü bir metin düzenleyicisine veya not defterine yapıştırın ve kaydedin (kolayca geri başvurabileceğiniz bir yere).
2. Power Apps'da:
   1. Power Apps Studio'da bir tuval uygulaması (veya özel sayfa) oluşturma veya düzenleme.
   2. Sol gezinme bölmesinde, Veri Kaynakları sekmesinde, + Yeni veri kaynağı öğesini seçin ve Dataverse bağlayıcıdan Çevre seçeneğini arayın.
   3. Aşağıdaki bileşenleri tuvale ekleyin:
   • Her parametrenin veri türüne karşılık gelen girdi kontrollerini ekleyin; metin ya da rakam için Metin girdisi, Boole için geçiş gibi.
   • Eklenti kapsamı bir tabloya bağlıysa, girişi seçebilmeniz için aynı tabloyla ilişkili bir birleşik giriş kutusu ekleyin.
   • Eklentiyi çağırmak için bir düğme ekleyin.
3. Kopyaladığınıa eklenti formülünü düğmenin OnSelect özelliğine yapıştırın.
4. Her bir giriş parametresini Value ilgili giriş denetimlerine başvurmak üzere eşleyin:
   • Formül Environment.new_CalculateSum({ X: Value, Y: Value }); olsaydı şöyle yeniden yazılabilirdi: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
   • Formül bağlıysa, eklentiye erişmek için tablo görünen adını Environment ile değiştirin.
5. Az kodlu eklenti için bir çıkış parametresi tanımlanmışsa:
   1. Yanıtı bir Set() veya UpdateContext() formülle yakalayın: Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Değişkeni bir etiket içinde görüntüleme. Alternatif olarak bir bildirimde veri görüntülemek için Notify() formülünü kullanın.
6. Uygulamayı oynatın ve az kodlu eklentiyi çalıştırmak için komut çubuğundan komutu seçin.

Dataverse eylemlerini doğrudan tuval uygulamalarındaki Power Fx'ten nasıl çağırabileceğinizhakkında daha fazla bilgi edinin.

Power Automate bulut akışından anlık eklenti çağırma

1. Bulut akışında Microsoft Dataverse bağlayıcıdan yeni bir eylem ekleyin.
2. Şu eylemi seçin Bir bağlı olmayan eylem gerçekleştirme ya da Bir bağlı eylem gerçekleştirme.
3. Eklentinizi seçin (önek içeren benzersiz bir ada sahiptir).
4. Tüm giriş parametreleri için değer girin (varsa).

Dataverse Web API'sinden anlık eklenti çağırma

Web API belgelerinden özel API'leri çağırma içinde Bağlantısız eylem ya da Tabloya bağlı eylem bölümleri için adımları izleyin (uygun eklenti kapsamına bağlı olarak).

Az kodlu eklentileriniz için yardım alma

Az kodlu eklentinizi oluştururken veya çalıştırırken sorunlarla karşılaşırsanız oluşabilecek yaygın sorunlar için şu ipuçlarına gidin: Microsoft Dataverse az kodlu eklenti ipuçları ve bilinen sorunlar

Yardım ve desteğe başvurma

Microsoft Dataverse az kodlu eklenti ipuçları ve bilinen sorunlar kapsamında olmayan Dataverse Hızlandırıcı çözümünü yükleme veya az kodlu eklentilerle ilgili sorunlar için Yardım + destek deneyimini kullanın ve aşağıdaki bilgileri dahil edin:

• Sorun Türü- Dataverse Web API ve SDK
• Sorun alt türü - Dataverse için Hızlandırıcı seti

Oluşturabileceğiniz örnek az kodlu eklentiler

Az kodlu eklenti oluşturmayla ilgili birkaç örnek için Örnek Dataverse az kodlu eklentiler (önizleme) bölümüne gidin

Sınırlamalar

• Mevcut tuval uygulamalarının içindeki yeni eklentilere erişmek için ortam dili nesnesinin yeniden eklenmesi gerekir. Ortam tablosu veri kaynağını mevcut bir tuval uygulamasına ekledikten sonra oluşturulan tüm eklentiler için Power Fx ortam dili nesnesini kaldırıp yeniden eklemeniz gerekir. Böylece tüm eklentilerin güncellenmiş listesini eylemler olarak görürsünüz.

• Formüldeki herhangi bir tabloya başvurmak isterseniz, Intellisense, otomatik eklentilerde açık bir not gerektirir. Köşeli ayraçlar ve @ simgesini kullanarak (Accounts değil) [@Accounts] gibi aşağıdaki kesinleştirme söz dizimini kullanın.

• İç içe geçmiş destek. Eklentiler, Power Fx ifadelerinden yalnızca Microsoft tarafından yayımlanan birinci taraf eylemleri çağırabilir.

• Bazı Collect senaryoları Patch gerektirir. Collect()'in işe yaramadığı bazı senaryolar vardır. Geçici çözüm, aşağıdaki doldruma sütunu örneğinde gösterildiği gibi Patch() kullanmaktır. Otomatik bir eklenti oluşturuyorsanız, Power Fx formülünde başvurulan her tablonun önüne @ ekleyin.

  Patch(Faxes,
      Collect(Faxes, { Subject : "Sub1" } ),
      { Regarding : First(Accounts) }
  )
  

• Az kodlu eklentiler konektörlerle etkileşime geçtiğinde ve DLP oluşturulduğunda, yönetici DLP kullanarak bağlantıların oluşturulmasını engelleyebilir. Ancak, Dataverse ortamındaki varolan bağlantı başvuruları çalışmaya devam eder. Yöneticinin tüm bağlayıcılarla az kodlu eklenti etkileşimlerini engellemesi gerekiyorsa, Allowconnectorsonpowerfxactions olan kuruluş ayarını devre dışı bırakabilir. Bu ayar varsayılan olarak etkindir ve her zamanki SDK yöntemleri (WebAPI, SDK, PowerShell vb.) tarafından devre dışı bırakılabilir. Aşağıdaki gibi, az kodlu bir anlık eklenti kullanarak bunu devre dışı bırakabilirsiniz:

  Patch(Organizations, First(Organizations), { 'Enable connectors on power fx actions.': 'Enable connectors on power fx actions. (Organizations)'.No })
  

• Bağlayıcılar kullanan eklentiler yalnızca belirli alanlardan sonuç verebilir. Bu nedenle, bağlayıcı yanıtından çıkış değerlerine belirli temel değerleri eşlemeniz gerekir.

Özel bağlayıcı sınırlamasına sahip az kodlu eklentiler

Özel bağlayıcılara sahip az kodlu eklentileriniz varsa bağlantı referanslarından veya akışlardan önce özel bağlayıcıların içe aktarılması gerekir.

Ortamınız bir çözümde özel bağlayıcı içermiyorsa yalnızca özel bağlayıcıyı içeren ayrı bir çözümü içe aktarın. Gerçek çözümü içe aktarmadan önce bu içe aktarma işlemini yapın. Diğer çözüm bileşenlerinin içe aktarılabilmesi için Azure'un özel bağlayıcıyı kaydetmesi gerektiğinden ilk önce bunu yapmanız gerekir.

Özel bağlayıcılar ve akışlar içeren bir çözümü içeri aktarırsanız Azure, bağlantı referanslarınızı veya akışlarınızı kaydederken özel bağlayıcıyı kaydedemez. Bu, daha önce ayrı bir çözümde içeri aktarılmayan özel bağlayıcının bağlantı başvuruları için de geçerlidir. Azure özel bağlayıcınızı kaydetmediyse içe aktarma başarısız olur veya içe aktarmayı başlatamazsınız.

Daha fazla bilgi: Çözümlerde özel bağlayıcılar oluşturma: Bilinen sınırlamalar

Ayrıca bkz.

Az kodlu eklentiler Power Fx (önizleme)

Power Apps platformunda Dataverse az kodlu eklentide önceden oluşturulmuş bir istem kullanma

Power Apps ile otomatik düşük kodlu eklenti oluşturma (video)

Power Apps ile anında düşük kodlu eklenti oluşturma (video)