วิธีการเชื่อมต่อสําหรับหน้าที่สร้าง

ใช้วิธีการเชื่อมต่อของ dataApi วัตถุเพื่อทํางานกับข้อมูลที่แสดงโดยตัวเชื่อมต่อ Power Platform ที่ผูกไว้กับหน้า

queryConnectorTable วิธี

คิวรีตารางที่แสดงโดยตัวเชื่อมต่อโดยใช้ตัวเลือกที่ระบุ

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นเหล่านี้

ตัวเลือก QueryConnectorTable

การคืนสินค้า

สัญญาที่ประกอบด้วยผลลัพธ์ของการดําเนินงาน เมื่อการดําเนินการสําเร็จ สัญญาจะส่งคืนออบเจ็กต์ที่มีตารางข้อมูลพร้อมผลลัพธ์ที่มีคุณสมบัติเหล่านี้:

queryConnectorTable แสดงหนึ่งหน้าของผลลัพธ์ ซึ่งจะไม่ส่งกลับฟังก์ชันต่อเนื่อง และขณะนี้ไม่มีวิธีการใดที่ได้รับการสนับสนุนในหน้าถัดไป เมื่อ hasMoreRows เป็น trueมีการส่งกลับแถวที่ตรงกันมากกว่า จํากัดคิวรีด้วย filterหรือบอกผู้ใช้ว่าผลลัพธ์ไม่สมบูรณ์

ตัวอย่าง 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,
  }
);

ตัวอย่างต่อไปนี้จะถือว่า documentsTableName ตารางอยู่ในจาก namelistConnectorTablesดังที่แสดงด้านบน

listConnectorTables วิธี

แสดงรายการตาราง (รายการหรือเอนทิตี) ที่พร้อมใช้งานในชุดข้อมูลตัวเชื่อมต่อที่ระบุ

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นเหล่านี้

การคืนสินค้า

สัญญาที่ประกอบด้วยอาร์เรย์ของข้อมูลตาราง แต่ละรายการมีคุณสมบัติเหล่านี้:

ตัวอย่าง listConnectorTables

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

listConnectorDatasets วิธี

แสดงรายการชุดข้อมูลที่พร้อมใช้งานสําหรับตัวเชื่อมต่อ เช่น SharePoint ไซต์ที่การเชื่อมต่อสามารถเข้าถึงได้

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นนี้

การคืนสินค้า

สัญญาที่ประกอบด้วยอาร์เรย์ของข้อมูลชุดข้อมูล แต่ละรายการมีคุณสมบัติเหล่านี้:

ตัวอย่าง listConnectorDatasets

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

listConnectorOperations วิธี

แสดงรายการการดําเนินการที่กําหนดไว้ในข้อกําหนด Swagger ของตัวเชื่อมต่อ ยกเว้นการดําเนินการที่ทําเครื่องหมายภายใน โดยเรียงลําดับตามชื่อที่แสดง วิธีนี้มีประโยชน์มากที่สุดสําหรับตัวเชื่อมต่อ REST (operation-keyed) เช่น ผู้ใช้ Office 365 สําหรับตัวเชื่อมต่อแบบตาราง ให้ใช้วิธีการคิวรีและแถวแทนการดําเนินการที่แสดงรายการวิธีการนี้

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นนี้

การคืนสินค้า

สัญญาที่ประกอบด้วยอาร์เรย์ของข้อมูลการดําเนินงาน แต่ละรายการมีคุณสมบัติเหล่านี้:

ตัวอย่าง listConnectorOperations

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

getConnectorSwagger วิธี

เรียกใช้ข้อกําหนด Swagger (OpenAPI) สําหรับตัวเชื่อมต่อ ซึ่งอธิบายการดําเนินการที่จะแสดง เอกสารผลลัพธ์จะอธิบายตัวเชื่อมต่อโดยรวม ซึ่งไม่รวม Schema คอลัมน์ต่อตารางสําหรับตัวเชื่อมต่อแบบตาราง ใช้สําหรับ getConnectorTableSchema ข้อมูลนั้น

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นนี้

การคืนสินค้า

สัญญาที่มีข้อกําหนด Swagger ของตัวเชื่อมต่อเป็นวัตถุ

ตัวอย่าง 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"
);

getConnectorTableSchema วิธี

เรียกใช้ schema (ข้อกําหนดคอลัมน์) สําหรับตารางที่เปิดเผยโดยตัวเชื่อมต่อ ตัวเชื่อมต่อกําหนดสคีมาที่จะส่งกลับ และจะแตกต่างกันไปตามตัวเชื่อมต่อ อย่าถือว่าคอลัมน์ดังกล่าวรวมทุกคอลัมน์แบบไดนามิกที่ตารางอาจมีอยู่

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นเหล่านี้

การคืนสินค้า

สัญญาที่มีเค้าร่างของตารางเป็นออบเจ็กต์

ตัวอย่าง 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
);

retrieveConnectorRow วิธี

ดึงข้อมูลแถวเดียวจากตารางตัวเชื่อมต่อที่ระบุ

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นเหล่านี้

RetrieveConnectorRowOptions

การคืนสินค้า

สัญญาที่มีข้อมูลแถว

ตัวอย่าง 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"
);

createConnectorRow วิธี

สร้างแถวใหม่ในตารางตัวเชื่อมต่อที่ระบุ

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นเหล่านี้

การคืนสินค้า

สัญญาที่มีร่างกายตอบสนองกลับคืนโดยตัวเชื่อมต่อถ้ามี ขึ้นอยู่กับตัวเชื่อมต่อ ค่านี้สามารถเป็นแถวที่สร้างขึ้น แถวบางส่วน หรือไม่มีค่าก็ได้

ตัวอย่าง 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" }
);

updateConnectorRow วิธี

อัปเดตแถวที่มีอยู่ในตารางตัวเชื่อมต่อที่ระบุ

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นเหล่านี้

การคืนสินค้า

สัญญาที่มีร่างกายตอบสนองกลับคืนโดยตัวเชื่อมต่อถ้ามี ค่านี้สามารถเป็นแถวที่อัปเดต แถวบางส่วน หรือไม่มีค่า ขึ้นอยู่กับตัวเชื่อมต่อ เมื่อต้องการอ่านค่าปัจจุบันของแถว ให้เรียกใช้retrieveConnectorRow

ตัวอย่าง updateConnectorRow

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 วิธี

ลบแถวจากตารางตัวเชื่อมต่อที่ระบุ

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นเหล่านี้

การคืนสินค้า

สัญญาที่ประกอบด้วยผลลัพธ์ของการดําเนินงาน เมื่อการดําเนินการสําเร็จ จะไม่มีการคืนค่า

ตัวอย่าง 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"
);

executeConnectorOperation วิธี

เรียกใช้การดําเนินการที่มีชื่อที่แสดงโดยตัวเชื่อมต่อ REST (การดําเนินการคีย์) เช่น HTTP, Teams send-message หรือ ผู้ใช้ Office 365 ตัวเชื่อมต่อแบบตารางควรใช้วิธีคิวรีและแถว CRUD แทน

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นเหล่านี้

การคืนสินค้า

สัญญาที่มีผลการดําเนินงานกับคุณสมบัติเหล่านี้ สัญญาปฏิเสธถ้าการอ้างอิงการเชื่อมต่อไม่สามารถแก้ไขได้ ข้อกําหนด Swagger ของตัวเชื่อมต่อไม่สามารถเรียกใช้ได้ การดําเนินการไม่พบในนั้น การเรียกใช้ไม่สามารถส่งได้ หรือการเชื่อมต่อไม่ได้รับอนุญาต (HTTP 403) และผู้ใช้ไม่สามารถดําเนินการตามพร้อมท์ความยินยอมการเชื่อมต่อให้เสร็จสมบูรณ์

ตัวอย่าง executeConnectorOperation

ตัวอย่างต่อไปนี้ถือว่าการดําเนินการที่ CopyFile ชื่อว่ายอมรับ sourceUrl และ destinationUrl พารามิเตอร์ ตรวจสอบ ID การดําเนินการและพารามิเตอร์เทียบกับข้อกําหนด Swagger ของตัวเชื่อมต่อ (ตัวอย่างเช่น ด้วย listConnectorOperations หรือ getConnectorSwagger) ก่อนใช้งาน เนื่องจากการดําเนินการที่พร้อมใช้งานและพารามิเตอร์จะแตกต่างกันไปตามตัวเชื่อมต่อ

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