Aracılığıyla paylaş

Uygulamadan, akıştan, koddan veya başka bir işlevden işlev çağırma (önizleme)

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

Dataverse'deki fonksiyonları bir tuval uygulamasından, model odaklı bir uygulamadaki özel bir sayfadan, bir akıştan, koddan veya başka bir fonksiyondan çağırabilirsiniz.

Önemli

  • Bu, bir önizleme özelliğidir.
  • Önizleme özellikleri, üretimde kullanıma yönelik değildir ve sınırlı işlevselliğe sahip olabilir. Bu özellikler, müşterilerin erken erişim elde etmesi ve geri bildirim sağlaması amacıyla resmi sürümden önce kullanıma sunulur.

Tuval uygulaması veya özel sayfadan işlev çağırma

  1. Power Apps'deki (make.powerapps.com) Fonksiyonlar alanından, bir tuval uygulamasından veya özel sayfadan çağırmak istediğiniz fonksiyonu seçin.
  2. Komut çubuğunda Kod parçacığını kopyala'yı seçin.
  3. Kopyalanan formülü bir metin düzenleyicisine, Not Defteri'ne veya kolayca başvurabileceğiniz bir yere yapıştırın ve kaydedin.
  4. Power Apps Studio'da:
    1. Power Apps Studio'de bir tuval uygulaması veya özel sayfa oluşturun veya düzenleyin.
    2. Sol gezinme bölmesinde, Veri Kaynakları sekmesi altında, Veri ekle'yi seçin ve Dataverse bağlayıcısından Ortam seçeneğini arayın ve seçin.
    3. Aşağıdaki bileşenleri tuval üzerine ekleyin:
      • Sayı girişi gibi her parametrenin veri türüne karşılık gelen giriş denetimleri ekleyin.
      • İşlevi çağırmak için bir düğme ekleyin.
      • Sayı girişi gibi parametrenizin veri türüne karşılık gelen bir çıkış denetimi ekleyin.
  5. Oluşturduğunuz düğmeyi seçin ve OnSelect özelliğinde, Environment.new_calculatesum gibi bir işlev girin.
  6. Her bir giriş parametresini Value ilgili giriş denetimlerine başvurmak üzere eşleyin:
    • İşleviniz Environment.new_CalculateSum({ X: Value, Y: Value }); ise, şu şekilde yeniden yazılabilir: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • Fonksiyonunuzun 'sonuç' çıktısını ayarlamak için formülünüzü 'Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))' olarak güncelleyin.
  7. Çıkış denetimini seçin ve 'Değer' özelliğini 'result.z' formülüyle ayarlayın.

Uygulamanızı önizleyin, giriş 1 ve 2 değerlerini girin ve düğmeyi seçin. Sonuç, çıktı alanında gösterilmelidir.

Power Automate bulut akışından işlevleri çağırma

  1. Bulut akışında Microsoft Dataverse bağlayıcıdan yeni bir eylem ekleyin.
  2. Bağlı olmayan eylem gerçekleştir adlı eylemi seçin
  3. İşlevinizi seçin. İşlevin öneki olan benzersiz bir adı vardır.
  4. Tüm giriş parametreleri (varsa) için değerler sağlayın.

Dataverse Web API'sinden işlevleri çağırma

Web API'sinden özel API'leri çağırma makalesindeki bağlanmamış eylem bölümlerine ilişkin adımları izleyin (eklentinin ilgili kapsamına bağlı olarak).

Var olan işlevleri yeni işlevlerin içinden çağırma

Varolan bir işlevi yeni bir işlev içinde çağırmak için şu sözdizimini kullanın: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Çıktı her zaman bir kayıt olduğundan, çıktı parametrelerine erişmek için nokta gösterimini kullanın. Örneğin, "ExistingFunction" işlevinin out1 ve out2 olarak tanımlanmış iki çıkış parametresi varsa, bunlara şu iki yoldan biriyle erişebilirsiniz:

  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out1
  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out2

Dataverse'teki işlevlerle ilgili sınırlamalar

  • Mevcut tuval uygulamalarının içindeki yeni işlevlere erişmek için ortam dili nesnesinin yeniden eklenmesi gerekir. Mevcut bir tuval uygulamasına ortam tablosu veri kaynağını ekledikten sonra oluşturulan tüm işlevler için Power Fx ortam dili nesnesini kaldırmalı ve yeniden eklemelisiniz. Ardından, güncelleştirilmiş işlevler listesini eylemler olarak görürsünüz.
  • İç içe geçmiş destek. İşlevler yalnızca Power Fx ifadelerden Microsoft tarafından yayımlanan Microsoft eylemlerini çağırabilir.
  • Bazı Collect senaryoları Patch gerektirir. Collect()'in işe yaramadığı bazı senaryolar vardır. Çözüm yolu, burada ilgili sütunu doldurma örneğinde gösterildiği gibi Patch() kullanmaktır.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

İşlevlerinizle ilgili hata ayıklama ve yardım alma

Fonksiyonunuzu oluştururken veya çalıştırırken sorunlarla karşılaşırsanız, hata ayıklama için trace() fonksiyonunu kullanın veya oluşabilecek genel sorunlar için Dataverse'teki fonksiyonlarla ilgili sınırlamalar bölümüne gidin.

trace() fonksiyonunu kullanarak hata ayıklama

  1. Trace fonksiyonunu kullanarak hata ayıklamak için eklentiyi ve özel iş akışı etkinlik izlemeyi etkinleştirdiğinizden emin olun.
  2. Power Apps'e (make.powerapps.com) gidin, sağ üstteki Ayarlar dişli simgesini seçin ve ardından Gelişmiş ayarlar'ı seçin.
  3. Ayarlar > Denetim > Genel Denetim Ayarları'nı seçin.
  4. Özelleştirme sekmesinde, Eklenti izleme günlüğüne günlüğe kaydetmeyi etkinleştir seçeneğinin Tümü için etkinleştirildiğinden emin olun.

İzlemeyi etkinleştirdikten sonra, Power Fx formüllerini hata ayıklamak için trace() fonksiyonlarını kullanmaya başlayabilirsiniz. Bir Power Fx ifadesinin içinde trace() fonksiyonunun nasıl kullanılacağı hakkında daha fazla bilgi edinin: İzleme fonksiyonu - Power Platform.

Yardım + desteğe başvurma

Microsoft Dataverse düşük kodlu eklenti ipuçlarında ele alınmayan işlevlerle ilgili sorunlar ve alınan belgelenmemiş hatalar gibi bilinen sorunlar için Yardım + destek deneyimini kullanın ve aşağıdaki bilgileri ekleyin:

  • Sorun Türü- Dataverse Web API ve SDK.
  • Sorun Alt Türü.

Örnek işlevler

Microsoft Dataverse uygulamasında işlevler oluşturma ve kullanma

  • Last updated on