AppAPI ช่วยให้ผู้ใช้โหลดข้อมูลเมตาของระบบจากแอปโดยใช้วิธีต่างๆ ใน FormEngine และ DMView ให้การเข้าถึงคีย์ข้อมูลต่างๆ สำหรับการดึงข้อมูลเฉพาะจากแอป

ใน XLSForm คุณสามารถใช้ฟังก์ชัน pulldata() กับไวยากรณ์ต่อไปนี้:

  • 'app-api': คีย์เวิร์ดนี้แจ้ง FormEngine ให้โหลดข้อมูลจาก App API
  • 'data-key': คีย์ของข้อมูลที่คุณต้องการโหลดจาก App API
  • หากคีย์ข้อมูลไม่ถูกต้องหรือไม่รองรับ การคำนวณจะส่งคืน “n/a”

นี่คือคีย์ข้อมูลที่รองรับที่คุณสามารถใช้กับ App-API:

osPlatform: ส่งคืนชื่อ OS ปัจจุบัน (Android หรือ iOS) และเวอร์ชัน OS

appPlatform: ส่งคืนชื่อแพลตฟอร์มแอป ซึ่งคือ rtSurvey

appVersion: ส่งคืนชื่อเวอร์ชันของแอป

getDisplayWidth: ส่งคืนความกว้างหน้าจออุปกรณ์เป็นพิกเซล

getDisplayHeight: ส่งคืนความสูงหน้าจออุปกรณ์เป็นพิกเซล

getScreenSize: ส่งคืนขนาดหน้าจออุปกรณ์เป็นนิ้ว

projectCode: ส่งคืนรหัสโปรเจกต์ปัจจุบันของไซต์ที่ผู้ใช้ลงชื่อเข้าใช้

projectURL: ส่งคืน URL โปรเจกต์ปัจจุบันของไซต์ที่ผู้ใช้ลงชื่อเข้าใช้

serverTime: ส่งคืนการประมาณที่ดีที่สุดของวันที่และเวลาบนเซิร์ฟเวอร์

user.[attribute]: ส่งคืนแอตทริบิวต์ผู้ใช้ปัจจุบันตามคีย์แอตทริบิวต์ที่ระบุ

Attribute Keyคำอธิบาย
usernameชื่อผู้ใช้
nameชื่อเต็มของผู้ใช้
staffCodeรหัสพนักงานของผู้ใช้
phoneหมายเลขโทรศัพท์ของผู้ใช้
emailที่อยู่อีเมลของผู้ใช้
descriptionข้อความคำอธิบายในข้อมูลผู้ใช้
organization_idID องค์กรที่ผู้ใช้สังกัด
organization_nameชื่อองค์กรที่ผู้ใช้สังกัด
team_idID ทีมที่ผู้ใช้สังกัด
supervisor_idID ของผู้ดูแลของผู้ใช้
is_supervisor1 ถ้าผู้ใช้เป็นผู้ดูแล, 0 ถ้าไม่ใช่

หมายเหตุ

  • การเรียก pulldata('app-api', ...) ทั้งหมดจะถูกประเมินเมื่อเปิดแบบฟอร์มและจะไม่ถูกประเมินซ้ำแบบไดนามิกระหว่างเซสชัน (ยกเว้น serverTime และ now())
  • หากคีย์ไม่รองรับหรือข้อมูลไม่พร้อมใช้งาน ฟังก์ชันจะส่งคืน 'n/a' (ไม่ใช่สตริงว่าง — ทดสอบด้วย != 'n/a' แทน != '')
  • ค่า openArgs พร้อมใช้งานเฉพาะเมื่อเปิดแบบฟอร์มจากปุ่มการกระทำ; มิฉะนั้นจะส่งคืนสตริงว่าง
หน้านี้มีประโยชน์หรือไม่?