Υποστήριξη Microsoft Power Platform CLI για Power Pages

Το Microsoft Power Platform CLI (διασύνδεση γραμμής εντολών) είναι ένα απλό, ενιαίο περιβάλλον εργασίας γραμμής εντολών προγραμματιστή, το οποίο δίνει τη δυνατότητα σε προγραμματιστές και δημιουργούς εφαρμογών να δημιουργούν στοιχεία κώδικα.

Η χρήση εργαλείων Microsoft Power Platform CLI είναι το πρώτο βήμα για μια συνολική διαδικασία διαχείρισης του κύκλου ζωής των εφαρμογών (ALM), όπου οι προγραμματιστές και οι ISV μπορούν να δημιουργήσουν, να συντάξουν, να διορθώσουν και να δημοσιεύσουν τις επεκτάσεις και τις προσαρμογές τους γρήγορα και αποτελεσματικά. Για περισσότερες πληροφορίες, μεταβείτε στο Τι είναι το Microsoft Power Platform CLI;.

Με αυτήν τη δυνατότητα, το Microsoft Power Platform CLI ενεργοποιεί το CI/CD (Συνεχόμενη ενοποίηση/Συνεχόμενη ανάπτυξη) της ρύθμισης παραμέτρων της τοποθεσίας Power Pages. Τώρα μπορείτε να ελέγξετε τη ρύθμιση παραμέτρων της τοποθεσίας web για τον έλεγχο προέλευσης και τη μεταφορά της ρύθμισης των παραμέτρων τοποθεσίας web σε οποιοδήποτε περιβάλλον χρησιμοποιώντας το Microsoft Power Platform CLI.

Σημείωμα

• Αυτή η δυνατότητα είναι γενικά διαθέσιμη ξεκινώντας με το Power Platform CLI έκδοση 1.9.8. Για να μάθετε σχετικά με την εγκατάσταση της πιο πρόσφατης έκδοσης, ανατρέξτε στο θέμα Εγκατάσταση Microsoft Power Platform CLI.
• Με το Power Platform CLI έκδοση 1.32, η εντολή pac powerpages άλλαξε σε pac pages. Με την έκδοση pac cli 1.27, η εντολή pac paportal άλλαξε σε pac powerpages. Αμφότερες οι σελίδες powerpage και paportal θα συνεχίσουν να λειτουργούν, όμως συνιστούμε να χρησιμοποιείτε σελίδες στο μέλλον.

Γιατί να χρησιμοποιήσετε το Microsoft Power Platform CLI για την ανάπτυξη τοποθεσιών web;

Με το Microsoft Power Platform CLI, μπορείτε πλέον να χρησιμοποιείτε δυνατότητα παρόμοια με τις δυνατότητες εκτός σύνδεσης για την προσαρμογή κάνοντας αλλαγές στο περιεχόμενο της τοποθεσίας web. Και μόλις όλες οι προσαρμογές ή οι αλλαγές αποθηκευτούν, μπορείτε να αποστείλετε τη ρύθμιση παραμέτρων τοποθεσίας web ξανά στο Microsoft Dataverse. Όταν κάνετε λήψη του περιεχομένου της τοποθεσίας web χρησιμοποιώντας το Microsoft Power Platform CLI, το περιεχόμενο δομείται σε μορφές YAML και HTML, διευκολύνοντας την προσαρμογή και ενεργοποιώντας μια εμπειρία προ-ανάπτυξης.

Ακολουθεί μια λίστα με τα χαρακτηριστικά και τις δυνατότητες που ωφελούν τις πύλες με την υποστήριξη για το Microsoft Power Platform CLI:

Ευκολία χρήσης

• Υποστήριξη για λήψη/αποστολή δεδομένων ρύθμισης παραμέτρων τοποθεσίας web προς/από το τοπικό σύστημα αρχείων

• Δημιουργία με βάση το υπάρχον εργαλείο Microsoft Power Platform CLI.

Διαχείριση κύκλου ζωής εφαρμογής (ALM)

• Παρακολούθηση αλλαγών στη ρύθμιση παραμέτρων τοποθεσίας web εντός ενός οργανισμού

• Μετακίνηση αρχείων ρύθμισης παραμέτρων σε οργανισμούς ή μισθωτές

Υποστήριξη για επαγγελματίες προγραμματιστές και επιχειρήσεις

• Βοηθά στην απρόσκοπτη ενσωμάτωση με οποιαδήποτε εργαλεία ελέγχου προέλευσης, όπως το "git"

• Εγκατάσταση διοχέτευσης CI/CD με εύκολο τρόπο

Εγκατάσταση του Microsoft Power Platform CLI

Για αναλυτικές οδηγίες, ανατρέξτε στην Εγκατάσταση του Microsoft Power Platform CLI.

Υποστηριζόμενοι πίνακες

Η υποστήριξη για τις πύλες 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

σχολιασμός

Σημαντικό

• Οι προσαρμοσμένοι πίνακες και οι πίνακες πύλης για συγκεκριμένα πρότυπα (όπως ιστολόγιο, κοινότητα ή πύλη ιδεών) δεν υποστηρίζονται για προσαρμογή με χρήση του CLI του Microsoft Power Platform.
• Δεν πραγματοποιείται λήψη συνημμένων αρχείων εικόνας σε εγγραφές 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".

Παράμετροι

Όνομα ιδιότητας	Περιγραφή	Παράδειγμα
λίστα	Αναγράφει όλες τις τοποθεσίες web πύλης από το τρέχον περιβάλλον Dataverse. Μπορείτε να προσθέσετε την παράμετρο -v για να υποδείξετε εάν η τοποθεσία χρησιμοποιεί τυπικό ή βελτιωμένο μοντέλο δεδομένων	pac pages list
λήψη	Λήψη περιεχομένου τοποθεσίας Web πύλης από το τρέχον περιβάλλον Dataverse. Έχει τις ακόλουθες παραμέτρους: - διαδρομή: Διαδρομή αποθήκευσης του περιεχομένου τοποθεσίας web (ψευδώνυμο: -p) - webSiteId: Αναγνωριστικό τοποθεσίας Web πύλης για λήψη (ψευδώνυμο: -id) - overwrite: (Προαιρετικό) αληθές - για την αντικατάσταση υπάρχοντος περιεχομένου, ψευδές - για αποτυχία, εάν ο φάκελος περιέχει ήδη περιεχόμενο τοποθεσίας web (ψευδώνυμο: -o) - modelVersion: 1 ή 2 για να υποδείξει εάν τα δεδομένα τοποθεσίας που θα ληφθούν χρησιμοποιούν το τυπικό (1) ή βελτιωμένο μοντέλο δεδομένων (2).	pac pages download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
αποστολή	Αποστολή περιεχομένου τοποθεσίας Web πύλης στο τρέχον περιβάλλον Dataverse. Έχει την ακόλουθη παράμετρο: - path: Διαδρομή αποθήκευσης του περιεχομένου τοποθεσίας web (ψευδώνυμο: -p) - deploymentProfile: Αποστολή δεδομένων πύλης με λεπτομέρειες περιβάλλοντος που έχουν οριστεί μέσω μεταβλητών προφίλ στο αρχείο deployment-profiles/[profile-name].deployment.yaml - modelVersion: 1 ή 2 για να υποδείξει εάν τα δεδομένα τοποθεσίας που θα αποσταλούν χρησιμοποιούν το τυπικό (1) ή βελτιωμένο μοντέλο δεδομένων (2). - forceUploadAll: Προωθεί όλα τα τοπικά αρχεία στο περιβάλλον. Χρησιμοποιήστε το όταν πιστεύετε ότι η απομακρυσμένη κατάσταση είναι κατεστραμμένη, εκτός συγχρονισμού ή όταν η τελευταία λήψη προέρχεται από διαφορετικό κλάδο.	pac pages upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Σημείωμα

• Όταν κάνετε λήψη μιας πύλης από το Περιβάλλον Α και την αποστέλλετε στο Περιβάλλον Β, το PAC CLI εκτελεί μια πλήρη αποστολή. Αυτή η συμπεριφορά προκύπτει επειδή η παρακολούθηση αλλαγών χρησιμοποιεί αρχεία διακήρυξης, τα οποία δεν μεταφέρουν πληροφορίες κατάστασης σε όλα τα περιβάλλοντα.
• Οι αποστολές delta, στις οποίες αποστέλλονται μόνο τροποποιημένα αρχεία, υποστηρίζονται μόνο όταν τόσο οι λειτουργίες λήψης όσο και αποστολής πραγματοποιούνται εντός του ίδιου περιβάλλοντος. Σε αυτή την περίπτωση, το PAC CLI εντοπίζει τοπικές αλλαγές και αποστέλλει μόνο τα ενημερωμένα αρχεία. Για να μάθετε περισσότερα σχετικά με τον τρόπο λειτουργίας της παρακολούθησης αλλαγών, ανατρέξτε στο θέμα Αρχεία διακήρυξης.
• Χρησιμοποιήστε την --forceUploadAll σε αυτές τις περιπτώσεις. (Αυτή η παράμετρος είναι προς το παρόν μόνο CLI. Οι εργασίες Azure DevOps δεν την εμφανίζουν ακόμα.)
  • Μετατόπιση κατάστασης διοχέτευσης (πραγματοποιήσατε επανεγγραφή βάσης ή επιλέξατε συγκεκριμένες {commit}, επομένως η τελευταία κατάσταση διακομιστή δεν ταιριάζει πλέον με τον κλάδο σας).
  • Υπάρχει υποψία αποτυχίας δέλτα (για παράδειγμα, μόνο μερικές αλλαγές εμφανίζονται μετά από μια κανονική upload).

Χρήση προφίλ ανάπτυξης

Ο διακόπτης deploymentProfile σας επιτρέπει να καθορίσετε ένα σύνολο μεταβλητών για το περιβάλλον σε μορφή YAML. Για παράδειγμα, μπορείτε να έχετε διαφορετικά προφίλ ανάπτυξης (όπως προγραμματιστής, δοκιμή, παραγωγή) τα οποία έχουν διαφορετικές λεπτομέρειες σχήματος που καθορίζονται στο προφίλ.

Εάν δημιουργείτε δοκιμαστικό προφίλ, μπορείτε να δημιουργήσετε αρχείο στα προφίλ-ανάπτυξης με το όνομα "test.deployment.yml" (δηλαδή, <profileTag>.deployment.yml). Επίσης, μπορείτε να εκτελέσετε την εντολή με ετικέτα (<profileTag>) για να χρησιμοποιήσετε αυτό το προφίλ:

pac pages upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2

Σε αυτό το αρχείο, μπορείτε να έχετε το όνομα του πίνακα (οντότητα) με το αναγνωριστικό πίνακα, τη λίστα χαρακτηριστικών και τις τιμές που θέλετε να παρακάμψετε κατά την μεταφόρτωση της διαμόρφωση πύλης χρησιμοποιώντας την παράμετρο 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.

Αρχεία δηλωτικού

Όταν κατεβάζετε το περιεχόμενο του ιστότοπου χρησιμοποιώντας την εντολή CLI pac pages download, μαζί με τη λήψη του περιεχομένου του ιστότοπου, δημιουργεί επίσης δύο αρχεία καταλόγου.

• Αρχείο δηλωτικού περιβάλλοντος (org-url-manifest.yml)
• Διαγραφή αρχείου δηλωτικού παρακολούθησης (manifest.yml)

Αρχείο δηλωτικού περιβάλλοντος (org-url-manifest.yml)

Το αρχείο διακήρυξης περιβάλλοντος δημιουργείται κάθε φορά που εκτελείται η εντολή λήψης σελίδων pac .

Μετά από κάθε λήψη, το εργαλείο PAC CLI διαβάζει το υπάρχον αρχείο δηλωτικού περιβάλλοντος και ενημερώνει τις καταχωρήσεις που διαγράφονται στο περιβάλλον ή δημιουργεί το αρχείο δηλωτικού περιβάλλοντος εάν δεν υπάρχει.

Όταν εκτελείτε την εντολή αποστολής σελίδων pac για να αποστείλετε το περιεχόμενο της τοποθεσίας web πύλης. Διαβάζει το αρχείο δηλωτικού περιβάλλοντος και προσδιορίζει τις αλλαγές που έγιναν από την τελευταία λήψη και κάνει αποστολή μόνο του ενημερωμένου περιεχομένου. Αυτό βοηθά στη βελτιστοποίηση της διαδικασίας αποστολής, καθώς αποστέλλεται μόνο ενημερωμένο περιεχόμενο τοποθεσίας Web, αντί να αποστέλλεται όλο το περιεχόμενο σε κάθε εντολή αποστολής.

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

Σημείωμα

• Το αρχείο διακήρυξης περιβάλλοντος δεν έχει σχεδιαστεί για την παρακολούθηση των αλλαγών κατά την ανάπτυξη της τοποθεσίας Web σε διαφορετικά περιβάλλοντα.
• Το αρχείο δηλωτικού περιβάλλοντος έχει σχεδιαστεί για να χρησιμοποιείται από προγραμματιστές για την ανάπτυξη τοπικά στο περιβάλλον προγραμματιστών τους και πρέπει να προστεθεί στη λίστα παράβλεψης git.

Διαγραφή αρχείου δηλωτικού παρακολούθησης (manifest.yml)

Αυτό το αρχείο χρησιμοποιείται για την παρακολούθηση των διαγραμμένων καρτελών από το περιβάλλον.

Όταν γίνεται λήψη περιεχομένου τοποθεσίας web με την εντολή λήψης σελίδων pac , αυτό προσθέτει τις διαγραμμένες εγγραφές από το αρχείο διακήρυξης περιβάλλοντος (org-url-manifest.yml) στο αρχείο manifest.yml. Επομένως, όταν κάνετε αποστολή του περιεχομένου της τοποθεσίας Web χρησιμοποιώντας την εντολή αποστολής σελίδων pac , διαγράφει τα αρχεία από το περιβάλλον (ακόμη και σε ένα διαφορετικό περιβάλλον). Αυτό το αρχείο δεν διαγράφεται και χρησιμοποιείται ανεξάρτητα από το περιβάλλον στο οποίο είστε συνδεδεμένοι. Αυτό το αρχείο πρέπει να θεωρηθεί όταν ωθείτε αλλαγές στο στοιχείο ελέγχου προέλευσης, προκειμένου να εξετάσετε το ενδεχόμενο διαγραφής στοιχείων στο περιβάλλον προορισμού.

Σημείωμα

Για να διαγράψετε τις εγγραφές περιεχομένου τοποθεσίας σε ένα περιβάλλον και να διαγράψετε επίσης τις ίδιες εγγραφές περιεχομένου σε ένα άλλο περιβάλλον χρησιμοποιώντας το PAC CLI, θα πρέπει να εκτελέσετε την εντολή λήψης σελίδων ρυθμούπριν και μετά τη διαγραφή του περιεχομένου εγγραφής της τοποθεσίας Web. Η manifest.yml θα παρακολουθεί αυτές τις αλλαγές και θα καταργεί τις αντίστοιχες εγγραφές στο περιβάλλον προορισμού όταν εκτελείται η εντολή αποστολής σελίδων pac .

Χρήση της επέκτασης Visual Studio 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 με πύλες

Δείτε επίσης

• Microsoft Power Platform CLI
• Χρήση της επέκτασης Visual Studio Code (έκδοση προεπισκόπησης)