การสร้างตัวเชื่อมต่อแรกของคุณ: สวัสดี ทุกท่าน

ตัวอย่างนี้มีส่วนขยายแหล่งข้อมูลอย่างง่ายที่สามารถเรียกใช้ใน Visual Studio Code และโหลดใน Power BI Desktop ได้

ตัวอย่างสวัสดี ทุกท่าน

ดังภาพรวม ตัวอย่างนี้แสดง:

• ฟังก์ชันการส่งออก (HelloWorld.Contents) ซึ่งใช้พารามิเตอร์ข้อความตัวเลือก
• การกําหนดชนิดแหล่งข้อมูลที่:
  • ประกาศว่าใช้การรับรองความถูกต้องแบบ Implicit (ไม่ระบุชื่อ)
  • ใช้ทรัพยากรสตริงที่อนุญาตให้มีการแปลเป็นภาษาท้องถิ่น
  • การประกาศเมตาดาต้า UI เพื่อให้ส่วนขยายสามารถแสดงในกล่องโต้ตอบรับข้อมูลของ Power BI Desktop

ทําตามคําแนะนําใน การติดตั้ง PowerQuery SDK สร้างตัวเชื่อมต่อใหม่ที่เรียกว่า "HelloWorld" คัดลอกในรหัส M ต่อไปนี้ และวางในไฟล์ HelloWorld.pq ของพื้นที่ทํางานของตัวเชื่อมต่อของคุณ จากนั้นทําตามคําแนะนําที่เหลือเพื่อให้สามารถเปิดใน Power BI ได้

ในข้อกําหนดตัวเชื่อมต่อต่อไปนี้ คุณค้นหา:

• คําสั่งsection
• ฟังก์ชันแหล่งข้อมูลที่มีเมตาดาต้าที่สร้างเป็นข้อกําหนดของแหล่งข้อมูลด้วย Kind HelloWorld และ Publish HelloWorld.Publish
• Authenticationระเบียนที่ประกาศว่าโดยนัย (ไม่ระบุชื่อ) เป็นชนิดการรับรองความถูกต้องเดียวสําหรับแหล่งข้อมูลนี้
• เรกคอร์ดที่เผยแพร่ประกาศว่าการเชื่อมต่อนี้อยู่ในรุ่นเบต้า ข้อความที่จะโหลดจากไฟล์ resx รูปภาพต้นทาง และรูปภาพชนิดแหล่งที่มา
• เรกคอร์ดที่เกี่ยวข้องกับขนาดไอคอนด้วย PNG เฉพาะในโฟลเดอร์บิลด

section HelloWorld;
 
[DataSource.Kind="HelloWorld", Publish="HelloWorld.Publish"]
shared HelloWorld.Contents = (optional message as text) =>
    let
        message = if (message <> null) then message else "Hello world"
    in
        message;
 
HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];
 
HelloWorld.Publish = [
    Beta = true,
    ButtonText = { Extension.LoadString("FormulaTitle"), Extension.LoadString("FormulaHelp") },
    SourceImage = HelloWorld.Icons,
    SourceTypeImage = HelloWorld.Icons
];
 
HelloWorld.Icons = [
    Icon16 = { Extension.Contents("HelloWorld16.png"), Extension.Contents("HelloWorld20.png"), Extension.Contents("HelloWorld24.png"), Extension.Contents("HelloWorld32.png") },
    Icon32 = { Extension.Contents("HelloWorld32.png"), Extension.Contents("HelloWorld40.png"), Extension.Contents("HelloWorld48.png"), Extension.Contents("HelloWorld64.png") }
];

เมื่อคุณได้สร้างไฟล์และคัดลอกไปยังไดเรกทอรีที่ถูกต้องแล้ว ให้ทําตามคําแนะนําใน การติดตั้งบทช่วยสอน PowerQuery SDK ให้เปิด Power BI คุณสามารถค้นหา "สวัสดี" เพื่อค้นหาตัวเชื่อมต่อ ของคุณในกล่องโต้ตอบรับข้อมูล ได้

ขั้นตอนนี้จะแสดงกล่องโต้ตอบการรับรองความถูกต้อง เนื่องจากไม่มีตัวเลือกการรับรองความถูกต้องและฟังก์ชันไม่ใช้พารามิเตอร์ จึงไม่มีขั้นตอนเพิ่มเติมในกล่องโต้ตอบเหล่านี้

กด เชื่อมต่อ และกล่องโต้ตอบจะบอกคุณว่าเป็น "ตัวเชื่อมต่อการแสดงตัวอย่าง" เนื่องจากBetaถูกตั้งค่าเป็น จริง ในคิวรี เนื่องจากไม่มีการรับรองความถูกต้อง หน้าจอการรับรองความถูกต้องจะแสดงแท็บสําหรับการรับรองความถูกต้องแบบไม่ระบุชื่อที่ไม่มีเขตข้อมูล กดเชื่อมต่ออีกครั้งเพื่อเสร็จสิ้น

สุดท้าย ตัวแก้ไขคิวรีจะปรากฏขึ้นเพื่อแสดงสิ่งที่คุณคาดหมาย — ฟังก์ชันที่ส่งกลับข้อความ "Hello world"

สําหรับตัวอย่างที่นําไปใช้อย่างสมบูรณ์ โปรดดู ตัวอย่างสวัสดี ทุกท่าน ในที่เก็บตัวอย่างของ เชื่อมต่อ ors ข้อมูล