Metody łącznika dla stron generowania

Użyj metod łącznika dataApi obiektu, aby pracować z danymi uwidocznianymi przez łącznik platformy Power Platform powiązany ze stroną.

Metoda queryConnectorTable

Wysyła zapytanie do tabeli uwidocznionej przez łącznik przy użyciu określonych opcji.

Parameters

Ustaw wartości dla tych wymaganych parametrów.

QueryConnectorTableOptions

Returns

Obietnica zawierająca wynik operacji. Po pomyślnym zakończeniu operacji obietnica zwraca obiekt zawierający tabelę danych z wynikami o następujących właściwościach:

queryConnectorTable Zwraca jedną stronę wyników. Nie zwraca funkcji kontynuacji i obecnie nie ma obsługiwanego sposobu pobierania następnej strony. Gdy hasMoreRows wartość to true, więcej wierszy dopasowanych niż zostały zwrócone. Zawęź zapytanie za pomocą filterpolecenia lub poinformuj użytkownika, że wyniki są niekompletne.

przykład 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,
  }
);

W poniższych przykładach przyjęto założenie, że documentsTableName tabela zawiera tabelę name z listConnectorTables, jak pokazano powyżej.

Metoda listConnectorTables

Wyświetla tabele (listy lub jednostki) dostępne w określonym zestawie danych łącznika.

Parameters

Ustaw wartości dla tych wymaganych parametrów.

Returns

Obietnica zawierająca tablicę informacji o tabeli. Każdy wpis ma następujące właściwości:

przykład listConnectorTables

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

Metoda listConnectorDatasets

Wyświetla listę zestawów danych dostępnych dla łącznika, takich jak lokacje SharePoint, do których może uzyskiwać dostęp połączenie.

Parameters

Ustaw wartość dla tego wymaganego parametru.

Returns

Obietnica zawierająca tablicę informacji o zestawie danych. Każdy wpis ma następujące właściwości:

przykład listConnectorDatasets

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

Metoda listConnectorOperations

Wyświetla listę operacji zdefiniowanych w definicji struktury Swagger łącznika, z wyłączeniem operacji oznaczonych jako wewnętrzne, posortowane według nazwy wyświetlanej. Ta metoda jest najbardziej przydatna w przypadku łączników REST (kluczem operacji), takich jak Użytkownicy usługi Office 365. W przypadku łączników tabelarycznych użyj metod zapytania i wierszy zamiast operacji, które zawiera ta metoda.

Parameters

Ustaw wartość dla tego wymaganego parametru.

Returns

Obietnica zawierająca tablicę informacji o operacjach. Każdy wpis ma następujące właściwości:

przykład listConnectorOperations

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

Metoda getConnectorSwagger

Pobiera definicję struktury Swagger (OpenAPI) dla łącznika, która opisuje ujawniane operacje. Zwrócony dokument opisuje ogólny łącznik. Nie zawiera schematów kolumn dla tabeli dla łączników tabelarycznych. Użyj getConnectorTableSchema tych informacji.

Parameters

Ustaw wartość dla tego wymaganego parametru.

Returns

Obietnica zawierająca definicję struktury Swagger łącznika jako obiekt.

przykład getConnectorSwagger

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

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

Metoda getConnectorTableSchema

Pobiera schemat (definicje kolumn) dla tabeli uwidocznionej przez łącznik. Łącznik definiuje zwracany schemat i różni się w zależności od łącznika. Nie zakładaj, że zawiera każdą kolumnę dynamiczną, która może zawierać tabelę.

Parameters

Ustaw wartości dla tych wymaganych parametrów.

Returns

Obietnica zawierająca schemat tabeli jako obiekt.

przykład getConnectorTableSchema

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

Metoda retrieveConnectorRow

Pobiera jeden wiersz z określonej tabeli łącznika.

Parameters

Ustaw wartości dla tych wymaganych parametrów.

RetrieveConnectorRowOptions

Returns

Obietnica zawierająca dane wierszy.

przykład retrieveConnectorRow

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

Metoda createConnectorRow

Tworzy nowy wiersz w określonej tabeli łącznika.

Parameters

Ustaw wartości dla tych wymaganych parametrów.

Returns

Obietnica zawierająca treść odpowiedzi zwróconą przez łącznik, jeśli istnieje. W zależności od łącznika ta wartość może być utworzonym wierszem, wierszem częściowym lub bez wartości.

przykład createConnectorRow

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

Metoda updateConnectorRow

Aktualizuje istniejący wiersz w określonej tabeli łącznika.

Parameters

Ustaw wartości dla tych wymaganych parametrów.

Returns

Obietnica zawierająca treść odpowiedzi zwróconą przez łącznik, jeśli istnieje. W zależności od łącznika ta wartość może być zaktualizowanym wierszem, wierszem częściowym lub bez wartości. Aby odczytać bieżące wartości wiersza, wywołaj metodę retrieveConnectorRow.

updateConnectorRow — przykład

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

Metoda deleteConnectorRow

Usuwa wiersz z określonej tabeli łącznika.

Parameters

Ustaw wartości dla tych wymaganych parametrów.

Returns

Obietnica zawierająca wynik operacji. Gdy operacja zakończy się pomyślnie, nie zwraca żadnej wartości.

przykład deleteConnectorRow

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

Metoda executeConnectorOperation

Wywołuje nazwaną operację uwidacznianą przez łącznik REST (klucz operacji), taki jak HTTP, Wysyłanie wiadomości w usłudze Teams lub Użytkownicy usługi Office 365. Zamiast tego łączniki tabelaryczne powinny używać metod CRUD zapytania i wiersza.

Parameters

Ustaw wartości dla tych wymaganych parametrów.

Returns

Obietnica zawierająca wynik operacji z tymi właściwościami. Obietnica odrzuca, jeśli nie można rozpoznać odwołania do połączenia, nie można pobrać definicji programu Swagger łącznika, nie można odnaleźć w niej operacji, nie można wysłać wywołania lub połączenie nie jest autoryzowane (HTTP 403), a użytkownik nie ukończy monitu o wyrażenie zgody połączenia.

przykład executeConnectorOperation

W poniższym przykładzie przyjęto założenie, że operacja o nazwie CopyFile akceptuje sourceUrl parametry i destinationUrl . Przed jego użyciem sprawdź identyfikator operacji i jego parametry względem własnej definicji programu Swagger łącznika (na przykład z listConnectorOperations lub getConnectorSwagger), ponieważ dostępne operacje i ich parametry różnią się w zależności od łącznika.

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