Definizione del modello ThingWorx in Composer > Modellazione > Snippet di codice > PurgeSelectedPropertyHistory
PurgeSelectedPropertyHistory
Descrizione
Quando le proprietà registrate vengono aggiornate, i relativi dati vengono scritti in uno stream di valori associato all'oggetto. È possibile utilizzare il servizio PurgeSelectedPropertyHistory per eliminare i dati cronologici di un elenco specificato di proprietà registrate di un oggetto per un intervallo di tempo specificato.
Viene eliminata la cronologia delle proprietà dell'oggetto per cui viene chiamato il servizio. Se si desidera eliminare i dati cronologici per più oggetti, è necessario chiamare il servizio per i singoli oggetti.
Questa eliminazione viene eseguita in modo sincrono.
Input
Nome parametro
Descrizione
Tipo di base
startDate
Data d'inizio, da intendersi inclusa, del periodo di cui devono essere eliminati i dati cronologici.
DATETIME
endDate
Data di fine, da intendersi inclusa, del periodo di cui devono essere eliminati i dati cronologici.
DATETIME
propertiesToPurge
Nomi delle proprietà per le quali devono essere eliminati i dati. I nomi delle proprietà vengono trasferiti in un'infotable. La data shape prevista per l'infotable è PropertyList.
INFOTABLE
Output
Nessuno
Esempio
Nell'esempio seguente, TestThing ha tre proprietà registrate: propertyA-Logged, propertyB-Logged e propertyC-Logged. Queste proprietà sono state aggiornate più volte e hanno raccolto dati cronologici. Il seguente snippet può essere utilizzato per eliminare la cronologia di un sottoinsieme specificato delle proprietà registrate dell'oggetto:
// 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 */
});
È stato utile?