ห่วงโซ่พาร์ทเนอร์
ฟิลด์ partner_chain ใช้บันทึกความสัมพันธ์ระดับกลางในลำดับชั้นพาร์ทเนอร์หลายชั้นที่ไม่ได้ถูกแทนไว้ที่อื่นในการผสานรวมนี้ โดยมีไว้สำหรับพาร์ทเนอร์ที่มอบเอกสารรับรองผ่านความร่วมมือระหว่างหลายสถาบัน และช่วยเพิ่มความละเอียดของการวิเคราะห์ที่ SEEK Pass สามารถให้กับคุณได้
ตัวอย่างเช่น ลำดับชั้นแบบง่ายระหว่างพาร์ทเนอร์ที่เชื่อมต่อระบบและผู้ออกข้อมูลรับรอง หมายความว่าข้อมูลที่เกี่ยวข้องทั้งหมดถูกเก็บครบถ้วนโดยธรรมชาติ โดยไม่จำเป็นต้องใช้ partner_chain:
Digital Credential Co (พาร์ทเนอร์การเชื่อมต่อ) ← ข้อมูลถูกบันทึกไว้โดยอัตโนมัติในการเชื่อมต่อผ่านการอนุมัติคำขอ
University A (ผู้ออกเอกสารรับรอง) ← ข้อมูลถูกบันทึกเป็น education_provider ในฟิลด์เอกสารรับรองด้านการศึกษา
ฟิลด์ partner_chain ใช้เก็บความสัมพันธ์ของตัวกลางระหว่างพาร์ทเนอร์ที่ผสานรวมกับผู้ออกข้อมูลรับรอง
ตัวอย่างเช่น เมื่อพาร์ทเนอร์ที่เชื่อมต่อระบบดูแลหลายสถาบันหรือหลายกลุ่มสถาบัน:
Digital Credential Co (พาร์ทเนอร์การเชื่อมต่อ) ← ข้อมูลถูกบันทึกไว้โดยอัตโนมัติในการเชื่อมต่อผ่านการอนุมัติคำขอ
ABC University Network (เครือข่ายของโรงเรียน เป็นพันธมิตรของ Digital Credential Co) ← เอนทิตีนี้จะไม่แสดงใน analytics หากไม่มี partner_chain
University A (ผู้ออกเอกสารรับรอง เป็นสมาชิกของ ABC University Network) ← ข้อมูลถูกบันทึกเป็น education_provider ในฟิลด์การศึกษา
หมายเหตุ
partner_chain แสดงเป็นอาร์เรย์เพื่อให้แสดงชั้นความสัมพันธ์เพิ่มเติมได้ จัดเรียงองค์ประกอบจาก parent ไป child โดย parent คือ พาร์ทเนอร์การเชื่อมต่อ และ child คือ ผู้ออกเอกสารรับรอง
ให้ใส่เฉพาะหน่วยงานตัวกลางใน partner_chain เท่านั้น ไม่ต้องใส่พาร์ทเนอร์ที่ผสานรวม หรือผู้ออกข้อมูลรับรอง ซึ่งทั้งสองส่วนถูกเก็บไว้ที่อื่นในขั้นตอนการส่งคำขอแล้ว
แนวคิดเรื่องผู้ออกข้อมูลรับรองจะเปลี่ยนไปตามประเภทข้อมูลรับรอง สำหรับ Education คือ education_provider สำหรับ Learning and Development คือ issuer_name และสำหรับ English คือ test_provider กรุณาดูเอกสารของแต่ละประเภทข้อมูลรับรองสำหรับฟิลด์ที่จำเป็น
ตัวอย่าง
ตัวกลางรายเดียว
Digital Credential Co: พาร์ทเนอร์การเชื่อมต่อที่เรียกใช้ API AtSP
ABC University Network: เครือข่ายของโรงเรียน เป็นพันธมิตรของ Digital Credential Co
University A: ผู้ออกเอกสารรับรอง เป็นสมาชิกของ ABC University Network
สำหรับตัวอย่างนี้ partner_chain มีเพียง: [{ "name": "ABC University Network" }]
มีตัวกลางหลายราย
Digital Credential Co: พาร์ทเนอร์การเชื่อมต่อที่เรียกใช้ API AtSP
ABC University Network: เครือข่ายของโรงเรียน เป็นพันธมิตรของ Digital Credential Co
Foo University Group: กลุ่มโรงเรียนขนาดเล็กที่อยู่ภายใต้ ABC University Network
University A: ผู้ออกเอกสารรับรอง เป็นสมาชิกของ Foo University Group
สำหรับตัวอย่างนี้ partner_chain มี: [{ "name": "ABC University Network" }, { "name": "Foo University Group" }]
ไม่มีตัวกลาง
Digital Credential Co: พาร์ทเนอร์การเชื่อมต่อที่เรียกใช้ API AtSP
University A: ผู้ออกเอกสารรับรอง เป็นพันธมิตรของ Digital Credential Co
สำหรับตัวอย่างนี้ ไม่ควรส่ง partner_chain