Υποστήριξη 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.27, η pac paportal εντολή αλλάζει σε pac powerpages. Το paportal συνεχίζει να λειτουργεί αλλά συνιστούμε τη χρήση powerpages στο εξής. Αυτό το άρθρο θα ενημερωθεί σύντομα και θα χρησιμοποιηθεί powerpages αντί του 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

Για αναλυτικές οδηγίες, ανατρέξτε στην Εγκατάσταση του 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".

Παράμετροι

Όνομα ιδιότητας	Περιγραφή	Παράδειγμα
λίστα	Αναγράφει όλες τις τοποθεσίες web πύλης από το τρέχον περιβάλλον Dataverse. Μπορείτε να προσθέσετε την παράμετρο -v για να υποδείξετε εάν η τοποθεσία χρησιμοποιεί τυπικό ή βελτιωμένο μοντέλο δεδομένων	pac paportal list
λήψη	Λήψη περιεχομένου τοποθεσίας Web πύλης από το τρέχον περιβάλλον Dataverse. Έχει τις ακόλουθες παραμέτρους: - διαδρομή: Διαδρομή αποθήκευσης του περιεχομένου τοποθεσίας web (ψευδώνυμο: -p) - webSiteId: Αναγνωριστικό τοποθεσίας Web πύλης για λήψη (ψευδώνυμο: -id) - overwrite: (Προαιρετικό) αληθές - για την αντικατάσταση υπάρχοντος περιεχομένου, ψευδές - για αποτυχία, εάν ο φάκελος περιέχει ήδη περιεχόμενο τοποθεσίας web (ψευδώνυμο: -o) - modelVersion: 1 ή 2 για να υποδείξει αν τα δεδομένα τοποθεσίας προς λήψη χρησιμοποιούν το τυπικό (1) ή το βελτιωμένο μοντέλο δεδομένων (2).	pac paportal 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).	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

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

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

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

pac paportal 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 paportal, μαζί με τη λήψη του περιεχομένου της τοποθεσίας δημιουργούνται επίσης δύο αρχεία δηλωτικού.

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

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

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

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

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

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

Σημείωμα

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

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

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

Όταν γίνεται λήψη του περιεχομένου τοποθεσίας με εντολή λήψη pac paportal,προστίθενται οι διαγραμμένες καρτέλες από το αρχείο δηλωτικού περιβάλλοντος (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 με πύλες

Δείτε επίσης

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