Définition du modèle ThingWorx dans Composer > Modélisation > Extraits de code > PurgeSelectedPropertyHistory
PurgeSelectedPropertyHistory
Description
Lorsque les propriétés journalisées sont mises à jour, leurs données sont écrites dans un flux de valeurs associé à l'objet. Vous pouvez utiliser le service PurgeSelectedPropertyHistory pour purger les données historiques d'une liste spécifiée de propriétés journalisées d'un objet pour une plage temporelle spécifiée.
L'historique des propriétés de l'objet sur lequel le service est appelé sera purgé. Si vous souhaitez purger les données historiques de plusieurs objets, vous devez appeler le service sur chacun d'eux.
Cette purge s'exécute de manière synchrone.
Entrée
Nom de paramètre
Description
Type de base
startDate
Date de début à partir de laquelle l'historique doit être purgé (la date spécifiée est incluse).
DATETIME
endDate
Dernière date à laquelle les données historiques doivent être purgées (la date spécifiée est incluse).
DATETIME
propertiesToPurge
Noms des propriétés pour lesquelles les données doivent être purgées. Les noms des propriétés sont transmis dans une table d'informations. La forme de données attendue pour la table d'informations est PropertyList.
INFOTABLE
Sortie
Aucun.
Exemple
Dans l'exemple suivant, TestThing possède trois propriétés journalisées : propertyA-Logged, propertyB-Logged et propertyC-Logged. Ces propriétés ont été mises à jour plusieurs fois et ont collecté des données historiques. L'extrait de code suivant peut être utilisé pour purger l'historique d'un sous-ensemble spécifié des propriétés journalisées de l'objet :
// 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 */
});
Est-ce que cela a été utile ?