Μέθοδοι πίνακα του dataverse για δημιουργία σελίδων

Χρησιμοποιήστε τις μεθόδους πίνακα του dataApi αντικειμένου για να δημιουργήσετε, ανακτήσετε, ενημερώσετε και διαγράψετε γραμμές πίνακα του Dataverse και στήλες επιλογής ερωτήματος.

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

createRow μέθοδος

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

Παράμετροι

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

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

Επιστροφές

Μια υπόσχεση που περιέχει το αποτέλεσμα της επιχείρησης. Όταν η λειτουργία ολοκληρωθεί με επιτυχία, το αποτέλεσμα είναι η τιμή 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);
}

deleteRow μέθοδος

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

Παράμετροι

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

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

Επιστροφές

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

παράδειγμα διαγραφήςΟθόνη

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

getChoices μέθοδος

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

Παράμετροι

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

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

Επιστροφές

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

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

παράδειγμα getChoices

// 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');

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

παράδειγμα queryTable

// 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`);
}

Remarks

Σημείωμα

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

retrieveRow μέθοδος

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

Παράμετροι

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

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

RetrieveRowOptions

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

Επιστροφές

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

παράδειγμα retrieveRow

// 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'],
});

updateRow μέθοδος

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

Παράμετροι

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

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

Επιστροφές

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

παράδειγμα updateRow

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);
}