Kod bileşenleri için Liquid şablonu etiketi

  • Makale

Not

12 Ekim 2022 tarihi itibarıyla Power Apps portalları, Power Pages olarak adlandırılmıştır. Daha fazla bilgi: Microsoft Power Pages genel kullanıma sunuldu (blog)
Yakında Power Apps portalları belgelerini taşıyıp Power Pages belgeleri ile birleştireceğiz.

Power Apps component framework, profesyonel geliştiricilerin ve uygulama oluşturucularının model temelli uygulamalar ve tuval uygulamaları için kod bileşenleri oluşturmasını destekler. Bu kod bileşenleri; formlar, görünümler ve panolar üzerinde verilerle çalışan kullanıcılar için gelişmiş deneyim sağlayabilir. Daha fazla bilgi: Portallarda kod bileşenlerini kullanma

Önemli

Kod bileşenleri için Liquid şablon etiketi, portal sürümü 9.3.10.x veya üstünü gerektirir.

Bu sürümle birlikte, web sayfalarında Liquid şablon etiketi ile kod bileşenleri ekleme özelliğini sunduk ve portallarda formlardaki alan düzeyinde bileşenler için Web API'si kullanan bileşenleri etkinleştirdik.

Kod bileşenleri, codecomponent Liquid şablon etiketini kullanarak eklenebilir. Yüklenmesi gereken kod bileşenini belirtmek için anahtar, name özniteliğini kullanarak aktarılır. Anahtar, Microsoft Dataverse'te içeri aktarılan kod bileşeninin GUID'i (kod bileşeni kimliği) veya adı olabilir.

Kod bileşeninin ":" (iki nokta simgesi) ile ayrılan bir anahtar/değer çifti olarak aktarılması gerektiğini beklediği ve anahtarın özellik adı ve değeri olduğu özelliklerin değerleri, JSON dize değeridir.

{% codecomponent name: <ID or name> <property1:value> <property2:value> %}

Örneğin, controlValue adlı bir giriş parametresi bekleyerek bir kod bileşeni eklemek için aşağıdaki Liquid şablon etiketini kullanın:

{% codecomponent name:abc_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value>%}

İpucu

Bu örnekte, controlvalue ve controlApiKey adlı parametreler kullanılmaktadır ancak kullandığınız bileşen için farklı parametre adları gerekebilir.

Portallarla kullanmak için örnek harita denetimi uygulayabilir ve kod bileşenini çözüm olarak paketleyebilirsiniz.

Not

Topluluk tarafından oluşturulan kaynaklar Microsoft tarafından desteklenmez. Topluluk kaynaklarıyla ilgili soru veya sorunlarınız olursa kaynağın yayıncısına başvurun. Bu kaynakları kullanmadan önce bu topluluk kaynaklarının Power Apps component framework yönergelerini karşıladığından emin olmanız ve bunları yalnızca başvuru amacıyla kullanmanız gerekir.

Öğretici: Liquid şablon etiketi olan sayfalarda kod bileşenlerini kullanma

Bu eğitmende, bir web sayfasına bileşen eklemek için Power Apps portalları yapılandıracaksınız. Ardından portallar web sayfasını ziyaret edip bileşenle etkileşim kuracaksınız.

Başlamadan önce

Bu öğreticide kullanılan örnek kod bileşenini kullanıyorsanız ilk olarak örnek çözümleri ortama içeri aktardığınızdan emin olun. Çözümü içeri aktarma hakkında bilgi edinmek için bkz. Çözümleri içeri aktarma.

Önkoşullar

Ön koşullar ve portallarda desteklenen/desteklenmeyen kod bileşenleri hakkında bilgi edinmek için bkz. Portallarda kod bileşenlerini kullanma.

Not

Bu öğreticide, web sayfasında bir harita denetimi göstermek için Power Apps component framework kullanarak oluşturulan örnek bir kod bileşeni kullanılmaktadır. Size ait mevcut veya yeni bileşenleri ve bu öğretici için diğer web sayfalarını da kullanabilirsiniz. Bu durumda, bu öğreticideki adımları izlerken bileşeninizi ve web sayfanızı kullandığınızdan emin olun. Kod bileşenleri oluşturma hakkında daha fazla bilgi için bkz. İlk bileşeninizi oluşturma.

Adım 1. Web sayfasına Stüdyo'dan kod bileşeni ekleme

  1.  Power Apps portalları Stüdyosu'nda portalınızı açın.

  2. Sol üst köşede, Yeni sayfa'yı seçin.

  3.  Boş seçeneğini belirleyin.

  4. Sağ taraftaki özellik bölmesinde, web sayfası adını güncelleştirin. Örneğin, "Harita Görüntüleyici."

  5. Kısmi URL'yi güncelleştirin. Örneğin, "mapviewer."

  6. İzinler'i genişletin.

  7. Sayfa herkesin kullanımına sunuldu seçeneğini devre dışı bırakın.

  8. Bu sayfaya erişim izni verilmesi gereken web rollerini seçin.

  9. Liquid kaynak kodunu düzenlemek için sayfadaki düzenlenebilir alanı seçin.

  10. Stüdyoda kod düzenleyici'yi açın.

  11. Aşağıdaki söz dizimini kullanarak Liquid şablon etiketi olan denetim ekleyin:

    {% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}

    İpucu

    Tüm içeri aktarılan bileşenlerin ayrıntılarını almak ve bileşen adı aramak için CustomControl Web API'sine başvurun.

    Örneğin:

    • Bileşen aramak için:

      https://contoso.api.crm10.dynamics.com/api/data/v9.2/customcontrols?$select=ContosoCustomControlName

    • Bileşenin giriş parametrelerini almak için:

      https://contoso.api.crm10.dynamics.com/api/data/v9.2/customcontrols?$filter=name eq 'ContosoCustomControlName' &$select=manifest

  12. Kaydedin ve kod düzenleyiciyi kapatın.

  13. Sağ üst köşede, Web sitesine göz at'ı seçin.

  14. Web sayfasında artık eklenen denetim gösterilecektir.

Sonraki adımlar

Genel bakış: Portallarda kod bileşenleri kullanma

Ayrıca bkz.

Codecomponent Dataverse varlık etiketi
Codecomponent Şablon etiketi
Power Apps Component Framework'e genel bakış
İlk bileşeninizi oluşturma
Model temelli uygulamalardaki bir sütuna veya tabloya kod bileşenleri ekleme
Örnek portal Web API'si bileşeni uygulama

Not

Belge dili tercihlerinizi bizimle paylaşabilir misiniz? Kısa bir ankete katılın. (lütfen bu anketin İngilizce olduğunu unutmayın)

Anket yaklaşık yedi dakika sürecektir. Kişisel veri toplanmaz (gizlilik bildirimi).