ซอฟต์แวร์ SARTORIUS Sim Api

ข้อมูลจำเพาะ

• ชื่อผลิตภัณฑ์: SimApi Guide
• วันที่วางจำหน่าย: 5 กันยายน 2024
• วัตถุประสงค์: จัดเตรียมข้อมูลให้กับผลิตภัณฑ์ Umetrics Suite

คำแนะนำการใช้ผลิตภัณฑ์

การแนะนำ SimApis

• SimApis ใช้ในการดึงข้อมูลสำหรับการสร้างโครงการและการสร้างแบบจำลองในผลิตภัณฑ์ Umetrics Suite

การขอรับ SimApis

• หากต้องการรับ SimApis โปรดดูเอกสารอย่างเป็นทางการหรือติดต่อฝ่ายสนับสนุนลูกค้าเพื่อขอความช่วยเหลือ

คุณสมบัติของ SimApi

• SimApis ให้ข้อมูลแบบเรียลไทม์สำหรับการตรวจสอบ ควบคุม และการสร้างแบบจำลองใน SIMCA และ SIMCA-online

การใช้ข้อมูลปัจจุบันเท่านั้น

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

การเตรียมการติดตั้ง SimApi

• ก่อนการติดตั้ง โปรดตรวจสอบให้แน่ใจว่าระบบของคุณตรงตามข้อกำหนดขั้นต่ำที่ระบุไว้ในคู่มือผู้ใช้

การติดตั้ง SimApi

• ปฏิบัติตามคำแนะนำทีละขั้นตอนที่ให้ไว้ในคู่มือผู้ใช้เพื่อติดตั้ง SimApi บนระบบของคุณ

การตั้งค่า SimApi สำหรับ SIMCA

• กำหนดค่าการตั้งค่า SimApi ใน SIMCA ตามแนวทางที่ให้ไว้

การตั้งค่า SimApi สำหรับ SIMCA-ออนไลน์

• ตั้งค่า SimApi สำหรับการดึงข้อมูลแบบเรียลไทม์และการเขียนกลับใน SIMCA-online

การทดสอบและการแก้ไขปัญหา

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

ทดสอบจาก SIMCA-online

• ทดสอบการรวม SimApi จาก SIMCA-online เพื่อตรวจสอบการดึงข้อมูล

การแก้ไขปัญหาด้วยบันทึก Files

• ใช้บันทึก SimApi file เพื่อระบุและแก้ไขปัญหาการติดตั้งหรือการทำงานใดๆ

การกำหนดค่าบัญชีบริการ

• รับรองการกำหนดค่าบัญชีบริการ SIMCA ออนไลน์ที่ถูกต้องเพื่อการดำเนินงานที่ราบรื่น

รายละเอียดทางเทคนิค

• ดูที่ส่วนที่ 7 ของคู่มือผู้ใช้สำหรับข้อมูลทางเทคนิคโดยละเอียดเกี่ยวกับ SimApis

การแนะนำ SimApis

• SimApi คืออินเทอร์เฟซซอฟต์แวร์ระหว่างซอฟต์แวร์ Umetrics® Suite และแหล่งข้อมูล วัตถุประสงค์หลักของ SimApi คือการจัดเตรียมข้อมูลให้กับ SIMCA® ออนไลน์หรือ SIMCA®
• Sartorius Stedim Data Analytics AB พัฒนา SimApis สำหรับแหล่งข้อมูลที่แตกต่างกันมากมาย เช่น ประวัติกระบวนการและฐานข้อมูลวัตถุประสงค์ทั่วไป
• เอกสารนี้แสดงให้เห็นว่า SimApi คืออะไร และใช้ในผลิตภัณฑ์ Umetrics Suite อย่างไร คุณจะได้เรียนรู้วิธีการวางแผนและติดตั้ง SimApi วิธีแก้ปัญหา และวิธีทดสอบการติดตั้ง บทสุดท้ายมีรายละเอียดทางเทคนิคของ SimApis ที่มุ่งเป้าไปที่นักพัฒนา

วัตถุประสงค์ของ SimApi: จัดเตรียมข้อมูลให้กับผลิตภัณฑ์ Umetrics Suite

• วัตถุประสงค์หลักของ SimApi คือการจัดเตรียมข้อมูลให้กับ SIMCA-online หรือ SIMCA จากแหล่งข้อมูล แหล่งข้อมูลไม่ใช่ส่วนหนึ่งของ SIMCA-online แต่สามารถเป็นประวัติกระบวนการหรือระบบอื่นที่เก็บรักษาและจัดการข้อมูลได้
• SimApi เปิดเผยลำดับชั้นของโหนดที่สอดคล้องกับโฟลเดอร์ใน file ระบบ แต่ละโหนดสามารถมีโหนดอื่น ๆ ได้ หรือ tags. ก. tag สอดคล้องกับตัวแปร สำหรับสิ่งเหล่านี้ tags, สามารถรับข้อมูลได้ ภาพแสดง tag, Temp, เลือกในโหนด
• BakersYeastControlGood เป็นแหล่งข้อมูลใน SIMCA-online นอกจากนี้ยังแสดงค่าล่าสุดที่นำมาจากแหล่งข้อมูลด้วย

การใช้งาน SimApi ใน Umetrics Suite

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

SimApis ที่ใช้กันทั่วไป

• SimApis ที่ใช้กันอย่างแพร่หลายที่สุดคือ:
• PI AF SimApi สำหรับการเชื่อมต่อกับระบบ PI ของ Aveva (เดิมคือ OSIsoft)
• OPC UA SimApi ช่วยเหลือ
• ODBC SimApi สำหรับการเข้าถึงฐานข้อมูลทั่วไป เช่น SQL Server หรือ Oracle
• รายการ SimApis ที่มีจำหน่ายทั้งหมดพร้อมคุณสมบัติในย่อหน้าที่ 3

DBMaker SimApi สำหรับข้อมูลจำลอง

• DBMaker คือแอปพลิเคชันที่มาพร้อมกับการติดตั้งเซิร์ฟเวอร์ SIMCA-online โดยจะจำลองแหล่งข้อมูล เช่น ประวัติกระบวนการ โดยใช้ตารางข้อมูลที่โหลดไว้ล่วงหน้า โดยจะมีการให้การสังเกตทีละรายการแก่ SIMCA-online ผ่าน DBMaker SimApi
• DBMaker ใช้เพื่อจุดประสงค์ในการสาธิตเท่านั้น และไม่สามารถใช้ในการผลิตกับข้อมูลสดจากแหล่งข้อมูลได้ ดูความช่วยเหลือในตัวเพื่อเรียนรู้เพิ่มเติมเกี่ยวกับ DBMaker

เอกสารเพิ่มเติม

• เอกสารนี้เป็นหนึ่งในชุดเอกสารที่เกี่ยวข้อง โดยแต่ละเอกสารมีจุดเน้นและกลุ่มเป้าหมายที่แตกต่างกัน:

แหล่งที่มา	อะไร	ที่ไหน
ซิมซีเอออนไลน์ web หน้าหนังสือ	ข้อมูลเบื้องต้นและการดาวน์โหลด	sartorius.com/umetrics-simca- ออนไลน์

SIMCA-อ่านและการติดตั้งออนไลน์.pdf	การติดตั้งและวิธีเริ่มต้นใช้งาน SIMCA - ข้อมูลสาธิตออนไลน์	ในไฟล์ติดตั้ง zip file
คู่มือการใช้งาน SIMCA แบบออนไลน์	อธิบายฟังก์ชันการทำงานของ SIMCA ออนไลน์ วางไว้ในบริบทเดียวกับซอฟต์แวร์ Umetrics Suite อื่นๆ อธิบายข้อกำหนดและแนวทางปฏิบัติที่ดีที่สุดสำหรับการใช้งานที่ประสบความสำเร็จ และคำแนะนำในการติดตั้งทีละขั้นตอน	sartorius.com/umetrics-simca- ออนไลน์
คู่มือ SimApi	การเตรียมการและดำเนินการติดตั้ง SimApi รวมถึงการแก้ไขปัญหา นอกจากนี้ยังมีรายละเอียดทางเทคนิคเกี่ยวกับ SimApis สำหรับนักพัฒนา	sartorius.com/umetrics-simapi
คู่มือผู้ใช้ SimApi	เอกสารประกอบสำหรับ SimApi ที่เผยแพร่แต่ละรายการพร้อมคุณลักษณะ คำแนะนำในการติดตั้ง และข้อมูลจำเพาะของการกำหนดค่า	sartorius.com/umetrics-simapi
คู่มือทางเทคนิคออนไลน์ของ SIMCA	ข้อมูลอ้างอิงทางเทคนิคสำหรับการวางแผนการติดตั้งเซิร์ฟเวอร์ SIMCA-online การแก้ไขปัญหา และการทำงานของ SIMCA-online แบบเจาะลึก	sartorius.com/umetrics-simca-ออนไลน์
ความช่วยเหลือออนไลน์ของ SIMCA	Web-ความช่วยเหลือตามเกี่ยวกับวิธีการใช้ SIMCA-online และการทำงานของ SIMCA-online	ในซอฟต์แวร์เองและบน sartorius.com/umetrics-simca
ซิมซีเอออนไลน์ Web คู่มือการติดตั้งไคลเอนต์	อธิบายการติดตั้ง SIMCA ออนไลน์ Web ไคลเอนต์	sartorius.com/umetrics-simca-ออนไลน์
ฐานความรู้ Umetrics	ฐานข้อมูลค้นหาที่มีบทความเกี่ยวกับซอฟต์แวร์แต่ละเวอร์ชันที่วางจำหน่าย บทความทางเทคนิค และปัญหาที่ทราบในผลิตภัณฑ์ Umetrics Suite	sartorius.com/umetrics-kb
ความช่วยเหลือ/คู่มือผู้ใช้ SIMCA	วิธีใช้เดสก์ท็อป SIMCA เพื่อสร้างโครงการและสร้างแบบจำลองข้อมูล	ใน SIMCA และบน sartorius.com/umetrics-simca
สนับสนุน web หน้าหนังสือ	วิธีขอรับการสนับสนุนทางเทคนิค	sartorius.com/umetrics-support

การสนับสนุนด้านเทคนิค

• ทีมสนับสนุนออนไลน์ของ Sartorius จะตอบคำถามทางเทคนิคเกี่ยวกับ SimApis และสามารถส่งต่อคำขอสำหรับการปรับปรุง SimApis ไปยังบุคลากรที่เหมาะสมได้ เรียนรู้เพิ่มเติมได้ที่ sartorius.com/umetrics-support.

การขอรับ SimApis

• เรามีเอกสารประกอบสำหรับ SimApis ที่มีอยู่และลิงก์ไปยังโปรแกรมติดตั้งที่ sartorius.com/umetrics-simapi.
• แต่ละ SimApi จะมีการบันทึกไว้ในคู่มือผู้ใช้
• คู่มือ SimApi ที่คุณกำลังอ่านอยู่นี้ จะช่วยเสริมข้อมูลดังกล่าวด้วยข้อมูลเสริม SimApi ในส่วนที่เกี่ยวข้องกับการวางแผน การติดตั้ง และการแก้ไขปัญหา SimApi

คุณสมบัติของ SimApi

• แหล่งข้อมูลทั้งหมดไม่เหมือนกัน SimApi ไม่จำเป็นต้องใช้ฟังก์ชันทั้งหมดในข้อกำหนด ด้วยเหตุผลเหล่านี้ SimApi ที่แตกต่างกันจึงมีฟังก์ชันการทำงานที่แตกต่างกัน เมทริกซ์ต่อไปนี้แสดงรายการ SimApi ที่มีให้ใช้และคุณลักษณะต่างๆ
• คุณลักษณะต่างๆ จะอธิบายไว้ด้านล่าง โปรดทราบว่าตารางมีคอลัมน์แยกกันเพื่อแสดงคุณลักษณะต่างๆ ที่มีอยู่ใน SIMCA-online และ SIMCA ตามลำดับ

คุณสมบัติ	วัตถุประสงค์	การใช้งาน SIMCA ออนไลน์	การใช้งาน SIMCA
ข้อมูลปัจจุบัน	อ่านการสังเกตเดียวด้วยค่าล่าสุดจากแหล่งที่มาของข้อมูล	การดำเนินการปกติแบบเรียลไทม์	-
ข้อมูลทางประวัติศาสตร์	อ่านข้อสังเกตหลายรายการพร้อมกันด้วยข้อมูลในอดีตจากแหล่งที่มาของข้อมูล	ติดตามและคาดการณ์ข้อมูลในอดีต สร้างโครงการโดยใช้ File > ใหม่	ตัวช่วยนำเข้าฐานข้อมูลสำหรับนำเข้าข้อมูลกระบวนการเพื่อสร้างแบบจำลอง
ข้อมูลแบบแยกส่วน	อ่านข้อมูลห้องปฏิบัติการ/IPC จากแหล่งข้อมูล สังเกตได้หลายรายการต่อชุด	สำหรับโครงการแบบแบตช์ที่มีเฟสหรือเงื่อนไขแบตช์ที่กำหนดค่าไว้สำหรับการดึงข้อมูลแบบแยกส่วน	-
ข้อมูลแบทช์	อ่านเงื่อนไขชุดและคุณลักษณะคุณภาพขั้นสุดท้าย (หรือ	เงื่อนไขชุดหรือการจัดศูนย์กลางท้องถิ่น	ตัวช่วยนำเข้าฐานข้อมูลเพื่ออ่านเงื่อนไขแบตช์สำหรับ

คุณสมบัติ	วัตถุประสงค์	การใช้งาน SIMCA ออนไลน์	การใช้งาน SIMCA
	ข้อมูลประเภท MES อื่น ๆ) หนึ่งการสังเกตต่อชุด		การสร้างแบบจำลองระดับชุด
โหนดแบตช์	ระบุเวลาเริ่มต้นและเวลาสิ้นสุด (ว่างเปล่าสำหรับแบตช์ที่ใช้งานอยู่) สำหรับแบตช์ที่ระบุ ระบุชุดทั้งหมดที่มีอยู่ในช่วงเวลาหนึ่ง	จำเป็นสำหรับการดำเนินการกำหนดค่าแบบแบตช์	ตัวช่วยนำเข้าฐานข้อมูลเพื่อเลือกชุดที่จะนำเข้า
เขียนกลับ – ข้อมูลอย่างต่อเนื่อง	เขียนข้อมูลต่อเนื่อง เช่น คำทำนาย กลับไปยังแหล่งที่มาของข้อมูล	เขียนข้อมูลกลับจากระดับวิวัฒนาการแบตช์สำหรับที่ปรึกษาการควบคุมหรือสำหรับการกำหนดค่าต่อเนื่อง	-
เขียนกลับ – แยกจากกัน	เขียนข้อมูลแยกส่วน เช่น คำทำนาย กลับไปยังแหล่งที่มาของข้อมูล	เขียนกลับสำหรับการกำหนดค่าแบตช์ที่ระดับวิวัฒนาการแบตช์สำหรับเฟสที่กำหนดค่าสำหรับการดึงข้อมูลแบบแยกส่วน	-
เขียนกลับ – ข้อมูลแบตช์	เขียนข้อมูลระดับชุดกลับมา เช่น คำทำนาย หรือคุณลักษณะคุณภาพขั้นสุดท้าย ไปยังแหล่งข้อมูล	เขียนกลับสำหรับการกำหนดค่าแบบแบตช์ที่ระดับแบตช์	-
ลำดับชั้นของโหนด	SimApi รองรับลำดับชั้นของโหนด คล้ายกับ file ระบบ แต่ละโหนดสามารถมี tags และโหนดอื่นๆ ลำดับชั้นทำให้การจัดการโหนดจำนวนมากง่ายขึ้น tags.	รองรับทุกสถานที่ tags มีการใช้กัน
อาร์เรย์ tag การขยายตัว	อาร์เรย์ tag เก็บค่าหลายค่า SimApi จะขยายอาร์เรย์ tag ต่อบุคคลจำนวนมาก tagsหนึ่งสำหรับแต่ละองค์ประกอบในอาร์เรย์	รองรับที่ไหน tags ใช้สำหรับข้อมูลต่อเนื่อง แต่ละส่วนจะขยายออก tag จะต้องแมปกับตัวแปรในโครงการ SIMCA
แหล่งข้อมูลหลายแหล่ง	SimApi สามารถเชื่อมต่อกับแหล่งข้อมูลมากกว่าหนึ่งแหล่งหรือรองรับอินสแตนซ์ของตัวเองหลายอินสแตนซ์ด้วยการตั้งค่าและบันทึกเฉพาะตัว files สำหรับแต่ละอินสแตนซ์	เชื่อมต่อกับแหล่งข้อมูลต่าง ๆ หลายแหล่งที่เป็นประเภทเดียวกัน	-
ความยืดหยุ่นในการเชื่อมต่อ	หาก SimApi ถูกตัดการเชื่อมต่อจากแหล่งข้อมูล มันจะพยายามสร้างการเชื่อมต่อใหม่โดยอัตโนมัติ	ไม่จำเป็นต้องรีสตาร์ท SimApi เพื่อสร้างการเชื่อมต่อกับแหล่งข้อมูลอีกครั้ง	-
พัฒนาภายในองค์กร	SimApi ได้รับการพัฒนา จัดทำ และสนับสนุนโดย

ไม่แนะนำให้ใช้เฉพาะข้อมูลปัจจุบันเท่านั้นโดยไม่มีข้อมูลในอดีต

• SimApis บางตัว โดยเฉพาะ OPC DA รองรับเฉพาะการอ่านข้อมูลปัจจุบันเท่านั้น ไม่รองรับข้อมูลในประวัติ
• ไม่สามารถใช้ SimApi ที่รองรับเฉพาะข้อมูลปัจจุบันใน SIMCA บนเดสก์ท็อปได้ เนื่องจากจะไม่สามารถอ่านข้อมูลในประวัติที่ใช้สร้างโมเดลได้
• สำหรับ SIMCA-online เราขอแนะนำแหล่งข้อมูลและ SimApi อย่างยิ่งที่ไม่เพียงแต่มีข้อมูลปัจจุบันสำหรับการดำเนินการแบบเรียลไทม์เท่านั้น แต่ยังรวมถึงข้อมูลในอดีตเพื่อให้สามารถคาดการณ์และติดตามข้อมูลในอดีตได้ SIMCA-online จะสลับระหว่างข้อมูลแบบเรียลไทม์และข้อมูลในอดีตโดยอัตโนมัติตามความจำเป็น และไม่สามารถปิดการทำงานนี้ได้
• แหล่งข้อมูลที่ให้เฉพาะข้อมูลปัจจุบันเท่านั้น แต่ไม่รวมข้อมูลในประวัติ สามารถทำงานกับโครงการต่อเนื่องใน SIMCA-online ได้ แต่สำหรับโครงการแบบแบตช์ จำเป็นต้องมีข้อมูลในประวัติ

การเตรียมการติดตั้ง SimApi

• หัวข้อนี้จะอธิบายข้อมูลสำคัญสำหรับการติดตั้ง SimApi ให้สำเร็จ

SimApis 64 บิต หรือ 32 บิต

• มี SimApi เวอร์ชัน 32 บิตและ 64 บิต
• SIMCA-online และ SIMCA เป็นแบบ 64 บิต และต้องใช้ SimApis เวอร์ชัน 64 บิต SimApis เวอร์ชัน 32 บิตแบบเก่ายังคงพร้อมใช้งานสำหรับการติดตั้งรุ่นเก่า

ตำแหน่งสำหรับบันทึก file และการตั้งค่า

• SimApi จะจัดเก็บบันทึกของตัวเอง files ในโฟลเดอร์ Program Data ที่ซ่อนอยู่1:
  %programdata%\Umetrics\SimApi โดยที่ %programdata% จะแมปกับโฟลเดอร์จริงบนคอมพิวเตอร์ของคุณ โดยค่าเริ่มต้นคือ C:\ProgramData
• โดยทั่วไปแล้ว SimApi แต่ละตัวจะใช้บันทึกของตัวเอง fileซึ่งคล้ายกับบันทึกเซิร์ฟเวอร์ SIMCA ออนไลน์ file จะมีข้อมูลมากหรือน้อยขึ้นอยู่กับการตั้งค่าระดับบันทึก file มีประโยชน์ในการแก้ไขปัญหา บันทึก file ได้รับการตั้งชื่อว่า
  .บันทึกที่ไหน คือ SimApi ที่คุณกำลังติดตั้ง เช่นampจาก PIAFSimApi โปรดดูส่วนถัดไปสำหรับชื่ออินสแตนซ์ SimApi ของ SIMCA-online
• โฟลเดอร์นี้ยังมีการตั้งค่า SimApi ในรูปแบบ XML file ชื่อ .xml.
• SimApis ส่วนใหญ่มีอินเทอร์เฟซผู้ใช้แบบกราฟิกที่เปลี่ยนการตั้งค่าใน xml fileแต่สำหรับบางรายการคุณสามารถป้อนการเปลี่ยนแปลงโดยตรงลงใน XML file ด้วยโปรแกรมแก้ไขข้อความ เช่น Notepad ดูคู่มือผู้ใช้สำหรับ SimApi แต่ละตัว

File ชื่อเมื่อใช้อินสแตนซ์ที่มีชื่อกับ SIMCA-online

• ใน SIMCA-online แต่ละอินสแตนซ์ SimApi จะมีการกำหนดค่าของตัวเอง file และเข้าสู่ระบบ file เพื่อทำงานกับอินสแตนซ์ต่างๆ ของ SimApi แต่ละรายการ ชื่อของสิ่งเหล่านี้ files จะต่อท้ายด้วยชื่อของอินสแตนซ์ตามที่ระบุไว้บนแท็บ SimApi ในกล่องโต้ตอบตัวเลือกเซิร์ฟเวอร์ SIMCA-online
• ตัวอย่างต่อไปนี้ample แสดงการตั้งชื่อของสิ่งเหล่านี้ fileส อยู่ที่ไหน จำเป็นต้องแทนที่ด้วยชื่อ SimApi
• ชื่อการกำหนดค่าที่กำหนดเมื่อเพิ่มอินสแตนซ์: OmegaServer
• การกำหนดค่า file ชื่อ: โอเมก้าเซิร์ฟเวอร์.xml
• บันทึก file ชื่อ: โอเมก้าเซิร์ฟเวอร์.log
• โปรดทราบว่าแบบทั่วไป file .บันทึก file ยังคงสร้างอยู่ บันทึกนี้ file มีรายการที่ไม่สามารถส่งไปยังบันทึกได้เนื่องจากเหตุผลทางเทคนิค file ของกรณีต่างๆ..
• โฟลเดอร์นี้ถูกซ่อนไว้ใน Windows ตามค่าเริ่มต้น หากต้องการดูใน File Explorer ที่คุณกำหนดค่าให้แสดงซ่อนอยู่ fileโปรดทราบว่าคุณสามารถนำทางไปยังโฟลเดอร์ที่ซ่อนอยู่ได้โดยการพิมพ์ที่อยู่ลงใน File แถบที่อยู่ของนักสำรวจ
• โปรดทราบว่า SIMCA ไม่รองรับ SimApi หลายอินสแตนซ์ ดังนั้นจึงใช้ชื่อที่ไม่มีชื่ออินสแตนซ์ดังที่อธิบายไว้ข้างต้น

การวางแผนเครือข่าย

• คุณควรติดตั้งเซิร์ฟเวอร์ SIMCA-online ไว้ใกล้กับแหล่งข้อมูลในเครือข่าย วิธีนี้จะช่วยให้เชื่อมต่อระหว่าง SIMCA-online กับแหล่งข้อมูลได้รวดเร็ว
• อุปกรณ์เครือข่ายอาจรบกวนการเชื่อมต่อระหว่าง SIMCA-ออนไลน์และแหล่งข้อมูล

บัญชีผู้ใช้และสิทธิ์อนุญาตแหล่งข้อมูล

• แหล่งข้อมูลโดยทั่วไปจะควบคุมการเข้าถึงข้อมูลของตนเอง ซึ่งโดยปกติจะทำโดยใช้ชื่อผู้ใช้และรหัสผ่าน แต่สามารถใช้ข้อจำกัดตามที่อยู่ IP หรือ DNS ได้เช่นกัน (เช่นampPI ไว้วางใจในระบบ Aveva PI)
• สามารถระบุชื่อผู้ใช้และรหัสผ่านให้กับแหล่งข้อมูลได้หลายวิธี:
• SimApi จะถูกเรียกใช้งานโดยเป็นผู้ใช้ Windows ของผู้ใช้ที่เรียกใช้บัญชีบริการ SIMCA บนเดสก์ท็อปหรือบัญชีบริการออนไลน์ของ SIMCA บนคอมพิวเตอร์เซิร์ฟเวอร์ SimApi สามารถเชื่อมต่อกับแหล่งข้อมูลโดยใช้บัญชีนี้ได้ นี่คือวิธีการทำงานของ OPC I และ PI SimApi และ ODBC หากคุณไม่ระบุข้อมูลประจำตัวเมื่อกำหนดค่า
• สำหรับ ODBC ทั่วไป คุณสามารถใช้แอปพลิเคชัน ODBC Data Sources Administrator ที่พบได้ในเริ่มใน Windows
• ผู้ให้บริการฐานข้อมูลบางรายจัดเตรียมไดรเวอร์และเครื่องมือสำหรับฐานข้อมูลของตนเอง เช่น ฐานข้อมูล Oracleampให้ใช้ Oracle Data Access Components (ODAC)
• SimApis บางตัว เช่น PI AF และ ODBC มีกล่องโต้ตอบการกำหนดค่าที่จัดเก็บข้อมูลประจำตัวที่เข้ารหัสไว้ในการกำหนดค่า SimApi XML file.
• นอกจากนี้ PI ยังมีตัวเลือกความปลอดภัยต่างๆ ให้เลือกใน PI System Management Tools บนคอมพิวเตอร์เซิร์ฟเวอร์ PI อ่านเพิ่มเติมในคู่มือผู้ใช้ PI AF SimApi คู่มือนี้มีประโยชน์แม้ว่าคุณจะใช้ OSIsoft PI SimApi รุ่นเก่าก็ตาม
• OPC DA และ HDA ใช้ DCOM เป็นการขนส่งระหว่างแหล่งข้อมูลและ SimApi DCOM ได้รับการกำหนดค่าด้วยเครื่องมือ Component Services (DCOMCNFG.EXE) ใน Windows และใช้การตรวจสอบสิทธิ์ของ Windows
• สำหรับ OSIsoft PI SimApi รุ่นเก่า (ไม่ใช่ AF SimApi ที่ใหม่กว่า) จะใช้แอปพลิเคชัน OSIsoft AboutPI-SDK (PISDKUtility.exe) เพื่อตั้งค่าการเชื่อมต่อกับเซิร์ฟเวอร์ PI

การตรวจสอบการเชื่อมต่อแหล่งข้อมูล
เมื่อคุณต้องการติดตั้ง SimApi บนคอมพิวเตอร์ การตรวจสอบการเชื่อมต่อจากคอมพิวเตอร์นั้นไปยังแหล่งข้อมูลด้วยเครื่องมืออื่นอาจเป็นประโยชน์:

• ODBC Data Sources ใน Windows ใช้สำหรับกำหนดค่าและทดสอบ ODBC ทั่วไป โปรดทราบว่าเครื่องมือนี้มีสองเวอร์ชันใน Windows 64 บิต: เวอร์ชันหนึ่งสำหรับแอปพลิเคชัน 32 บิต และอีกเวอร์ชันหนึ่งสำหรับแอปพลิเคชัน 64 บิต ใช้ปุ่มทดสอบแหล่งข้อมูลที่ส่วนท้ายของตัวช่วยกำหนดค่า ODBC เพื่อตรวจสอบการเชื่อมต่อกับฐานข้อมูล เราขอแนะนำให้คุณกำหนดค่าแหล่งข้อมูลของคุณเป็น DSN ของระบบ
• เครื่องมือการเชื่อมต่อเฉพาะฐานข้อมูลจากผู้ให้บริการฐานข้อมูล เช่น Oracle Data Access Components
• PI System Explorer สามารถใช้เพื่อทดสอบการเชื่อมต่อกับเซิร์ฟเวอร์ PI AF ซึ่งเป็นส่วนหนึ่งของ PI AF Client ซึ่งเป็นข้อกำหนดเบื้องต้นสำหรับ PI AF SimApi
• OPC UA Expert จาก Unified Automation – UaExpert เป็นไคลเอนต์ทดสอบข้ามแพลตฟอร์มสำหรับเซิร์ฟเวอร์ OPC UA
• สามารถใช้แอปพลิเคชัน PI-SDK (PISDKUtility.exe) เพื่อทดสอบการเชื่อมต่อและ view ข้อความแสดงข้อผิดพลาดใดๆ ที่อาจบันทึกไว้เมื่อ SIMCA-online พยายามเชื่อมต่อกับเซิร์ฟเวอร์ PI ซึ่งใช้สำหรับ OSIsoft SimApi รุ่นเก่าเท่านั้น ไม่ใช่ PIAF
• เครื่องมือจัดการระบบ PI ถูกใช้บนคอมพิวเตอร์เซิร์ฟเวอร์ PI เพื่อแก้ไขปัญหาจากด้านนั้น ตัวอย่างเช่นampเพื่อค้นหาปัญหาความปลอดภัยที่ขัดขวางการเข้าถึงจากเซิร์ฟเวอร์ SIMCA-online เรียนรู้เพิ่มเติมเกี่ยวกับการแก้ไขปัญหาของระบบ PI ในวิดีโอ YouTube นี้
• Excel สามารถใช้ในการรับข้อมูลจากการเชื่อมต่อ ODBC และระบบอื่นๆ ส่วนใหญ่ได้เมื่อมีการติดตั้งปลั๊กอินที่เหมาะสม
• Matrikon OPC Explorer for Ior HDA (ซึ่งเป็นเครื่องมือแยกกัน) สามารถใช้ทดสอบการเชื่อมต่อ OPC และ Matrikon OPC Analyzer สามารถใช้วินิจฉัยปัญหาการเชื่อมต่อ OPC ได้ ดาวน์โหลดเครื่องมือฟรีเหล่านี้ได้จาก https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (สำหรับ DInd HDA) จากสถาบันฝึกอบรม OPC web เว็บไซต์ “ช่วยให้ผู้ใช้สามารถวินิจฉัยปัญหาด้านการสื่อสารและความปลอดภัยได้อย่างง่ายดาย และแก้ไขปัญหาได้ทันทีด้วยการกดปุ่มเพียงปุ่มเดียว ทั้งหมดนี้สามารถทำได้โดยไม่จำเป็นต้องเรียนรู้วิธีกำหนดค่า DCOM เลย”

การติดตั้ง SimApi

วิธีการติดตั้ง SimApi บนพีซีมีดังนี้:

1. อ่านคู่มือผู้ใช้สำหรับ SimApi ที่คุณกำลังติดตั้ง ซึ่งมีรายละเอียดเฉพาะสำหรับ SimApi นั้นๆ ที่เสริมคำแนะนำทั่วไปที่คุณกำลังอ่านอยู่
2. ติดตั้งและกำหนดค่าข้อกำหนดเบื้องต้นใดๆ ที่ระบุไว้ในคู่มือผู้ใช้ SimApi (เช่นampไดรเวอร์ฐานข้อมูลหรือ SDK)
3. เรียกใช้โปรแกรมติดตั้งเพื่อติดตั้ง SimApi ติดตั้งเวอร์ชัน 64 บิต (x64) หรือ 32 บิต (x86) ที่ตรงกับซอฟต์แวร์ที่คุณจะเรียกใช้
4. กำหนดค่า SimApi ใน SIMCA-online หรือ SIMCA ตามที่อธิบายไว้ในหัวข้อต่อไปนี้ และดูคู่มือผู้ใช้ของ SimApi เพื่อดูคำอธิบายของการตั้งค่าที่ใช้ได้
5. เริ่มเซิร์ฟเวอร์ SIMCA-online โปรดทราบว่าอาจใช้เวลานาน เนื่องจากเมื่อเริ่มต้น SimApi แล้ว ระบบจะแสดงรายการทั้งหมด tags ในแหล่งที่มาของข้อมูล
6. ทดสอบ SimApi โดยรับข้อมูลบางส่วน สำหรับ SIMCA-online คุณสามารถใช้ File > แยกข้อมูลตามที่อธิบายไว้ในข้อ 6.1
7. หาก SimApi ไม่ทำงานตามที่คาดหวัง โปรดดูบันทึก SimApi fileสำหรับการแก้ไขปัญหา และคู่มือผู้ใช้ SimApi

การตั้งค่า SimApi เพื่อใช้ใน SIMCA

วิธีใช้ SimApi ใน SIMCA มีดังนี้:

1.  เริ่มการนำเข้าฐานข้อมูลด้วยวิธีใดวิธีหนึ่งต่อไปนี้:
   • a. ในการสร้างโครงการใหม่ใน SIMCA: File > โครงการปกติใหม่หรือโครงการแบตช์ใหม่ เลือกจากฐานข้อมูลบนแท็บหน้าแรก
   • b. การนำเข้าชุดข้อมูลในโครงการที่มีอยู่แล้วใน SIMCA: จากชุดข้อมูลบนแท็บข้อมูลของโครงการ SIMCA ที่เปิดอยู่
2. คลิกเพิ่มแหล่งข้อมูลใหม่
3. เลือก SimApi เป็นประเภทการเชื่อมต่อ คลิกปุ่ม … และค้นหา .dll ในโฟลเดอร์การติดตั้ง แล้วคลิกเปิด
4. คลิกกำหนดค่าและดูวิธีการตั้งค่าในคู่มือผู้ใช้ SimApi แต่ละรายการ
5. คลิกทดสอบการเชื่อมต่อแหล่งข้อมูลเพื่อยืนยันว่าคุณสามารถเชื่อมต่อกับฐานข้อมูลได้ ซึ่งอาจใช้เวลานานหากมีข้อมูลจำนวนมาก tags ในแหล่งที่มาของข้อมูล
6. คลิกตกลงเพื่อเสร็จสิ้นการกำหนดค่า
7. ดูวิธีทำงานกับข้อมูลที่นำเข้าได้จากความช่วยเหลือของ SIMCA

การตั้งค่า SimApi เพื่อใช้งานใน SIMCA-ออนไลน์

• สิ่งสำคัญ: จำเป็นต้องมีใบอนุญาตเซิร์ฟเวอร์ SIMCA-online จึงจะสามารถใช้ SimApi ได้ การติดตั้ง SIMCA-online รุ่นสาธิตไม่อนุญาตให้ใช้ SimApis
• หากต้องการเพิ่ม SimApi ลงในระบบ คุณต้องเรียกใช้ตัวเลือกเซิร์ฟเวอร์ SIMCA-online บนพีซีเซิร์ฟเวอร์ เรียนรู้ขั้นตอนโดยละเอียดในหัวข้อวิธีใช้ SICMA-online เรื่องการเพิ่มและกำหนดค่า SimApi บนเซิร์ฟเวอร์
• เคล็ดลับ: หากคุณทำการเปลี่ยนแปลงสำหรับ SimApi คุณสามารถรีสตาร์ท SimApi นั้นแยกจากตัวเลือกเซิร์ฟเวอร์โดยไม่ต้องรีสตาร์ทเซิร์ฟเวอร์ทั้งหมด
• หากต้องการกำหนดค่าอินสแตนซ์หลายอินสแตนซ์ของ SimApi นี้ ให้ทำซ้ำขั้นตอนข้างต้นและใช้ชื่อที่ไม่ซ้ำกันสำหรับแต่ละอินสแตนซ์ อ่านเพิ่มเติมเกี่ยวกับบันทึกและการกำหนดค่าที่แตกต่างกัน files สำหรับอินสแตนซ์ใน 4.2

การทดสอบและการแก้ไขปัญหา SimApi

• บทนี้เกี่ยวกับการทดสอบและแก้ไขปัญหาการติดตั้ง SimApi

ทดสอบ SimApi จาก SIMCA-online

• เมื่อเริ่มต้นเซิร์ฟเวอร์ SIMCA-online สำเร็จแล้ว คุณสามารถทดสอบ SimApi ของคุณใน SIMCA-online ได้ (หากเซิร์ฟเวอร์ไม่เริ่มทำงาน โปรดดู 6.2):
• เข้าสู่ระบบเซิร์ฟเวอร์ในไคลเอนต์ SIMCA-online และไปที่ Extract บน File แท็บ Extract ช่วยให้คุณทดสอบ SimApi โดยรับข้อมูลผ่านมัน:
• โหนด ("โฟลเดอร์") ของ SimApi จะแสดงในกล่องด้านซ้าย Tags สำหรับโหนดที่เลือกจะแสดงอยู่ที่ด้านบนขวา
• สามารถทดสอบข้อมูลปัจจุบันได้อย่างรวดเร็วเพียงคลิก view> บน tags ที่ให้ข้อมูลกระบวนการอย่างต่อเนื่อง (ดูภาพหน้าจอ)
• คลิกขวาที่โหนดเพื่อค้นหาชุดข้อมูลภายในช่วงเวลา โหนดจะต้องเป็นโหนดชุดข้อมูลที่ทราบเกี่ยวกับชุดข้อมูล
• เลือก tags ในการแยกข้อมูลและคลิกถัดไปและดำเนินการตามตัวช่วยเพื่อสร้างข้อมูลโดยใช้โหมดการดึงข้อมูลที่แตกต่างกัน ได้แก่ ข้อมูลปัจจุบัน ข้อมูลในอดีต ข้อมูลแบบชุด และข้อมูลแบบแยกส่วน
• เปรียบเทียบข้อมูลที่แยกออกมาด้วยสิ่งที่คุณเห็นในแหล่งข้อมูลของคุณโดยใช้เครื่องมือต่างๆ เรียนรู้เพิ่มเติมเกี่ยวกับการทดสอบและการตรวจสอบคุณสมบัติทั้งหมดของ SimApi ในเวอร์ชัน 7.13

แก้ไขปัญหา SimApi โดยใช้บันทึก SimApi file

• หากเซิร์ฟเวอร์ไม่เริ่มทำงาน SimApi ไม่ทำงานตามที่คาดหวังหรือการแยกข้อมูลล้มเหลว คุณต้องตรวจสอบบันทึก SimApi file ซึ่งจะแจ้งให้คุณทราบว่าปัญหาคืออะไร เปิดใช้งานการบันทึกข้อมูลในระดับดีบักในบันทึก SimApi เพื่อดูรายละเอียดทั้งหมด ดู 4.2
• หมายเหตุ: บันทึกเซิร์ฟเวอร์ SIMCA-online นั้นไม่มีประโยชน์มากนัก บันทึกจะแสดงวิธีโหลดและเริ่มต้น SimApi โดยเซิร์ฟเวอร์ แต่รายละเอียดเฉพาะของ SimApi นั้นมีอยู่ในบันทึก file.

ใช้บัญชีบริการ SIMCA ออนไลน์ที่ถูกต้อง

• เมื่อคุณทำการทดสอบการเข้าถึงแหล่งข้อมูล โปรดจำไว้ว่าคุณเข้าสู่ระบบเป็นผู้ใช้เฉพาะบนคอมพิวเตอร์เซิร์ฟเวอร์ (โดยทั่วไปคือบัญชีผู้ใช้ของคุณเองในโดเมน Windows) แต่บัญชีบริการเซิร์ฟเวอร์ SIMCA-online จะเป็นบัญชีอื่น โดยค่าเริ่มต้นคือ LocalSystem ซึ่งมีสิทธิ์การเข้าถึงต่างกันเมื่อเทียบกับบัญชีผู้ใช้ของคุณ
• ด้วยเหตุนี้ จึงไม่ใช่เรื่องแปลกที่การทดสอบจะทำงานได้เมื่อเรียกใช้เป็นบัญชีของคุณ แต่ SIMCA-online ไม่สามารถเชื่อมต่อกับแหล่งข้อมูลได้
• ในการแก้ไขปัญหานี้ จำเป็นต้องให้สิทธิ์การเข้าถึงสำหรับบัญชีที่ใช้โดยบริการเซิร์ฟเวอร์ SIMCA-online โดยปกติแล้ว คุณต้องเปลี่ยน LocalSystem เป็นบัญชีบริการโดเมนเฉพาะ และให้สิทธิ์กับบัญชีนี้ โปรดทราบว่าข้อนี้จะไม่มีผลหาก SimApi ใช้ข้อมูลประจำตัวที่ตั้งค่าไว้ในการกำหนดค่า SimApi เนื่องจากข้อมูลประจำตัวเหล่านี้จะมีสิทธิ์เหนือกว่า

รายละเอียดทางเทคนิคของ SimApis

• บทนี้จะให้รายละเอียดทางเทคนิคเกี่ยวกับการทำงานของ SimApi โดยมุ่งเป้าไปที่นักพัฒนาที่ต้องการทำความเข้าใจ SimApi เพื่อนำ SimApi ไปใช้เป็นแหล่งข้อมูล
• นักพัฒนาควรอ่านส่วนก่อนหน้าของเอกสารนี้เพื่อดูข้อมูลแนะนำ SimApis และคำอธิบายฟีเจอร์ในระดับสูง

เมื่อใดควรพิจารณาพัฒนา SimApi และเมื่อใดที่ไม่ควรทำ?

ก่อนที่จะพิจารณาพัฒนา SimApi สำหรับแหล่งข้อมูล:

1. ตรวจสอบว่ามี SimApi ที่คุณสามารถใช้ได้อยู่แล้วหรือไม่ บางทีคุณอาจเปิดใช้ฟีเจอร์บางอย่างในแหล่งข้อมูลของคุณเพื่อใช้ SimApi ที่มีอยู่ เช่น OPC UA
2. โปรดอ่านเอกสารนี้และเอกสารอ้างอิงอย่างละเอียด และตรวจสอบว่าแหล่งข้อมูลของคุณเป็นไปตามข้อกำหนดหรือไม่ เช่นampจะต้องรวดเร็วเพียงพอ ไม่เพียงแต่ให้ข้อมูลปัจจุบันเท่านั้น แต่รวมถึงข้อมูลในอดีตด้วย

• ด้วยเหตุผลเหล่านี้ เราจึงไม่แนะนำให้พัฒนา SimApi ที่เชื่อมต่อกับฮาร์ดแวร์หรือเครื่องมือระดับต่ำ ควรเชื่อมต่อเครื่องมือเหล่านั้นกับโปรแกรมบันทึกกระบวนการ เช่น Aveva PI System แล้วปล่อยให้โปรแกรมรับข้อมูลจากเครื่องมือและสร้างบันทึกข้อมูล จากนั้นจึงสามารถใช้ PIAF SimApi เพื่อรับข้อมูลจาก PI ไปยังผลิตภัณฑ์ Umetrics

การพัฒนา SimApi และข้อกำหนดของ SimApi

• ข้อกำหนด SimApi หรือ SimApi-v2 ประกอบด้วยเอกสารสำหรับฟังก์ชัน C ทั้งหมดใน SimApi ที่ DLL ของ SimApi ต้องใช้ในการใช้งาน รวมไปถึงคำแนะนำบางส่วนเกี่ยวกับวิธีการพัฒนา SimApi
• การใช้งาน SimApi โดยใช้ C หรือ C++ ในกรณีส่วนใหญ่จะอยู่ในระดับที่ไม่จำเป็น
• วิธีที่แนะนำและง่ายกว่าในการใช้งาน SimApi คือการใช้ Ex เป็นฐานampซอร์สโค้ด leSimApi ที่เรามอบให้ มันคือตัวอย่างampการใช้งาน SimApi ที่จัดการอินเทอร์เฟซ C และแปลงเป็น .NET Framework ซึ่งเป็นที่ที่นำไปใช้งานจริง นอกจากนี้ยังมีโค้ดเฟรมเวิร์กสำหรับการบันทึก การตั้งค่า การกำหนดค่า GUI และโค้ดเฟรมเวิร์กอื่นๆ
• ในการพัฒนา SimApi ทีมนักพัฒนาต้องมีประสบการณ์ในการพัฒนา Windows, .NET Framework, C หรือ C++ นอกจากนี้ ยังต้องมีความรู้ที่ดีเกี่ยวกับแหล่งข้อมูลที่ SimApi ควรเชื่อมต่อด้วย เนื่องจากจุดประสงค์ของ SimApi คือการแปลคำขอข้อมูลจาก SIMCA-online หรือ SIMCA ไปยัง API ของแหล่งข้อมูล การนำ SimApi ไปใช้งานจริงนั้นไม่ใช่โครงการแบบครั้งเดียว แต่โดยทั่วไปแล้วจะต้องมีการสนับสนุนอย่างต่อเนื่องและการบำรุงรักษาเป็นครั้งคราว

การอ่านหรือการเขียนข้อมูล

• SimApi มีหน้าที่หลักในการจัดเตรียมข้อมูลจากแหล่งข้อมูล ซึ่งเรียกว่าการอ่านข้อมูล
• การใช้งาน SimApi ส่วนใหญ่ยังรองรับการเขียนข้อมูลด้วย ซึ่งหมายความว่าจะเขียนข้อมูลกลับผ่าน SimApi ไปยังแหล่งข้อมูล การเขียนข้อมูลเป็นคุณลักษณะเสริมใน SIMCA-online

Tags และโหนด

• A tag เป็นตัวระบุของคอลัมน์หรือ “ตัวแปร” ในแหล่งข้อมูล tagชื่อของเขาใช้เพื่อระบุตัวตน tagชื่อภายในโหนดต้องไม่ซ้ำกัน SIMCA-online 18 เป็นเวอร์ชันแรกที่รองรับโหนดที่ประกอบด้วยโหนดย่อยและ tag ที่มีชื่อเดียวกัน เช่นample: โหนดหลักอาจมีโหนดย่อยชื่อ Batch และ tag เรียกว่า แบตช์
• โหนดคือคอนเทนเนอร์ของ tagsโหนดสามารถมีโหนดอื่น ๆ ได้เช่นเดียวกัน file ระบบมีโฟลเดอร์อยู่ในโฟลเดอร์
• เหมือนใน file ระบบโหนดและ tag ชื่อสามารถรวมเป็นเส้นทางเต็มที่ระบุเฉพาะได้ tag. การ tag เส้นทางที่ใช้ใน SIMCA-online หรือ SIMCA เมื่อทำการเลือก tags ที่จะใช้. tag เส้นทางเริ่มต้นด้วยชื่ออินสแตนซ์ SimApi ตามด้วยโครงสร้างโหนด และสิ้นสุดด้วย tag ชื่อแต่ละรายการคั่นด้วยเครื่องหมายโคลอน (:) เช่นampจาก “:ODBCSQLServer:Node:SensorTag1”

SimApi จะมีการแจกแจงรายการ tags และโหนดเมื่อเริ่มต้น

• การใช้งาน SimApi จะเรียกดูเซิร์ฟเวอร์เพื่อหาโหนดและ tags ในแหล่งข้อมูลเมื่อ SimApi ถูกเริ่มต้นและติดตามข้อมูลเหล่านั้นเพื่อให้ฟังก์ชั่น SimApi ต่างๆ ที่ใช้ในการแจงรายการ tags และโหนดสามารถนำมาใช้ได้
• การเริ่มต้นระบบ SimApi จะไม่เกิดขึ้นทันทีเมื่อเซิร์ฟเวอร์เริ่มทำงาน แต่ผู้ใช้ยังสามารถเรียกใช้งานซ้ำได้ใน SIMCA-online โดยใช้ฟังก์ชัน Refresh SimApi

ความไวของตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ของ tag- และชื่อโหนด

• Tag ชื่อและชื่อโหนดจะต้องตรงตามตัวพิมพ์ใหญ่-เล็ก
• ดังนั้น, tag เรียกว่า "tag1” ไม่เหมือนกับ “Tag1” เนื่องจากตัว “T” แตกต่างกัน เราขอแนะนำไม่ให้ใช้ tags หรือชื่อโหนดที่แตกต่างกันเพียงตัวพิมพ์ใหญ่หรือเล็กเท่านั้น

โหนดกระบวนการต่อเนื่อง 

• เมื่อโหนดมี tags ด้วยข้อมูลกระบวนการต่อเนื่อง สามารถเรียกได้ว่าเป็นโหนดกระบวนการ ภาพหน้าจอสองภาพต่อไปนี้แสดงตารางแสดงโหนดกระบวนการพร้อมข้อมูล ตามด้วยรูปภาพที่แสดงให้เห็นว่าโหนดมีลักษณะอย่างไรเมื่อเลือก tags ใน SIMCA-ออนไลน์

โหนดกระบวนการต่อเนื่องต้องไม่ขึ้นอยู่กับแบตช์ การทำงาน หรือเวลา

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

รหัสแบทช์ tag จำเป็นสำหรับโหนดกระบวนการต่อเนื่องสำหรับการดำเนินโครงการแบบแบตช์

• กระบวนการต่อเนื่องแต่ละอย่างจะต้องมี tag (ตัวแปร) ที่เก็บรหัสชุดสำหรับการสังเกตแต่ละครั้ง รหัสชุดนี้จะถูกใช้โดย SIMCA หรือ SIMCA-online เพื่อทราบว่าการสังเกตแต่ละครั้งอยู่ในชุดใด
• $BatchID คือ tag ในภาพหน้าจอใน 7.4.3 มีตัวอย่างดังกล่าวampเล.
  แม้ว่าจะไม่จำเป็น แต่ขอแนะนำให้มี tag ในโหนดกระบวนการที่แสดงเฟสหรือขั้นตอนปัจจุบันของกระบวนการนี้ tag สามารถนำไปใช้ในเงื่อนไขการดำเนินการเฟสใน SIMCA-online หรือใน SIMCA เมื่อนำเข้าข้อมูล ค่าสำหรับสิ่งนี้ tag สามารถเป็นได้สำหรับอดีตamp“ระยะที่ 1”, “การทำความสะอาด”, “ระยะที่ 2”

โหนดบริบทแบตช์

• โหนดแบตช์คือโหนดที่คอยติดตามแบตช์ ตัวระบุแบตช์ เวลาเริ่มต้น และเวลาสิ้นสุด โหนดนี้เป็นข้อกำหนดสำหรับการดำเนินโครงการแบตช์ใน SIMCA-online แหล่งข้อมูลสามารถมีโหนดแบตช์ได้มากกว่าหนึ่งโหนดซึ่งแสดงแบตช์ในรูปแบบต่างๆ ผู้ใช้เลือกโหนดแบตช์ที่จะใช้กับแอปพลิเคชันของตน ตัวอย่างนี้ample เปิดเผยชุดข้อมูลที่ครอบคลุมสองหน่วยที่แตกต่างกัน:
• /Factory1 – ชุดที่มีอายุการใช้งานรวมกันทั้งใน Unit1 และ Unit2
• /Factory1/Unit1 – ชุดที่มีอายุการใช้งานใน Unit1 เท่านั้น
• /Factory1/Unit2 – ชุดที่มีอายุการใช้งานใน Unit2 เท่านั้น
• หากคุณไม่มีโหนดแบตช์ในแหล่งข้อมูลของคุณ คุณสามารถใช้ Batch Context Generator ใน SIMCA-online ได้ ดูวิธีใช้ในตัว
• ข้อมูลแบทช์เสริม
• โหนดแบตช์สามารถมีข้อมูลแบตช์ได้เช่นกัน ซึ่งเป็นข้อมูลที่มีการสังเกตเพียงครั้งเดียวสำหรับแบตช์ทั้งหมด โปรดทราบว่า tags ไม่จำเป็นต้องอยู่ในโหนดที่มีฟังก์ชันการทำงานเต็มรูปแบบของโหนดแบตช์ด้วยข้อมูลแบตช์ เพียงแค่ SimApi รองรับการอ่านข้อมูลแบตช์ก็เพียงพอแล้ว tagsเรียนรู้เพิ่มเติมเกี่ยวกับข้อมูลชุดใน 7.6
• นี่คืออดีตample ของโหนดแบตช์:
• หมายเหตุ: ภาพหน้าจอด้านบนนี้ถ่ายมาจาก DBMaker ซึ่งรวมอยู่ใน SIMCA-online หากต้องการดูด้วยตนเองใน DBMaker ให้คลิก View ปุ่มข้อมูลบนฐานข้อมูล Bakers Yeast จะแสดงสองหน้าต่าง โดยหน้าต่างหนึ่งเป็นโหนดแบตช์ และอีกหน้าต่างหนึ่งเป็นข้อมูลกระบวนการ

ประเภทข้อมูล: ข้อมูลตัวเลข ข้อมูลข้อความ และข้อมูลที่ขาดหายไป

• สำหรับแต่ละ tagSimApi สามารถรองรับข้อมูลสามประเภท: ตัวเลข, tex, t และหายไป:
• ข้อมูลตัวเลขโดยทั่วไปเป็นค่าจริงของพารามิเตอร์กระบวนการ เช่นample 6.5123 SimApi สามารถจัดการค่าจุดลอยตัวความแม่นยำเดี่ยวขนาด 32 บิตได้เท่านั้น รูปแบบจุดลอยตัวความแม่นยำเดี่ยว -Wikipedia ประเภทข้อมูลตัวเลขอื่นๆ ทั้งหมดในแหล่งข้อมูลควรแปลงเป็น float ดังนั้น จึงสามารถจัดการทั้งค่าขนาดใหญ่และขนาดเล็กได้ แต่มีตัวเลขสำคัญเพียงประมาณ 6 หรือ 7 หลักเท่านั้น เรียนรู้เพิ่มเติมในคู่มือทางเทคนิค
• สิ่งนี้อาจนำไปสู่การสูญเสียความแม่นยำสำหรับจำนวนเต็มขนาดใหญ่หรือสำหรับจำนวนจริงที่มีขนาดใหญ่และมีทศนิยม สำหรับข้อมูลเพิ่มเติม โปรดดูคู่มือทางเทคนิค
• ข้อมูลข้อความ/สตริงใช้สำหรับ ID ชุด เงื่อนไขการดำเนินการตามเฟส หรือสำหรับตัวแปรเชิงคุณภาพ ค่าสำหรับข้อความ tag ข้อมูลจะแยกแยะตัวพิมพ์เล็ก-ใหญ่ ซึ่งหมายความว่าค่า “กำลังทำงาน” ไม่เหมือนกับ
  “กำลังดำเนินการ” ตัวแปร Datetime ไม่ได้รับการสนับสนุนโดยตรงจาก SimApi แต่สามารถส่งคืนเป็นสตริงที่มีรูปแบบเป็น YY-MM-DD HH:MM (ตัวอย่างเช่นample “2020-09-07 13:45”).
• ค่าที่หายไปหมายความว่าไม่มีค่าที่จะส่งคืน กล่าวคือ ไม่มีข้อมูล
• ประเภทข้อมูลที่ส่งคืนขึ้นอยู่กับการใช้งาน SimApi SimApi ทราบเกี่ยวกับข้อมูลในแหล่งข้อมูลและควรส่งคืนประเภทข้อมูลที่เหมาะสมที่สุด

โหมดการดึงข้อมูลสามโหมด: ต่อเนื่อง, Batc, h และไม่ต่อเนื่อง

• ข้อกำหนด SimApi กำหนดโหมดการดึงข้อมูลสามโหมด กล่าวคือ SimApi สามารถจัดเตรียมข้อมูลจากสามวิธีที่แตกต่างกัน tags ในแหล่งข้อมูล (หรือในทิศทางอื่น: เขียนข้อมูลไปที่ tags ในแหล่งข้อมูล)
• การดึงข้อมูลอย่างต่อเนื่อง หมายถึง การอ่านข้อมูลอย่างต่อเนื่องและต่อเนื่อง โดยสังเกตการสังเกตแต่ละครั้งตามชุดข้อมูลหรือกระบวนการที่พัฒนาไป ข้อมูลจะถูกอ่านในช่วงเวลาปัจจุบันหรือช่วงเฉพาะในช่วงเวลาที่สม่ำเสมอระหว่างการสังเกตแต่ละครั้ง ตัวอย่างเช่นampข้อมูลทั้งหมดระหว่างเวลา 09:00:00 น. ถึง 10:00:00 น.ampนำทุกๆ 60 วินาที ส่งผลให้มีการสังเกต 61 ครั้งเมื่อรวมจุดสิ้นสุดแล้ว
• การเรียกค้นข้อมูลแบบแบตช์ – หมายถึงการสังเกตครั้งเดียวที่มีข้อมูลสำหรับแบตช์ทั้งหมด (ไม่เกี่ยวข้องกับความครบถ้วนสมบูรณ์หรือจุดเวลาเฉพาะ) แอตทริบิวต์แบตช์และข้อมูลศูนย์กลางท้องถิ่นจะอ่านเป็นข้อมูลแบตช์ใน SIMCA-online โดยปกติแล้วเงื่อนไขแบตช์จะอ่านเป็นข้อมูลแบตช์ด้วยเช่นกัน (เว้นแต่จะกำหนดค่าให้เรียกค้นข้อมูลแบบแยกส่วน)
• การดึงข้อมูลแบบแยกส่วน – ข้อมูลแบบแยกส่วนอาจประกอบด้วยการสังเกตหลายรายการสำหรับช่วงครบกำหนดหลายช่วง แต่ต่างจากข้อมูลต่อเนื่อง ข้อมูลแบบแยกส่วนจะไม่ถูกอ่านตามลำดับ แต่จะถูกอ่านทั้งหมดในครั้งเดียวสำหรับช่วงเฉพาะของชุดข้อมูล ไม่จำเป็นต้องเว้นระยะข้อมูลด้วยช่วงเวลาปกติของตัวแปรช่วงครบกำหนด ข้อมูลทั้งหมดจะถูกอ่านซ้ำทุกครั้งที่มีการร้องขอข้อมูลในช่วงเวลาที่กำหนดไว้
• สำหรับสิ่งที่กำหนดไว้ tag สามารถขอข้อมูลได้ในโหมดใดโหมดหนึ่งจากสามโหมด แต่โดยทั่วไปแล้ว SimApi จะรองรับโหมดใดโหมดหนึ่งสำหรับแต่ละบุคคลเท่านั้น tag. เช่นเดียวกันก็สามารถผสมได้ tags ภายในโหนด แต่โดยทั่วไปทั้งหมด tags ภายในโหนดเฉพาะรองรับโหมดการดึงข้อมูลแบบเดียวกัน
• สำหรับข้อมูลต่อเนื่อง (แต่ไม่ใช่สำหรับข้อมูลแบบชุดหรือแบบแยกส่วน2) สามารถร้องขอข้อมูลปัจจุบันหรือข้อมูลในประวัติได้ ซึ่งเป็นหัวข้อของหัวข้อถัดไป
• SimApis ไม่รองรับโหมดทั้งหมด โปรดดูเมทริกซ์คุณสมบัติด้านบนและ SimApi web หน้าสำหรับรายละเอียด

ข้อมูลต่อเนื่องในปัจจุบันและประวัติศาสตร์ผ่าน SimApi

• ข้อมูลต่อเนื่องหมายถึงข้อมูลการประมวลผลที่เปลี่ยนแปลงไปตามกาลเวลา

ข้อมูลปัจจุบัน

• การอ่านข้อมูลปัจจุบันหมายถึงการขอค่าล่าสุดจากแหล่งที่มาของข้อมูล tags ณ เวลาที่ถาม โปรดทราบว่าที่นี่จะไม่ใช้เวลาของแหล่งข้อมูลภายนอก
• ข้อมูลที่อ่านเป็นข้อมูลปัจจุบันคือสิ่งที่ SIMCA-online จะแสดงเป็นข้อมูลสด ด้วยเหตุนี้ จึงมีความสำคัญที่จะต้องไม่มีการหน่วงเวลาที่ไม่จำเป็นในแหล่งข้อมูล ข้อมูลปัจจุบันควรเป็นข้อมูลล่าสุดที่สุดเท่าที่จะเป็นไปได้เพื่อให้ทำงานได้ดีใน SIMCA-online
• แหล่งข้อมูลอาจใช้ความรู้เกี่ยวกับข้อมูลและระยะเวลาที่ค่าต่างๆ ถูกต้อง และตัดสินใจส่งคืนข้อมูลที่ขาดหายไปเมื่อข้อมูลดิบสำหรับจุดเวลาหนึ่งเก่าเกินไป ตัวอย่างเช่นample: ข้อมูลถูกขอในเวลา 15:00:00 น. แต่จุดข้อมูลล่าสุดในแหล่งข้อมูลคือเวลา 03:00:00 น. ในกรณีนี้ ข้อมูลมีอายุ 12 ชั่วโมง ดังนั้น SimApi อาจตัดสินใจส่งคืนค่าที่ขาดหายไป (ไม่มีข้อมูล)

ข้อมูลทางประวัติศาสตร์

• การอ่านข้อมูลประวัติศาสตร์หมายถึงการขอค่าหนึ่งค่าหรือมากกว่าจากแหล่งที่มาของข้อมูล tags สำหรับช่วงเวลาเฉพาะที่มีระยะเวลาระหว่างการสังเกตที่เจาะจง โปรดทราบว่าที่นี่เป็นเวลาท้องถิ่นของแหล่งข้อมูลที่ใช้ค้นหาข้อมูล ดังนั้นการซิงโครไนซ์เวลาระหว่างแหล่งข้อมูลและเซิร์ฟเวอร์จึงมีความสำคัญ
• ข้อมูลประวัติประกอบด้วยเมทริกซ์ของข้อมูล ขึ้นอยู่กับการใช้งาน SimApi ที่จะร้องขอข้อมูลจากแหล่งที่มาของข้อมูล และampให้อยู่ในช่วงที่กำหนดและสร้างเมทริกซ์ของข้อมูลที่จะส่งคืน:
• บางครั้งแหล่งข้อมูลเองมีฟังก์ชันการรวมเพื่อส่งคืนข้อมูลที่ประมวลผลแล้วหรือampฟังก์ชั่น ling ที่สามารถใช้เพื่อส่งคืนข้อมูลที่ถูกต้องได้
• สำหรับแหล่งข้อมูลอื่น SimApi จะต้องร้องขอข้อมูลทั้งหมดในช่วงเวลาและจากนั้นampการสังเกตที่ถูกต้องจะสร้างเมทริกซ์
• ข้อมูลจะต้องส่งคืนสำหรับช่วงเวลา แม้ว่าอาจไม่มีข้อมูลดิบในช่วงเวลานั้น แต่ก่อนเวลาเริ่มต้นเท่านั้น ตัวอย่างเช่นample: ข้อมูลมีอยู่ในแหล่งข้อมูลที่จุดเวลา 10 และ 20 SimApi ขอข้อมูลสำหรับเวลา 15 และ 17 ในกรณีนี้ ค่าสำหรับจุดเวลา 10 ควรส่งคืนโดย SimApi แต่ timestampแก้ไขเป็นเวลา 15 และ 17 เนื่องจากเป็นข้อมูลล่าสุดในช่วงเวลาดังกล่าว ค่าสำหรับ tags ในเวลา 10 จะถูกอ้างถึงเป็นค่าขอบเขตสำหรับช่วงที่ร้องขอ สำหรับคำอธิบายที่ลึกซึ้งยิ่งขึ้นเกี่ยวกับค่าขอบเขต โปรดดูตัวอย่างampอ่านเอกสารประกอบสำหรับ returnBounds ที่ UA ตอนที่ 11: การเข้าถึงทางประวัติศาสตร์ – โครงสร้าง ReadRawModifiedDetails 6.4.3
  (opcfoundation.org)
• ไม่ควรใช้การสอดแทรกเพื่อคำนวณค่าสำหรับจุดเวลาในอนาคต เนื่องจากข้อมูลจะไม่ตรงกับข้อมูลที่อ่านได้แบบเรียลไทม์เป็นข้อมูลปัจจุบัน สำหรับตัวอย่างampจากหัวข้อก่อนหน้า: หากข้อมูลสำหรับ 15 และ 17 จะถูกแทรกโดยใช้ค่าสำหรับรายการ 10 และ 20 ก็จะใช้ค่าจากอนาคตอย่างมีประสิทธิภาพ ซึ่งไม่ได้รับอนุญาต
• แหล่งข้อมูลอาจใช้ความรู้เกี่ยวกับข้อมูลและระยะเวลาที่ค่าต่างๆ ถูกต้อง และตัดสินใจส่งคืนข้อมูลที่ขาดหายไปเมื่อข้อมูลดิบสำหรับจุดเวลาหนึ่งเก่าเกินไป ตัวอย่างเช่นample: ข้อมูลถูกขอในเวลา 15:00:00 น. แต่จุดข้อมูลล่าสุดในแหล่งข้อมูลคือเวลา 03:00:00 น. ในกรณีนี้ ข้อมูลมีอายุ 12 ชั่วโมง ดังนั้น SimApi อาจตัดสินใจส่งคืนค่าที่ขาดหายไป (ไม่มีข้อมูล)

บันทึก: โดยปกติแล้ว SIMCA-online จะไม่ร้องขอข้อมูลมากกว่า 100 รายการในหนึ่งการเรียกใช้ระหว่างการดำเนินโครงการปกติ เมื่อทำการแยกข้อมูลใน SIMCA-online หรือเมื่อใช้งาน SIMCA บนเดสก์ท็อป อาจมีการร้องขอข้อมูลจำนวนมาก ซึ่งอาจใช้เวลานาน ซึ่งเป็นเรื่องปกติ

ข้อมูลปัจจุบันและข้อมูลประวัติต้องตรงกัน

• บางครั้งอาจมีความแตกต่างกันเมื่อข้อมูลถูกอ่านเป็นข้อมูลปัจจุบันแบบเรียลไทม์หรือข้อมูลในอดีต ซึ่งทำให้เกิดปัญหาใน SIMCA-online เนื่องจากเซิร์ฟเวอร์จะสลับระหว่างข้อมูลปัจจุบันและข้อมูลในอดีตโดยอัตโนมัติตามความจำเป็น

การรวบรวมข้อมูลความหน่วงต่ำ

• เมื่อ SIMCA-online ใช้แหล่งข้อมูลแบบเรียลไทม์ สิ่งสำคัญคือข้อมูลในแหล่งข้อมูลจะต้องเป็นปัจจุบัน ไม่ควรเกิดความล่าช้าที่ไม่จำเป็นในการรวบรวมข้อมูลในแหล่งข้อมูล ข้อมูลกระบวนการต่อเนื่องสำหรับตัวแปรทั้งหมดจะต้องพร้อมใช้งานในเวลาเดียวกันสำหรับทุกการสังเกต ข้อมูลที่ส่งมาล่าช้าสำหรับตัวแปรบางตัวจะไม่ถูก SIMCA-online หยิบมาใช้

สามารถอ่านข้อมูลได้ตลอดเวลา 

• เมื่อ SIMCA-online ขอค่าของ tag สำหรับเวลา t เซิร์ฟเวอร์จะรับค่าจากแหล่งข้อมูลจากเวลา t หรือค่าการสังเกตล่าสุดในแหล่งข้อมูลก่อนเวลา t หรือค่าที่แทรกสำหรับเวลา t ดังนั้น เซิร์ฟเวอร์จะได้รับค่าเสมอทุกครั้งที่ขอ แม้ว่าการสังเกตสำหรับจุดเวลาที่แน่นอนนี้อาจไม่มีอยู่ในแหล่งข้อมูลก็ตาม
• เวลาampเวลาใน SimApi จะเป็น UTC เสมอ ไคลเอนต์ SIMCA-online และ SIMCA แสดงเวลาเป็นเวลาท้องถิ่น

การร้อยด้าย 

• โดยค่าเริ่มต้น ผู้ใช้ SimApi จะเรียกใช้งาน SimApi โดยเธรดเดี่ยว สิ่งนี้ใช้ได้กับ SIMCA ทุกเวอร์ชันและ SIMCA-online จนถึงเวอร์ชัน 17
• SIMCA-online 18 รองรับแฟล็กฟีเจอร์เพื่อเปิดการเข้าถึงแบบมัลติเธรดผ่าน SimApi อ่านเพิ่มเติมในหัวข้อวิธีใช้ การเข้าถึง SimApi พร้อมกัน
• ซึ่งหมายความว่า SimApis ควรเตรียมพร้อมสำหรับการทำงานแบบมัลติเธรด หากเป็นไปได้ โดยทำให้เธรดการใช้งาน SimApi ปลอดภัย และบันทึกข้อมูลนี้ รวมถึงข้อควรพิจารณาอื่นๆ สำหรับผู้ใช้ SimApi

บันทึก file

• SimApi ควรบันทึกการดำเนินการ ข้อความแสดงข้อผิดพลาด และคำเตือนลงในบันทึกของตน file เพื่อช่วยแก้ไขปัญหา ใช้ระดับการบันทึกที่แตกต่างกันเพื่อระบุความสำคัญของการบันทึก
• ขอแนะนำให้บันทึก "ไม่ได้ใช้งาน" สำหรับฟีเจอร์ที่ไม่ได้ใช้งานใน SimApi

การจัดการข้อผิดพลาด

• เมื่อ SimApi ไม่สามารถตอบสนองคำขอจากแหล่งข้อมูลได้ ก็จะสามารถจัดการปัญหานี้ได้ 2 วิธี คือ ส่งคืนค่าที่หายไป (ไม่มีข้อมูล) หรือส่งสัญญาณข้อผิดพลาดของ SimApi:
• การคืนค่าที่ขาดหายไปให้กับผู้เรียกและการส่งสัญญาณว่าสำเร็จจะทำให้ผู้เรียกสามารถดำเนินการต่อได้ตามปกติ (แต่แน่นอนว่าจะไม่มีข้อมูลใดๆ) นี่เป็นแนวทางปฏิบัติที่แนะนำสำหรับข้อผิดพลาดบางส่วน เช่น เมื่อสามารถรับข้อมูลได้บางส่วนแต่ไม่ใช่ทั้งหมด tags ในการร้องขอ
• การส่งสัญญาณข้อผิดพลาด SimApi ช่วยให้ผู้โทร (เช่นampเซิร์ฟเวอร์ SIMCA-online) เพื่อดูสิ่งนี้ทันทีและดำเนินการ นี่คือแนวทางปฏิบัติที่แนะนำสำหรับคำขอที่ล้มเหลวโดยสิ้นเชิงและไม่สามารถส่งคืนข้อมูลใดๆ ได้เลย
• SIMCA-online จัดการค่าที่ขาดหายไปหรือรหัสข้อผิดพลาดแตกต่างกันออกไป ดังที่อธิบายไว้ในคู่มือทางเทคนิคของ SIMCA-online

ข้อกำหนดด้านประสิทธิภาพของ SimApi

• ฟังก์ชั่นใน SimApi ใช้เพื่อรับข้อมูล
• หากการเข้าถึงข้อมูลช้า SimApi จะไม่ทำงานได้ดี ซึ่งตัวอย่างนี้ampแสดงให้เห็นว่า: หาก SIMCA-online ร้องขอข้อมูลทุก ๆ วินาที แต่ใช้เวลาถึงสองวินาทีในการรับข้อมูล เซิร์ฟเวอร์ SIMCA-online จะไม่สามารถตามทันแบบเรียลไทม์ได้ แต่จะยิ่งล้าหลังลงเรื่อย ๆ
• ในหัวข้อย่อย เราจะแสดงวิธีที่ SIMCA และ SIMCA-online ใช้ฟังก์ชัน SimApi สำหรับการเข้าถึงข้อมูล และความถี่ในการเรียกใช้ฟังก์ชัน SimApi ซึ่งจะช่วยในการกำหนดข้อกำหนดด้านประสิทธิภาพสำหรับการนำ SimApi ไปใช้งาน

การใช้งานฟังก์ชั่น SimApi ของ SIMCA

• เมื่อเดสก์ท็อป SIMCA หรือผลิตภัณฑ์ออฟไลน์อื่นใช้ SimApi เพื่อรับข้อมูล คำขอเหล่านี้จะใช้สำหรับชุดข้อมูลและประมวลผลข้อมูลสำหรับชุดตัวแปรในช่วงเวลาที่กำหนด
• เนื่องจากคำขอเหล่านี้เริ่มต้นโดยผู้ใช้ด้วยตนเอง จึงไม่ได้เกิดขึ้นบ่อยนักและไม่ก่อให้เกิดภาระหนักต่อแหล่งข้อมูล
• ฟังก์ชัน SimApi เหล่านี้ใช้เพื่อรับข้อมูล:
• simapi2_nodeรับแบตช์ที่ใช้งานอยู่
• simapi2_nodeรับเวลาแบตช์
• simapi2_connection อ่านข้อมูลประวัติย้อนหลัง

การใช้งานฟังก์ชั่น SimApi ของ SIMCA-online

• SIMCA-online ใช้สำหรับตรวจสอบกระบวนการแบบเรียลไทม์ ดังนั้นจึงร้องขอข้อมูลผ่าน SimApi เป็นระยะๆ ช่วงเวลาการดำเนินการที่สั้นที่สุดที่สามารถใช้ได้คือ 1 วินาที ตัวอย่างในโลกแห่งความเป็นจริงบางตัวอย่างampระยะเวลาในการดำเนินการคือ 10 วินาที 1 นาที หรือ 10 นาที
• เซิร์ฟเวอร์สามารถมีโปรเจ็กต์หลายรายการทำงานในเวลาเดียวกันได้
• เพื่อลดจำนวนการเรียก API ผ่าน SimApi เซิร์ฟเวอร์จะเพิ่มประสิทธิภาพการร้องขอข้อมูลโดยการจัดกลุ่มคำขอเล็ก ๆ ที่เกิดขึ้นพร้อมกันหลายรายการให้เป็นคำขอเดียวที่ใหญ่ขึ้นสำหรับตัวแปรทั้งหมดในเวลาเดียวกัน (เรียนรู้เพิ่มเติมในหัวข้อวิธีใช้ "การอ่านที่เพิ่มประสิทธิภาพจากแหล่งข้อมูลช่วยเพิ่มประสิทธิภาพ")
• อัลกอริทึมการดำเนินการของเซิร์ฟเวอร์ทำงานดังนี้เมื่อร้องขอข้อมูลโดยใช้ฟังก์ชั่น SimApi ที่แสดงไว้ด้านล่าง:
• เฟสทั้งหมดที่ดำเนินการในช่วงเวลาเดียวกันจะถูกจัดกลุ่มเป็นการเรียก SimApi ครั้งเดียวเพื่อลดจำนวนการเรียก เซิร์ฟเวอร์จะอ่านข้อมูลล่าสุดสำหรับตัวแปรทั้งหมดที่ใช้โดยโมเดลทั้งหมดที่แชร์ช่วงเวลาดังกล่าว กล่าวคือ การเรียกนี้จะส่งผลให้เกิดแถวข้อมูลกว้างๆ ซึ่งจะถูกใช้โดยโครงการทั้งหมด
  • simapi2_connection อ่านข้อมูลปัจจุบัน
• สำหรับโครงการแบบแบตช์แต่ละโครงการ เซิร์ฟเวอร์จะต้องทราบด้วยว่าแบตช์ใดทำงานอยู่ ซึ่งจะต้องเกิดขึ้นทุกครั้งที่มีการดำเนินการโครงการ:
  • simapi2_nodeรับแบตช์ที่ใช้งานอยู่
  • simapi2_nodeGetBatchTimes ถูกเรียกน้อยลง
• นอกจากนี้ SIMCA-online ยังต้องการข้อมูลประวัติด้วย คำขอดังกล่าวจะเกิดขึ้นเฉพาะเมื่อจำเป็น เช่น เพื่อติดตามช่วงเริ่มต้นของแบตช์ที่เริ่มต้นก่อนที่ SIMCA-online จะเริ่มต้น หรือเมื่อเซิร์ฟเวอร์ล้าหลังและจำเป็นต้องอ่านข้อมูลเป็นบล็อก:
  • simapi2_connection อ่านข้อมูลประวัติย้อนหลัง
• ทางเลือกในการกำหนดค่าโครงการบางอย่างใช้ฟีเจอร์ที่ใช้ข้อมูลชุดหรือข้อมูลแยกส่วนซึ่งส่งผลให้มีการเรียก SimApi ไปที่:
  • การเชื่อมต่อ simapi2 อ่านข้อมูลชุด
  • simapi2_connection อ่านข้อมูลแบบไม่ต่อเนื่อง
• ทางเลือกในการกำหนดค่าโครงการบางอย่างใช้การเขียนกลับเพื่อส่งข้อมูลกลับไปยังแหล่งที่มาของข้อมูล:
  • simapi2_connectionWriteHistoricalDataEx (และฟังก์ชันที่เกี่ยวข้องสำหรับข้อมูลแบตช์ ข้อมูลแยกส่วน)
• สิ่งสำคัญคือการเรียกใช้ฟังก์ชันหลักในการรับข้อมูล เช่น readCurrentData, getActiveBatches/getBatchTimes แต่ละครั้งจะต้องรวดเร็ว และไม่ใช่เรื่องยากสำหรับแหล่งข้อมูลเอง เนื่องจาก SIMCA-online เรียกใช้ฟังก์ชันเหล่านั้นบ่อยมาก

การทดสอบและตรวจสอบข้อมูล SimApi

• ส่วนนี้เกี่ยวกับการทดสอบ SimApi เพื่อตรวจสอบว่าข้อมูลที่ส่งกลับมาตรงกับข้อมูลในแหล่งข้อมูลหรือไม่ การรันการทดสอบในลักษณะนี้มีความสำคัญหลังจากการสร้างหรือเปลี่ยนแปลงการใช้งาน SimApi หรือเมื่อ API ของแหล่งข้อมูลมีการเปลี่ยนแปลง
• ในทางปฏิบัติ การตรวจสอบข้อมูลจะทำโดยใช้ SIMCA-online และฟังก์ชันการแยกข้อมูลเพื่อดึงข้อมูลจากแหล่งข้อมูลผ่าน SimApi จากนั้นจึงเปรียบเทียบกับข้อมูลดิบในแหล่งข้อมูล ไม่สามารถใช้ SIMCA บนเดสก์ท็อปเพื่อทดสอบคุณลักษณะแบบเรียลไทม์ของ SimApi ได้

การเตรียมพร้อมและความต้องการ

• บางรายการเป็นทางเลือก แต่สามารถดำเนินการได้หากขอบเขตการทดสอบของคุณรวมถึงรายการดังกล่าว:

1. ติดตั้ง SIMCA-online ตามคำอธิบายในไฟล์ ReadMe และ Installation Guide.pdf ที่อยู่ในไฟล์ zip ของผลิตภัณฑ์
2. รับใบอนุญาตสำหรับเซิร์ฟเวอร์ SIMCA-online และติดตั้ง SimApi จะไม่ทำงานหากไม่มีใบอนุญาต บทความฐานความรู้สำหรับ SIMCA-online จะแสดงวิธีการออกใบอนุญาตผลิตภัณฑ์ ตัวอย่างเช่นampเลอ: SIMCA ออนไลน์ 18 (sartorius.com)
3. ติดตั้งและกำหนดค่า SimApi ที่คุณต้องการทดสอบ ดูที่บทที่ 4 – 5 ในเอกสารนี้และคู่มือผู้ใช้ของ SimApi เฉพาะรุ่น
   • a. ทางเลือก: ตรวจสอบให้แน่ใจว่าคู่มือผู้ใช้เป็นปัจจุบันและถูกต้อง
4. ตรวจสอบให้แน่ใจว่าคุณมีเครื่องมือสำหรับแหล่งข้อมูลของคุณซึ่งคุณสามารถใช้เปรียบเทียบข้อมูล SimApi ได้
5. ในไคลเอนต์เดสก์ท็อป SIMCA-online ให้เข้าสู่ระบบเซิร์ฟเวอร์ SIMCA-online ของคุณและใช้ File > การแยกข้อมูลเพื่อรับข้อมูลผ่าน SimApi
6. ตัวเลือกหากขอบเขตการทดสอบของคุณมีสิ่งนี้: หลังจากเสร็จสิ้นการทดสอบ ให้ถอนการติดตั้ง SimApi และตรวจสอบ files จะถูกลบออก

สิ่งที่ต้องทดสอบ

• เมทริกซ์ฟีเจอร์ในบทที่ 3 แสดงรายการฟีเจอร์ที่เป็นไปได้ทั้งหมด แต่การใช้งาน SimApi ที่กำหนดอาจรองรับเพียงบางส่วนเท่านั้น คุณควรทดสอบฟีเจอร์ทั้งหมดที่ SimApi ที่กำหนดใช้งาน
• การทดสอบต่อไปนี้เป็นเรื่องปกติสำหรับการใช้งาน SimApi ส่วนใหญ่:
• การพิสูจน์ตัวตนด้วยชื่อผู้ใช้และรหัสผ่าน
• ทดสอบการตั้งค่าต่างๆ ในการกำหนดค่าของ SimApi
• ลำดับชั้นของโหนด: โหนดและ tags ที่เปิดเผยโดย SimApi นั้นถูกต้อง
  • จะต้องมี tag เปิดเผยสำหรับ "ตัวแปร" ทั้งหมดที่ควรพร้อมใช้งานผ่าน SimApiamples: การวัดกระบวนการ, ค่าที่คำนวณ, ค่าคงที่
• ความยืดหยุ่นของการเชื่อมต่อ: หากแหล่งข้อมูลไม่พร้อมใช้งาน จะส่งผลให้เกิดคำเตือนหรือข้อผิดพลาดในบันทึก fileแต่การเชื่อมต่อกับแหล่งข้อมูลจะถูกสร้างขึ้นใหม่โดยอัตโนมัติเมื่อแหล่งข้อมูลพร้อมใช้งาน
• หลายอินสแตนซ์: อินสแตนซ์สองตัวสามารถกำหนดค่าและใช้ได้อย่างอิสระและพร้อมกันโดยมีบันทึกแยกกัน files.
• ข้อมูลปัจจุบัน: ดึงข้อมูลปัจจุบันออกมา tagsตรวจสอบให้แน่ใจว่าข้อมูลเป็นค่าที่ทราบล่าสุดจากแหล่งข้อมูล หรือขาดหายไปเนื่องจากคุณภาพไม่ดี หรือเมื่อข้อมูลเก่าเกินไป
  • ดึงข้อมูลทุก ๆ 10 วินาที (หรือประมาณนั้น) เป็นเวลา XNUMX นาที
• ข้อมูลต่อเนื่องทางประวัติศาสตร์: ดึงข้อมูลทางประวัติศาสตร์สำหรับ tags.
  • ใช้ช่วงเวลาที่ตรงกับเวลาที่คุณดึงข้อมูลปัจจุบันออกมา ตรวจสอบว่าข้อมูลปัจจุบันตรงกับข้อมูลในอดีตและข้อมูลดิบในแหล่งข้อมูล
  • ลองช่วงเวลาและวินาทีที่แตกต่างกันampช่วงลิ่ง ตรวจสอบข้อมูลให้ตรงกับแหล่งที่มาของข้อมูล
  • ลองดึงข้อมูลทุกๆ 1 วินาที ซึ่งเป็นเวลาที่สั้นที่สุดเท่าที่จะเป็นไปได้ampช่วงหลิง
  • ลองหลายประเภท tags ในแหล่งข้อมูล (ตัวแปรกระบวนการ ฯลฯ) ตรวจสอบให้แน่ใจว่าข้อมูลตรงกัน
  • หมายเหตุ: SIMCA-online อาจแบ่งคำขอข้อมูลประวัติขนาดใหญ่รายการเดียวออกเป็นส่วนย่อยๆ หลายส่วน ซึ่งจะมองเห็นได้ในบันทึก SimApi
• ตรวจสอบว่า SimApi ทำงานกับข้อมูลข้อความ ข้อมูลตัวเลข และข้อมูลที่หายไป
• บันทึก SimApi file. ตรวจสอบว่าบันทึกมีรายการที่เหมาะสม
• โหนดแบตช์: คลิกขวาที่โหนดแล้วค้นหาแบตช์
  • ตรวจสอบชื่อชุดงาน เวลาเริ่มต้น และเวลาสิ้นสุดสำหรับชุดงาน
  • ลองใช้แบตช์ที่ใช้งานอยู่ในแหล่งข้อมูล ไม่ควรมีเวลาสิ้นสุดผ่าน SimApi
• ตัวระบุแบตช์โหนดกระบวนการ tagหาก SimApi มีฟังก์ชันโหนดแบตช์ (ดูหัวข้อก่อนหน้า) จะต้องมีตัวระบุแบตช์ด้วย tag ในโหนดข้อมูลกระบวนการจับคู่ ข้อมูลสำหรับสิ่งนี้ tag ควรเป็นตัวระบุแบตช์ (ชื่อแบตช์) ข้อมูลนี้จำเป็นสำหรับโครงการแบตช์เพื่อระบุว่าแถวข้อมูลนั้นอยู่ในแบตช์ใด

ขึ้นอยู่กับว่า SimApi รองรับหรือไม่ คุณอาจต้องการทดสอบสิ่งต่อไปนี้:

• การใช้ข้อมูลชุด File > สกัด
• การใช้ข้อมูลแบบแยกส่วน File > สกัด หมายเหตุ: เพื่อทดสอบข้อมูลแยกส่วนด้วย File > แยกโหนด โหนดแบตช์และโหนดข้อมูลแยกส่วนต้องอยู่ใน SimApi เดียวกัน (เมื่อ SIMCA-online ดำเนินการโครงการ สามารถมาจาก SimApis ที่แตกต่างกันได้)
• เขียนกลับ – ส่งข้อมูลชุดหนึ่งไปยังแหล่งข้อมูล หากต้องการทดสอบสิ่งนี้ คุณต้องกำหนดค่าคอนฟิกูเรชันโครงการใน SIMCA-online เพื่อเขียนเวกเตอร์ข้อมูลกลับไปยังแหล่งข้อมูล จากนั้นดำเนินการโครงการใน SIMCA-online และตรวจสอบข้อมูลที่เขียนกลับในแหล่งข้อมูล
• ข้อมูลต่อเนื่องได้รับการกำหนดค่าบนหน้า Evolution Write Back ในการกำหนดค่าโครงการ
• ข้อมูลแบบแยกส่วนได้รับการกำหนดค่าบนหน้าเดียวกัน แต่เฉพาะสำหรับเฟสที่กำหนดค่าไว้สำหรับการดึงข้อมูลแบบแยกส่วนเท่านั้น
• ข้อมูลชุดจากการเขียนชุดกลับ

ข้อมูลเพิ่มเติม

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 อูเมโอ สวีเดน
• โทรศัพท์: + 46 90-18 48 00
• www.sartorius.com
• ข้อมูลและตัวเลขที่มีอยู่ในคำแนะนำเหล่านี้สอดคล้องกับวันที่ของเวอร์ชันที่ระบุด้านล่าง
• ซาร์โทเรียสขอสงวนสิทธิ์ในการเปลี่ยนแปลงเทคโนโลยี คุณสมบัติ ข้อมูลจำเพาะ และการออกแบบอุปกรณ์โดยไม่ต้องแจ้งให้ทราบล่วงหน้า แบบฟอร์มเพศชายหรือเพศหญิงใช้เพื่ออำนวยความสะดวกในการอ่านคำแนะนำเหล่านี้ และแสดงถึงเพศทั้งหมดพร้อมกันเสมอ
  ประกาศเกี่ยวกับลิขสิทธิ์:
• คำแนะนำเหล่านี้ รวมถึงส่วนประกอบทั้งหมด ได้รับการคุ้มครองโดยลิขสิทธิ์
• ห้ามใช้เกินขอบเขตของกฎหมายลิขสิทธิ์โดยไม่ได้รับการอนุมัติจากเรา
• สิ่งนี้ใช้โดยเฉพาะกับการพิมพ์ซ้ำ การแปล และการแก้ไข โดยไม่คำนึงถึงประเภทของสื่อที่ใช้

คำถามที่พบบ่อย

• ถาม: จุดประสงค์ของ SimApis คืออะไร?
  • ตอบ: วัตถุประสงค์หลักของ SimApis คือการจัดเตรียมข้อมูลให้กับผลิตภัณฑ์ Umetrics Suite สำหรับการสร้างโครงการและการสร้างแบบจำลอง
• ถาม: ฉันจะแก้ไขปัญหาเกี่ยวกับการติดตั้ง SimApi ได้อย่างไร
  • A: คุณสามารถแก้ไขปัญหาได้โดยการทดสอบจาก SIMCA-online โดยตรวจสอบบันทึก SimApi fileและการตรวจสอบให้แน่ใจว่ามีการกำหนดค่าบัญชีบริการที่ถูกต้อง

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

ซอฟต์แวร์ SARTORIUS Sim Api [พีดีเอฟ] คู่มือการใช้งาน ซอฟต์แวร์ Sim Api, ซอฟต์แวร์ Api, ซอฟต์แวร์

อ้างอิง

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