REST API ใหม่ระหว่าง Grasshopper และ Connection
ด้วยการเปิดตัว Rest Connection API ใหม่ Component ของ Grasshopper ที่เกี่ยวข้องกับ API เดิม (ConHiddenCalculator) จะไม่สามารถใช้งานได้อีกต่อไป เนื่องจาก API นี้ไม่ได้รับการสนับสนุนตั้งแต่ IDEA StatiCa เวอร์ชัน 24.1.3 เป็นต้นไป
การติดตั้งปลั๊กอิน
เช่นเดียวกับเวอร์ชันเก่า ปลั๊กอินสามารถ ติดตั้ง ได้ผ่าน Rhino Package Manager เปิด Package Manager โดยพิมพ์ PackageManager ในพรอมต์คำสั่งของ Rhino จากนั้นอัปเดตหรือติดตั้งปลั๊กอิน IDEA StatiCa เวอร์ชันล่าสุดที่มีอยู่
ข้อดีของปลั๊กอิน Grasshopper ใหม่
ด้วยปลั๊กอินเวอร์ชันใหม่ ผู้ใช้สามารถเข้าถึงฟีเจอร์ที่ได้รับการปรับปรุงของ API ใหม่ และการโต้ตอบระหว่าง Grasshopper กับ IDEA StatiCa Connection ที่ง่ายขึ้นมาก
ปลั๊กอินเวอร์ชันเก่า 0.1.X
- ยากต่อการทำความเข้าใจว่าเกิดอะไรขึ้นใน API เมื่อใช้ Component
- มีการดำเนินการ IO จำนวนมาก
- การดำเนินการที่ใช้เวลานาน (เช่น การคำนวณ) ทำให้สคริปต์หยุดทำงาน
- มี Component จำนวนมากสำหรับ Object ทั้งหมด
- ไม่รองรับการทำงานกับหลายการเชื่อมต่อในโปรเจกต์เดียวกัน
- ยากต่อการเลือกเวอร์ชันเฉพาะของ IDEA StatiCa
ปลั๊กอินเวอร์ชันใหม่ 0.2.0
- เชื่อมโยงอย่างใกล้ชิดกับวัฒนธรรม API จริง (ช่วยให้การเปลี่ยนไปใช้ Python หรือ C# ง่ายขึ้น)
- โปรเจกต์จะอยู่บนเซิร์ฟเวอร์จนกว่าผู้ใช้จะบันทึก
- API Component ทำงานแบบ Async ผู้ใช้สามารถเขียนสคริปต์ต่อได้ขณะที่ Component กำลังคำนวณ
- การแยกส่วน API Object อัตโนมัติ
- รองรับการทำงานกับการเชื่อมต่อทั้งหมดในโปรเจกต์โดยตรง
- API Attacher/Runner ช่วยให้ระบุเวอร์ชันได้ง่าย
- ส่งออกไฟล์ IFC ได้โดยตรงใน Grasshopper
- ขั้นตอนการใช้งาน Template สอดคล้องกับแอปพลิเคชัน
- Pin และ Anchor สามารถกำหนดได้ใน IOM Component
ภาพรวมของ Component
ปลั๊กอินใหม่แบ่งออกเป็นสองแผงใน Grasshopper Ribbon
- App Common: API Component ที่ใช้ร่วมกันในทุก IDEA StatiCa Design API
- Connection: Component ที่เฉพาะเจาะจงสำหรับ Connection API
การเชื่อมต่อกับ API ผ่าน Grasshopper
เช่นเดียวกับ API Client อื่นๆ คุณสามารถเชื่อมต่อสคริปต์ Grasshopper กับ Runner API Instance (Connection Service Attacher) หรือเริ่มบริการภายใน Grasshopper (Connection Service Runner) ผู้ใช้ต้องเลือก Component ใดComponent หนึ่งข้างต้นและรันก่อนที่ API Component ใดๆ จะสามารถทำงานได้
ไม่ถูกต้อง:
คุณจะได้รับข้อความแสดงข้อผิดพลาดบน Component หาก Component พยายามทำงานโดยไม่มีการเชื่อมต่อ API ที่ถูกต้อง
ถูกต้อง:
เมื่อมีการเชื่อมต่อ API ที่ถูกต้องแล้ว Service Component ไม่จำเป็นต้องรันใหม่จนกว่าสคริปต์จะถูกปิดหรือออกจากหน้านั้น การเชื่อมต่อจะถูกจัดเก็บในเครื่องเพื่อให้ Component ทั้งหมดสามารถเข้าถึงได้
API Component
ปุ่ม "Active" ด้านล่างช่วยระบุ Component ที่โต้ตอบกับ API ได้อย่างง่ายดาย Component สามารถรันครั้งเดียวโดยคลิกปุ่ม Run หรือรันต่อเนื่องโดยใช้ Toggle True/False ที่เชื่อมต่อกับ Active Component
API Component มีความเกี่ยวข้องอย่างใกล้ชิดกับ Controller ใน Connection API Controller แบ่งออกเป็นแบบ Action-based (การคำนวณ การส่งออก รายงาน) หรือแบบ Object-based (ผลของแรงกระทำ ชิ้นส่วน พารามิเตอร์ เป็นต้น)
แบบ Action-based: Controller แบบ Action-based ทำงานเฉพาะหรือการดำเนินการบนการเชื่อมต่อหรือโปรเจกต์ที่ระบุ ซึ่งรวมถึงฟังก์ชันการคำนวณหรือการส่งออก
แบบ Object-based: Controller แบบ Object-based โดยทั่วไปจะมี Get Component และ Update Component:
- Get: ดึง Object ประเภท Controller ทั้งหมดใน Connection และดึง Object เฉพาะที่สามารถแยกส่วนหรือแก้ไขได้
- Update: อัปเดต Object ที่ระบุซึ่งได้รับการแก้ไขในสคริปต์ Grasshopper Object จะถูกอัปเดตโดยใช้ Automatic Modify Object Component
API Component ส่วนใหญ่จะรับ Input และให้ Output ของ Object ซึ่งสามารถแยกส่วนหรือแก้ไขได้ การจัดเตรียม Component ในรูปแบบนี้ช่วยลดจำนวน Component โดยรวมที่ผู้ใช้ต้องเพิ่ม
ตัวอย่างพื้นฐานที่สุดคือการแยกส่วนโปรเจกต์เพื่อรับข้อมูลที่มีอยู่ภายใน เช่น การเชื่อมต่อที่มีอยู่
ตัวอย่างง่ายๆ – การอัปเดตพารามิเตอร์การเชื่อมต่อ
ดูตัวอย่างง่ายๆ ของวิธีการทำงานของ Modify Component ภาพด้านล่างแสดงตัวอย่างการใช้ API และ Automatic Object Component ในการใช้งาน Template อย่างง่ายและการอัปเดตพารามิเตอร์การเชื่อมต่อ
ตัวอย่างพร้อมใช้งาน
รายการตัวอย่างทั้งหมดพร้อมให้ผู้ใช้ที่ดาวน์โหลดปลั๊กอินในไฟล์ Zip: %appdata%\McNeel\Rhinoceros\packages\8.0\IdeaStatiCaGrasshopper\[0.0.0]\Examples 0.2.0.zip
ความเข้ากันได้ของเวอร์ชัน
ปลั๊กอินใหม่เวอร์ชัน 0.2.0 มีให้ใช้งานใน Rhino Package Manager และจะทำงานร่วมกับ IDEA StatiCa เวอร์ชัน 24.1.3 และใหม่กว่า
เวอร์ชันเก่า 0.1.x ยังคงมีให้ใช้งานและจะทำงานร่วมกับ IDEA StatiCa เวอร์ชัน 24.1.2 และเก่ากว่า
เปิดตัวใน IDEA StatiCa เวอร์ชัน 24.1.4