Aracılığıyla paylaş

pac canvas

Power Apps .msapp dosyalarıyla çalışma

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

Önemli

  • pack ve unpack komutları kullanım dışıdır.
  • Tuval uygulamanızı kaynak denetimi için Power Platform Git Tümleştirmesi'ni kullanın.
  • create komutu genel olarak kullanılabilir.

Commands

Command Description
pac canvas create Özel bağlayıcıdan tuval uygulaması oluşturma
pac canvas download Tuval uygulamasını .msapp dosyası olarak indirme
pac canvas list Tuval uygulamalarını listeleme
pac canvas pack (Önizleme) Kaynakları bir msapp dosyasına paketleme
pac canvas unpack (Önizleme) Msapp dosyasını kaynaklara ayıklama
pac canvas validate (Önizleme) Sıkıştırması açılmış bir msapp dosyası için .pa.yaml kaynağını doğrulama

pac canvas create

Özel bağlayıcıdan tuval uygulaması oluşturma

Bu komut, mevcut özel .msappbağlayıcının OpenAPI tanımına dayalı bir tuval uygulaması oluşturur. Uygulama, önceden tanımlanmış bir görünüm ve görünüme sahip özel bağlayıcının eylemlerinin nasıl tanımlandığına göre oluşturulan ekranlar, denetim düzeni ve Power Fx kodu içerir. Uygulama, özel bağlayıcıda tanımlanan eylemleri doğrudan uygulamak için kullanılabilir.

Oluşturucular, uygulamayı yürütmek veya düzenleme yapmak ve daha fazla özelleştirme yapmak için oluşturulan .msapp öğesini Power Apps Studio'ya aktarabilir. Oluşturulan uygulamayı Power Apps Studio'ya aktarmak için Studio'da Dosya>Aç>Gözat'a gidin .

Örnekler

Aşağıdaki örneklerde komutun kullanımı gösterilmektedir pac canvas create .

Görünen ada göre Open API Tanımını temel alan bir tuval uygulaması oluşturma

Bu örnek, bağlayıcının görünen adını kullanarak Open API Tanımına dayalı bir tuval uygulaması (*.msapp dosyası olarak) oluşturur.

pac canvas create --msapp HelloWorld.msapp --connector-display-name "My Custom Connector"

Kimliğine göre Open API Tanımını temel alan bir tuval uygulaması oluşturma

Bu örnek, bağlayıcının kimliğini kullanarak Open API Tanımını temel alan bir tuval uygulaması (*.msapp dosyası olarak) oluşturur.

pac canvas create --msapp HelloWorld.msapp --connector-id 00000000-0000-0000-0000-000000000000

ya da connector-display-nameconnector-id gereklidir.

Için Gerekli Parametreler canvas create

--msapp

Oluşturulacak .msapp dosyasının yolu

için İsteğe Bağlı Parametreler canvas create

--connector-display-name

Power App'in oluşturulacağı Bağlayıcının görünen adı.

--connector-id

Power App'in oluşturulacağı Bağlayıcı kimliği.

--environment

Hedef Ortam Kimliği veya URL. Varsayılan değer şu anda etkin olan Dataverse Kimlik Doğrulama Profilinizin ortamıdır.

Açıklamalar

Dikkat edilmesi gerekenler ve sınırlamalar:

  • veya connector-display-name parametreleriyle başvuruda bulunılan connector-id özel bağlayıcı bir Çözümün parçası olmalıdır.
  • Uygulamayı Studio'ya aktardıktan sonra özel bağlayıcıyla hiçbir ilişkilendirme olmaz. Oluşturucu, uygulamanın oynatılabilmesi için önce uygulamanın oluşturulduğu özel bağlayıcıya el ile bir başvuru eklemelidir. Adımlar için bkz. Tuval uygulamalarına veri bağlantıları ekleme . Bu işlem yapılana kadar, uygulamada bağlayıcı başvurusu eklendikten sonra çözülecek formül hataları görebilirsiniz. Uygulamaya eklediğiniz özel bağlayıcının adı, komutta başvuruda bulunan özel bağlayıcının görünen adıyla canvas create eşleşmelidir.
  • Uygulama, bağlayıcının tanımladığı her POST biri ve GET eylemi için bir ekran içerir.
    • Özel bağlayıcılarda kullanılabilen diğer fiiller desteklenmez.
  • Her eylemin ekranında işlenen denetimler, her eylemin giriş ve çıkış türlerinin nasıl tanımlandığına bağlı olarak dinamik olarak oluşturulur. Özel bağlayıcıda tanımlanan belirli giriş ve çıkış türleri tarafından canvas createdesteklenmez. Komut, bunlarla karşılaşıldığında konsolda uyarılar oluşturur. Belirli durumlar:
    • Nesne dizileri ve dizi dizileri giriş olarak desteklenmez
    • 20 derinliğinin ötesinde nesneler veya iç içe diziler için denetimler oluşturulmaz
    • Giriş veya çıkış için "Dosya" ve "ikili biçim" türleri desteklenmez.

pac canvas download

Tuval uygulamasını .msapp dosyası olarak indirme

Için Gerekli Parametreler canvas download

--name -n

Tuval uygulaması tam, kısmi ad veya Uygulama Kimliği

için İsteğe Bağlı Parametreler canvas download

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--extract-to-directory -d

Tuval uygulamasını ayıklamak için dizin adı

--file-name -f

Dosya adı (genellikle .msapp uzantısıyla). Sağlanmadıysa dosya 'appname'.msapp ile geçerli dizine kaydedilir

--overwrite -o

Dosyanın üzerine yazılmasını izin ver

Bu parametre için değer gerekmez. Bu bir anahtar.

pac canvas list

Tuval uygulamalarını listeleme

için İsteğe Bağlı Parametreler canvas list

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

pac canvas pack

(Önizleme) Kaynakları bir msapp dosyasına paketleme

Example

pac canvas pack --sources MyHelloWorldFiles --msapp HelloWorld.msapp

Için Gerekli Parametreler canvas pack

--msapp

.msapp dosyasının yolu

--sources

Paketlenecek kaynaklara dizin

Açıklamalar

Önceden paketlenmemiş kaynak dosyalardan bir .msapp dosya oluşturur. Sonuç, Dosya>Açma>Gözat'a giderek Power Apps Studio'da açılabilir.

Paketten çıkarıldıktan sonra, kaynak dosyalar Visual Studio Code ve GitHub gibi dış araçlarla düzenlenebilir ve yönetilebilir.

pac canvas unpack

(Önizleme) Msapp dosyasını kaynaklara ayıklama

Example

pac canvas unpack --msapp HelloWorld.msapp --sources MyHelloWorldFiles

pac canvas unpack --msapp HelloWorld.msapp

Varsayılan HelloWorld_src dizine açılır.

Için Gerekli Parametreler canvas unpack

--msapp

.msapp dosyasının yolu

için İsteğe Bağlı Parametreler canvas unpack

--sources

Paketlenecek kaynaklara dizin

Açıklamalar

Kaynak dosyayı açar .msapp .

.msapp Bu bilgisayar> Dosya Kaydet'e giderek > Power Apps Studio'dan indirin.

Sources parametresi belirtilmezse, dosyayla aynı ada ve konuma .msapp sahip bir dizin sonek ile _src kullanılır.

Klasör yapısı

Paketten çıkarma ve paketleme özellikleri aşağıdaki klasör yapısını kullanın:

  • \src - Denetim ve bileşen dosyaları. Bu, kaynakları içerir.
    • *.fx.yaml - Dosyadan control.json ayıklanan formüller.

      Uyarı

      Burası formüllerinizi düzenleyebileceğiniz yerdir.

    • CanvasManifest.json - Normalde üst bilgide, özelliklerde ve publishInfo'da bulunan bilgileri içeren bir bildirim dosyası.
    • *.json - Ham control.json dosya.
    • \EditorState*.editorstate.json - Power Apps Studio'da kullanılacak önbelleğe alınmış bilgiler.
  • \DataSources - Uygulama tarafından kullanılan tüm veri kaynakları.
  • \Connections - Uygulamayla kaydedilen ve Power Apps Studio'ya yeniden yüklenirken kullanılan bağlantı örnekleri.
  • \Assets - Uygulamaya eklenmiş medya dosyaları.
  • \pkgs - Şablonlar, API tanım dosyaları ve bileşen kitaplıkları gibi dış başvuruların indirilmiş bir kopyası. Bunlar NuGet/NPM başvurularına benzer.
  • \other - yeniden oluşturmak .msappiçin gereken tüm çeşitli dosyalar.
    • entropy.json - Geçici öğeler (zaman damgaları gibi) bu dosyaya ayıklanır. Bu, diğer dosyalardaki gürültülü farkları azaltmaya yardımcı olurken, yine de gidiş dönüş sağlayabildiğimizi güvence altına alır.
    • \references içindekiler gibi msapp'teki diğer dosyaları tutar.

Dosya biçimi

Dosyalar .fx.yamlYAML'nin bir alt kümesini kullanır. Excel'e benzer şekilde, tüm ifadeler eşittir işaretiyle =başlamalıdır. Daha fazla bilgi: Power Fx YAML Formül Dil Bilgisi

Power Apps Studio ile değişiklikleri birleştirme

İki farklı Power Apps Studio oturumunda yapılan değişiklikleri birleştirirken:

  • Tüm denetim adlarının benzersiz olduğundan emin olun. Örneğin, iki farklı oturuma düğme eklemek iki Button1 denetime neden olabilir. Denetimleri oluşturduktan kısa süre sonra adlandırmanızı öneririz. Araç aynı ada sahip iki denetimi kabul etmez.
  • Bu dosyalar için, normalde yaptığınız gibi bunları birleştirin:
    • \src*.fx.yaml
  • Çakışmalar veya hatalar varsa şu dosyaları silebilirsiniz:
    • \src\editorstate*.json - Bu dosyalar Power Apps Studio'da isteğe bağlı bilgiler içerir.
    • \other\entropy.jsaçık
  • Bu dosyalardaki tüm çakışmalar için en son sürümü kabul etmek uygun olur:
    • \checksum.jsaçık
  • Bu yolların altında birleştirme çakışmaları varsa, birleştirme güvenli değildir. Bu durum sık sık gerçekleşirse bize bildirin; çakışmaları önlemek için dosya biçimini yeniden yapılandırmaya çalışacağız.
    • \Bağlantı*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Açık kaynak

Microsoft Power Platform CLI'daki tuval komutları açık kaynaktır. Geliştirmeleri tartışın, sorun oluşturun ve Power Apps dil araç deposundan koda erişin.

pac canvas validate

(Önizleme) Sıkıştırması açılmış bir msapp dosyası için .pa.yaml kaynağını doğrulama

Için Gerekli Parametreler canvas validate

--directory -d

Doğrulanması için .pa.yaml dosyalarını içeren ayıklanan msapp dizininin yolu

Ayrıca bakınız

Microsoft Power Platform CLI Komut Grupları
Microsoft Power Platform CLI'ya genel bakış

  • Last updated on