Welcome !

ยินดีต้อนรับสู่ iCube Learning แหล่งรวบรวมวิธีการใช้งานแพลตฟอร์มและ Use Case ในการใช้งานจริง ในรูปแบบต่างๆ ในโรงงานอุตสาหกรรม เพื่อให้ทุกท่านได้เข้าถึงวิธีใหม่ๆ ในการจัดการข้อมูลด้วยตัวเอง และนำไปสู่การเป็น Data-Driven Manufacturing อย่างแท้จริง

iCube Platform Ecosystem

iCube Contents

Website & Facebook

E-Learning & Online Contents

iCube Contacts

Address: 110/1 อาคารเคเอกซ์ ชั้นที่ 12 ห้องเลขที่ 1225 ถนนกรุงธนบุรี แขวงบางลำภูล่าง เขตคลองสาน กรุงเทพมหานคร 10600

Email: support@icube.co.th

Tel: 065-198-2415

iCube Server Overall : หน้าหลักสำหรับการมอนิเตอร์สถานะการทำงานของ Service ต่าง ๆ บนแพลตฟอร์ม iCube โดยจะแสดงข้อมูลสำคัญที่เกี่ยวข้องกับประสิทธิภาพและการทำงานของแต่ละบริการ ประกอบด้วยหัวข้อหลัก 3 รายการ ได้แก่

Value & Value Relation editor : หน้าต่างสำหรับช้แสดงข้อมูลที่ถูกจัดเก็บใน Tag และ TagRelation โดยข้อมูลที่แสดงนั้นจะอ้างอิงจากค่าที่ถูกเก็บในระบบ โดยมีวิธีการจัดการแท็กแบ่งออกเป็น 4 ส่วน ได้แก่

iCube Server : แพลตฟอร์มที่ใช้สำหรับจัดการข้อมูล ผู้ใช้งาน และการบริการ (Service) ต่าง ๆ ของระบบ iCube Platform โดยมีการเชื่อมต่อและประสานการทำงานระหว่างฟีเจอร์ต่าง ๆ ภายในแพลตฟอร์มเพื่อให้ผู้ใช้งานสามารถบริหารจัดการข้อมูลและทรัพยากรได้อย่างมีประสิทธิภาพ

What to read next

การเพิ่มข้อมูลมี 4 ขั้นตอน ดังนี้

1. Select : Tag/TagRelation ที่ต้องการเพิ่มข้อมูล

1. Click : คลิกปุ่มเพิ่ม Value (+ Value)

การเพิ่มข้อมูลมี 2 แบบ ได้แก่

2.1 Add Value เเบบ Single : กรอกข้อมูลเเละเลือกช่วงเวลาที่ต้องการให้ข้อมูลเเสดง

2.2 Add Value เเบบ Multiple : การเพิ่มข้อมูลผ่านไฟล์ .CSV สามารถใช้งานได้เฉพาะกับ TagRelation เท่านั้น

2.2.1 จัดเตรียมไฟล์ .CSV ที่มีหัวคอลัมน์เป็นแบบเดียวกับแท็ก/แท็กรีเรชัน หรือดาวน์โหลด Template เพื่อเติมข้อมูล

2.2.2 หลังจากแนบไฟล์ข้อมูลจะแสดงตัวอย่างข้อมูลก่อนอัพโหลด

1. Save / Upload : กดปุ่ม Save หรือ Upload เมื่อจัดเตรียมข้อมูลเรียบร้อย

iCube (Industrial Informatics & Intelligent Systems) คือ บริษัทที่ให้บริการแพลตฟอร์มการบริหารจัดการข้อมูลสำหรับโรงงานอุตสาหกรรม (Plant Information Management System, PIMS) โดยแพลตฟอร์มที่จะเข้ามาช่วยแก้ไขปัญหาการทำงานซ้ำซ้อนของพนักงานในโรงงาน ไม่ว่าจะเป็นการกรอกข้อมูล, การจัดการข้อมูล และการบริหารข้อมูลในโรงงาน ทำให้การทำงานมีประสิทธิภาพมากยิ่งขึ้น ทั้งนี้แพลตฟอร์มถูกดีไซต์บนคอนเซ็ปต์ Automation as a Service (AaaS) ที่ให้บริการเซอร์วิสผ่านดาต้าแพลตฟอร์มหรือ iCube Server ทำให้ผู้ใช้บริการสามารถเลือกรับบริการตามความต้องการได้อย่างอิสระ ตอบสนองความต้องการของผู้ใช้บริการงานได้อย่างเหมาะสมที่สุด

แพลตฟอร์มไอคิวบ์ เป็น แพลตฟอร์มการบริหารและจัดการข้อมูลกระบวนการผลิต (Plant Information Management System, PIMS) โดยออกแบบบนแนวคิดที่ต้องการนำข้อมูลในโรงงานทั้งโรงงานมาไว้บนสมาร์ทดีไวซ์ เพื่อให้งานต่อการเข้าถึงข้อมูล, จัดการข้อมูล และบริหารข้อมูลอย่างทันท่วงที รวมถึงการเชื่อมต่อข้อมูลกับแพลตฟอร์มอื่นๆ ได้อย่างง่ายดาย

หากต้องการรู้ว่า iCube คืออะไร

หากต้องการเริ่มต้นใช้งาน

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

1. Start Time (เวลาเริ่มต้น)

2. End Time (เวลาสิ้นสุด)

โดยสามารถดูไวยกรณ์การกำหนดเวลาได้ดังนี้

การใช้เครื่องหมาย

• วันเวลาปัจจุบัน ใช้เครื่องหมายดอกจัน (*)

• เวลาก่อนหน้า ใช้เครื่องหมายลบ (-)

• เวลาหลังจาก ใ ช้เครื่องหมายบวก (+)

การใช้คำย่อ

• หน่วย วินาที (sec)

• หน่วย นาที (m)

• หน่วย ชั่วโมง (h)

• หน่วย วัน (d)

• หน่วย เดือน (mo)

• หน่วย ปี (y)

การเรียกใช้ข้อมูลมี 3 ขั้นตอน ได้แก่

1. Select : เลือก Tag/TagRelation ที่ต้องการเรียกดูข้อมูล

1. Time Range : กำหนดค่าเวลาเริ่มต้นและเวลาสิ้นสุด การใช้งานมี 2 รูปแบบ โดยการปิด/เปิด Toggle ได้แก่

   2.1 Time Expression : ค่าเริ่มต้นของเวลาเริ่มต้นคือ *-10m หรือ เวลาย้อนหลังไป 10 นาที จากเวลาปัจจุบัน และเวลาสิ้นสุด คือ * หรือ เวลา ณ ปัจจุบัน

2.2 Date time : การใช้งานพิมพ์ช่วงเวลาหรือกดที่ไอคอนปฏิธินเพื่อเลือกช่วงเวลาในการเรียกดูข้อมูล

1. Historical Value : การกำหนดจำนวนเเถวของข้อมูลที่ต้องการเเสดง

Tag Configuration : การกำหนดคุณสมบัติและจัดการแท็กที่ใช้ในการระบุและจัดประเภทข้อมูล หรือวัตถุต่าง ๆ ภายในระบบเพื่อให้สามารถค้นหาและจัดการได้ง่ายขึ้น

Function

การลบข้อมูลมี 3 ขั้นตอน ดังนี้

1. Select : เลือก Tag/TagRelation ที่ต้องการลบข้อมูล

1. Click : คลิกข้อมูลที่ต้องการลบ

1. Delete : คลิกปุ่ม Delete เพื่อลบ

1. Preview: หลังจากกดปุ่ม Delete ระบบจะแสดงหน้า Preview เพื่อแสดงข้อมูลที่กำลังจะถูกลบ ให้ผู้ใช้ตรวจสอบรายละเอียดก่อนยืนยันการลบข้อมูล

1. Confirm : ยืนยันการลบข้อมูล

การสร้างแท็กมี 3 ขั้นตอน ดังนี้

1. Click : คลิกปุ่มเพิ่ม Tag (+ Tag) เพื่อเปิดเมนูสำหรับสร้างแท็กใหม่

1. Information : กรอกรายละเอียดของแท็ก

ข้อกำหนดเเละรายละเอียด

• Tagname : ชื่อแท็กต้องมีตัวอักษรเกินกว่า 3 ตัว แต่ไม่เกิน 50 ตัวและไม่สามารถใช้ชื่อซ้ำได้

• Description : ไม่บังคับว่าต้องกำหนดหรือถ้ากำหนดต้องมีตัวอักษรไม่เกิน 100 ตัว

• Sub-Description : ไม่บังคับว่าต้องกำหนด ใช้สำหรับนำไปใช้ระบุประเภทหรือคุณลักษณะของข้อมูลสำหรับการใช้งาน

• Tag source : ตัวกำหนดลักษณะการเก็บข้อมูลของแท็ก

  • Normal Tag (แท็กปกติ) : แท็กที่ใช้สำหรับเก็บข้อมูล ไม่ว่าจะเป็นข้อมูลที่รับมาจากแพลตฟอร์มภายนอก หรือข้อมูลจากเซอร์วิสอื่นๆ ของแพลตฟอร์ม iCube ที่นำมาเก็บไว้ในแท็ก

• Tag type : ตัวกำหนดประเภทข้อมูลที่จัดเก็บภายในแท็ก

• Eng. unit : กำหนดหน่วยทางวิศวกรรม

• Tag Mode : โหมดในการเก็บข้อมูลของแท็ก ประกอบด้วยกัน 2 ประเภท ได้แก่

Default mode (เริ่มต้น) : โหมดเริ่มต้นเป็นโหมดการเก็บข้อมูลที่รอรับข้อมูลอย่างเดียว

Condition mode (เงื่อนไข) : โหมดเงื่อนไขเป็นโหมดการเก็บข้อมูลที่ทำการเช็คเงื่อนไขข้อมูลก่อนจะทำการเก็บข้อมูล

ข้อกำหนดเเละการตั้งเงื่อนไขตาม Tag type

1. Save : คลิกปุ่ม Save เพื่อสร้างแท็ก

Tag : ชื่อแท็กสำหรับการการเก็บข้อมูล เหมาะสำหรับการเก็บข้อมูลของเครื่องจักร, Sensor ต่างๆ และอื่นๆ ที่มีการส่งข้อมูลออกมา 1 รายการ พร้อมทั้งคุณภาพ สถานะ และเวลาของข้อมูลที่เกิดขึ้น

Attribute

การแก้ไขแท็กมี 3 ขั้นตอน ดังนี้

1. Select : เลือก Tag ที่ต้องการแก้ไข

1. Edit : แก้ไขรายละเอียดของแท็ก

1. Save : คลิกปุ่ม Save เพื่อบันทึกการแก้ไข

การลบแท็กมี 2 ขั้นตอน ดังนี้

1. Select : เลือก Tag ที่ต้องการลบ

1. Delete : คลิกปุ่ม Delete

1. Confirm : คลิกปุ่ม Delete อีกครั้งเพื่อยืนยัน

การลบกลุ่ม TagRelation มี 2 ขั้นตอน ดังนี้

1. Select : เลือก TagRelation ที่ต้องการลบ

1. Delete : คลิกปุ่ม Delete

1. Confirm : คลิกปุ่ม Delete อีกครั้งเพื่อยืนยัน

ฟังก์ชันแท็ก คือ ฟังก์ชันหลักสำหรับการสร้างแหล่งเก็บข้อมูล โดยในฟังก์ชันแท็กเองจะแบ่งออกเป็น 2 ส่วน ได้แก่

1. Tag : ใช้สำหรับเก็บข้อมูลจุดต่อจุด

1. TagRelation : ใช้สำหรับการเก็บข้อมูลจากหลาย ๆ คอลัมน์แล้วนำมารวบรวมเป็นชุดข้อมูล

Tag Relation Configuration : การกำหนดคุณสมบัติและจัดการแท็กที่ใช้ในการระบุและจัดประเภทข้อมูลหรือวัตถุต่าง ๆ ภายในระบบที่สามารถจัดเก็บข้อมูลได้มากกว่า 1 รายการ

Function

Interface Configuration : การเชื่อมต่อที่ใช้ในการสื่อสารและทำงานกับระบบหรือโปรแกรม ทำหน้าที่เป็นตัวกลางที่ช่วยให้ผู้ใช้สามารถเข้าถึงและโต้ตอบกับข้อมูลจากแหล่งต่าง ๆ ได้

Function

การสร้างสร้าง TagRelation มี 3 ขั้นตอน ดังนี้

1. Click : คลิกปุ่มเพิ่ม TagRelation (+ TagRelation) เพื่อเปิดเมนูสำหรับสร้างแท็กรีเลชั่นใหม่

1. Information : กรอกรายละเอียดของ TagRelation ให้ครบถ้วน

ข้อกำหนดเเละรายละเอียด

• Relation name : ชื่อ TagRelation ต้องมีตัวอักษรเกินกว่า 3 ตัว แต่ไม่เกิน 50 ตัว ไม่สามารถเว้นว่างได้และไม่สามารถใช้ชื่อซ้ำได้

• Description : ไม่บังคับว่าต้องกำหนดหรือถ้ากำหนดต้องมีตัวอักษรไม่เกิน 100 ตัว

• Table type :

  • Table : การสร้าง TagRelation ให้จัดเก็บข้อมูลในรูปแบบตารางมีการกำหนดคอลัมน์ เพื่อเก็บข้อมูลในรูปแบบต่าง ๆ

  • View : การเขียน Query เพื่อจัดการข้อมูลจากรูปแบบ Table ให้พร้อมก่อนนำไปใช้งาน โดยใช้ภาษา PostgreSQL

• Data type : รูปการการจัดเก็บข้อมูลของ TagRelation

  • Non-time series : การจัดเก็บข้อมูลที่ไม่ได้ถูกจัดเก็บหรือวิเคราะห์ตามลำดับของเวลา ไม่จำเป็นต้องอ้างอิงหรือผูกกับช่วงเวลาในการบันทึกข้อมูล ทำให้ไม่ต้องคำนึงถึงลำดับเวลาของเหตุการณ์หรือค่าต่าง ๆ

  • Time series : การจัดเก็บข้อมูลที่เกิดขึ้นตามช่วงเวลาที่กำหนด โดยมีลักษณะเป็นข้อมูลที่ถูกบันทึกหรือวัดผลซ้ำ ๆ ในช่วงเวลาที่แตกต่างกัน ซึ่งข้อมูลเหล่านี้จะถูกจัดเรียงตามลำดับเวลาอย่างต่อเนื่อง

Field TagRelation

• Name : ชื่อของคอลัมน์ที่ใช้สำหรับจัดเก็บข้อมูล

• Data Type : ตัวกำหนดประเภทของข้อมูลที่จัดเก็บภายในคอลัมน์

• Not NULL : กำหนดให้คอลัมน์ต้องมีข้อมูล ไม่สามารถปล่อยให้ว่างได้

• Identity : กำหนดให้คอลัมน์สามารถระบุเป็นคีย์หลัก (Primary Key) สำหรับ TagRelation

1. Save : คลิกปุ่ม Save เพื่อสร้าง TagRelation

การแก้ไข Interface มี 4 ขั้นตอน ดังนี้

1. Select : เลือก Interface ที่ต้องการแก้ไข

1. Information : ทำการแก้ไข Interface

1. Check Status : กดปุ่ม Check Status เพื่อตรวจสอบการเชื่อมต่อ

2. Save : กดปุ่ม Save เพื่อบันทึกการแก้ไข

การแก้ไข TagRelation มี 3 ขั้นตอน ได้แก่

1. Select : เลือกข้อมูล TagRelation ที่ต้องการแก้ไข

1. Information : แก้ไขรายละเอียดของ TagRelation

1. Save : คลิกปุ่ม Save เพื่อบันทึกการแก้ไข

Mapping : การตั้งค่าการแมป (Mapping) เพื่อกำหนดฟิลด์ข้อมูลหรือแท็กจากระบบหนึ่งไปยัง iCube Server โดยใช้ Interface ในการเชื่อมต่อกับแหล่งข้อมูล ซึ่งช่วยให้ข้อมูลสามารถถูกรวบรวมและประมวลผลได้อย่างถูกต้องและมีประสิทธิภาพในการจัดการข้อมูลระหว่างระบบต่าง ๆ

Function

การสร้าง Interface มี 3 ขั้นตอน ดังนี้

1. Click : กดปุ่มเพิ่ม Interface ( + Interface )

1. Interface name : กรอกชื่อ Interface name

1. Select : เลือก Interface type มี 5 รูปเเบบ

1. Information : กรอกข้อมูลการเชื่อมต่อและทดสอบการเชื่อมต่อ โดยกดปุ่ม Check Status

1. Save : กด Save เพื่อบันทึกการเชื่อมต่อ

การลบ Interface มี 3 ขั้นตอน ดังนี้

1. Select : เลือก Interface ที่ต้องการลบ

1. Information : เมื่อกดเลือก จะมีการแสดงรายละเอียดของ Interface และสามารถกดปุ่ม Delete

1. Confirm : กดปุ่ม Delete อีกครั้งเพื่อยืนยันการลบ Interface ที่เลือก

Provider : การเปิดปิด Tag/TagRelation ในระบบที่สามารถเรียกใช้งานผ่าน RESTful API เพื่อให้บริการข้อมูลกับผู้ใช้

Tag Provider

TagRelation Provider

Usage

การปรับ Toggle เพื่อเปิดปิด การใช้งานผ่าน RESTful API

• Active : เปิดการใช้งานผ่าน RESTful API

• Inactive : ปิดการใช้งานผ่าน RESTful API

• Active / Inactive All : เปิดการใช้งานผ่าน RESTful API ทั้งหมดที่มีใน iCube Server 1. Click : กดปุ่ม Status 2. Select : เลือก Status ที่ต้องการตั้งค่า 3. Submit : กดปุ่ม Submit เพื่อบันทึกการตั้งค่า

การสร้าง Mapping มี 3 ขั้นตอน ดังนี้

1. Click : กดสร้าง Mapping (+ Mapping)

1. Information : ตั้งชื่อ Mapping เเละ เลือก Interface โดยการ Mapping จะเเตกต่างกันไปตามประเภทของ Interface

1. Validate : คลิกปุ่ม Check Status ที่หัวข้อ Validate Execution

1. Save : กดปุ่ม Save เพื่อบันทึกการสร้าง Mapping

Example URL

https://api.icube.co.th/integration/webapi

Last Update: 1 NOV 2024

Get Base URL Information

Method: GET

URL: {{base_url}}

Response Example:

{
    "data": {
        "tag": "string"
    }
}

Response Details:

การแก้ไขข้อมูลมี 4 ขั้นตอน ดังนี้

1. Select : เลือก Tag/TagRelation ที่ต้องการแก้ไขข้อมูล

1. Click : เลือกข้อมูลที่ต้องการแก้ไขและเลื่อนไปด้านขวา กดไอคอนปากกาเพื่อแก้ไข

1. Edit : แก้ไขข้อมูล โดยการแก้ไขมี 2 ลักษณะได้แก่

   3.1 Text box : ช่องสำหรับการกรอกข้อมูล

   3.2 Selection Box : ช่องสำหรับเลือกข้อมูล

1. Save : คลิกปุ่มเครื่องหมายถูก (Save) หลังจากเเก้ไขเสร็จสิ้น

การแก้ไข Mapping มี 4 ขั้นตอน ดังนี้

1. Select : เลือก Mapping ที่ต้องการแก้ไข

1. Information : ทำการแก้ไข Mapping

1. Validate : คลิกปุ่ม Check Status ที่หัวข้อ Validate Execution

1. Save : กดปุ่ม Save เพื่อบันทึกการแก้ไข

Example URL

https://api.icube.co.th/integration/webapi/connect

Last Update: 7 NOV 2024

Connect

Method: GET

URL: {{base_url}}/connect

Response Example:

{
    "result": bool
}

Response Details:

Example URL

https://api.icube.co.th/integration/webapi/tagrelation

Last Update: 7 NOV 2024

Retrieve Tag Relations

Method: GET

URL: {{base_url}}/tagrelation

Response Example:

{
    "result": [
        {
            "tagRelationName": "string",
            "server": "string",
            "description": "string",
            "createAt": "datetime",
            "updateAt": "datetime or null",
            "deleteAt": "datetime or null",
            "enableHyperTable": bool,
            "isView": bool
        }
    ]
}

Response Details:

การลบ Mapping มี 3 ขั้นตอน ดังนี้

1. Select : เลือก Mapping ที่ต้องการลบ

1. Information : เมื่อกดเลือก จะมีการแสดงรายละเอียดของ Mapping และกดปุ่ม Delete

1. Confirm : กดปุ่ม Delete อีกครั้งเพื่อยืนยันการลบ Mapping ที่เลือก

Example URL

https://api.icube.co.th/integration/webapi/tagrelation/bronze_relation_raw/value?starttime=*-10d&endtime=*&query=name like 'K%'

Last Update: 5 NOV 2024

Retrieve Tag Relation Value with Conditions

Method: GET

URL: {{base_url}}/tagrelation/{tagrelationname}/value?starttime={starttime}&endtime={endtime}&query={query}

Query Parameters:

Time Expression:

Response Example:

{
    "data": [
        {
            "Id": "string",
            "name": "string",
            "tel": "string",
            "quality": integer,
            "status": integer,
            "timeStamp": "datetime"
        }
    ]
}

Note: The fields Id, name, and tel are placeholders and will vary depending on the specific tag relation being represented in the request. Ensure you refer to the specific tag relation schema for exact field details.

Response Details:

Example URL

https://api.icube.co.th/integration/webapi/tag/B15-Status

Last Update: 1 NOV 2024

Retrieve Tag Information

Method: GET

URL: {{base_url}}/tag/{tagname}

Response Example:

{
    "data": [
        {
            "tagname": "string",
            "server": "string",
            "description": "string or null",
            "subDescription": "string or null",
            "tagType": "string",
            "tagSource": "string",
            "tagMode": "string",
            "unit": "string",
            "timeStamp": "datetime",
            "value": "string"
        }
    ]
}

Response Details:

What is Integration?

Integration: ฟังก์ชันที่มีหน้าที่ในการเชื่อมต่อกับแพลตฟอร์มอื่น ๆ ผ่าน RESTful API โดยสามารถดึงข้อมูลและทราบรายละเอียดต่าง ๆ ที่เกี่ยวข้องจากระบบภายนอกได้อย่างมีประสิทธิภาพ

Tag/ Tag Relation Provider

Publisher

Function

Example URL

https://api.icube.co.th/integration/webapi/tagrelation/value?mode=read

Last Update: 7 NOV 2024

Retrieve Tag Relation Values

Method: POST

URL: {{base_url}}/tagrelation/value?mode=read

Query Parameters:

Request Body:

Time Expression:

Example Request Body:

{
    "tagrelations": "tagrelationname,tagrelationname",
    "starttime": "*-10y",
    "endtime": "*",
    "statusData": 9
}

Response Example:

{
    "data": [
        {
            "tagRelationName": "string",
            "Id": "string",
            "name": "string",
            "tel": "string",
            "quality": integer,
            "status": integer,
            "timeStamp": "datetime"
        }
    ]
}

Note: The fields Id, name, and tel are placeholders and will vary depending on the specific tag relation being represented in the request. Ensure you refer to the specific tag relation schema for exact field details.

Response Details:

Value editor

Value editor : หน้าต่างสำหรับแสดงและจัดการข้อมูลที่เก็บอยู่ในแท็ก โดยมีคุณสมบัติของข้อมูลประกอบด้วย

• Tag : ชื่อแท็กที่ใช้สำหรับจัดเก็บข้อมูล

• Query time : ช่วงเวลาในการอ่านข้อมูลมาเเสดงผล

• Value : ค่าที่จัดเก็บอยู่ในแท็ก โดยจัดเก็บในรูปแบบ Time Series

• Tag Type : ประเภทของข้อมูลที่จัดเก็บในแท็ก

• Timestamp : ช่วงเวลาของข้อมูลที่บันทึกเข้าระบบ

• Quality : คุณภาพของข้อมูลที่เกิดจากการกระทำกับข้อมูล

• Status : สถานะที่ใช้แบ่งประเภทของข้อมูล

Value Relation editor

Value Relation editor : หน้าต่างสำหรับแสดงและจัดการข้อมูลที่เก็บอยู่ในแท็กรีเลชัน โดยมีคุณสมบัติของข้อมูลประกอบด้วย

• TagRelation : ชื่อแท็กรีเลชันที่ใช้สำหรับจัดเก็บข้อมูล

• Table Type : ประเภทของแท็กรีเลชันที่เกิดจากการเก็บข้อมูลโดยตรงหรือแท็กรีเลชันที่เกิดจากการเขียน Query ในการแสดงผล

• Data Type : รูปแบบการจัดการข้อมูลของแท็กรีเลชัน

• Query time : ช่วงเวลาในการอ่านข้อมูลมาเเสดงผล

• Identity : คอลัมน์ที่จัดเก็บข้อมูล ใช้ระบุเป็นคีย์สำหรับการจัดการข้อมูลร่วมกับ Timestamp

• Field : คอลัมน์ที่จัดเก็บข้อมูลที่ไม่มีผลต่อการจัดการข้อมูล

• Timestamp : ช่วงเวลาของข้อมูลที่บันทึกเข้าระบบ

• Quality : คุณภาพของข้อมูลที่เกิดจากการกระทำกับข้อมูล

• Status : สถานะที่ใช้แบ่งประเภทของข้อมูล

Function

Example URL

https://api.icube.co.th/integration/webapi/tag

Last Update: 1 NOV 2024

Retrieve Tag List

Method: GET

URL: {{base_url}}/tag

Response Example:

{
    "data": [
        {
            "tagname": "string",
            "server": "string",
            "description": "string or null",
            "subDescription": "string or null",
            "tagType": "string",
            "tagSource": "string",
            "tagMode": "string",
            "unit": "string",
            "timeStamp": "datetime",
            "value": "string"
        }
    ]
}

Response Details:

Example URL

https://api.icube.co.th/integration/webapi/tag/value?mode=write

Last Update: 1 NOV 2024

Add Tag Values

Method: POST

URL: {{base_url}}/tag/value?mode=write

Query Parameters:

Request Body:

The request body must be an array of tag value objects, each containing the following parameters:

Value Data Types:

Example Request Body:

[
    {
        "TagName": "string",
        "timeStamp": "datetime",
        "value": "variant"
    },
    {
        "TagName": "string",
        "timeStamp": "datetime",
        "value": "variant"
    }
]

Response Example:

{
    "message": "string"
}

Response Details:

Example URL

https://api.icube.co.th/integration/webapi/tagrelation/bronze_relation_raw

Last Update: 1 NOV 2024

Retrieve Tag Relation Information

Method: GET

URL: {{base_url}}/tagrelation/{tagrelationname}

Response Example:

{
    "data": {
        "tagRelationName": "string",
        "server": "string",
        "description": "string",
        "enableHyperTable": "string",
        "isView": "string",
        "sqlQueryScript": "string or null",
        "createAt": "datetime",
        "value": "string",
        "tagRelationFieldMappings": [
            {
                "fieldName": "string",
                "description": "string or null",
                "isIdentity": bool
            }
        ]
    }
}

Response Details:

Example URL

Last Update: 1 NOV 2024

Add Tag Relation Values

Method: POST

URL: {{base_url}}/tagrelation/value?mode=write

Query Parameters:

Request Body:

The request body must be an array of tag relation value objects, each containing the following parameters:

Field Mappings:

Each object in the fieldMappings array must contain the following parameters:

Value Data Types:

Example Request Body:

Response Example:

Response Details:

Example URL

Last Update: 5 NOV 2024

Retrieve Tag Values with Filters

Method: GET

URL: {{base_url}}/tag/value?name={tagname}&starttime={starttime}&endtime={endtime}&statusData={statusData}

Query Parameters:

Time Expression:

Response Example:

Response Details:

Example URL

Last Update: 1 NOV 2024

Retrieve Tag Value with Conditions

Method: GET

URL: {{base_url}}/tag/{tagname}/value?starttime={starttime}&endtime={endtime}&query={query}

Query Parameters:

Time Expression:

Response Example:

Response Details:

Example URL

https://api.icube.co.th/integration/webapi/tagrelation/TagRelationData3/value

Last Update: 1 NOV 2024

Delete Tag Relation Values

Method: DELETE

URL: {{base_url}}/tagrelation/{tagrelationname}/value

Request Body:

The request body must be an array of objects, each containing the following parameter:

Example Request Body:

[
    {
        "timeStamp": "datetime"
    },
    {
        "timeStamp": "datetime"
    }
]

Response Example:

{
    "message": "string"
}

Response Details:

Example URL

Last Update: 1 NOV 2024

Delete Tag Values

Method: DELETE

URL: {{base_url}}/tag/{tagname}/value

Request Body:

The request body must be an array of objects, each containing the following parameter:

Example Request Body:

Response Example:

Response Details:

Example URL

Last Update: 7 NOV 2024

Retrieve Tag Relation Values with Filters

Method: GET

URL: {{base_url}}/tagrelation/value?name={tagrelationname}&starttime={starttime}&endtime={endtime}&statusData={statusData}

Query Parameters:

Time Expression:

Response Example:

Note: The fields Id, name, and tel are placeholders and will vary depending on the specific tag relation being represented in the request. Ensure you refer to the specific tag relation schema for exact field details.

Response Details:

Last Update: 7 NOV 2024

Example URL

Connect

Method: GET

URL: {{base_url}}/connect

Response Example:

Response Details:

Example URL

Last Update: 7 NOV 2024

Retrieve Tag Values

Method: POST

URL: {{base_url}}/tag/value?mode=read

Query Parameters:

Request Body:

Time Expression:

Example Request Body:

Response Example:

Response Details: