Définition du modèle ThingWorx dans Composer > Stockage des données > Tables de données > Services de table de données
Services de table de données
Il existe un certain nombre de services intégrés permettant d'insérer et d'extraire des données des tables de données qui sont spécifiques à la forme de table de données. Ils se présentent comme suit :
Service
Description
AddDataTableEntry (TAGS tags, VALUES values)
Transmettre dans VALUES, et facultativement tags. Le retour booléen indique si l'opération a réussi ou non.
AddDataTableEntries
Ajoute plusieurs entrées de table de données.
AddOrUpdateDataTableEntry (TAGS tags, VALUES values)
Transmettre dans VALUES, et facultativement tags. Renvoie une valeur TEXTE du streamID de l'entrée nouvelle ou actualisée de la table de données. Met à jour une ligne si elle existe, sinon une ligne est ajoutée.
AddOrUpdateDataTableEntries
Ajoute ou met à jour plusieurs entrées de table de données. Met à jour une ligne si elle existe, sinon une ligne est ajoutée. Les clés primaires doivent correspondre pour que la mise à jour ait lieu.
AssignDataTableEntries
Remplace des entrées existantes de la table de données.
DeleteDataTableEntry (STRING keyvalue)
Supprime une entrée unique compte tenu de la valeur de clé. Le retour booléen indique si l'opération a réussi ou non.
* 
La spécification d'une clé primaire est nécessaire pour la suppression d'une entrée.
DeleteDataTableEntries
Supprime plusieurs entrées correspondant à la première ligne de valeurs fournie dans le paramètre d'entrée de table d'informations. Par exemple, prenons une table de données possédant un champ nommé Int01 et trois entrées dont le champ Int01 est défini sur 10. Au moment de son exécution, DeleteDataTableEntries supprimera les trois entrées en question si 10 est spécifié comme critère de suppression.
* 
Une erreur "Invalid Number of values provided to DeleteDataTableEntries in thingName" s'affiche si plusieurs lignes de valeurs sont fournies dans le paramètre d'entrée de table d'informations.
FindDataTableEntries
Effectue une recherche sur les index uniquement. Cette solution peut donc s'avérer plus rapide que le service QueryDataTableEntries.
* 
Si plusieurs index sont définis dans la configuration de la table de données, l'index utilisé pour la recherche est pondéré en fonction des champs que vous avez désignés comme étant soumis aux recherches dans le paramètre Values que vous transmettez à FindDataTableEntries. Par exemple, supposons que vous avez quatre propriétés (ENTIER, BOOLEEN, CHAINE et TEXTE) et que vous avez créé deux index (un pour BOOLEEN et CHAINE, et un pour TEXTE). Si vous spécifiez une valeur à rechercher uniquement pour la propriété TEXTE, une pondération plus forte sera associée à cet index par rapport à l'index de BOOLEEN/CHAINE, car vous avez fourni pour cet index une valeur sur laquelle faire porter la recherche.
* 
Un seul paramètre d'entrée de table d'informations est accepté pour FindDataTableEntries. Aucun résultat n'est renvoyé si aucune entrée ou si plusieurs paramètres d'entrée sont fournis.
GetDataTableEntries (NUMBER maxItems)
Renvoie les dernières entrées jusqu'au nombre maximum d'éléments demandé.
GetDataTableEntry (STRING keyvalue)
Renvoie une table d'informations d'une ligne avec l'entrée correspondante.
GetFieldNames
Renvoie une liste de noms de champ associés à cette table de données.
PurgeDataTableEntries
Supprime toutes les entrées pour cette table de données. Le retour booléen indique si l'opération a réussi ou non.
QueryDataTableEntries (NUMBER maxItems, STRING queryExpression, TAGS tags, VALUES query)
Renvoie une table d'informations des enregistrements qui correspondent aux paramètres de la requête.
* 
Un seul paramètre d'entrée de table d'informations est accepté pour QueryDataTableEntries.
Si aucun paramètre d'entrée n'est fourni, QueryDataTableEntries renvoie toutes les lignes de la table de données.
Si plusieurs paramètres d'entrée sont fournis, les lignes correspondant uniquement à la première entrée sont renvoyées, tandis que les autres entrées sont ignorées. Dans ce cas, utilisez le paramètre d'entrée de la requête du service.
SearchDataTableEntries
Renvoie toutes les entrées de la table de données qui correspondent aux paramètres de requête. L'expression de recherche searchExpression est la clé de ce service ; elle inclut une recherche en texte intégral sur les champs CHAINE et TEXTE uniquement. Les filtres suivants peuvent être utilisés dans l'expression searchExpression : + (signe plus), sensibilité à la casse, ? (point d'interrogation), % (signe pourcentage), AND et OR.
UpdateDataTableEntry (TAGS tags, VALUES values)
Transmettre dans values, et facultativement tags. Le retour booléen indique si l'opération a réussi ou non. Met à jour une ligne si elle existe.
Définition de la sensibilité à la casse dans les recherches en table de données
Vous pouvez définir la sensibilité à la casse dans les recherches en table de données en utilisant un filtre dans le paramètre query.
Par exemple, au moyen du service SearchDataTableEntries avec les entrées suivantes :
Vous pouvez définir un filtre pour le paramètre query afin que soient renvoyés des résultats sensibles à la casse. Par exemple :
{"filters":{"type":"EQ", "fieldName":"Field1","isCaseSensitive":true, "value":"AA"}}
Avec la requête ci-dessus, les résultats suivants s'affichent :
Dans un autre exemple avec le même service, en utilisant le filtre suivant dans le paramètre query :
{"filters":{"type":"EQ", "fieldName":"Field1","isCaseSensitive":true, "value":"aa"}}
La recherche renvoie les résultats suivants :
Est-ce que cela a été utile ?