informazioni di riferimento su dataApi per le pagine generative

Quando si genera una pagina usando il linguaggio naturale, l'intelligenza artificiale crea una pagina React in TypeScript. La pagina generata copre sia l'esperienza utente front-end selezionando i componenti corretti che determinando il layout migliore e la logica di business corrispondente.

È possibile visualizzare e modificare il codice generato per perfezionare l'output. Le operazioni sui dati usano un dataApi oggetto che espone i metodi pubblici seguenti:

Metodo createRow

Crea una nuova riga nella tabella specificata.

Parametri

Impostare i valori per questi parametri obbligatori.

Restituzioni

Promessa contenente il risultato dell'operazione. Quando l'operazione ha esito positivo, il risultato è il valore ID (GUID) della riga creata.

Example

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

Metodo updateRow

Aggiorna una riga esistente nella tabella specificata.

Parametri

Impostare i valori per questi parametri obbligatori.

Restituzioni

Promessa contenente il risultato dell'operazione. Quando l'operazione ha esito positivo, non restituisce alcun valore.

Example

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

Metodo deleteRow

Elimina una riga dalla tabella specificata.

Parametri

Impostare i valori per questi parametri obbligatori.

Restituzioni

Promessa contenente il risultato dell'operazione. Quando l'operazione ha esito positivo, non restituisce alcun valore.

Example

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

Metodo retrieveRow

Recupera una riga dalla tabella specificata utilizzando le opzioni specificate.

Parametri

Impostare i valori per questi parametri obbligatori.

RetrieveRowOptions

Restituzioni

Promessa contenente il risultato dell'operazione. Quando l'operazione ha esito positivo, viene restituito un oggetto contenente i dati del record, incluse tutte le colonne selezionate.

Example

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

Metodo queryTable

Esegue una query su una tabella usando le opzioni specificate.

Parametri

Impostare i valori per questi parametri obbligatori.

QueryTableOptions

Restituzioni

Promessa contenente il risultato dell'operazione. Quando l'operazione ha esito positivo, la promessa restituisce un oggetto contenente una tabella dati con i risultati con queste proprietà:

Example

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

Osservazioni:

Metodo getChoices

Recupera le scelte per il nome della colonna di scelta specificata.

Parametri

Questo parametro è obbligatorio.

Restituzioni

Promessa contenente il risultato dell'operazione. Quando l'operazione ha esito positivo, restituisce una matrice delle opzioni di scelta. Ogni opzione ha queste proprietà:

Example

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