Services avec objets distants
Voici la liste des services pouvant être utilisés avec des objets distants.
Service
Description
EvaluateReporting
Ce service évalue le statut de reporting de l'objet en fonction de sa stratégie.
Les paramètres d'entrée du service sont les suivants :
eventName : nom de l'événement
eventTime : heure à laquelle l'événement est déclenché
source : nom de l'objet qui a déclenché des événements
sourceProperty : Source Property eventData
Aucune sortie n'est reçue après l'exécution de ce service.
GetEventSubscriptions
Obtenez les événements liés à l'objet distant.
Aucune entrée n'est requise pour ce service.
L'exécution de ce service renvoie les événements souscrits pour l'objet distant sous la forme d'une table d'informations.
Les paramètres suivants sont reçus après l'exécution de ce service :
Data Shape : EdgeThingEventNotification
Infotable Type : table d'informations simple
GetPropertySubscriptions
Obtenez les propriétés, le type de modification des données et le seuil de modification des données pour l'objet Edge.
Les paramètres d'entrée du service sont les suivants :
options : options de liaison prises en charge par le SDK appelant
L'exécution de ce service renvoie les propriétés souscrites pour l'objet distant sous la forme d'une table d'informations.
Les paramètres suivants sont reçus après l'exécution de ce service :
Data Shape : EdgeThingEventNotification
Infotable Type : table d'informations simple
GetQueuedTasks
Récupère toutes les tâches associées à cet objet connecté.
Aucune entrée n'est requise pour ce service.
L'exécution de ce service renvoie les objets Edge sous la forme d'une table d'informations.
Les paramètres suivants sont reçus après l'exécution de ce service :
Data Shape : MessageStoreList
Infotable Type : table d'informations simple
GetRemoteMetadata
Renvoie les métadonnées de l'objet connecté.
Aucune entrée n'est requise pour ce service.
L'exécution de ce service renvoie les métadonnées de l'objet connecté au format JSON.
GetReportingStrategy
Récupère la stratégie de reporting de l'objet.
Aucune entrée n'est requise pour ce service.
L'exécution de ce service renvoie les métadonnées de l'objet connecté au format STRING.
Invoke
Les paramètres d'entrée du service sont les suivants :
endpointUri
paramsTable
headerParams
resultType
L'exécution de ce service renvoie la sortie sous la forme d'une table d'informations.
ProcessRemoteEvents
Traite les événements distants.
Les paramètres d'entrée du service sont les suivants :
values
Aucune sortie n'est reçue après l'exécution de ce service.
ReceiveRouteLifecycleEvent
Les paramètres d'entrée du service sont les suivants :
eventPayload
Aucune sortie n'est reçue après l'exécution de ce service.
RegisterRoute
Les paramètres d'entrée du service sont les suivants :
routeXml
Aucune sortie n'est reçue après l'exécution de ce service.
SendMaxQueuedTasks
Envoie jusqu'à un nombre maximal spécifique de tâches en file d'attente à l'objet connecté.
Les paramètres d'entrée du service sont les suivants :
maxCount : nombre maximal de messages souhaité par le périphérique Edge.
L'exécution de ce service renvoie le nombre de tâches en file d'attente envoyées, jusqu'au nombre maxCount, au format INTEGER.
SendQueuedTasks
Envoie toutes les tâches en file d'attente à l'objet connecté.
Aucune entrée n'est requise pour ce service.
Aucune sortie n'est reçue après l'exécution de ce service.
SetReportingStrategy
Définit la stratégie de reporting de l'objet.
Les paramètres d'entrée du service sont les suivants :
strategyThing : nom de l'objet de stratégie.
Aucune sortie n'est reçue après l'exécution de ce service.
UpdateSubscribedPropertyValues
Ecrit les valeurs de propriété souscrites pour un objet connecté.
Les paramètres d'entrée du service sont les suivants :
values
Aucune sortie n'est reçue après l'exécution de ce service.
Le paramètre values est une table d'informations composée de plusieurs lignes, où chaque ligne contient le nom, la valeur et la qualité de la propriété, avec l'horodatage de la mise à jour. Les valeurs de propriété ne peuvent pas être nulles.
Par défaut, les mises à jour des valeurs sont effectuées séparément pour chaque propriété. Pour que les valeurs soient triées et regroupées par horodatage plutôt que par propriété, le paramètre GroupPropertyValuesByTime doit être défini sur true dans la section BasicSettings du fichier platform-settings.json.
Lorsque le paramètre ci-dessus est défini sur true, dans toutes les propriétés mises à jour avec le même horodatage, les événements déclenchés par des données s'activent en même temps que les alertes. Par conséquent, les abonnements multi-événements enregistrés pour tout ou partie de ces événements ne s'exécutent qu'une fois par horodatage et les événements correspondants sont transmis dans le paramètre events.
UpdateSubscribedPropertyValuesBatched
Ecrit dans des lots les valeurs des propriétés souscrites pour un objet connecté.
Les paramètres d'entrée du service sont les suivants :
batches
Aucune sortie n'est reçue après l'exécution de ce service.
Le paramètre batches est une table d'informations composée de plusieurs lignes. Chaque ligne contient un lot de valeurs de propriétés et l'horodatage de mise à jour.
La valeur du champ batch est une table d'informations composée de plusieurs lignes. Chaque ligne contient le nom, la valeur et la qualité de la propriété. Les valeurs de propriété ne peuvent pas être nulles.
Les valeurs des propriétés sont triées et regroupées par horodatage des lots, ce qui signifie que, dans toutes les propriétés mises à jour avec le même horodatage, les événements déclenchés par des données s'activent en même temps que les alertes. Par conséquent, les abonnements multi-événements enregistrés pour tout ou partie de ces événements ne s'exécutent qu'une fois par horodatage et tous les événements correspondants sont transmis dans le paramètre events.
Est-ce que cela a été utile ?