ใช้ตัวแปรสภาพแวดล้อมของแหล่งข้อมูลในแอป Canvas

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

ใช้ตัวแปรสภาพแวดล้อมของแหล่งข้อมูลที่มีอยู่ก่อน

คุณสามารถนำตัวแปรสภาพแวดล้อมมาใช้ซ้ำได้ในแอปอื่น ๆ และแม้แต่ทรัพยากรชนิดต่าง ๆ เช่น โฟลว์ระบบคลาวด์ คุณอาจต้องการสร้างสิ่งเหล่านั้นภายในโซลูชันของคุณก่อน และใช้สิ่งเหล่านั้นในภายหลังในขณะที่เขียนแอป Canvas และโฟลว์ระบบคลาวด์ ขั้นตอนต่อไปนี้ใช้ SharePoint Online เป็นตัวอย่าง

  1. ทำตามขั้นตอนเพื่อ สร้างตัวแปรสภาพแวดล้อมในโซลูชันด้วยตนเอง
  2. แก้ไขหรือสร้างแอพพลิเคชันผ้าใบจากโซลูชันของคุณ
  3. เพิ่ม สร้าง แหล่งข้อมูลสำหรับ SharePoint ออนไลน์
  4. เลือกแท็บ ขั้นสูง คุณจะเห็นรายการตัวแปรสภาพแวดล้อมที่กรองแล้วที่คุณสามารถเข้าถึง ได้ และที่ตรงกับพารามิเตอร์ที่ถูกตั้งค่า ตัวอย่างเช่น เมื่อคุณเลือกไซต์ SharePoint รายการจะมีตัวแปรสภาพแวดล้อมแหล่งข้อมูลที่มีตัวเชื่อมต่อเป็น SharePoint และชนิดพารามิเตอร์เป็นไซต์ เช่นเดียวกับเมื่อเลือกรายการ SharePoint สำหรับไซต์ที่กำหนด ถ้าตัวแปรที่มีอยู่ไม่ปรากฏขึ้น ให้ดู ข้อจํากัดและการแก้ไขปัญหา
  5. เลือกตัวแปรสภาพแวดล้อมที่ต้องการ จากนั้นเลือก เชื่อมต่อ

สำคัญ

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

สร้างตัวแปรสภาพแวดล้อมแหล่งข้อมูลโดยอัตโนมัติเมื่อเชื่อมต่อกับข้อมูล

ตัวเลือกนี้มีความเรียบง่ายและมั่นใจได้ว่าจะมีการใช้ตัวแปรสภาพแวดล้อมสําหรับแหล่งข้อมูลเช่น SharePoint Online เสมอ อย่างไรก็ตาม ลูกค้าบางรายต้องการระบุชื่อสคีมาของตนเอง ดังนั้นจึงควรสร้างจากโซลูชัน

หมายเหตุ

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

  1. แก้ไขหรือสร้างแอพพลิเคชันผ้าใบจากโซลูชันของคุณ

  2. เลือก การตั้งค่า>ทั่วไป และเปิดใช้งานการตั้งค่าเป็น สร้างตัวแปรสภาพแวดล้อมโดยอัตโนมัติเมื่อเพิ่มแหล่งข้อมูล

  3. เพิ่ม สร้าง แหล่งข้อมูลสำหรับ SharePoint ออนไลน์

  4. เลือก ไซต์ SharePoint หนึ่ง รายการ หรือมากกว่า แล้ว เชื่อมต่อ

    หมายเหตุ

    เพื่อป้องกันการสร้างตัวแปรสภาพแวดล้อมที่ซ้ํากัน คุณจะได้รับพร้อมท์ให้ใช้ตัวแปรสภาพแวดล้อมที่มีอยู่เมื่อมีการระบุรายการซ้ํา คุณสามารถล้างตัวเลือกเพื่อใช้ตัวแปรสภาพแวดล้อมที่มีอยู่หากต้องการสร้างรายการที่ซ้ำกัน

  5. เลือก บันทึก

ข้อจํากัดและการแก้ไขปัญหา

ตัวแปรสภาพแวดล้อมสามารถอยู่ในสภาพแวดล้อมของคุณโดยไม่ต้องปรากฏในตัวเลือกแหล่งข้อมูล Canvas Studio ตรวจสอบข้อจํากัดต่อไปนี้เมื่อคุณไม่พบตัวแปร

ข้อจํากัดของตัวเลือก Canvas Studio

ข้อจํากัดนี้ใช้ได้เมื่อเลือกตัวแปรสภาพแวดล้อมแหล่งข้อมูลสําหรับตัวเชื่อมต่อที่สนับสนุน รวมถึง SharePoint และ SQL Server สําหรับ SQL Server จะนําไปใช้กับชนิดการเชื่อมต่อที่สนับสนุนตัวแปรสภาพแวดล้อมของแหล่งข้อมูล เช่น การเชื่อมต่อ Microsoft Entra

ตัวเลือกแหล่งข้อมูล Canvas Studio ดึงเฉพาะหน้าแรกของข้อกําหนดและค่าตัวแปรสภาพแวดล้อมที่ตรงกับตัวเชื่อมต่อและชนิดพารามิเตอร์ที่เลือกเท่านั้น โดยไม่ได้เป็นการดึงข้อมูลหน้าต่อไป คําขอ Dataverse แต่ละรายการจะส่งกลับระเบียนที่ตรงกันสูงสุด 5,000 ระเบียน ดังนั้นตัวแปรบางตัวอาจไม่ปรากฏในแท็บ ขั้นสูง หรือผลลัพธ์การค้นหา การค้นหาตัวแปรที่หายไปไม่ได้ดึงข้อมูลมาจากหน้าต่อไป

ข้อจํากัดนี้มีไว้สําหรับตัวเลือกแบบ picker ไม่ใช่ขีดจํากัดของตัวแปรสภาพแวดล้อม 5,000 รายการใน Dataverse จำนวนที่เกี่ยวข้องคือจำนวนของคำนิยามหรือค่าที่ตรงกันสำหรับแต่ละคำขอ ไม่ใช่จำนวนรวมของตัวแปรในตัวเชื่อมต่อทั้งหมดในสภาพแวดล้อม

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

การตรวจสอบการกําหนดค่าเฉพาะ SharePoint

นอกเหนือจากข้อจํากัดการแบ่งหน้าที่ใช้ในตัวเชื่อมต่อที่รองรับแล้ว ตัวแปร SharePoint จะต้องเป็นไปตามข้อกําหนดการกําหนดค่าเหล่านี้:

  • ตัวแปรของไซต์จําเป็นต้องมีค่าปัจจุบันที่ไม่ว่างหรือค่าเริ่มต้นที่มี URL ของไซต์ SharePoint ตัวเลือกไม่ได้แสดงรายการตัวแปรของไซต์ที่มีค่าทั้งสองที่ว่างเปล่า
  • ค่าของตัวแปรรายการต้องตรงกับตัวระบุที่ไม่ซ้ำกัน (GUID) ของรายการที่ส่งกลับมาสำหรับไซต์และการเชื่อมต่อที่เลือก ไม่ใช่ชื่อที่แสดงของรายการ ตรวจสอบว่าการเชื่อมต่อมีสิทธิ์เข้าถึงรายการ และตัวแปรมีตัวระบุของรายการนั้นหรือไม่

ดูเพิ่มเติมที่

สร้างแอปพื้นที่ทำงานตั้งแต่เริ่มต้นโดยใช้ Dataverse
ใช้ตัวแปรสภาพแวดล้อมในโฟลว์ระบบคลาวด์ของโซลูชัน Power Automate
ภาพรวมตัวแปรสภาพแวดล้อม