Υποστήριξη πυλών για το Microsoft Power Platform CLI
Σημείωση
Από τις 12 Οκτωβρίου 2022, οι πύλες του Power Apps είναι Power Pages. Περισσότερες πληροφορίες: Το Microsoft Power Pages είναι πλέον γενικά διαθέσιμο (ιστολόγιο)
Σύντομα θα μετεγκαταστήσουμε και θα συγχωνεύσουμε την τεκμηρίωση των πυλών Power Apps με την τεκμηρίωση Power Pages.
Το Microsoft Power Platform CLI (Περιβάλλον εργασίας γραμμής εντολών) είναι ένα απλό, ολοκληρωμένο περιβάλλον εργασίας εντολών προγραμματιστή που επιτρέπει στους προγραμματιστές να προσθέσουν δείκτες για τη δημιουργία στοιχείων κώδικα.
Η χρήση εργαλείων Microsoft Power Platform CLI είναι το πρώτο βήμα για μια συνολική διαδικασία διαχείρισης του κύκλου ζωής των εφαρμογών (ALM), όπου οι προγραμματιστές και οι ISV μπορούν να δημιουργήσουν, να συντάξουν, να διορθώσουν και να δημοσιεύσουν τις επεκτάσεις και τις προσαρμογές τους γρήγορα και αποτελεσματικά. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Τι είναι το Microsoft Power Platform CLI;
Με αυτήν τη δυνατότητα, οι πύλες Microsoft Power Apps υποστηρίζουν το Microsoft Power Platform CLI για την ενεργοποίηση του CI/CD (Συνεχόμενη ενοποίηση/Συνεχόμενη ανάπτυξη) της ρύθμισης παραμέτρων της πύλης. Τώρα μπορείτε να ελέγξετε τη ρύθμιση παραμέτρων της πύλης για τον έλεγχο προέλευσης και τη μεταφορά της ρύθμισης των παραμέτρων πύλης σε οποιοδήποτε περιβάλλον χρησιμοποιώντας το Microsoft Power Platform CLI.
Σημείωση
Αυτή η δυνατότητα είναι γενικά διαθέσιμη ξεκινώντας με το Power Platform CLI έκδοση 1.9.8. Για να μάθετε σχετικά με την εγκατάσταση της πιο πρόσφατης έκδοσης, ανατρέξτε στο θέμα Εγκατάσταση Microsoft Power Platform CLI.
Γιατί να χρησιμοποιήσετε το Microsoft Power Platform CLI για την ανάπτυξη πυλών;
Με την υποστήριξη πυλών για το Microsoft Power Platform CLI, μπορείτε πλέον να χρησιμοποιείτε δυνατότητες παρόμοιες με τις δυνατότητες εκτός σύνδεσης για την προσαρμογή των πυλών κάνοντας αλλαγές στο περιεχόμενο των πυλών. Και μόλις όλες οι προσαρμογές ή οι αλλαγές αποθηκευτούν, μπορείτε να τις φορτώστε στην πύλη. Όταν κάνετε λήψη του περιεχομένου των πυλών χρησιμοποιώντας το Microsoft Power Platform CLI, το περιεχόμενο δομείται σε μορφές YAML και HTML, διευκολύνοντας την προσαρμογή και ενεργοποιώντας μια εμπειρία προ-ανάπτυξης.
Ακολουθεί μια λίστα με τα χαρακτηριστικά και τις δυνατότητες που ωφελούν τις πύλες με την υποστήριξη για το Microsoft Power Platform CLI:
Ευκολία χρήσης
Υποστήριξη για λήψη/αποστολή δεδομένων πύλης προς/από το τοπικό σύστημα αρχείων
Δημιουργία με βάση το υπάρχον εργαλείο Microsoft Power Platform CLI.
Διαχείριση κύκλου ζωής εφαρμογής (ALM)
Παρακολούθηση αλλαγών στη ρύθμιση παραμέτρων πύλης εντός ενός οργανισμού
Μετακίνηση αρχείων ρύθμισης παραμέτρων σε οργανισμούς ή μισθωτές
Υποστήριξη για επαγγελματίες προγραμματιστές και επιχειρήσεις
Βοηθά στην απρόσκοπτη ενσωμάτωση με οποιαδήποτε εργαλεία ελέγχου προέλευσης, όπως το "git"
Εγκατάσταση διοχέτευσης CI/CD με εύκολο τρόπο
Εγκατάσταση του Microsoft Power Platform CLI
Για αναλυτικές οδηγίες, ανατρέξτε στην Εγκατάσταση του CLI του Microsoft Power Platform.
Υποστηριζόμενοι πίνακες
Η υποστήριξη για τις πύλες Microsoft Power Platform CLI περιορίζεται στους πίνακες που παρατίθενται παρακάτω.
adx_ad
adx_adplacement
adx_blog
adx_blogpost
adx_botconsumer
adx_communityforum
adx_communityforumaccesspermission
adx_contentsnippet
adx_entityform
adx_entityformmetadata
adx_entitylist
adx_entitypermission
adx_forumthreadtype
adx_pagetemplate
adx_poll
adx_polloption
adx_pollplacement
adx_portallanguage
adx_publishingstate
adx_redirect
adx_shortcut
adx_sitemarker
adx_sitesetting
adx_tag
adx_urlhistory
adx_webfile
adx_webform
adx_webformmetadata
adx_webformstep
adx_weblink
adx_weblinkset
adx_webpage
adx_webpageaccesscontrolrule
adx_webrole
adx_website
adx_websiteaccess
adx_websitebinding (μόνο λήψη)
adx_websitelanguage
adx_webtemplate
σχολιασμός
Σημαντικό
- Οι προσαρμοσμένοι πίνακες και οι πίνακες που αφορούν συγκεκριμένα πρότυπα πύλης (όπως τις πύλες blog, κοινότητας ή ιδεών) δεν υποστηρίζονται για προσαρμογή με χρήση του Microsoft Power Platform CLI.
- Δεν είναι έγινε λήψη συνημμένων αρχείων εικόνας σε καρτέλες διαφημίσεων (adx_ad) με χρήση του CLI του Power Platform. Ως λύση, χρησιμοποιήστε το πεδίο Διεύθυνση URL εικόνας ή προσθέτοντας μια αναφορά HTML στο πεδίο Αντιγραφή σε μια καρτέλα αρχείου web που περιέχει ένα αρχείο εικόνας.
Εγκατάσταση και επαλήθευση του Microsoft Power Platform CLI για πύλες
Για να μάθετε περισσότερα σχετικά με την εγκατάσταση του Microsoft Power Platform CLI, μεταβείτε στο θέμα Εγκατάσταση του Microsoft Power Platform CLI.
Μετά την εγκατάσταση του Microsoft Power Platform CLI, ανοίξτε μια γραμμή εντολών και εκτελέστε το pac για να επαληθεύσετε ότι το αποτέλεσμα περιέχει το στοιχείο “paportal” - την εντολή για τις πύλες Power Apps.
Εντολές Microsoft Power Platform CLI για πύλες
Η εντολή Microsoft Power Platform CLI για πύλες είναι “paportal”.
Στις ακόλουθες ενότητες παρέχονται περισσότερες λεπτομέρειες σχετικά με τις διαφορετικές ιδιότητες της εντολής "paportal".
Παράμετροι
| Όνομα ιδιότητας | Description | Παράδειγμα |
|---|---|---|
| λίστα | Αναγράφει όλες τις τοποθεσίες web πύλης από το τρέχον περιβάλλον Dataverse. | pac paportal list |
| λήψη | Λήψη περιεχομένου τοποθεσίας Web πύλης από το τρέχον περιβάλλον Dataverse. Έχει τις ακόλουθες παραμέτρους: - path: Διαδρομή όπου θα γίνει λήψη του περιεχομένου της τοποθεσίας web (ψευδώνυμο: -p) - webSiteId: Αναγνωριστικό τοποθεσίας Web πύλης για λήψη (ψευδώνυμο: -id) - overwrite: (Προαιρετικό) αληθές - για την αντικατάσταση υπάρχοντος περιεχομένου, ψευδές - για αποτυχία, εάν ο φάκελος περιέχει ήδη περιεχόμενο τοποθεσίας web (ψευδώνυμο: -o) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| αποστολή | Αποστολή περιεχομένου τοποθεσίας Web πύλης στο τρέχον περιβάλλον Dataverse. Έχει την ακόλουθη παράμετρο: - path: Διαδρομή αποθήκευσης του περιεχομένου τοποθεσίας web (ψευδώνυμο: -p) -deploymentProfile: Αποστολή δεδομένων πύλης με λεπτομέρειες περιβάλλοντος που καθορίζονται μέσω μεταβλητών προφίλ στο αρχείο deployment-profiles/[profile-name].deployment.yaml |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
Χρήση προφίλ ανάπτυξης
Ο διακόπτης deploymentProfile σας επιτρέπει να καθορίσετε ένα σύνολο μεταβλητών για το περιβάλλον σε μορφή YAML. Για παράδειγμα, μπορείτε να έχετε διαφορετικά προφίλ ανάπτυξης (όπως προγραμματιστής, δοκιμή, παραγωγή) τα οποία έχουν διαφορετικές λεπτομέρειες σχήματος που καθορίζονται στο προφίλ.
Εάν δημιουργείτε δοκιμαστικό προφίλ, μπορείτε να δημιουργήσετε αρχείο στα προφίλ-ανάπτυξης με το όνομα "test.deployment.yml" (δηλαδή, <profileTag>.deployment.yml). Επίσης, μπορείτε να εκτελέσετε την εντολή με ετικέτα (<profileTag>) για να χρησιμοποιήσετε αυτό το προφίλ:
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test
Σε αυτό το αρχείο, μπορείτε να έχετε το όνομα του πίνακα (οντότητα) με το αναγνωριστικό πίνακα, τη λίστα χαρακτηριστικών και τις τιμές που θέλετε να παρακάμψετε κατά την μεταφόρτωση της διαμόρφωση πύλης χρησιμοποιώντας την παράμετρο deploymentProfile.
Επιπλέον, μπορείτε να χρησιμοποιήσετε τη μεταβλητή OS για να αποκτήσετε πρόσβαση στις μεταβλητές περιβάλλοντος του λειτουργικού συστήματος.
Ακολουθεί ένα παράδειγμα του αρχείου YAML του προφίλ "test.deployment.yml" που έχει μοναδικές λεπτομέρειες σχήματος:
adx_sitesetting:
- adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
adx_value: ${OS.FacebookAppId}
adx_name: Authentication/OpenAuth/Facebook/AppId
- adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
adx_value: contoso_sample
adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
- adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
adx_name: PowerBI/contoso/sales
adx_value: https://powerbi.com/group/contoso/sales
Σημείωση
Για να μάθετε για όλες τις εντολές που χρησιμοποιούνται στο CLI εκτός από τις πύλες, μεταβείτε στο θέμα Κοινές εντολές στο Microsoft Power Platform CLI.
Αρχεία δηλωτικού
Όταν κάνετε λήψη του περιεχομένου της τοποθεσίας web χρησιμοποιώντας την εντολή CLI λήψη pac paportal μαζί με τη λήψη του περιεχομένου της τοποθεσίας θα δημιουργήσει επίσης δύο αρχεία δηλωτικού.
- Αρχείο δηλωτικού περιβάλλοντος (org-url-manifest.yml)
- Διαγραφή αρχείου δηλωτικού παρακολούθησης (manifest.yml)
Αρχείο δηλωτικού περιβάλλοντος (org-url-manifest.yml)
Το αρχείο δηλωτικού περιβάλλοντος δημιουργείται κάθε φορά που εκτελείται η εντολή λήψη pac paportal.
Μετά από κάθε λήψη, το εργαλείο PAC CLI διαβάζει το υπάρχον αρχείο δηλωτικού περιβάλλοντος και ενημερώνει τις καταχωρήσεις που διαγράφονται στο περιβάλλον ή δημιουργεί το αρχείο δηλωτικού περιβάλλοντος εάν δεν υπάρχει.
Όταν εκτελείτε την εντολή αποστολή pac paportal για αποστολή του περιεχομένου της τοποθεσίας web της πύλης. Διαβάζει το αρχείο δηλωτικού περιβάλλοντος και προσδιορίζει τις αλλαγές που έγιναν από την τελευταία λήψη και κάνει αποστολή μόνο του ενημερωμένου περιεχομένου. Αυτό βοηθά στη βελτιστοποίηση της διαδικασίας αποστολής, καθώς αποστέλλεται μόνο ενημερωμένο περιεχόμενο τοποθεσίας Web, αντί να αποστέλλεται όλο το περιεχόμενο σε κάθε εντολή αποστολής.
Το αρχείο δηλωτικού περιβάλλοντος θα είναι μόνο για ανάγνωση όταν συνδέεται στο ίδιο περιβάλλον (η διεύθυνση URL του περιβάλλοντος αντιστοιχεί με όνομα αρχείου), για να αποφευχθούν οι ακούσιες αλλαγές.
Διαγραφή αρχείου δηλωτικού παρακολούθησης (manifest.yml)
Αυτό το αρχείο χρησιμοποιείται για την παρακολούθηση των διαγραμμένων καρτελών από το περιβάλλον.
Όταν γίνεται λήψη του περιεχομένου τοποθεσίας Web με την εντολή λήψη pac paporta, θα προστεθούν οι διαγραμμένες καρτέλες από το αρχείο δηλωτικού περιβάλλοντος (org-url-manifest.yml) στο αρχείο manifest.yml. Έτσι, όταν κάνετε αποστολή του περιεχομένου της τοποθεσίας web χρησιμοποιώντας την εντολή αποστολή pac paportal θα διαγραφούν τα αρχεία από το περιβάλλον (ακόμη και σε διαφορετικό περιβάλλον). Αυτό το αρχείο δεν διαγράφεται και χρησιμοποιείται ανεξάρτητα από το περιβάλλον στο οποίο είστε συνδεδεμένοι.
Σημείωση
Για να διαγράψετε τις καρτέλες περιεχομένου τοποθεσίας σε ένα περιβάλλον και επίσης να διαγράψετε τις ίδιες καρτέλες περιεχομένου σε ένα άλλο περιβάλλον χρησιμοποιώντας το PAC CLI, θα πρέπει να εκτελέσετε την εντολή λήψη pac paportal πριν και μετά τη διαγραφή του περιεχομένου της καρτέλας τοποθεσίας Web. Το manifest.yml θα παρακολουθεί αυτές τις αλλαγές και θα καταργεί τις αντίστοιχες καρτέλες στο περιβάλλον προορισμού κατά την εκτέλεση της εντολής αποστολή pac paportal.
Χρήση της επέκτασης Visual Studio Code
Μπορείτε επίσης να χρησιμοποιήσετε την επέκταση VS Code Power Platform VS Code Extension για να ωφεληθείτε από την ενσωματωμένη γλώσσα Liquid από το IntelliSense, την υποβοήθηση συμπλήρωσης κώδικα, την παροχή συμβουλών και να αλληλεπιδράσετε με το Microsoft Power Platform CLI χρησιμοποιώντας το VS Code Integrated Terminal. Περισσότερες πληροφορίες: Χρήση της επέκτασης Visual Studio Code (έκδοση προεπισκόπησης)
Επιπλέον επισημάνσεις
- Αναφέρεται ένα σφάλμα εάν η διαδρομή αρχείου σας υπερβαίνει τον περιορισμό του μέγιστου μήκους διαδρομής. Περισσότερες πληροφορίες: Μέγιστος περιορισμός μήκους διαδρομής στα Windows
- Για τις διπλότυπες καρτέλες, όπως ένα διπλότυπο όνομα ιστοσελίδας, το Microsoft Power Platform CLI δημιουργεί δύο διαφορετικούς φακέλους—έναν με το όνομα της ιστοσελίδας και έναν με το ίδιο όνομα και με πρόθεμα έναν κωδικό κατακερματισμού. Για παράδειγμα, "Η σελίδα μου" και "Η σελίδα μου-κωδικός κατακερματισμού".
Επόμενα βήματα
Πρόγραμμα εκμάθησης: χρήση του Microsoft Power Platform CLI με πύλες