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 */
});
這是否有幫助?