Koblingsmetoder for generative sider

Bruk koblingsmetodene dataApi for objektet til å arbeide med data som vises av en Power Platform-kobling som er bundet til siden.

queryConnectorTable metode

Spør en tabell som vises av koblingen ved hjelp av de angitte alternativene.

Parametre

Angi verdier for disse nødvendige parameterne.

QueryConnectorTableOptions

Returer

Et løfte som inneholder resultatet av operasjonen. Når operasjonen lykkes, returnerer løftet et objekt som inneholder en datatabell med resultatene med disse egenskapene:

queryConnectorTable returnerer én enkelt side med resultater. Den returnerer ikke en fortsettelsesfunksjon, og det finnes for øyeblikket ingen støttede måter å hente neste side på. Når hasMoreRows er truedet, samsvarer flere rader enn det som ble returnert. Begrens spørringen med filter, eller fortell brukeren at resultatene er ufullstendige.

eksempel på queryConnectorTable

if (!dataApi.listConnectorTables || !dataApi.queryConnectorTable) {
  throw new Error("Connector methods aren't available on this page.");
}

const tables = await dataApi.listConnectorTables(
  "sp_shared_sharepointonline",
  "https://contoso.sharepoint.com/sites/Marketing"
);
const documentsTable = tables.find((table) => table.displayName === "Documents");
if (!documentsTable) {
  throw new Error("The Documents table wasn't found in this dataset.");
}
const documentsTableName = documentsTable.name;

const result = await dataApi.queryConnectorTable(
  "sp_shared_sharepointonline",
  "https://contoso.sharepoint.com/sites/Marketing",
  documentsTableName,
  {
    select: ["Title", "Modified"],
    top: 50,
  }
);

Eksemplene nedenfor forutsetter at documentsTableName tabellen er name fra listConnectorTables, som vist ovenfor.

listConnectorTables metode

Viser tabellene (lister eller enheter) som er tilgjengelige i det angitte koblingsdatasettet.

Parametre

Angi verdier for disse nødvendige parameterne.

Returer

Et løfte som inneholder en matrise med tabellinformasjon. Hver oppføring har disse egenskapene:

eksempel på listConnectorTables

const tables = await dataApi.listConnectorTables?.(
  "sp_shared_sharepointonline",
  "https://contoso.sharepoint.com/sites/Marketing"
);

listConnectorDatasets metode

Viser datasettene som er tilgjengelige for koblingen, for eksempel de SharePoint områdene en tilkobling har tilgang til.

Parametre

Angi en verdi for denne nødvendige parameteren.

Returer

Et løfte som inneholder en matrise med datasettinformasjon. Hver oppføring har disse egenskapene:

eksempel på listConnectorDatasets

const datasets = await dataApi.listConnectorDatasets?.("sp_shared_sharepointonline");

listConnectorOperations metode

Viser operasjonene som er definert i koblingens Swagger-definisjon, unntatt operasjoner merket som interne, sortert etter visningsnavn. Denne metoden er mest nyttig for REST-koblinger (operasjonstaster), for eksempel Office 365-brukere. For tabellkoblinger bruker du spørrings- og radmetodene i stedet for operasjonene denne metoden viser.

Parametre

Angi en verdi for denne nødvendige parameteren.

Returer

Et løfte som inneholder en matrise med operasjonsinformasjon. Hver oppføring har disse egenskapene:

eksempel på listConnectorOperations

const operations = await dataApi.listConnectorOperations?.("sp_shared_sharepointonline");

getConnectorSwagger metode

Henter Swagger-definisjonen (OpenAPI) for koblingen, som beskriver operasjonene den viser. Det returnerte dokumentet beskriver koblingen generelt. Det inkluderer ikke kolonneskjemaer per tabell for tabellkoblinger. Bruk getConnectorTableSchema denne informasjonen.

Parametre

Angi en verdi for denne nødvendige parameteren.

Returer

Et løfte som inneholder koblingens Swagger-definisjon som et objekt.

getConnectorSwagger-eksempel

if (!dataApi.getConnectorSwagger) {
  throw new Error("getConnectorSwagger isn't available on this page.");
}

const swagger = await dataApi.getConnectorSwagger(
  "/providers/Microsoft.PowerApps/apis/shared_sharepointonline"
);

getConnectorTableSchema metode

Henter skjemaet (kolonnedefinisjonene) for en tabell som vises av koblingen. Koblingen definerer skjemaet den returnerer, og det varierer etter kobling. Ikke anta at den inneholder alle dynamiske kolonner en tabell kan inneholde.

Parametre

Angi verdier for disse nødvendige parameterne.

Returer

Et løfte som inneholder tabellens skjema som et objekt.

getConnectorTableSchema-eksempel

if (!dataApi.getConnectorTableSchema) {
  throw new Error("getConnectorTableSchema isn't available on this page.");
}

const schema = await dataApi.getConnectorTableSchema(
  "sp_shared_sharepointonline",
  "https://contoso.sharepoint.com/sites/Marketing",
  documentsTableName // from listConnectorTables
);

retrieveConnectorRow metode

Henter én rad fra den angitte koblingstabellen.

Parametre

Angi verdier for disse nødvendige parameterne.

HentConnectorRowOptions

Returer

Et løfte som inneholder raddataene.

hentConnectorRow-eksempel

if (!dataApi.retrieveConnectorRow) {
  throw new Error("retrieveConnectorRow isn't available on this page.");
}

const row = await dataApi.retrieveConnectorRow(
  "sp_shared_sharepointonline",
  "https://contoso.sharepoint.com/sites/Marketing",
  documentsTableName, // from listConnectorTables
  "1"
);

createConnectorRow metode

Oppretter en ny rad i den angitte koblingstabellen.

Parametre

Angi verdier for disse nødvendige parameterne.

Returer

Et løfte som inneholder svarteksten som returneres av koblingen, om noen. Avhengig av koblingen kan denne verdien være den opprettede raden, en delvis rad eller ingen verdi.

createConnectorRow-eksempel

if (!dataApi.createConnectorRow) {
  throw new Error("createConnectorRow isn't available on this page.");
}

const newRow = await dataApi.createConnectorRow(
  "sp_shared_sharepointonline",
  "https://contoso.sharepoint.com/sites/Marketing",
  documentsTableName, // from listConnectorTables
  { Title: "New document" }
);

updateConnectorRow metode

Oppdaterer en eksisterende rad i den angitte koblingstabellen.

Parametre

Angi verdier for disse nødvendige parameterne.

Returer

Et løfte som inneholder svarteksten som returneres av koblingen, om noen. Avhengig av koblingen kan denne verdien være den oppdaterte raden, en delvis rad eller ingen verdi. Hvis du vil lese gjeldende verdier for raden, kaller du .retrieveConnectorRow

updateConnectorRow-eksempel

if (!dataApi.updateConnectorRow) {
  throw new Error("updateConnectorRow isn't available on this page.");
}

const updatedRow = await dataApi.updateConnectorRow(
  "sp_shared_sharepointonline",
  "https://contoso.sharepoint.com/sites/Marketing",
  documentsTableName, // from listConnectorTables
  "1",
  { Title: "Updated title" }
);

deleteConnectorRow metode

Sletter en rad fra den angitte koblingstabellen.

Parametre

Angi verdier for disse nødvendige parameterne.

Returer

Et løfte som inneholder resultatet av operasjonen. Når operasjonen lykkes, returnerer den ingen verdi.

deleteConnectorRow-eksempel

if (!dataApi.deleteConnectorRow) {
  throw new Error("deleteConnectorRow isn't available on this page.");
}

await dataApi.deleteConnectorRow(
  "sp_shared_sharepointonline",
  "https://contoso.sharepoint.com/sites/Marketing",
  documentsTableName, // from listConnectorTables
  "1"
);

executeConnectorOperation metode

Aktiverer en navngitt operasjon som vises av en REST-kobling (operasjonstavet), for eksempel HTTP, Teams-sendingsmelding eller Office 365-brukere. Tabellkoblinger bør bruke spørrings- og rad-CRUD-metodene i stedet.

Parametre

Angi verdier for disse nødvendige parameterne.

Returer

Et løfte som inneholder operasjonsresultatet med disse egenskapene. Løftet avviser hvis tilkoblingsreferansen ikke kan løses, koblingens Swagger-definisjon kan ikke hentes, operasjonen finnes ikke i den, samtalen kan ikke sendes, eller tilkoblingen er ikke autorisert (HTTP 403) og brukeren fullfører ikke forespørselen om tilkoblingssamtykke.

executeConnectorOperation-eksempel

Følgende eksempel forutsetter en operasjon med navnet CopyFile godtar sourceUrl og destinationUrl parametere. Bekreft operasjons-ID-en og dens parametere mot koblingens egen Swagger-definisjon (for eksempel med listConnectorOperations eller getConnectorSwagger) før du bruker den, siden tilgjengelige operasjoner og deres parametere varierer etter kobling.

if (!dataApi.executeConnectorOperation) {
  throw new Error("executeConnectorOperation isn't available on this page.");
}

try {
  const result = await dataApi.executeConnectorOperation(
    "sp_shared_sharepointonline",
    "CopyFile",
    { sourceUrl: "/sites/Marketing/Shared Documents/file.docx", destinationUrl: "/sites/Sales/Shared Documents/file.docx" }
  );

  if (result.ok) {
    console.log(result.body);
  }
  else {
    console.log(result.status);
  }
}
catch (error) {
  console.log(error);
}