pac model

Εντολές για εργασία με εφαρμογές βάσει μοντέλου.

Commands

Command Description
pac model create Δημιουργεί μια νέα εφαρμογή βάσει μοντέλου.
pac model genpage download Τραβήξτε σελίδες που δημιουργούνται από μια εφαρμογή βάσει μοντέλου.
pac model genpage generate-types Δημιουργεί ορισμούς σχήματος TypeScript για προελεύσεις δεδομένων
pac model genpage list Παραθέτει όλες τις σελίδες που δημιουργούνται στην καθορισμένη εφαρμογή βάσει μοντέλου.
pac model genpage transpile Μεταγλωττίζει ένα αρχείο TypeScript με τύπους χρόνου εκτέλεσης για δοκιμή και εντοπισμό σφαλμάτων
pac model genpage upload Αποστείλετε και δημοσιεύστε μια σελίδα που δημιουργήθηκε σε μια εφαρμογή βάσει μοντέλου.
pac model list Παραθέτει όλες τις εφαρμογές βάσει μοντέλου στο περιβάλλον.
pac model list-languages Παραθέτει τις ενεργοποιημένες γλώσσες στο περιβάλλον Dataverse.
pac model list-tables Λίστα πινάκων Dataverse στο συνδεδεμένο περιβάλλον.

pac model create

Δημιουργεί μια νέα εφαρμογή βάσει μοντέλου.

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

--name -n

Το εμφανιζόμενο όνομα για τη νέα εφαρμογή βάσει μοντέλου.

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

--description -d

Περιγραφή της νέας εφαρμογής βάσει μοντέλου.

--environment -env

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

--publish

Δημοσιεύστε την εφαρμογή μετά τη δημιουργία.

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

--solution

Μοναδικό όνομα λύσης για την προσθήκη της εφαρμογής. Η προεπιλογή είναι η ενεργή λύση.

pac model create Παραδείγματα

Τα παρακάτω παραδείγματα εμφανίζουν συνήθεις τρόπους χρήσης της εντολής pac model create .

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

pac model create --name "Contoso Sales Hub"

Δημιουργήστε μια εφαρμογή με μια περιγραφή και προσθέστε τη σε μια λύση και, στη συνέχεια, δημοσιεύστε την αμέσως

pac model create \
  --name "Contoso Sales Hub" \
  --description "Central hub for managing Contoso sales activities, accounts, and contacts." \
  --solution "ContosoSales" \
  --publish

Δημιουργήστε μια εφαρμογή σε ένα συγκεκριμένο περιβάλλον παρέχοντας τη διεύθυνση URL περιβάλλοντος

pac model create \
  --name "Contoso Sales Hub" \
  --description "Central hub for managing Contoso sales activities, accounts, and contacts." \
  --environment "https://contoso.crm.dynamics.com" \
  --solution "ContosoSales" \
  --publish

Tip

Χρησιμοποιήστε pac model list την για να επαληθεύσετε ότι η εφαρμογή δημιουργήθηκε και ανακτήστε το αναγνωριστικό εφαρμογής της για χρήση με άλλες εντολές όπως pac model genpage upload.

pac model genpage download

Τραβήξτε σελίδες που δημιουργούνται από μια εφαρμογή βάσει μοντέλου.

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

--app-id

Το αναγνωριστικό της εφαρμογής βάσει μοντέλου.

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

--environment -env

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

--output-directory -o

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

--page-id

Λίστα αναγνωριστικών σελίδας διαχωρισμένων με κόμματα προς έλξη.

pac model genpage download Παραδείγματα

Τα παρακάτω παραδείγματα εμφανίζουν συνήθεις τρόπους χρήσης της εντολής pac model genpage download .

Λήψη μίας σελίδας δημιουργίας βάσει του αναγνωριστικού σελίδας της σε έναν τοπικό φάκελο για επεξεργασία

pac model genpage download \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --page-id "e5f6a7b8-abcd-ef01-2345-000000000010" \
  --output-directory ./pages/account-dashboard

Λήψη όλων των σελίδων δημιουργίας σε μια εφαρμογή ταυτόχρονα

pac model genpage download \
  --app-id "Contoso Sales Hub" \
  --output-directory ./pages

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

./pages/account-dashboard/
  e5f6a7b8-abcd-ef01-2345-000000000010/
    page.tsx          ← TypeScript source code
    page.js           ← Transpiled JavaScript
    RuntimeTypes.ts   ← Dataverse type definitions
    config.json       ← Page metadata
    prompt.txt        ← Original generation prompt

pac model genpage generate-types

Δημιουργεί ορισμούς σχήματος TypeScript για προελεύσεις δεδομένων

Απαιτούμενες παράμετροι για model genpage generate-types

--data-sources

Λίστα προελεύσεων δεδομένων διαχωρισμένων με κόμματα που χρησιμοποιούνται (π.χ., "λογαριασμός, υποψήφιος πελάτης, επαφή").

Προαιρετικές παράμετροι για model genpage generate-types

--environment -env

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

--output-file -o

Διαδρομή για την αποθήκευση του αρχείου σχήματος TypeScript που δημιουργήθηκε (από προεπιλογή RuntimeTypes.ts)

pac model genpage generate-types Παραδείγματα

Τα παρακάτω παραδείγματα εμφανίζουν συνήθεις τρόπους χρήσης της εντολής pac model genpage generate-types .

Δημιουργία τύπων TypeScript

Δημιουργήστε τύπους TypeScript για account τους πίνακες και contact και γράψτε τους στο ./src/RuntimeTypes.ts:

pac model genpage generate-types \
  --data-sources "account,contact" \
  --output-file ./src/RuntimeTypes.ts

Δημιουργία τύπων για έναν μεμονωμένο πίνακα σε έναν συγκεκριμένο κατάλογο εξόδου

pac model genpage generate-types \
  --data-sources "opportunity" \
  --output-file ./pages/opportunity/RuntimeTypes.ts

Note

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

pac model genpage list

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

Απαιτούμενες παράμετροι για model genpage list

--app-id

Το αναγνωριστικό της εφαρμογής βάσει μοντέλου.

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

--environment -env

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

pac model genpage list Παραδείγματα

Τα παρακάτω παραδείγματα εμφανίζουν συνήθεις τρόπους χρήσης της εντολής pac model genpage list .

Παράθεση σελίδων με χρήση του αναγνωριστικού εφαρμογής

Παράθεση όλων των σελίδων δημιουργίας στην εφαρμογή Διανομέα πωλήσεων Contoso χρησιμοποιώντας το αναγνωριστικό εφαρμογής της:

pac model genpage list --app-id "a1b2c3d4-1234-5678-abcd-000000000001"

Παράθεση σελίδων με χρήση του ονόματος εφαρμογής

Λίστα με δημιουργία σελίδων με βάση το όνομα της εφαρμογής (το CLI αναζητά αυτόματα το αναγνωριστικό εφαρμογής):

pac model genpage list --app-id "Contoso Sales Hub"

pac model έξοδος δείγματος σελίδας genpage

Found 2 generated page(s):

  Account Dashboard
    Page ID: e5f6a7b8-abcd-ef01-2345-000000000010
    Description: Created: 2026-01-15T10:22:00Z

  Opportunity Tracker
    Page ID: e5f6a7b8-abcd-ef01-2345-000000000011
    Description: Created: 2026-02-03T14:05:00Z

pac model genpage transpile

Μεταγλωττίζει ένα αρχείο TypeScript με τύπους χρόνου εκτέλεσης για δοκιμή και εντοπισμό σφαλμάτων

Απαιτούμενες παράμετροι για model genpage transpile

--code-file

Η διαδρομή προς το αρχείο που περιέχει τον κωδικό σελίδας.

Προαιρετικές παράμετροι για model genpage transpile

--data-sources

Λίστα προελεύσεων δεδομένων διαχωρισμένων με κόμματα που χρησιμοποιούνται (π.χ., "λογαριασμός, υποψήφιος πελάτης, επαφή").

--environment -env

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

--output-file

Διαδρομή για την αποθήκευση της εξόδου JavaScript που έχει δημιουργηθεί (η προεπιλεγμένη τιμή [αρχείο-κώδικα].compiled.js)

pac model genpage upload

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

Απαιτούμενες παράμετροι για model genpage upload

--app-id

Το αναγνωριστικό της εφαρμογής βάσει μοντέλου.

--code-file

Η διαδρομή προς το αρχείο που περιέχει τον κωδικό σελίδας.

Προαιρετικές παράμετροι για model genpage upload

--add-to-sitemap

Προσθέστε τη σελίδα στην περιήγηση χάρτη τοποθεσίας της εφαρμογής.

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

--agent-message

Το μήνυμα απάντησης του πράκτορα.

--agent-message-file

Διαδρομή προς ένα αρχείο που περιέχει το μήνυμα απόκρισης του παράγοντα.

--compiled-code-file

Διαδρομή προς το αρχείο που περιέχει τον μεταγλωττισμένο κώδικα JavaScript. Εάν δεν παρέχεται, η TypeScript θα μεταδοθεί αυτόματα σε JavaScript.

--data-sources

Λίστα προελεύσεων δεδομένων διαχωρισμένων με κόμματα που χρησιμοποιούνται (π.χ., "λογαριασμός, υποψήφιος πελάτης, επαφή").

--environment -env

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

--model

Το μοντέλο AI που χρησιμοποιήθηκε για τη δημιουργία της σελίδας (π.χ. "claude-3-5-sonnet-20241022").

--name -n

Το όνομα της σελίδας.

--page-id

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

--prompt

Το μήνυμα χρήστη που δημιούργησε αυτή τη σελίδα.

--prompt-file

Η διαδρομή προς ένα αρχείο που περιέχει την προτροπή του χρήστη που δημιούργησε αυτήν τη σελίδα.

pac model genpage upload Παραδείγματα

Τα παρακάτω παραδείγματα εμφανίζουν συνήθεις τρόπους χρήσης της εντολής pac model genpage upload .

Δημοσίευση νέας σελίδας δημιουργίας

Δημοσιεύστε μια νέα σελίδα δημιουργίας στην εφαρμογή Διανομέα πωλήσεων Contoso και προσθέστε τη στον χάρτη τοποθεσίας εφαρμογής:

pac model genpage upload \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --code-file ./pages/account-dashboard.tsx \
  --name "Account Dashboard" \
  --data-sources "account,contact" \
  --prompt "A dashboard showing Account records as interactive cards with contact count and revenue metrics." \
  --model "claude-sonnet-4-6" \
  --agent-message "Created account dashboard with card grid, revenue chart, and contact list. Uses account and contact tables." \
  --add-to-sitemap

Ενημέρωση υπάρχουσας σελίδας δημιουργίας

Ενημερώστε μια υπάρχουσα σελίδα δημιουργίας παρέχοντας το αναγνωριστικό σελίδας της (παραλείπεται --add-to-sitemap για να αποφύγετε τη δημιουργία μιας διπλότυπης καταχώρησης χάρτη τοποθεσίας):

pac model genpage upload \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --page-id "e5f6a7b8-abcd-ef01-2345-000000000010" \
  --code-file ./pages/account-dashboard.tsx \
  --data-sources "account,contact" \
  --prompt "A dashboard showing Account records as interactive cards with contact count and revenue metrics." \
  --model "claude-sonnet-4-6" \
  --agent-message "Updated card layout to use a two-column grid; added revenue sparkline chart."

Δημοσίευση σελίδας που χρησιμοποιεί εικονικά δεδομένα

Δημοσίευση μιας σελίδας που χρησιμοποιεί εικονικά δεδομένα (χωρίς πίνακες dataverse — παράλειψη --data-sources):

pac model genpage upload \
  --app-id "Contoso Sales Hub" \
  --code-file ./pages/welcome-screen.tsx \
  --name "Welcome" \
  --prompt "A branded welcome screen with Contoso logo, quick-action tiles, and a news feed placeholder." \
  --model "claude-sonnet-4-6" \
  --agent-message "Welcome page with static mock data. No Dataverse queries." \
  --add-to-sitemap

Tip

Η --app-id παράμετρος αποδέχεται είτε το GUID της εφαρμογής είτε το εμφανιζόμενο όνομά της. Εάν πολλές εφαρμογές έχουν το ίδιο εμφανιζόμενο όνομα, χρησιμοποιήστε το GUID για να αποφύγετε ασάφειες. Εκτελέστε την pac model list για να αναζητήσετε αναγνωριστικά εφαρμογών.

pac model genpage upload γρήγορη αναφορά παραμέτρου

Parameter Required Description
--app-id Yes GUID εφαρμογής ή εμφανιζόμενο όνομα. Εκτελέστε το pac model list για να το βρείτε.
--code-file Yes Διαδρομή προς το αρχείο προέλευσης .tsx για ανάπτυξη.
--name Νέες σελίδες μόνο Το εμφανιζόμενο όνομα εμφανίζεται στον χάρτη τοποθεσίας εφαρμογής.
--page-id Updates only GUID της υπάρχουσας σελίδας για αντικατάσταση.
--data-sources Dataverse pages Λίστα λογικών ονομάτων πίνακα διαχωρισμένων με κόμματα (για παράδειγμα, "account,contact").
--prompt Recommended Σύνοψη φυσικής γλώσσας για το τι κάνει η σελίδα. Αποθηκευμένες για περιβάλλον αναγέννησης.
--model Recommended Αναγνωριστικό μοντέλου που χρησιμοποιήθηκε για τη δημιουργία της σελίδας (για παράδειγμα, claude-sonnet-4-6).
--agent-message Recommended Περιγραφή των στοιχείων που δημιουργήθηκαν ή άλλαξαν. Αποθηκεύονται ως ιστορικό αλλαγών.
--add-to-sitemap Νέες σελίδες μόνο Προσθέτει αυτόματα τη σελίδα στην περιήγηση εφαρμογής. Παραλείπει κατά την ενημέρωση.

pac model list

Παραθέτει όλες τις εφαρμογές βάσει μοντέλου στο περιβάλλον.

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

--environment -env

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

pac model list παράδειγμα

Παράθεση όλων των εφαρμογών βάσει μοντέλου στο τρέχον ενεργό περιβάλλον:

pac model list

Sample output:

Found 3 model-driven app(s):

  Contoso Sales Hub
    App ID: a1b2c3d4-1234-5678-abcd-000000000001
    Unique Name: contoso_SalesHub

  Contoso Field Service
    App ID: a1b2c3d4-1234-5678-abcd-000000000002
    Unique Name: contoso_FieldService

  Contoso Customer Portal
    App ID: a1b2c3d4-1234-5678-abcd-000000000003
    Unique Name: contoso_CustomerPortal

pac model list-languages

Παραθέτει τις ενεργοποιημένες γλώσσες στο περιβάλλον Dataverse.

Προαιρετικές παράμετροι για model list-languages

--environment -env

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

pac model list-tables

Λίστα πινάκων Dataverse στο συνδεδεμένο περιβάλλον.

Προαιρετικές παράμετροι για model list-tables

--environment -env

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

--search -s

Λίστα ονομάτων διαχωρισμένων με κόμματα προς αναζήτηση (ταιριάζει με το λογικό όνομα, το όνομα σχήματος ή το εμφανιζόμενο όνομα).

--type -t

Φιλτράρισμα κατά τύπο πίνακα: "προσαρμοσμένο", "τυπικό" ή "όλα" (προεπιλογή: όλα).

See also

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