新增或更新資料表

Composer 中的 ThingWorx 模型定義 > 建模 > 程式碼片段 > 新增或更新資料表

新增或更新資料表

AddOrUpdateDataTableEntry 描述

產生用來將串流項目新增到所選串流物件所需的程式碼。請注意，部份自動產生的程式碼必須以項目值更新。尤其是以下項目：

• 值：值預設將設定為「未定義」。可以使用硬式編碼定義值，也可從服務參數或其他變數指派值。

• 位置：針對經度、緯度與海拔，位置物件預設設為 0。如果這些值為已知，可以進行更新。

• 標籤：依預設，標籤物件沒有任何值。

• 時間戳記：依預設，會使用目前時間。這可以是提供其日期時間的任何值。

值、位置、標籤、時間戳記以及來源會在 AddStreamEntry 服務呼叫中使用。

輸入

參數名稱	描述	基礎類型
tags	項目的資料標籤 (選用)。	TAGS
location	項目的位置 (選用)。	LOCATION
source	項目的來源 (選用)。	STRING
sourceType	來源類型 (選用)。	STRING
values	要在資料表中新增或更新的值。	INFOTABLE

輸出

參數名稱	描述	基礎類型
Result	傳回資料表中新增或已更新項目的 streamID STRING 值	STRING

範例


                            // tags:TAGS
            let tags = new Array();
            // values:INFOTABLE(Datashape: DTAuditShape)
            let values = Things["AuditDataTable"].CreateValues();
            values.auditCategory = undefined; // STRING
            values.messageArgs = undefined; // INFOTABLE
            values.id = undefined; // GUID [Primary Key]
            values.message = undefined; // STRING
            values.user = undefined; // STRING
            // location:LOCATION
            let location = {
                latitude: 0,
                longitude: 0,
                elevation: 0,
                units: "WGS84"
            };
            let params = {
                tags: tags,
                source: me.name,
                values: values,
                location: location
            };
            // AddOrUpdateDataTableEntry(tags:TAGS, source:STRING("me.name"), values:INFOTABLE(AuditDataTable), location:LOCATION):STRING
            let id = Things["AuditDataTable"].AddOrUpdateDataTableEntry(params);

AddOrUpdateDataTableEntries 描述

AddOrUpdateDataTableEntries 可用來新增及更新資料表中的項目。

輸入

參數名稱	描述	基礎類型
tags	項目的資料標籤 (選用)。	TAGS
location	項目的位置 (選用)。	LOCATION
source	項目的來源 (選用)。	STRING
sourceType	來源類型 (選用)。	STRING
values	要在資料表中新增或更新的值。	INFOTABLE

輸出

沒有 AddOrUpdateDataTableEntries 的輸出。

範例

// Define the parameters for creating the InfoTable
var params = {
    infoTableName : "InfoTable",
    dataShapeName : "EmployeesDataShape"
};
// Create the InfoTable
var valuesInfotable = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape(params);
// Define a updated entry to be added
var UpdatedValuesRow = {
    EmployeeID: "209833",
    Name: "Vishal",
    Role: "Software Engineer Specialist",
    Salary: "50000"
};
// Add the new row to the InfoTable
valuesInfotable.AddRow(UpdatedValuesRow);
// Define a new entry to be added
var addValuesRow = {
    EmployeeID: "209838",
    Name: "Sagar",
    Role: "QA",
    Salary: "40000"
};
// Add the new row to the InfoTable
valuesInfotable.AddRow(addValuesRow);
Things["EmployeesDataTable"].AddOrUpdateDataTableEntries({
	sourceType: undefined /* STRING */,
	values: valuesInfotable /* INFOTABLE */,
	location: undefined /* LOCATION */,
	source: undefined /* STRING */,
	tags: undefined /* TAGS */
});

這是否有幫助?