SharePoint.Files

วากยสัมพันธ์

SharePoint.Files(url as text, optional options as nullable record) as table

ประมาณ

แสดงตารางที่มีหนึ่งแถวสําหรับแต่ละแฟ้มที่พบในไซต์ urlSharePoint ที่ระบุ รวมถึงแฟ้มในโฟลเดอร์ย่อย ซึ่งแตกต่างจาก SharePoint.Contentsฟังก์ชันนี้ส่งกลับตารางแบบแฟล็ตและไม่รวมแถวสําหรับโฟลเดอร์ URL ของไซต์ไม่สามารถมีสตริงแบบสอบถามหรือส่วนย่อยได้ แต่ละแถวประกอบด้วยเนื้อหาไบนารีของไฟล์ในContentคอลัมน์และไฟล์เมตาดาต้าในExtensionNameDate accessedคอลัมน์ , , Date modified, Date created, Attributes, และFolder Path ค่า Folder Path เป็น URL แบบสัมบูรณ์ของโฟลเดอร์ที่มีไฟล์ อาจมีการระบุ options เพื่อควบคุมตัวเลือกต่อไปนี้:

• ApiVersion: ตัวเลข (14 หรือ 15) หรือข้อความ "อัตโนมัติ" ที่ระบุเวอร์ชัน SharePoint API ที่จะใช้สําหรับไซต์นี้ เมื่อไม่ได้ระบุ จะใช้ API เวอร์ชัน 14 เมื่อระบุ อัตโนมัติ ระบบจะค้นหาเวอร์ชันเซิร์ฟเวอร์โดยอัตโนมัติถ้าเป็นไปได้ มิฉะนั้น ค่าเริ่มต้นของเวอร์ชันจะเป็น 14 ไซต์ SharePoint ที่ไม่ใช่ภาษาอังกฤษต้องการอย่างน้อยเวอร์ชันที่ 15

ตัวอย่างที่ 1

แสดงรายชื่อ ส่วนขยายไฟล์ และ URL ของโฟลเดอร์สําหรับทุกไฟล์ในไซต์ SharePoint Contoso โดยใช้การเลือก API อัตโนมัติ

การใช้งาน

let
    Source = SharePoint.Files(
        "https://contoso.sharepoint.com/sites/Contoso",
        [ApiVersion = "Auto"]
    ),
    SelectedColumns = Table.SelectColumns(
        Source,
        {"Name", "Extension", "Folder Path"}
    )
in
    SelectedColumns

ผลลัพธ์

A table containing the name, extension, and absolute folder URL for each file in the site and its subfolders.

ตัวอย่างที่ 2

ส่งกลับทุกไฟล์ที่มี.xlsxนามสกุลจากไซต์ SharePoint Contoso ตัวอย่างนี้ใช้ API เวอร์ชัน 15 ซึ่งทํางานกับทั้งเว็บไซต์ภาษาอังกฤษและที่ไม่ใช่ภาษาอังกฤษ SharePoint การเปรียบเทียบส่วนขยายต้องตรงตามตัวพิมพ์ใหญ่-เล็ก ดังนั้นจึงจับคู่ด้วย.XLSX

การใช้งาน

let
    Source = SharePoint.Files(
        "https://contoso.sharepoint.com/sites/Contoso",
        [ApiVersion = 15]
    ),
    ExcelWorkbooks = Table.SelectRows(
      Source,
      each Comparer.OrdinalIgnoreCase([Extension], ".xlsx") = 0
    )
  in
    ExcelWorkbooks

ผลลัพธ์

A table containing every .xlsx file in the site and its subfolders.

ตัวอย่างที่ 3

ส่งกลับเฉพาะไฟล์ที่จัดเก็บไว้ในโฟลเดอร์โดยตรงShared Documents/Reports การจับคู่ตรงกันทุกประการ Folder Path ไม่รวมแฟ้มในโฟลเดอร์ย่อย

การใช้งาน

let
    Source = SharePoint.Files("https://contoso.sharepoint.com/sites/Contoso"),
    ReportsFiles = Table.SelectRows(
        Source,
        each [Folder Path] = "https://contoso.sharepoint.com/sites/Contoso/Shared Documents/Reports/"
    )
in
    ReportsFiles

ผลลัพธ์

A table containing only the files stored directly in the Reports folder.

ตัวอย่าง 4

แสดงเนื้อหาไบนารีของ Budget.xlsx จากโฟลเดอร์เอกสาร/รายงานที่ใช้ร่วมกัน

การใช้งาน

let
    Source = SharePoint.Files("https://contoso.sharepoint.com/sites/Contoso"),
    Budget = Source{
      [
        Name = "Budget.xlsx",
        #"Folder Path" = "https://contoso.sharepoint.com/sites/Contoso/Shared Documents/Reports/"
      ]
    }[Content]
  in
    Budget

ผลลัพธ์

The binary content of Budget.xlsx.