ThingWorx Modelldefinition in Composer > Modellierung > Code-Snippets > PurgeSelectedPropertyHistory
PurgeSelectedPropertyHistory
Beschreibung
Wenn protokollierte Eigenschaften aktualisiert werden, werden ihre Daten in einen Wert-Stream geschrieben, der dem Ding zugeordnet ist. Sie können den Dienst PurgeSelectedPropertyHistory verwenden, um die historischen Daten einer bestimmten Liste protokollierter Eigenschaften eines Dings für einen angegebenen Zeitbereich zu bereinigen.
Der Eigenschaftsverlauf des Dings, in dem der Dienst aufgerufen wird, wird bereinigt. Wenn Sie die historischen Daten für mehrere Dinge bereinigen möchten, müssen Sie den Dienst für jedes Ding aufrufen.
Das Bereinigen wird synchron ausgeführt.
Eingabe
Parametername
Beschreibung
Basistyp
startDate
Das Startdatum, einschließlich des angegebenen Datums, ab dem die historischen Daten bereinigt werden sollen.
DATETIME
endDate
Das Enddatum, einschließlich des angegebenen Datums, bis zu dem die historischen Daten bereinigt werden sollen.
DATETIME
propertiesToPurge
Die Namen der Eigenschaften, für die Daten bereinigt werden sollen. Die Namen der Eigenschaften werden in einer Infotable übergeben. Der erwartete Data Shape für die Infotable ist PropertyList.
INFOTABLE
Ausgabe
Keine.
Beispiel
Im folgenden Beispiel hat TestThing die drei protokollierten Eigenschaften propertyA-Logged, propertyB-Logged und propertyC-Logged. Diese Eigenschaften wurden mehrmals aktualisiert und enthalten gesammelte historische Daten. Das folgende Snippet kann verwendet werden, um den Verlauf einer bestimmten Untermenge der protokollierten Eigenschaften des Dings zu bereinigen:
// Creating an infotable using the required datashape for specifying the names of properties to purge
var propertiesToPurge = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape( {
infoTableName : "InfoTable",
dataShapeName : "PropertyList"
});

// Adding the names of properties to the infotable created above
propertiesToPurge.AddRow({ propertyName: "propertyA-Logged" });
propertiesToPurge.AddRow({ propertyName: "propertyB-Logged" });
// Purging history
Things["TestThing"].PurgeSelectedPropertyHistory({
propertiesToPurge: propertiesToPurge, /* INFOTABLE */
startDate: 0, /* DATETIME */
endDate: dateAddYears((new Date()),1000) /* DATETIME */
});
War dies hilfreich?