Πρόγραμμα εκμάθησης: χρήση Microsoft Power Platform CLI με πύλες

Σημείωση

Από τις 12 Οκτωβρίου 2022, οι πύλες του Power Apps είναι Power Pages. Περισσότερες πληροφορίες: Το Microsoft Power Pages είναι πλέον γενικά διαθέσιμο (ιστολόγιο)
Σύντομα θα μετεγκαταστήσουμε και θα συγχωνεύσουμε την τεκμηρίωση των πυλών Power Apps με την τεκμηρίωση Power Pages.

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

Σημείωση

• Μπορείτε να χρησιμοποιήσετε το Power Platform CLI με το Power Pages. Περισσότερες πληροφορίες: Τι είναι το Power Pages
• Αυτό το πρόγραμμα εκμάθησης εστιάζει στις απαιτούμενες εντολές Microsoft Power Platform CLI για τη χρήση των πυλών Power Apps. Για περισσότερες πληροφορίες σχετικά με τις εντολές που χρησιμοποιούνται στο Power Platform CLI, ανατρέξτε στο θέμα Κοινές εντολές.

Λήψη και εγκατάσταση του Visual Studio Code

Για να συνδεθείτε σε πύλες Power Apps και να χρησιμοποιήσετε τις εντολές Microsoft Power Platform CLI, χρησιμοποιήστε το Visual Studio Code και το ενοποιημένο τερματικό. Το ενσωματωμένο τερματικό διευκολύνει τη σύνδεση στο περιβάλλον Dataverse και τη λήψη, την αλλαγή και την αποστολή των ρυθμίσεων παραμέτρων των πυλών. Μπορείτε, επίσης, να χρησιμοποιήσετε το Windows PowerShell αντί για αυτό.

Βήμα 1. Έλεγχος ταυτότητας

Πριν συνδεθείτε, δημιουργήσετε λίστα, κάνετε λήψη ή αποστολή τυχόν αλλαγών σε μια πύλη Power Apps πρέπει πρώτα να υποβληθείτε σε έλεγχο ταυτότητας στο περιβάλλον Dataverse. Για περισσότερες πληροφορίες σχετικά με τον έλεγχο ταυτότητας χρησιμοποιώντας το Microsoft Power Platform CLI, μεταβείτε στο θέμα έλεγχος ταυτότητας pac.

Για να υποβληθείτε σε έλεγχο ταυτότητας, ανοίξτε το Windows PowerShell και εκτελέστε την εντολή δημιουργία ελέγχου ταυτότητας pacχρησιμοποιώντας τη διεύθυνση URL του περιβάλλοντος Dataverse:

pac auth create -u [Dataverse URL]

Παράδειγμα

pac auth create -u https://contoso-org.crm.dynamics.com

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

Βήμα 2. Λίστα διαθέσιμων πυλών

Χρησιμοποιήστε την εντολή λίστα pac paportal για την παράθεση των διαθέσιμων πυλών Power Apps στο περιβάλλον Dataverse στο οποίο συνδεθήκατε στο προηγούμενο βήμα.

pac paportal list

Βήμα 3. Λήψη περιεχομένου πυλών

Κάντε λήψη του περιεχομένου της τοποθεσίας web της πύλης από το συνδεδεμένο περιβάλλον Dataverse χρησιμοποιώντας την εντολή λήψης pac paportal.

pac paportal download --path [PATH] -id [WebSiteId-GUID]

Παράδειγμα

pac paportal download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

Για την παράμετρο αναγνωριστικό χρησιμοποιήστε το WebSiteId που επιστράφηκε από την έξοδο του προηγούμενου βήματος.

Βήμα 4. Αλλαγή περιεχομένου πυλών

Αλλάξτε τη ρύθμιση παραμέτρων χρησιμοποιώντας το Visual Studio Code και αποθηκεύστε τις αλλαγές σας.

Σημείωση

Βεβαιωθείτε ότι ενημερώνετε μόνο τους υποστηριζόμενους πίνακες για χρήση με το Power Platform CLI. Για περισσότερες πληροφορίες, ανατρέξτε στους Υποστηριζόμενους πίνακες.

Για παράδειγμα, η προεπιλεγμένη σελίδα πύλης εμφανίζει κείμενο όπως αυτό:

Αυτό το κείμενο είναι ορατό από τον κώδικα html της ιστοσελίδας:

Μπορείτε να αλλάξετε αυτό το κείμενο και να αποθηκεύσετε τις αλλαγές:

Φιλοδώρημα

Μπορείτε να αλλάξετε τη θέση της διαδρομής φακέλου στο PowerShell/ενσωματωμένο τερματικό στη θέση λήψεων και να καταχωρήσετε τη λέξη "code ." για να ανοίξτε τον φάκελο απευθείας στο Visual Studio Code.

Βήμα 5. Αποστολή των αλλαγών

Σημείωση

• Εάν κάνετε αποστολή σε πολλά περιβάλλοντα, ανατρέξτε στο θέμα αποστολή των αλλαγών χρησιμοποιώντας το προφίλ ανάπτυξης για να μάθετε πώς να αποστείλετε αλλαγές χρησιμοποιώντας το προφίλ ανάπτυξης.
• Βεβαιωθείτε ότι το μέγιστο μέγεθος συνημμένου του περιβάλλοντος προορισμού έχει οριστεί στο ίδιο ή μεγαλύτερο μέγεθος με το περιβάλλον προέλευσης.
• Το μέγιστο μέγεθος αρχείων καθορίζεται από τη ρύθμιση μέγιστου μεγέθους αρχείου στην καρτέλα email ρυθμίσεων συστήματος στο παράθυρο διαλόγου "Ρυθμίσεις συστήματος περιβάλλοντος".

Αφού κάνετε τις απαιτούμενες αλλαγές, κάντε αποστολή χρησιμοποιώντας την εντολή αποστολής pac paportal:

pac paportal upload --path [Folder-location]

Παράδειγμα

pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Σημείωση

Βεβαιωθείτε ότι η διαδρομή για το περιεχόμενο των πυλών που εισαγάγατε είναι σωστή. Ως προεπιλογή, δημιουργείται ένας φάκελος που ονομάζεται από την πύλη (φιλικό όνομα) με το περιεχόμενο των πυλών που λήφθηκε. Για παράδειγμα, αν το φιλικό όνομα της πύλης είναι προσαρμοσμένη πύλη, η διαδρομή για την παραπάνω εντολή (--διαδρομή) πρέπει να είναι C:\pac-portals\downloads\custom-portal.

Η αποστολή συμβαίνει μόνο για περιεχόμενο που έχει αλλάξει. Σε αυτό το παράδειγμα, εφόσον η αλλαγή γίνεται σε μια ιστοσελίδα, το περιεχόμενο αποστέλλεται μόνο για τον πίνακα adx_webpage.

Αποστολή των αλλαγών χρησιμοποιώντας το προφίλ ανάπτυξης

Όταν εργάζεστε με πολλά διαφορετικά περιβάλλοντα, μπορείτε να χρησιμοποιήσετε προφίλ ανάπτυξης για να εξασφαλίσετε ότι οι αλλαγές αποστέλλονται στο σωστό περιβάλλον, χρησιμοποιώντας το προφίλ ανάπτυξης.

1. Δημιουργήστε ένα φάκελο με όνομα προφίλ ανάπτυξης μέσα στο φάκελο που περιέχει το περιεχόμενο της πύλης. Για παράδειγμα, αν το περιεχόμενο της πύλης που έχετε κάνει λήψη βρίσκεται μέσα στην "πύλη εκκίνησης", ο φάκελος των προφίλ ανάπτυξης πρέπει να βρίσκεται μέσα σε αυτόν τον φάκελο.

   

2. Μέσα στο φάκελο προφίλ ανάπτυξης, δημιουργήστε ένα αρχείο ανάπτυξης YAML που περιέχει τις αλλαγές που αφορούν το περιβάλλον. Για παράδειγμα, το περιβάλλον ανάπτυξης μπορεί να ονομάζεται "dev.deployment.yml".

   

3. Επεξεργαστείτε το αρχείο ανάπτυξης YAML χρησιμοποιώντας το Visual Studio Code με την ακόλουθη μορφή:

   <table-name>:
   - <record-id>: <GUID>
     <column-name>: <Name>
     <column-value>: <Value>
   

   Για παράδειγμα, το παρακάτω δείγμα κώδικα YAML ενημερώνει την τιμή για το "Επίθεμα τίτλου προγράμματος περιήγησης" από την προεπιλεγμένη "Προσαρμοσμένη πύλη" σε "Προσαρμοσμένη πύλη (Dev)".

   adx_contentsnippet:
       - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
         adx_name: Browser Title Suffix # Setting name
         adx_value:   · Custom Portal (Dev) # Setting value
   

4. Για να αποστείλετε τις αλλαγές σε ένα διαφορετικό περιβάλλον χρησιμοποιώντας ένα αρχείο προφίλ ανάπτυξης ΥΑML, κάντε πρώτα έλεγχο ταυτότητας στον οργανισμό προορισμού.

5. Μετά τον έλεγχο ταυτότητας και τη σύνδεση στο σωστό περιβάλλον, χρησιμοποιήστε την εντολή αποστολής pac paportal για αποστολή του περιεχομένου:

   pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile dev

   Σημείωση

   Στο παραπάνω παράδειγμα, το όνομα του προφίλ ανάπτυξης που χρησιμοποιείται είναι "dev" αφού ακολουθήθηκαν τα προηγούμενα βήματα για να δημιουργήσετε ένα προφίλ ανάπτυξης dev. Αλλάξτε το όνομα από "dev" σε οποιοδήποτε άλλο (όπως QA για "qa.deployment.yml" ή Test για "test.deployment.yml") εάν έχετε χρησιμοποιήσει ένα διαφορετικό όνομα αρχείου για το αρχείο ανάπτυξης YAML.

Βήμα 6. Επιβεβαίωση των αλλαγών

Για να επιβεβαιώσετε τις αλλαγές που έγιναν στην ιστοσελίδα της πύλης:

1. Διαγράψτε την κρυφή μνήμη πλευράς διακομιστή ή χρησιμοποιήστε το Συγχρονισμό ρύθμισης παραμέτρων χρησιμοποιώντας το Power Apps portals Studio.

2. Περιηγηθείτε στην ιστοσελίδα της πύλης για να δείτε την αλλαγή.

   

3. Αν χρησιμοποιήσατε το παράδειγμα του προφίλ ανάπτυξης που εξηγείται προηγουμένως, το τμήμα κώδικα YAML θα ενημερώσει την τιμή όπως φαίνεται παρακάτω.

   

   Το επίθεμα τίτλου του προγράμματος περιήγησης που ενημερώνεται μέσω της παραπάνω αλλαγής δείχνει την αλλαγή όταν ανοίγετε την πύλη σε ένα πρόγραμμα περιήγησης:

   

Έτσι ολοκληρώνεται το πρόγραμμα εκμάθησης. Μπορείτε να επαναλάβετε τα παραπάνω βήματα και να αλλάξετε το περιεχόμενο των πυλών για άλλους υποστηριζόμενους πίνακες.

Επόμενα βήματα

Χρήση της επέκτασης Visual Studio Code

Δείτε επίσης

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