αναφορά dataApi για δημιουργία σελίδων

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

Μπορείτε να προβάλετε και να επεξεργαστείτε τον δημιουργημένο κώδικα για να περιορίσετε τα δεδομένα εξόδου. Οι λειτουργίες δεδομένων χρησιμοποιούν ένα dataApi αντικείμενο που εκθέτει τις ακόλουθες δημόσιες μεθόδους:

Μέθοδος	Περιγραφή
createRow	Δημιουργεί μια νέα γραμμή στον καθορισμένο πίνακα.
updateRow	Ενημερώνει μια υπάρχουσα γραμμή στον καθορισμένο πίνακα.
deleteRow	Διαγράφει μια γραμμή από τον καθορισμένο πίνακα.
retrieveRow	Ανακτά μια γραμμή από τον καθορισμένο πίνακα με τις καθορισμένες επιλογές.
queryTable	Υποβάλλει ερωτήματα σε έναν πίνακα με τις καθορισμένες επιλογές.
getChoices	Ανακτά τις επιλογές για το καθορισμένο όνομα στήλης επιλογής.

createRow μέθοδος

Δημιουργεί μια νέα γραμμή στον καθορισμένο πίνακα.

Παράμετροι

Ορίστε τιμές για αυτές τις απαιτούμενες παραμέτρους.

Ονομασία	Τύπος	Περιγραφή
tableName	string	Το λογικό όνομα του πίνακα στον οποίο θα δημιουργηθεί η γραμμή.
row	αντικείμενο	Τα δεδομένα γραμμής που θα δημιουργηθούν.

Επιστροφές

Μια υπόσχεση που περιέχει το αποτέλεσμα της επιχείρησης. Όταν η λειτουργία ολοκληρωθεί με επιτυχία, το αποτέλεσμα είναι η τιμή ID (Guid) της γραμμής που δημιουργήθηκε.

Παράδειγμα

// Define the row data to create new account
var row =
    {
        "name": "Sample Account",
        "creditonhold": false,
        "address1_latitude": 47.639583,
        "description": "This is the description of the sample account",
        "revenue": 5000000,
        "accountcategorycode": 1,
    }

try {
  // Create a new account record
  const newAccountId = await dataApi.createRow("account", row);
  console.log("Account created with ID: " + newAccountId);

  // Create a contact with a lookup to an account
  const newContactId = await dataApi.createRow('contact', {
    firstname: 'John',
    lastname: 'Doe',
    emailaddress1: 'john.doe@contoso.com',
    "parentcustomerid@odata.bind": `/account(${newAccountId})`, // Lookup format
  });
}
catch (error) {
  console.log(error.message);
}

updateRow μέθοδος

Ενημερώνει μια υπάρχουσα γραμμή στον καθορισμένο πίνακα.

Παράμετροι

Ορίστε τιμές για αυτές τις απαιτούμενες παραμέτρους.

Ονομασία	Τύπος	Περιγραφή
tableName	string	Το λογικό όνομα του πίνακα στον οποίο θα ενημερωθεί η γραμμή.
rowId	string	Το αναγνωριστικό της γραμμής προς ενημέρωση.
row	Αντικείμενο	Τα δεδομένα γραμμής προς ενημέρωση.

Επιστροφές

Μια υπόσχεση που περιέχει το αποτέλεσμα της επιχείρησης. Όταν η λειτουργία ολοκληρωθεί με επιτυχία, δεν επιστρέφει καμία τιμή.

Παράδειγμα

let rowId = "5531d753-95af-e711-a94e-000d3a11e605"

// Define the row to update a record
var row =
    {
        "name": "Updated Sample Account ",
        "creditonhold": true,
        "address1_latitude": 47.639583,
        "description": "This is the updated description of the sample account",
        "revenue": 6000000,
        "accountcategorycode": 2
    }

// update the record

try {
   await dataApi.updateRow("account", rowId, row);
}
catch (error){
  console.log(error.message);
}

deleteRow μέθοδος

Διαγράφει μια γραμμή από τον καθορισμένο πίνακα.

Παράμετροι

Ορίστε τιμές για αυτές τις απαιτούμενες παραμέτρους.

Ονομασία	Τύπος	Περιγραφή
tableName	string	Το λογικό όνομα του πίνακα στον οποίο θα διαγραφεί η γραμμή.
rowId	string	Το αναγνωριστικό της γραμμής που θα διαγραφεί.

Επιστροφές

Μια υπόσχεση που περιέχει το αποτέλεσμα της επιχείρησης. Όταν η λειτουργία ολοκληρωθεί με επιτυχία, δεν επιστρέφει καμία τιμή.

Παράδειγμα

let rowId = "5531d753-95af-e711-a94e-000d3a11e605";
try {
  await dataApi.deleteRow("account", rowId);
}
catch (error) {
  console.log(error.message);
}

retrieveRow μέθοδος

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

Παράμετροι

Ορίστε τιμές για αυτές τις απαιτούμενες παραμέτρους.

Ονομασία	Τύπος	Περιγραφή
tableName	string	Το λογικό όνομα του πίνακα από τον οποίο θα γίνει η ανάκτηση
options	RetrieveRowOptions	Επιλογές για την ανάκτηση της γραμμής

RetrieveRowOptions

Ονομασία	Τύπος	Περιγραφή
id	string	Το αναγνωριστικό (Guid) της γραμμής προς ανάκτηση
select	string[]	(Συνιστάται) Ο πίνακας ονομάτων στηλών προς ανάκτηση. Εάν παραλειφθεί, επιστρέφονται όλες οι στήλες.

Επιστροφές

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

Παράδειγμα

// Retrieve an account with all columns
const account = await dataApi.retrieveRow('account', {
  id: '30dc51e9-947d-47d8-ad48-4fc48fba4a95',
});

// Retrieve specific columns only
const contact = await dataApi.retrieveRow('contact', {
  id: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
  select: ['firstname', 'lastname', '_parentcustomerid_value'],
});

queryTable μέθοδος

Υποβάλλει ερώτημα σε έναν πίνακα χρησιμοποιώντας τις καθορισμένες επιλογές.

Παράμετροι

Ορίστε τιμές για αυτές τις απαιτούμενες παραμέτρους.

Ονομασία	Τύπος	Περιγραφή
tableName	string	Το λογικό όνομα του πίνακα προς ερώτημα
query	QueryTableOptions	Επιλογές για την υποβολή ερωτημάτων στον πίνακα

QueryTableOptions

Ονομασία	Τύπος	Περιγραφή
select	string[]	(Συνιστάται) Ο πίνακας ονομάτων στηλών προς ανάκτηση.
filter	string	(Προαιρετικό) Παράσταση φίλτρου OData (για παράδειγμα, statecode eq 0).
orderBy	string	(Προαιρετικό) Παράσταση orderby OData (για παράδειγμα, name asc, createdon desc).
pageSize	number	(Προαιρετικό) Μέγιστος αριθμός γραμμών που θα επιστραφούν ανά σελίδα.

Επιστροφές

Μια υπόσχεση που περιέχει το αποτέλεσμα της επιχείρησης. Όταν η λειτουργία ολοκληρωθεί με επιτυχία, η υπόσχεση επιστρέφει ένα αντικείμενο που περιέχει έναν πίνακα δεδομένων με τα αποτελέσματα με αυτές τις ιδιότητες:

Ονομασία	Τύπος	Περιγραφή
rows	Object[]	Πίνακας δεδομένων γραμμών
hasMoreRows	boolean	Υποδεικνύει εάν υπάρχουν περισσότερες διαθέσιμες γραμμές
loadMoreRows	function	Συνάρτηση για φόρτωση της επόμενης σελίδας αποτελεσμάτων. (Προαιρετικό)

Παράδειγμα

// Query tasks with options
const result = await dataApi.queryTable("task", {
    select: ["activityid", "subject", "scheduledend", "prioritycode", "statecode"],
    orderBy: "scheduledend asc",
    pageSize: 50,
    filter: "statecode eq 0"
});

// Query accounts with pagination
const pagedAccounts = await dataApi.queryTable('account', {
  select: ['name'],
  pageSize: 50,
});

console.log(`Page 1: ${pagedAccounts.rows.length} accounts`);

if (pagedAccounts.hasMoreRows && pagedAccounts.loadMoreRows) {
  const nextPage = await pagedAccounts.loadMoreRows();
  console.log(`Page 2: ${nextPage.rows.length} accounts`);
}

Παρατηρήσεις

Σημείωμα

Για βέλτιστες επιδόσεις, περιορίστε πάντα τον αριθμό των στηλών που επιστρέφονται χρησιμοποιώντας την ιδιότητα QueryTableOptionsselect .

getChoices μέθοδος

Ανακτά τις επιλογές για το καθορισμένο όνομα στήλης επιλογής.

Παράμετροι

Αυτή η παράμετρος απαιτείται.

Ονομασία	Τύπος	Περιγραφή
enumName	string	Το όνομα της στήλης επιλογής στη μορφή tablename-columnname

Επιστροφές

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

Ονομασία	Τύπος	Περιγραφή
label	string	Η μεταφρασμένος τιμή ετικέτας της επιλογής.
value	Αριθμός	Η αριθμητική τιμή της επιλογής.

Παράδειγμα

// Returns the accountcategorycode column options from the account table
const categoryChoices = await dataApi.getChoices("account-accountcategorycode");
// Returns the statecode column options from the contact table
const stateChoices = await dataApi.getChoices('contact-statecode');
// Returns the statuscode column options from the account table
const statusChoices = await dataApi.getChoices('account-statuscode');