ติดต่อบริการ API
อ้างอิง
เดือนธันวาคม 2022

API บริการติดต่อ BEMS คืออะไร

Contact Service API ช่วยให้แอป BlackBerry Dynamics ของบริษัทอื่นสามารถสอบถาม ดึงข้อมูล สร้าง และอัปเดตข้อมูลผู้ติดต่อจากโฟลเดอร์ผู้ติดต่อของผู้ใช้ รวมถึงโฟลเดอร์และโฟลเดอร์ย่อยใดๆ ที่ผู้ใช้สร้างในโฟลเดอร์ผู้ติดต่อในกล่องจดหมายของพวกเขา สำหรับเช่นampอย่างไรก็ตาม คุณสามารถใช้ API เพื่อทำสิ่งต่อไปนี้:

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

ร้องขอ สร้าง และอัปเดตรูปแบบ

คุณต้องระบุตำแหน่งข้อมูล BEMS ใน API จุดสิ้นสุดระบุตำแหน่งของที่อยู่ของวัตถุ

จุดสิ้นสุด: :8443/api/ติดต่อ
รูปแบบสำหรับคำขอ HTTP เพื่อดึงข้อมูลการติดต่อจากกล่องจดหมายใน BEMS คือ:
โพสต์ :8443/api/ติดต่อ


รูปแบบคำขอ HTTP เพื่อสร้างผู้ติดต่อในกล่องจดหมายใน BEMS คือ:
โพสต์ :8443/api/contact/create


รูปแบบสำหรับคำขอ HTTP เพื่ออัปเดตผู้ติดต่อในกล่องจดหมายใน BEMS คือ:
โพสต์ :8443/api/contact/update


รูปแบบสำหรับคำขอ HTTP เพื่อสร้างโฟลเดอร์และโฟลเดอร์ย่อยเพิ่มเติมภายใต้โฟลเดอร์ผู้ติดต่อใน
ตู้ไปรษณีย์ใน BEMS คือ:
โพสต์ :8443/api/folder/create


รูปแบบสำหรับคำขอ HTTP เพื่อรับโฟลเดอร์และโฟลเดอร์ย่อยทั้งหมดภายใต้โฟลเดอร์ผู้ติดต่อในเมลบ็อกซ์ใน BEMS คือ:
โพสต์ :8443/api/โฟลเดอร์/get


ดังต่อไปนี้เป็นดังนี้ampส่วนหัว:
ประเภทเนื้อหา: แอปพลิเคชัน/json
X-Good-GD-AuthToken:
การขอข้อมูลรายชื่อผู้ติดต่อ
แอป BlackBerry Dynamics ของบริษัทอื่นสามารถดึงข้อมูลผู้ติดต่อที่เพิ่มภายในระยะเวลาที่คุณระบุ ผู้ติดต่อที่ระบุ หรือรายชื่อผู้ติดต่อจากโฟลเดอร์ผู้ติดต่อของผู้ใช้ในกล่องจดหมายของพวกเขา
การดึงคุณสมบัติข้อมูลรายชื่อผู้ติดต่อ
ตารางต่อไปนี้อธิบายคุณสมบัติเนื้อหาคำขอที่คุณสามารถรวมไว้ในคำขอที่จัดรูปแบบ JSON เมื่อคุณดึงข้อมูลรายชื่อผู้ติดต่อจากโฟลเดอร์ของผู้ใช้ในกล่องจดหมาย

พารามิเตอร์	พิมพ์	คำอธิบาย
บัญชี	สตริง	พารามิเตอร์นี้ระบุบัญชีอีเมลของผู้ใช้ที่ใช้ในการขอข้อมูลการติดต่อ (เช่นampเล, jamie01@ex365.exampเลอ.คอม).
โดยชื่อ	สตริง	พารามิเตอร์นี้ระบุเพื่อค้นหาผู้ติดต่อในเครื่องของผู้ใช้ตามชื่อเฉพาะ ผลลัพธ์การค้นหารวมผู้ติดต่อทั้งหมดที่มีชุดอักขระที่ระบุ เช่นample, “ByName”: “Jane” จะส่งกลับผู้ใช้ทั้งหมดที่มี Jane เป็นชื่อ นามสกุล หรือส่วนหนึ่งของชื่อ เมื่อคุณใช้พารามิเตอร์นี้ คุณยังสามารถรวมคุณสมบัติ UserShape “พื้นฐาน” หรือ “รายละเอียด” เพื่อดึงข้อมูลเพิ่มเติมสำหรับผู้ติดต่อที่ส่งคืนได้ ดูพารามิเตอร์ UserShape ด้านล่างสำหรับข้อมูลเพิ่มเติม
โดยอีเมล	สตริง	พารามิเตอร์นี้ระบุเพื่อค้นหารายชื่อผู้ติดต่อในเครื่องของผู้ใช้ด้วยที่อยู่อีเมลเฉพาะ เมื่อคุณใช้พารามิเตอร์นี้ คุณยังสามารถรวมคุณสมบัติพารามิเตอร์ UserShape “พื้นฐาน” หรือ “รายละเอียด” เพื่อดึงข้อมูลเพิ่มเติมสำหรับผู้ติดต่อที่ส่งคืนได้ ดูพารามิเตอร์ UserShape ด้านล่างสำหรับข้อมูลเพิ่มเติม
รหัสโฟลเดอร์	สตริง	พารามิเตอร์นี้ดึงข้อมูลผู้ติดต่อจาก FolderId ที่ระบุ นี่เป็นทางเลือก หากไม่ได้ระบุ FolderId BEMS จะดึงข้อมูลผู้ติดต่อจากโฟลเดอร์ผู้ติดต่อของผู้ใช้
MaxNumber	จำนวนเต็ม	พารามิเตอร์นี้ระบุจำนวนผู้ติดต่อหรือออบเจ็กต์สูงสุดที่จะส่งคืนในคำค้นหา ตามค่าเริ่มต้น BEMS สามารถส่งคืนสินค้าได้สูงสุดครั้งละ 512 รายการเท่านั้น ลูกค้าจะต้องทำการเรียกหลายครั้งเพื่อดึงข้อมูลมากกว่า 512 รายการโดยการตั้งค่าพารามิเตอร์ "ออฟเซ็ต" ค่า "MoreAvailable" จะแจ้งให้ลูกค้าทราบว่ามีรายการเพิ่มเติมหรือไม่ ดูตารางตอบกลับ API ด้านล่างสำหรับข้อมูลเพิ่มเติม
ออฟเซ็ต	จำนวนเต็ม	พารามิเตอร์นี้ระบุจุดเริ่มต้นของการตอบกลับแบบแบตช์ ตามค่าเริ่มต้น ออฟเซ็ตจะเป็น 0 (ศูนย์)
ตั้งแต่Ts	จำนวนเต็ม (ยาว)	พารามิเตอร์นี้ระบุผู้ติดต่อใหม่หรือที่แก้ไขในรายชื่อผู้ติดต่อส่วนบุคคลของผู้ใช้ตั้งแต่เวลาที่กำหนด SinceTs ถูกระบุในรูปแบบเวลายุค หากคุณต้องการดึงข้อมูลผู้ติดต่อใหม่และที่แก้ไข คุณต้องระบุ SinceT เพื่อเริ่มค้นหาผู้ติดต่อ หากไม่ได้ระบุ SinceT BEMS จะดึงข้อมูลผู้ติดต่อทั้งหมดจากโฟลเดอร์ผู้ติดต่อของผู้ใช้ เมื่อคุณใช้พารามิเตอร์นี้ คุณยังสามารถรวมคุณสมบัติพารามิเตอร์ UserShape “พื้นฐาน” หรือ “รายละเอียด” เพื่อดึงข้อมูลเพิ่มเติมสำหรับผู้ติดต่อที่ส่งคืนได้ ดูพารามิเตอร์ UserShape ด้านล่างสำหรับข้อมูลเพิ่มเติม
รูปร่างผู้ใช้	อาร์เรย์สตริง	พารามิเตอร์นี้ระบุรายการแอตทริบิวต์ที่จะส่งคืนในผลการค้นหา (เช่นampไฟล์, พื้นฐาน, โทรศัพท์มือถือ, ตำแหน่งงาน, ภาพถ่าย) UserShape รองรับรายการคุณสมบัติทั่วไปที่กำหนดไว้ล่วงหน้า: พื้นฐานและรายละเอียด รายการชื่อคุณสมบัติพื้นฐานและรายละเอียดสามารถกำหนดค่าได้ใน BEMS • พื้นฐาน: ตามค่าเริ่มต้น คุณสมบัตินี้จะส่งคืนรายการคุณสมบัติต่อไปนี้: นามสกุล, ชื่อที่แสดง, ที่อยู่อีเมล และ หมายเลขโทรศัพท์ • รายละเอียด: ตามค่าเริ่มต้น คุณสมบัตินี้จะส่งคืนรายการคุณสมบัติต่อไปนี้ นอกเหนือจากคุณสมบัติพื้นฐาน: PhyicalAddresses, CompanyName, JobTitle, Department และ Photo สำหรับคำแนะนำเกี่ยวกับวิธีการที่ผู้ดูแลระบบสามารถทำได้ view หรือกำหนดค่าคุณสมบัติ UserShape ดูภาคผนวก: กำหนดค่าคุณสมบัติ UserShape

การตอบสนอง API
ตารางต่อไปนี้อธิบายคุณสมบัติการตอบสนองที่อาจปรากฏในการตอบสนอง API ที่จัดรูปแบบ JSON เมื่อคุณดึงข้อมูลผู้ติดต่อจากรายชื่อผู้ติดต่อในเครื่องของผู้ใช้

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

ขอข้อมูลติดต่อ

คุณสามารถดึงข้อมูลผู้ติดต่อจากโฟลเดอร์ผู้ติดต่อหลักของผู้ใช้และจากโฟลเดอร์ย่อยที่ผู้ใช้สร้างขึ้น
ผู้ติดต่อที่ถูกลบจะไม่ส่งคืน หากไคลเอ็นต์ไม่ได้ระบุ FolderId ในคำขอ ผู้ติดต่อจะถูกดึงข้อมูลจากโฟลเดอร์หลัก
ในส.ต่อไปนี้ampเนื่องจาก BEMS จะดึงข้อมูลผู้ติดต่อทั้งหมดสำหรับผู้ใช้ Jamie01 ยกเว้นผู้ติดต่อที่ถูกลบ จากโฟลเดอร์ย่อยเฉพาะ การตอบกลับครั้งแรกจาก BEMS มีผู้ติดต่อสูงสุด 100 ราย ตามที่ระบุโดย MaxNumber ผู้ติดต่อแต่ละรายการที่ถูกดึงข้อมูลจะมีคุณสมบัติพื้นฐานเริ่มต้นที่ระบุไว้ใน BEMS
หากมีผู้ติดต่อมากกว่า 100 ราย (เช่นampเนื่องจากกล่องจดหมายนี้มี TotalCount ของผู้ติดต่อ 150 ราย) การตอบสนองรวม MoreAvailable เป็นจริง ดังนั้นแอปพลิเคชันไคลเอ็นต์จึงส่งคำขอเพิ่มเติมโดยใช้ค่า NextOffset เพื่อดึงข้อมูลผู้ติดต่อเป็นชุดจนกว่า MoreAvailable จะเป็นเท็จ ในตัวอย่างนี้ampเลอ คุณสมบัติพื้นฐานส่งคืนข้อมูลต่อไปนี้สำหรับผู้ติดต่อ:

• แสดงชื่อ
• ที่อยู่อีเมล์
• ชื่อที่ตั้ง
• นามสกุล

ในกรณีต่อไปนี้ampไคลเอนต์จัดเตรียม FolderId และ BEMS จะดึงข้อมูลผู้ติดต่อจากโฟลเดอร์เฉพาะหากคำขอสำเร็จ BEMS จะส่งคืนผู้ติดต่อ 100 แรกที่ตรงตามเกณฑ์การสืบค้น BEMS ยังส่งคืน TotalCount ของผู้ติดต่อและ NextPageOffset เพื่อดึงข้อมูลผู้ติดต่อชุดถัดไปไคลเอนต์ตั้งค่าออฟเซ็ตเป็น NextPageOffset จากแบบสอบถามก่อนหน้าเพื่อรับชุดถัดไป
BEMS ส่งคืนผู้ติดต่อ 50 รายถัดไป รวมทั้งหมด 150 ราย ไม่มีที่อยู่ติดต่อเพิ่มเติมขอผู้ติดต่อโดยใช้ที่อยู่อีเมลและคุณสมบัติที่กำหนดไว้ล่วงหน้า
คุณสามารถดึงข้อมูลผู้ติดต่อจากโฟลเดอร์ผู้ติดต่อของผู้ใช้ หรือโฟลเดอร์และโฟลเดอร์ย่อยที่ผู้ใช้สร้างในกล่องจดหมายโดยใช้คุณสมบัติหลายรายการ (เช่นampเรียกข้อมูลผู้ใช้ตามที่อยู่อีเมลและรวมคุณสมบัติรายละเอียดที่กำหนดไว้ล่วงหน้าสำหรับผู้ติดต่อ) ในตัวอย่างนี้ample การตอบกลับมีผู้ติดต่อหนึ่งรายและ MoreAvailable เป็นเท็จ หากมีการระบุผู้ติดต่อมากกว่า 512 ราย การตอบสนองจะระบุว่า MoreAvailable เป็นจริง และไคลเอนต์ส่งคำขอเพิ่มเติมเพื่อดึงข้อมูลผู้ติดต่อเป็นชุดจนกว่า MoreAvailable จะเป็นเท็จ หากไคลเอ็นต์ระบุ FolderId แล้ว BEMS จะดึงข้อมูลผู้ติดต่อจากโฟลเดอร์ที่ระบุหากคำขอสำเร็จ BEMS จะส่งคืนการตอบกลับต่อไปนี้ และแอป BlackBerry Dynamics ของบริษัทอื่นจะแสดงข้อมูลต่อไปนี้สำหรับผู้ติดต่อด้วยที่อยู่อีเมล jane_doe@exampเลอ.คอม หากไม่มีคุณสมบัติ BEMS จะส่งกลับค่า Null และข้อมูลจะไม่รวมอยู่ในการตอบกลับ ในตัวอย่างนี้ampอย่างไรก็ตาม ข้อมูลต่อไปนี้จะแสดงสำหรับ Jane Doe:

• ชื่อที่แสดง
• ระบุชื่อ
• นามสกุล
• ชื่อเต็ม
• ที่อยู่อีเมล

ขอข้อมูลรายชื่อผู้ติดต่อโดยใช้คุณสมบัติเฉพาะ
คุณสามารถขอข้อมูลการติดต่อของผู้ใช้สำหรับผู้ติดต่อที่ส่งคืนคุณสมบัติเฉพาะ (เช่นample เฉพาะชื่อของผู้ติดต่อเท่านั้น) ในส.ต่อไปนี้ampรหัส BEMS จะขอชื่อของผู้ติดต่อทั้งหมดในโฟลเดอร์ผู้ติดต่อของผู้ใช้ การตอบกลับมีผู้ติดต่อสูงสุด 50 ราย หากไคลเอนต์ระบุ FolderId BEMS จะร้องขอผู้ติดต่อจากโฟลเดอร์เฉพาะหากคำขอสำเร็จ BEMS จะส่งคืนการตอบกลับต่อไปนี้ และแอป BlackBerry Dynamics ของบริษัทอื่นจะแสดงชื่อของผู้ติดต่อ

การสร้างและการร้องขอข้อมูลโฟลเดอร์และโฟลเดอร์ย่อย

แอป BlackBerry Dynamics ของบริษัทอื่นสามารถดึงข้อมูลโฟลเดอร์และโฟลเดอร์ย่อยที่ผู้ใช้สร้างในโฟลเดอร์ผู้ติดต่อของตนได้ โฟลเดอร์ย่อยสามารถสร้างขึ้นในโฟลเดอร์เฉพาะได้
การสร้างและอัพเดตพารามิเตอร์โฟลเดอร์
ตารางต่อไปนี้อธิบายคุณสมบัติเนื้อหาคำขอที่คุณสามารถรวมไว้ในคำขอที่จัดรูปแบบ JSON เมื่อคุณสร้างโฟลเดอร์หรือโฟลเดอร์ย่อยในโฟลเดอร์ผู้ติดต่อของกล่องจดหมายของผู้ใช้

พารามิเตอร์	พิมพ์	คำอธิบาย
ชื่อโฟลเดอร์	สตริง	พารามิเตอร์นี้ระบุชื่อของโฟลเดอร์หรือโฟลเดอร์ย่อยที่ผู้ใช้สร้างขึ้น
ParentFolderID	สตริง	พารามิเตอร์นี้สร้างผู้ติดต่อใน ParentFolderId ที่ระบุ นี่เป็นทางเลือก หากไม่ได้ระบุ ParentFolderId BEMS จะสร้างผู้ติดต่อในโฟลเดอร์ผู้ติดต่อของผู้ใช้

สร้างโฟลเดอร์หรือโฟลเดอร์ย่อย
คุณสามารถสร้างโฟลเดอร์และโฟลเดอร์ย่อยในโฟลเดอร์ผู้ติดต่อของผู้ใช้ได้ ParentFolderId เป็นทางเลือก เมื่อไม่ได้ระบุและสร้างโฟลเดอร์ โฟลเดอร์จะปรากฏในโฟลเดอร์ผู้ติดต่อของผู้ใช้ ในส.ต่อไปนี้ample code โฟลเดอร์ชื่อ “โฟลเดอร์ Support” จะถูกสร้างขึ้นเป็นโฟลเดอร์ย่อยใน ParentFolderId ที่ระบุ หากคำขอสำเร็จ BEMS จะส่งคืนรหัสตอบกลับ HTTP 201 ที่สร้างโฟลเดอร์ผู้ติดต่อสำเร็จ
หากมีโฟลเดอร์ที่มีชื่อเดียวกันอยู่ในโฟลเดอร์หลัก BEMS จะส่งคืนรหัสตอบกลับ HTTP 200 และโฟลเดอร์จะไม่ถูกบันทึกร้องขอโฟลเดอร์และโฟลเดอร์ย่อยทั้งหมดภายใต้โฟลเดอร์ผู้ติดต่อ
คุณสามารถดึงข้อมูลโฟลเดอร์และโฟลเดอร์ย่อยทั้งหมดที่ผู้ใช้สร้างขึ้นในโฟลเดอร์ที่ติดต่อของผู้ใช้ได้ ในส.ต่อไปนี้ampรหัส BEMS จะดึงข้อมูลโฟลเดอร์ทั้งหมดที่ผู้ใช้สร้างขึ้นหากคำขอสำเร็จ BEMS จะส่งคืนการตอบสนองต่อไปนี้ และแอป BlackBerry Dynamics ของบริษัทอื่นจะแสดงโฟลเดอร์ที่ดึงข้อมูล

การเพิ่มข้อมูลการติดต่อ

แอป BlackBerry Dynamics ของบริษัทอื่นสามารถสร้างและอัปเดตข้อมูลผู้ติดต่อในโฟลเดอร์ผู้ติดต่อของผู้ใช้ หรือโฟลเดอร์และโฟลเดอร์ย่อยที่ผู้ใช้สร้างในกล่องจดหมายของตน
คุณสมบัติที่ใช้เมื่อสร้างผู้ติดต่อ
รายการต่อไปนี้แสดงคุณสมบัติเนื้อหาที่ได้รับการสนับสนุนที่คุณสามารถรวมไว้ในคำขอที่จัดรูปแบบ JSON เมื่อคุณสร้างผู้ติดต่อในโฟลเดอร์ของผู้ใช้ในกล่องจดหมาย ค่าใดๆ ที่เป็นโมฆะหรือว่างเปล่าในเนื้อหาคำขอจะไม่ถูกบันทึกไว้ในผู้ติดต่อ
หากผู้ใช้อัปเดตผู้ติดต่อที่มีอยู่ ค่าทั้งหมดสำหรับคำขอจะถูกส่งไปยัง BEMS ไม่ว่าจะมีการเปลี่ยนแปลงหรือไม่ก็ตาม สามารถระบุค่าต่อไปนี้ได้เมื่อสร้างผู้ติดต่อ:

• ติดต่อ
  • ชื่อจริง
  • ชื่อกลาง
  • นามสกุล
  • โทรศัพท์มือถือ
  • โทรศัพท์บ้าน
  • โทรศัพท์บ้าน2
  • แฟกซ์ที่บ้าน
  • โทรสารอื่นๆ
  • ที่อยู่อีเมล1
  • ที่อยู่อีเมล2
  • ที่อยู่อีเมล3
  • เบอร์โทรสำหรับติดต่อเรื่องธุรกิจ
  • โทรศัพท์ธุรกิจ2
  • โทรศัพท์ติดรถยนต์
  • บริษัทโทรศัพท์หลัก
  • ไอเอสดีเอ็น
  • โทรกลับ
  • วิทยุโทรศัพท์
  • โทรศัพท์หลัก
  • โทรศัพท์ผู้ช่วย
  • เทเล็กซ์
  • TtyTddPhone
• ที่อยู่บ้าน
  • ถนน
  • เมือง
  • สถานะ
  •ประเทศ
  • รหัสไปรษณีย์
• งาน
  • บริษัท
  • ตำแหน่งงาน
  • แผนก
  • สำนักงาน
  • ผู้จัดการ
  • ผู้ช่วย
• ที่อยู่ธุรกิจ
  • ถนน
  • เมือง
  • สถานะ
  •ประเทศ
  • รหัสไปรษณีย์

สร้างผู้ติดต่อโดยใช้คุณสมบัติเฉพาะ
คุณสามารถสร้างผู้ติดต่อโดยใช้คุณสมบัติเฉพาะได้ ในส.ต่อไปนี้ampรหัส BEMS จะสร้างผู้ติดต่อในโฟลเดอร์ผู้ติดต่อของผู้ใช้ หากมี ParentFolderId รวมอยู่ด้วย ผู้ติดต่อจะถูกสร้างขึ้นในโฟลเดอร์ที่ระบุ
ในอดีตที่ผ่านมาampเนื่องจากผู้ใช้สร้างผู้ติดต่อโดยใช้ข้อมูลต่อไปนี้สำหรับผู้ติดต่อ:

• ชื่อจริง
• นามสกุล
• ชื่อกลาง
• โทรศัพท์มือถือ
• โทรศัพท์บ้าน
• โทรศัพท์ติดต่อธุรกิจ
• ที่อยู่อีเมล์
• ชื่อบริษัท

หากสร้างผู้ติดต่อสำเร็จ BEMS จะส่งคืนรหัสเฉพาะและแอป BlackBerry Dynamics ของบริษัทอื่นจะแสดงข้อมูลผู้ติดต่อที่ให้ไว้ หากไม่ได้ระบุคุณสมบัติ BEMS จะส่งกลับค่า Null และข้อมูลจะไม่ถูกบันทึกในผู้ติดต่อ

อัพเดตข้อมูลรายชื่อผู้ติดต่อ

คุณสามารถอัปเดตข้อมูลสำหรับผู้ติดต่อโดยใช้คุณสมบัติเฉพาะได้ ในส.ต่อไปนี้ample code, BEMS จะอัพเดตข้อมูลผู้ติดต่อสำหรับ NewContact Last ในโฟลเดอร์ผู้ติดต่อของผู้ใช้ ลูกค้าส่ง UniqueID เพื่อให้ผู้ติดต่ออัปเดต เมื่อมีการอัพเดตผู้ติดต่อ ไคลเอนต์จะส่งค่าทั้งหมดสำหรับผู้ติดต่อไปยัง BEMS ไม่ว่าค่าจะถูกแก้ไขหรือไม่ก็ตาม หากไคลเอ็นต์ระบุ ParentFolderID แล้ว BEMS จะอัปเดตผู้ติดต่อในโฟลเดอร์ที่ระบุ
ในอดีตที่ผ่านมาample ผู้ติดต่อจะได้รับการอัปเดตด้วยข้อมูลการทำงานของพวกเขา ข้อมูลใหม่และที่มีอยู่จะถูกส่งไปยัง BEMS เพื่อทำการอัปเดต

• ตำแหน่งงาน
• แผนก
• ชื่อกลาง
• โทรศัพท์มือถือ
• โทรศัพท์บ้าน
• โทรศัพท์ติดต่อธุรกิจ
• ที่อยู่อีเมล์
• ชื่อบริษัท

หากคำขอสำเร็จ BEMS จะส่งคืนรหัสตอบกลับ HTTP 200 รหัสที่อัปเดตผู้ติดต่อสำเร็จ

ภาคผนวก: กำหนดค่าคุณสมบัติ UserShape

คำเตือน: อย่าแก้ไขคุณสมบัติ UserShape เว้นแต่จะต้องมีการเปลี่ยนแปลง การตั้งค่าที่แก้ไขจะไม่คงอยู่เมื่อคุณอัพเกรดซอฟต์แวร์ BEMS
สามารถระบุค่าต่อไปนี้สำหรับคุณสมบัติ UserShape ค่าอื่นๆ จะถูกละเว้น

• นามแฝง	• ใบรับรองผู้ใช้
• ที่อยู่อีเมล	• ใบรับรอง Usersmime
• ชื่อที่แสดง	• ใบรับรอง PrUserx509
• กิฟเวนเนม	• โทรศัพท์บ้าน
• ชื่อจริง	• โฮมโฟน2
• นามสกุล	• โทรศัพท์มือถือ
• นามสกุล	• เพจเจอร์
• ชื่อที่สมบูรณ์	• เบอร์โทรสำหรับติดต่อเรื่องธุรกิจ
• ชื่อ บริษัท	• แฟกซ์ธุรกิจ
• บริษัท	• โทรศัพท์อื่นๆ
• แผนก	• หมายเลขโทรศัพท์
• ตำแหน่งงาน	• ที่อยู่ทางกายภาพ
• ชื่อเรื่อง	• ผู้จัดการ
• รูปถ่าย	• รายงานโดยตรง

1. เปิดเบราว์เซอร์แล้วไปที่ Apache Karaf Web การกำหนดค่าคอนโซล webเว็บไซต์ตั้งอยู่ที่ https:// :8443/system/console/configMgr และเข้าสู่ระบบในฐานะผู้ดูแลระบบด้วยข้อมูลรับรอง Microsoft Active Directory ที่เหมาะสม
2. บนเมนู คลิก OSGi > การกำหนดค่า
3. ค้นหา and click Directory Lookup Common Configuration.
4. ในฟิลด์ basicPropertyNames ค่าคุณสมบัติพื้นฐานจะแสดงรายการ
   คลิกปุ่ม + และชื่อคุณสมบัติเพื่อเพิ่มคุณสมบัติทั่วไปลงในรายการ หรือคลิกปุ่ม – เพื่อลบคุณสมบัติทั่วไปออกจากรายการ
5. ในฟิลด์ detailPropertyNames ชื่อค่าคุณสมบัติโดยละเอียดของชื่อคุณสมบัติทั่วไปจะถูกแสดงรายการ
   คลิกปุ่ม + และคุณสมบัติเพื่อเพิ่มคุณสมบัติทั่วไปลงในรายการ หรือคลิกปุ่ม – เพื่อลบคุณสมบัติทั่วไปออกจากรายการ
6. คลิกบันทึก

ประกาศทางกฎหมาย
©2023 BlackBerry Limited เครื่องหมายการค้ารวมถึงแต่ไม่จำกัดเพียง BLACKBERRY, BBM, BES, EMBLEM Design, ATHOC, CYLANCE และ SECUSMART เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ BlackBerry Limited บริษัทในเครือและ/หรือบริษัทในเครือ ซึ่งใช้ภายใต้ใบอนุญาต และสงวนลิขสิทธิ์เฉพาะสำหรับเครื่องหมายการค้าดังกล่าวไว้โดยชัดแจ้ง เครื่องหมายการค้าอื่นๆ ทั้งหมดเป็นทรัพย์สินของเจ้าของที่เกี่ยวข้อง
สิทธิบัตร ตามความเหมาะสม ระบุไว้ที่: www.blackberry.com/patents.
เอกสารนี้รวมถึงเอกสารทั้งหมดที่อ้างอิงในที่นี้ เช่น เอกสารที่จัดทำหรือมีให้ใช้งานบน BlackBerry webไซต์ที่จัดหาหรือทำให้สามารถเข้าถึงได้ “ตามที่เป็น” และ “ตามที่มี” และไม่มีเงื่อนไข การรับรอง การรับประกัน การเป็นตัวแทน หรือการรับประกันใดๆ โดย BlackBerry Limited และบริษัทในเครือ (“BlackBerry”) และ BlackBerry จะไม่รับผิดชอบต่อการพิมพ์ใดๆ ทางเทคนิคหรือความไม่ถูกต้อง ข้อผิดพลาด หรือการละเว้นอื่นๆ ในเอกสารนี้ เพื่อปกป้องข้อมูลที่เป็นกรรมสิทธิ์และเป็นความลับของ BlackBerry และ/หรือความลับทางการค้า เอกสารนี้อาจอธิบายลักษณะบางประการของเทคโนโลยี BlackBerry ในคำทั่วไป BlackBerry ขอสงวนสิทธิ์ในการเปลี่ยนแปลงข้อมูลที่อยู่ในเอกสารนี้เป็นระยะๆ อย่างไรก็ตาม BlackBerry ไม่มีข้อผูกมัดที่จะให้การเปลี่ยนแปลง การอัปเดต การปรับปรุง หรือส่วนเพิ่มเติมใดๆ ในเอกสารนี้แก่คุณอย่างทันท่วงทีหรือทั้งหมด เอกสารนี้อาจมีการอ้างอิงถึงแหล่งข้อมูลบุคคลที่สาม ฮาร์ดแวร์หรือซอฟต์แวร์ ผลิตภัณฑ์หรือบริการ รวมถึงส่วนประกอบและเนื้อหา เช่น เนื้อหาที่ได้รับการคุ้มครองโดยลิขสิทธิ์และ/หรือบุคคลที่สาม webไซต์ (เรียกรวมกันว่า “ผลิตภัณฑ์และบริการของบริษัทอื่น”) BlackBerry ไม่ได้ควบคุมและไม่รับผิดชอบต่อผลิตภัณฑ์และบริการของบริษัทอื่นใด รวมถึงแต่ไม่จำกัดเพียงเนื้อหา ความแม่นยำ การปฏิบัติตามลิขสิทธิ์ ความเข้ากันได้ ประสิทธิภาพ ความน่าเชื่อถือ ความถูกต้องตามกฎหมาย ความเหมาะสม ลิงก์ หรือด้านอื่นใดของผลิตภัณฑ์และบริการของบริษัทอื่น การรวมการอ้างอิงถึงผลิตภัณฑ์และบริการของบริษัทอื่นในเอกสารนี้ไม่ได้หมายความถึงการรับรองโดย BlackBerry ต่อผลิตภัณฑ์และบริการของบริษัทอื่นหรือบริษัทอื่นในทางใดทางหนึ่ง
ยกเว้นในขอบเขตที่ห้ามโดยเฉพาะตามกฎหมายที่ใช้บังคับในเขตอำนาจศาลของคุณ เงื่อนไข การรับรอง การรับประกัน การแสดง หรือการรับประกันใดๆ ทั้งสิ้น ไม่ว่าจะโดยชัดแจ้งหรือโดยนัย รวมถึงแต่ไม่จำกัดเพียง เงื่อนไข การรับรอง การรับประกัน การแสดง หรือการรับประกันใดๆ เกี่ยวกับความคงทน ความเหมาะสมสำหรับวัตถุประสงค์หรือการใช้งานเฉพาะ ความสามารถในการขาย คุณภาพในการขาย ไม่ละเมิด คุณภาพที่น่าพอใจ หรือกรรมสิทธิ์ หรือที่เกิดจากกฎหมายหรือประเพณี หรือแนวทางการจัดการหรือการใช้ทางการค้า หรือที่เกี่ยวข้องกับเอกสารหรือการใช้งาน หรือประสิทธิภาพการทำงานหรือการไม่ทำงานของซอฟต์แวร์ ฮาร์ดแวร์ บริการ หรือผลิตภัณฑ์และบริการของบุคคลที่สามใดๆ ที่อ้างถึงในที่นี้ จะถูกยกเว้น คุณอาจมีสิทธิอื่นๆ ที่แตกต่างกันไปในแต่ละรัฐหรือจังหวัด เขตอำนาจศาลบางแห่งอาจไม่อนุญาตให้ยกเว้นหรือจำกัดการรับประกันโดยนัยและเงื่อนไข ในขอบเขตที่กฎหมายอนุญาต การรับประกันโดยนัยหรือเงื่อนไขใด ๆ ที่เกี่ยวข้องกับเอกสาร ในขอบเขตที่ไม่สามารถยกเว้นได้ตามที่กำหนดไว้ข้างต้น แต่สามารถจำกัดได้ จะถูกจำกัดไว้ที่เก้าสิบ (90) วันนับจากวันที่คุณได้รับเอกสารหรือรายการที่เป็นประเด็นของการเรียกร้องเป็นครั้งแรก
ในขอบเขตสูงสุดที่อนุญาตโดยกฎหมายที่บังคับใช้ในเขตอำนาจศาลของคุณ ไม่ว่าในกรณีใด BLACKBERRY จะไม่รับผิดต่อความเสียหายประเภทใด ๆ ที่เกี่ยวข้องกับเอกสารนี้หรือการใช้งาน หรือประสิทธิภาพหรือการไม่ปฏิบัติงานของซอฟต์แวร์ ฮาร์ดแวร์ บริการ หรือบุคคลที่สามใด ๆ สินค้าและบริการที่อ้างอิงถึงในที่นี้ รวมถึงแต่ไม่จำกัดเพียงความเสียหายใด ๆ ดังต่อไปนี้: ความเสียหายโดยตรง, ที่เป็นผลสืบเนื่อง, ที่เป็นแบบอย่าง, โดยบังเอิญ, โดยอ้อม, พิเศษ, เป็นการลงโทษหรือรุนแรงขึ้น, ความเสียหายจากการสูญเสียผลกำไรหรือรายได้, ความล้มเหลวในการตระหนักถึงการออม, ธุรกิจที่คาดหวังใด ๆ การหยุดชะงัก การสูญเสียข้อมูลทางธุรกิจ การสูญเสียโอกาสทางธุรกิจ หรือการทุจริตหรือการสูญเสียข้อมูล ความล้มเหลวในการส่งหรือรับข้อมูลใด ๆ ปัญหาที่เกี่ยวข้องกับแอปพลิเคชันใด ๆ ที่ใช้ร่วมกับผลิตภัณฑ์หรือบริการของ BLACKBERRY ต้นทุนการหยุดทำงาน การสูญเสียการใช้ผลิตภัณฑ์ BLACKBERRY หรือ บริการหรือส่วนหนึ่งส่วนใดของบริการหรือบริการเวลาออกอากาศ ต้นทุนของสินค้าทดแทน ต้นทุนของความคุ้มครอง สิ่งอำนวยความสะดวกหรือบริการ ต้นทุนของทุน หรือการสูญเสียทางการเงินที่คล้ายคลึงกันอื่น ๆ ไม่ว่าความเสียหายดังกล่าวจะเกิดขึ้นหรือไม่คาดฝันก็ตาม และแม้ว่า BLACKBERRY จะได้รับ ได้รับคำแนะนำถึงความเป็นไปได้ของ
ความเสียหายดังกล่าว
ในขอบเขตสูงสุดตามที่กฎหมายที่ใช้บังคับในเขตอำนาจศาลของคุณอนุญาต BLACKBERRY จะไม่มีภาระผูกพัน หน้าที่ หรือความรับผิดอื่นใดทั้งสิ้นในสัญญา การละเมิด หรืออื่นใดต่อคุณ รวมถึงความรับผิดใดๆ สำหรับความประมาทเลินเล่อหรือความรับผิดที่ร้ายแรง
ไทย ข้อจำกัด ข้อยกเว้น และการปฏิเสธความรับผิดในที่นี้จะมีผลใช้บังคับ: (A) โดยไม่คำนึงถึงลักษณะของสาเหตุของการดำเนินการ ความต้องการ หรือการดำเนินการของคุณ รวมถึงแต่ไม่จำกัดเพียงการละเมิดสัญญา ความประมาทเลินเล่อ การละเมิด ความรับผิดที่ร้ายแรง หรือทฤษฎีทางกฎหมายอื่นใด และจะยังคงมีผลบังคับแม้เกิดการละเมิดพื้นฐานหลายครั้งหรือความล้มเหลวในวัตถุประสงค์ที่สำคัญของข้อตกลงนี้หรือการเยียวยาใดๆ ที่ระบุไว้ในที่นี้ และ (B) ให้แก่ BLACKBERRY และบริษัทในเครือ ผู้สืบทอด ผู้รับมอบหมาย ตัวแทน ซัพพลายเออร์ (รวมถึงผู้ให้บริการเวลาออกอากาศ) ผู้จัดจำหน่าย BLACKBERRY ที่ได้รับอนุญาต (รวมถึงผู้ให้บริการเวลาออกอากาศ) และกรรมการ พนักงาน และผู้รับเหมาอิสระของแต่ละบริษัท
นอกเหนือจากข้อจำกัดและข้อยกเว้นที่กำหนดไว้ข้างต้น ไม่ว่าในกรณีใดๆ กรรมการ พนักงาน ตัวแทน ผู้จัดจำหน่าย ซัพพลายเออร์ ผู้รับจ้างอิสระของ BLACKBERRY หรือบริษัทในเครือใดๆ ของ BLACKBERRY จะไม่มีความรับผิดใดๆ ที่เกิดขึ้นจากหรือเกี่ยวข้องกับเอกสารนี้ ก่อนที่จะสมัคร ติดตั้ง หรือใช้ผลิตภัณฑ์และบริการของบุคคลที่สาม เป็นความรับผิดชอบของคุณที่จะต้องตรวจสอบให้แน่ใจว่าผู้ให้บริการเวลาออกอากาศของคุณตกลงที่จะสนับสนุนคุณสมบัติทั้งหมดของพวกเขา ผู้ให้บริการเวลาออกอากาศบางรายอาจไม่เสนอฟังก์ชันการเรียกดูอินเทอร์เน็ตโดยสมัครสมาชิก BlackBerry Internet Service
ตรวจสอบกับผู้ให้บริการของคุณเกี่ยวกับความพร้อมใช้งาน การจัดเตรียมการโรมมิ่ง แผนบริการ และคุณสมบัติต่างๆ การติดตั้งหรือการใช้ผลิตภัณฑ์และบริการของบุคคลที่สามกับผลิตภัณฑ์และบริการของ BlackBerry อาจต้องมีสิทธิบัตร เครื่องหมายการค้า ลิขสิทธิ์ หรือใบอนุญาตอื่น ๆ ตั้งแต่หนึ่งรายการขึ้นไป เพื่อหลีกเลี่ยงการละเมิดหรือละเมิดสิทธิ์ของบุคคลที่สาม คุณมีหน้าที่รับผิดชอบแต่เพียงผู้เดียวในการพิจารณาว่าจะใช้ผลิตภัณฑ์และบริการของบุคคลที่สามหรือไม่ และจำเป็นต้องมีใบอนุญาตของบุคคลที่สามในการทำเช่นนั้นหรือไม่ หากจำเป็น คุณจะต้องรับผิดชอบในการรับสิ่งเหล่านั้น คุณไม่ควรติดตั้งหรือใช้ผลิตภัณฑ์และบริการของบุคคลที่สามจนกว่าจะได้รับใบอนุญาตที่จำเป็นทั้งหมด ผลิตภัณฑ์และบริการของบุคคลที่สามใดๆ ที่มาพร้อมกับผลิตภัณฑ์และบริการของ BlackBerry ได้รับการจัดเตรียมไว้เพื่ออำนวยความสะดวกให้กับคุณ และจัดให้มี "ตามที่เป็น" โดยไม่มีเงื่อนไข การรับรอง การรับรอง การรับรอง หรือการรับประกันใดๆ โดยชัดแจ้งหรือโดยนัยโดย BlackBerry และ BlackBerry ถือว่าไม่มีความรับผิดใด ๆ ที่เกี่ยวข้องกับการดังกล่าว การใช้ผลิตภัณฑ์และบริการของบุคคลที่สามของคุณจะอยู่ภายใต้และอยู่ภายใต้การที่คุณยอมรับข้อกำหนดของใบอนุญาตแยกต่างหากและข้อตกลงอื่นๆ ที่บังคับใช้กับบุคคลที่สาม ยกเว้นในขอบเขตที่ครอบคลุมโดยชัดแจ้งโดยใบอนุญาตหรือข้อตกลงอื่นกับ BlackBerry
ข้อกำหนดการใช้งานผลิตภัณฑ์หรือบริการของ BlackBerry ใดๆ ก็ตามจะระบุไว้ในใบอนุญาตแยกต่างหากหรือข้อตกลงอื่นที่บังคับใช้กับ BlackBerry ดังกล่าว เอกสารนี้ไม่มีเนื้อหาใดที่ตั้งใจจะแทนที่ข้อตกลงหรือการรับประกันที่เป็นลายลักษณ์อักษรโดยชัดแจ้งใดๆ ที่จัดทำโดย BLACKBERRY สำหรับผลิตภัณฑ์หรือบริการของ BLACKBERRY บางส่วนนอกเหนือจากเอกสารนี้
ซอฟต์แวร์ BlackBerry Enterprise ประกอบด้วยซอฟต์แวร์ของบุคคลที่สาม ข้อมูลใบอนุญาตและลิขสิทธิ์ที่เกี่ยวข้องกับซอฟต์แวร์นี้สามารถดูได้ที่ http://worldwide.blackberry.com/legal/thirdpartysoftware.jsp.

BlackBerry Limited
2200 ยูนิเวอร์ซิตี้ อเวนิว ตะวันออก
วอเตอร์ลู ออนแทรีโอ
แคนาดา N2K 0A7
แบล็กเบอร์รี่ สหราชอาณาจักร จำกัด
ชั้นล่าง อาคาร The Pearce West Street
เมเดนเฮด เบิร์กเชียร์ SL6 1RL
สหราชอาณาจักร
ตีพิมพ์ในแคนาดา

เอกสาร / แหล่งข้อมูล

การอ้างอิง API บริการติดต่อ BEMS [พีดีเอฟ] คู่มือการใช้งาน ติดต่อการอ้างอิง API บริการ, ติดต่อ, การอ้างอิง API บริการ, การอ้างอิง API, การอ้างอิง

อ้างอิง

• คู่มือการใช้งาน