Κοινοποίηση μέσω

pac canvas

Λειτουργία με αρχεία .msapp του Power Apps

[Αυτό το άρθρο αποτελεί τεκμηρίωση προέκδοσης και ενδέχεται να αλλάξει.]

Σημαντικό

  • Οι pack εντολές και unpack είναι υπό απόσυρση.
  • Για να ελέγξετε την προέλευση της εφαρμογής καμβά σας, χρησιμοποιήστε την Ενοποίηση Power Platform Git.
  • Η create εντολή είναι γενικά διαθέσιμη.

Εντολές

Command Περιγραφή
pac canvas create Δημιουργία εφαρμογής καμβά από προσαρμοσμένη σύνδεση
pac canvas download Λήψη εφαρμογής καμβά ως αρχείο .msapp
pac canvas list Λίστα εφαρμογών καμβά
pac canvas pack (Προεπισκόπηση) Προελεύσεις πακέτου σε ένα αρχείο msapp
pac canvas unpack (Προεπισκόπηση) Εξαγωγή αρχείου msapp σε προελεύσεις
pac canvas validate (Προεπισκόπηση) Επικύρωση της προέλευσης .pa.yaml για ένα αποσυμπιεημένο αρχείο msapp

pac canvas create

Δημιουργία εφαρμογής καμβά από προσαρμοσμένη σύνδεση

Αυτή η εντολή θα δημιουργήσει μια .msapp εφαρμογή καμβά βάσει του ορισμού OpenAPI μιας υπάρχουσας προσαρμοσμένης σύνδεσης. Η εφαρμογή θα περιέχει οθόνες, διάταξη στοιχείων ελέγχου και κώδικα Power Fx που δημιουργείται με βάση τον τρόπο ορίσατε τις ενέργειες της προσαρμοσμένης σύνδεσης, με μια προκαθορισμένη εμφάνιση και αίσθηση. Η εφαρμογή μπορεί να χρησιμοποιηθεί για απευθείας άσκηση των ενεργειών που ορίζονται στην προσαρμοσμένη σύνδεση.

Οι δημιουργοί μπορούν να εισαγάγουν το δημιουργημένο .msapp στο Power Apps Studio για αναπαραγωγή της εφαρμογής ή για να κάνουν αλλαγές και να κάνουν περαιτέρω προσαρμογές. Εισαγάγετε την εφαρμογή που δημιουργήθηκε στο Power Apps Studio, μεταβαίνοντας στην επιλογή Αρχείο>Άνοιγμα>αναζήτησης στο Studio.

Παραδείγματα

Τα παρακάτω παραδείγματα δείχνουν τη χρήση της εντολής pac canvas create .

Δημιουργία εφαρμογής καμβά βάσει ενός ανοιχτού ορισμού API κατά εμφανιζόμενο όνομα

Αυτό το παράδειγμα δημιουργεί μια εφαρμογή καμβά (ως αρχείο *.msapp) που βασίζεται σε έναν Ανοιχτό ορισμό API χρησιμοποιώντας το εμφανιζόμενο όνομα της σύνδεσης.

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

Δημιουργία εφαρμογής καμβά βάσει ανοιχτού ορισμού API κατά αναγνωριστικό

Αυτό το παράδειγμα δημιουργεί μια εφαρμογή καμβά (ως αρχείο *.msapp) που βασίζεται σε έναν Ανοιχτό ορισμό API χρησιμοποιώντας το αναγνωριστικό της σύνδεσης.

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

Απαιτούνται ή connector-display-nameconnector-id .

Απαιτούμενες παράμετροι για canvas create

--msapp

Διαδρομή προς το αρχείο .msapp που θα δημιουργηθεί

Προαιρετικές παράμετροι για canvas create

--connector-display-name

Το εμφανιζόμενο όνομα της σύνδεσης από την οποία θα δημιουργηθεί το Power App.

--connector-id

Το αναγνωριστικό της σύνδεσης από την οποία θα δημιουργηθεί το Power App.

--environment

Το αναγνωριστικό περιβάλλοντος προορισμού ή η διεύθυνση URL. Η προεπιλεγμένη τιμή είναι το περιβάλλον του αυτήν τη στιγμή ενεργού προφίλ ελέγχου ταυτότητας του Dataverse.

Παρατηρήσεις

Ζητήματα και περιορισμοί:

  • Η προσαρμοσμένη σύνδεση στην οποία αναφέρονται οι connector-display-name παράμετροι ή connector-id πρέπει να αποτελεί μέρος μιας λύσης.
  • Μετά την εισαγωγή της εφαρμογής στο Studio, δεν θα υπάρχει καμία συσχέτιση με την προσαρμοσμένη σύνδεση. Ο δημιουργός πρέπει να προσθέσει με μη αυτόματο τρόπο μια αναφορά στην προσαρμοσμένη σύνδεση από την οποία δημιουργήθηκε η εφαρμογή πριν από την αναπαραγωγή της εφαρμογής. Ανατρέξτε στο θέμα Προσθήκη συνδέσεων δεδομένων σε εφαρμογές καμβά για βήματα. Μέχρι να γίνει αυτό, ενδέχεται να δείτε σφάλματα τύπων στην εφαρμογή που θα επιλυθούν όταν προστεθεί η αναφορά σύνδεσης. Το όνομα της προσαρμοσμένης σύνδεσης που προσθέτετε στην εφαρμογή πρέπει να συμφωνεί με το εμφανιζόμενο όνομα της προσαρμοσμένης σύνδεσης που αναφέρεται στην canvas create εντολή.
  • Η εφαρμογή θα περιέχει μία οθόνη για κάθε POST ενέργεια και GET την ενέργεια που ορίζει η σύνδεση.
    • Δεν υποστηρίζονται άλλα ρήματα που είναι διαθέσιμα σε προσαρμοσμένες συνδέσεις.
  • Τα στοιχεία ελέγχου που αποδίδονται στην οθόνη κάθε ενέργειας δημιουργούνται δυναμικά με βάση τον τρόπο ορίσατε τους τύπους εισόδου και εξόδου κάθε ενέργειας. Ορισμένοι τύποι εισόδου και εξόδου που ορίζονται στην προσαρμοσμένη σύνδεση δεν υποστηρίζονται από canvas createτο . Η εντολή θα δημιουργήσει προειδοποιήσεις στην κονσόλα όταν αυτές συναντήσετε. Συγκεκριμένες περιπτώσεις:
    • Οι πίνακες αντικειμένων και πινάκων πινάκων δεν υποστηρίζονται ως είσοδοι
    • Τα στοιχεία ελέγχου δεν δημιουργούνται για αντικείμενα ή ένθετες πίνακες με βάθος 20
    • Οι τύποι "Αρχείο" και "δυαδικής μορφής" δεν υποστηρίζονται για είσοδο ή έξοδο.

pac canvas download

Λήψη εφαρμογής καμβά ως αρχείο .msapp

Απαιτούμενες παράμετροι για canvas download

--name -n

Ακριβής εφαρμογή καμβά, μερικό όνομα ή αναγνωριστικό εφαρμογής

Προαιρετικές παράμετροι για canvas download

--environment -env

Καθορίζει το dataverse προορισμού. Η τιμή μπορεί να είναι μια διεύθυνση URL Guid ή απόλυτη διεύθυνση URL https. Όταν δεν καθορίζεται, θα χρησιμοποιηθεί ο ενεργός οργανισμός που επιλέγεται για το τρέχον προφίλ ελέγχου ταυτότητας.

--extract-to-directory -d

Όνομα καταλόγου για εξαγωγή εφαρμογής καμβά σε

--file-name -f

Όνομα αρχείου (συνήθως με επέκταση .msapp). Εάν δεν παρέχεται το αρχείο αποθηκεύεται στον τρέχοντα κατάλογο με το 'appname'.msapp

--overwrite -o

Να επιτρέπεται η αντικατάσταση αρχείου

Αυτή η παράμετρος δεν απαιτεί καμία τιμή. Είναι διακόπτης.

pac canvas list

Λίστα εφαρμογών καμβά

Προαιρετικές παράμετροι για canvas list

--environment -env

Καθορίζει το dataverse προορισμού. Η τιμή μπορεί να είναι μια διεύθυνση URL Guid ή απόλυτη διεύθυνση URL https. Όταν δεν καθορίζεται, θα χρησιμοποιηθεί ο ενεργός οργανισμός που επιλέγεται για το τρέχον προφίλ ελέγχου ταυτότητας.

pac canvas pack

(Προεπισκόπηση) Προελεύσεις πακέτου σε ένα αρχείο msapp

Παράδειγμα

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

Απαιτούμενες παράμετροι για canvas pack

--msapp

Διαδρομή προς το αρχείο .msapp

--sources

Κατάλογος σε προελεύσεις που θα συσκευαστούν

Παρατηρήσεις

Δημιουργεί ένα .msapp αρχείο από τα προηγουμένως αποσυμπιεσμένα αρχεία προέλευσης. Το αποτέλεσμα μπορεί να ανοίξει στο Power Apps Studio μεταβαίνοντας στην επιλογή Αρχείο>Άνοιγμα>αναζήτησης.

Αφού αποσυμπιεστούν, μπορείτε να επεξεργαστείτε και να διαχειριστείτε τα αρχεία προέλευσης με εξωτερικά εργαλεία, όπως ο Κώδικας Visual Studio και το GitHub.

pac canvas unpack

(Προεπισκόπηση) Εξαγωγή αρχείου msapp σε προελεύσεις

Παράδειγμα

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

pac canvas unpack --msapp HelloWorld.msapp

Αποσυμπιεσμένα πακέτα στον προεπιλεγμένο HelloWorld_src κατάλογο.

Απαιτούμενες παράμετροι για canvas unpack

--msapp

Διαδρομή προς το αρχείο .msapp

Προαιρετικές παράμετροι για canvas unpack

--sources

Κατάλογος προελεύσεων που θα αποσυμπιεστούν

Παρατηρήσεις

Αποσυμπιεί το .msapp αρχείο προέλευσης.

Κάντε λήψη του αρχείου από το .msapp Power Apps Studio, μεταβαίνοντας στο αρχείο Αποθήκευση>ως>αυτόν τον υπολογιστή.

Εάν η παράμετρος προέλευσης δεν έχει καθοριστεί, ένας κατάλογος με το ίδιο όνομα και θέση με το .msapp αρχείο χρησιμοποιείται με _src επίθημα.

Δομή φακέλων

Οι ιδιότητες unpack και pack χρησιμοποιούν την ακόλουθη δομή φακέλου:

  • \src - Αρχεία ελέγχου και στοιχείων. Περιέχει τις προελεύσεις.
    • *.fx.yaml - Οι τύποι που έχουν εξαχθεί από το control.json αρχείο.

      Σημείωμα

      Αυτό είναι το σημείο για να επεξεργαστείτε τους τύπους σας.

    • CanvasManifest.json - Ένα αρχείο διακήρυξης που περιέχει τις πληροφορίες που συνήθως υπάρχουν στην κεφαλίδα, τις ιδιότητες και τη publishInfo.
    • *.json - Το ανεπεξέργαστα control.json αρχείο.
    • \EditorState*.editorstate.json - Πληροφορίες στο cache για χρήση στο Power Apps Studio.
  • \Προελεύσεις δεδομένων - Όλες οι προελεύσεις δεδομένων που χρησιμοποιούνται από την εφαρμογή.
  • \Συνδέσεις - Οι παρουσίες σύνδεσης αποθηκεύονται με την εφαρμογή και χρησιμοποιούνται κατά την επαναφόρτωση στο Power Apps Studio.
  • \Assets - Αρχεία πολυμέσων ενσωματωμένα στην εφαρμογή.
  • \pkgs - Ένα ληφθέντα αντίγραφο εξωτερικών αναφορών, όπως πρότυπα, αρχεία ορισμού API και βιβλιοθήκες στοιχείων. Αυτές είναι παρόμοιες με τις αναφορές NuGet/NPM.
  • \other - Όλα τα διάφορα αρχεία που απαιτούνται για την εκ νέου δημιουργία του .msapp.
    • entropy.json - Τα μεταβλητά στοιχεία (όπως οι χρονικές σημάνσεις) εξάγονται σε αυτό το αρχείο. Αυτό συμβάλλει στη μείωση των νωθών διαφορών σε άλλα αρχεία, εξασφαλίζοντας παράλληλα ότι μπορούμε ακόμα να την κάνουμε ταυτόχρονα.
    • Περιέχει άλλα αρχεία από το msapp, όπως ό,τι υπάρχει σε \references.

Μορφή αρχείου

Τα .fx.yaml αρχεία χρησιμοποιούν ένα υποσύνολο του YAML. Παρόμοια με το Excel, όλες οι παραστάσεις πρέπει να ξεκινούν με το σύμβολο =ίσον . Περισσότερες πληροφορίες: Γραμματική τύπων Power Fx YAML

Συγχώνευση αλλαγών με το Power Apps Studio

Κατά τη συγχώνευση αλλαγών που πραγματοποιούνται σε δύο διαφορετικές περιόδους λειτουργίας του Power Apps Studio:

  • Βεβαιωθείτε ότι όλα τα ονόματα των στοιχείων ελέγχου είναι μοναδικά. Για παράδειγμα, η εισαγωγή ενός κουμπιού σε δύο διαφορετικές περιόδους λειτουργίας μπορεί να οδηγήσει σε δύο Button1 στοιχεία ελέγχου. Συνιστούμε να ονομάσετε τα στοιχεία ελέγχου αμέσως μετά τη δημιουργία τους. Το εργαλείο δεν αποδέχεται δύο στοιχεία ελέγχου με το ίδιο όνομα.
  • Για αυτά τα αρχεία, συγχωνεύστε τα όπως κάνετε συνήθως:
    • \src*.fx.yaml
  • Εάν υπάρχουν διενέξεις ή σφάλματα, μπορείτε να διαγράψετε αυτά τα αρχεία:
    • \src\editorstate*.json - Αυτά τα αρχεία περιέχουν προαιρετικές πληροφορίες στο Power Apps Studio.
    • \other\entropy.jsενεργοποιημένο
  • Για τυχόν διενέξεις σε αυτά τα αρχεία, μπορείτε να αποδεχτείτε την πιο πρόσφατη έκδοση:
    • \checksum.jsενεργοποιημένο
  • Εάν υπάρχουν διενέξεις συγχώνευσης σε αυτές τις διαδρομές, δεν είναι ασφαλές να συγχωνεύσετε. Ενημερώστε μας εάν αυτό συμβαίνει συχνά. Θα εργαστούμε για την αναδιάρθρωση της μορφής αρχείου για να αποφύγουμε διενέξεις.
    • \Συνδέσεις*
    • \Προελεύσεις δεδομένων*
    • \pkgs*
    • CanvasManifest.json

Ανοικτού

Οι εντολές καμβά στο Microsoft Power Platform CLI είναι ανοιχτού κώδικα. Συζητήστε βελτιώσεις, εγείρει ζητήματα και αποκτήστε πρόσβαση στον κώδικα από το αποθετήριο εργαλείων γλώσσας του Power Apps.

pac canvas validate

(Προεπισκόπηση) Επικύρωση της προέλευσης .pa.yaml για ένα αποσυμπιεημένο αρχείο msapp

Απαιτούμενες παράμετροι για canvas validate

--directory -d

Διαδρομή προς τον κατάλογο msapp που έχει εξαχθεί και περιέχει αρχεία .pa.yaml για επικύρωση

Δείτε επίσης

Ομάδες εντολών CLI του Microsoft Power Platform
Επισκόπηση CLI του Microsoft Power Platform

  • Last updated on