|
Servizio
|
Descrizione
|
|---|---|
|
EvaluateReporting
|
Questo servizio valuta lo stato di report dell'oggetto in base alla relativa strategia.
Di seguito sono riportati i parametri di input per il servizio.
• eventName: nome dell'evento
• eventTime: ora in cui viene attivato l'evento
• source: nome dell'oggetto che ha attivato gli eventi
• sourceProperty: eventData
Dopo l'esecuzione del servizio non viene ricevuto alcun output.
|
|
GetEventSubscriptions
|
Ottenere gli eventi associati all'oggetto remoto.
Per questo servizio non è richiesto alcun input.
L'esecuzione di questo servizio restituisce gli eventi sottoscritti per l'oggetto remoto sotto forma di infotable.
Dopo l'esecuzione di questo servizio vengono ricevuti i parametri seguenti:
• Data Shape: EdgeThingEventNotification
• Infotable Type: solo infotable
|
|
GetPropertySubscriptions
|
Ottenere le proprietà, il tipo di modifica dei dati e la soglia per la modifica dei dati per l'oggetto edge.
Di seguito sono riportati i parametri di input per il servizio.
• options: opzioni di associazione supportate dall'SDK chiamante
L'esecuzione di questo servizio restituisce le proprietà sottoscritte per l'oggetto remoto sotto forma di infotable.
Dopo l'esecuzione di questo servizio vengono ricevuti i parametri seguenti:
• Data Shape: EdgeThingEventNotification
• Infotable Type: solo infotable
|
|
GetQueuedTasks
|
Recuperare i task per questo oggetto connesso.
Per questo servizio non è richiesto alcun input.
L'esecuzione di questo servizio restituisce gli oggetti edge sotto forma di infotable.
Dopo l'esecuzione di questo servizio vengono ricevuti i parametri seguenti:
• Data Shape: MessageStoreList
• Infotable Type: solo infotable
|
|
GetRemoteMetadata
|
Restituisce i metadati per l'oggetto connesso.
Per questo servizio non è richiesto alcun input.
L'esecuzione di questo servizio restituisce i metadati dell'oggetto connesso in formato JSON.
|
|
GetReportingStrategy
|
Recupera la strategia di report di questo oggetto.
Per questo servizio non è richiesto alcun input.
L'esecuzione di questo servizio restituisce i metadati dell'oggetto connesso in formato STRING.
|
|
Invoke
|
Di seguito sono riportati i parametri di input per il servizio.
• endpointUri
• paramsTable
• headerParams
• resultType
L'esecuzione di questo servizio restituisce l'output sotto forma di infotable.
|
|
ProcessRemoteEvents
|
Elaborare gli eventi remoti.
Di seguito sono riportati i parametri di input per il servizio.
• values
Dopo l'esecuzione del servizio non viene ricevuto alcun output.
|
|
ReceiveRouteLifecycleEvent
|
Di seguito sono riportati i parametri di input per il servizio.
• eventPayload
Dopo l'esecuzione del servizio non viene ricevuto alcun output.
|
|
RegisterRoute
|
Di seguito sono riportati i parametri di input per il servizio.
• routeXml
Dopo l'esecuzione del servizio non viene ricevuto alcun output.
|
|
SendMaxQueuedTasks
|
Invia fino a un numero massimo specifico di task in coda all'oggetto connesso.
Di seguito sono riportati i parametri di input per il servizio.
• maxCount: numero massimo di messaggi che si desidera ricevere dal dispositivo edge.
L'esecuzione di questo servizio restituisce il numero di operazioni in coda inviate, fino al valore maxCount, in formato INTEGER.
|
|
SendQueuedTasks
|
Invia tutti i task in coda all'oggetto connesso.
Per questo servizio non è richiesto alcun input.
Dopo l'esecuzione del servizio non viene ricevuto alcun output.
|
|
SetReportingStrategy
|
Impostare la strategia di report di questo oggetto.
Di seguito sono riportati i parametri di input per il servizio.
• strategyThing: nome dell'oggetto strategia.
Dopo l'esecuzione del servizio non viene ricevuto alcun output.
|
|
UpdateSubscribedPropertyValues
|
Scrivere i valori delle proprietà sottoscritte per un oggetto connesso.
Di seguito sono riportati i parametri di input per il servizio.
• values
Dopo l'esecuzione del servizio non viene ricevuto alcun output.
Il parametro values è un'infotable composta da più righe, dove ogni riga contiene il nome, il valore e la qualità della proprietà, accompagnati da data e ora dell'aggiornamento. I valori delle proprietà non possono essere impostati su null.
Per default, gli aggiornamenti del valore vengono eseguiti separatamente per ogni proprietà. Per fare in modo che i valori siano ordinati e raggruppati in base a data e ora anziché in base alla proprietà, è necessario che l'impostazione di GroupPropertyValuesByTime sia true nella sezione BasicSettings del file platform-settings.json.
Quando l'impostazione sopra indicata è true, gli avvisi e gli eventi attivati dai dati per tutte le proprietà aggiornate con la stessa data e ora vengono attivati insieme. Di conseguenza, le sottoscrizioni a più eventi registrate per alcuni o per tutti questi eventi vengono eseguite solo una volta per ogni data e ora, con gli eventi corrispondenti passati nel parametro events.
|
|
UpdateSubscribedPropertyValuesBatched
|
Scrivere i valori delle proprietà sottoscritte in batch per un oggetto connesso.
Di seguito sono riportati i parametri di input per il servizio.
• batches
Dopo l'esecuzione del servizio non viene ricevuto alcun output.
Il parametro batches è un'infotable composta da più righe. Ogni riga contiene un batch di valori delle proprietà e la data e l'ora dell'aggiornamento.
Il valore del campo batch è un'infotable composta da più righe. Ogni riga contiene nome, valore e qualità della proprietà. I valori delle proprietà non possono essere impostati su null.
I valori delle proprietà vengono ordinati e raggruppati in base a data e ora dei batch, questo significa che gli avvisi e gli eventi attivati dai dati per tutte le proprietà aggiornate con la stessa data e ora vengono attivati insieme. Di conseguenza, le sottoscrizioni a più eventi registrate per alcuni o per tutti questi eventi vengono eseguite solo una volta per ogni data e ora, con gli eventi corrispondenti passati nel parametro events.
|