Definizione del modello ThingWorx in Composer > Sistema > Sottosistemi > Sottosistema Verifica > Utilizzo dell'implementazione della persistenza diretta > Esportazione dei dati di verifica online
Esportazione dei dati di verifica online
Quando l'implementazione della persistenza diretta è attiva, utilizzare il servizio ExportOnlineAuditData per esportare una versione localizzata dei messaggi di verifica dall'archivio dati online. Poiché il servizio ExportOnlineAuditData è disponibile solo per l'implementazione della persistenza diretta, l'archivio dati è il database configurato come provider di persistenza per ThingWorx Platform, ovvero PostgreSQL o MS SQL.
Il servizio ExportOnlineAuditData costruisce messaggi di verifica localizzati a partire dai dati online. Questo servizio utilizza una lingua, un nome di repository, un percorso di destinazione, un nome di file di destinazione, una data di inizio e una data di fine. La lingua viene utilizzata per la traduzione dei messaggi di verifica. Quando viene richiamato, il servizio esporta le voci di verifica corrispondenti ai criteri specificati dallo spazio di archiviazione online in un file ZIP nel percorso di destinazione indicato, utilizzando il nome del file di destinazione specificato. L'esportazione viene ordinata per data di verifica. Di seguito sono riportati il servizio e i relativi input:

ExportOnlineAuditData(locale[STRING],
targetRepositoryName[THINGNAME],
targetPath[STRING],
targetFileName[STRING],
startDate[DATETIME],
endDate[DATETIME],
query[QUERY])
Nella tabella seguente sono elencati i parametri di input con una breve descrizione e il relativo tipo di base ThingWorx:
Parametro
Descrizione
Tipo di base
locale
Abbreviazione del nome della lingua in cui restituire i risultati. (STRING). Ad esempio è possibile utilizzare fr per il francese o zh_CN per il cinese (Cina). Per un elenco delle lingue supportate da ThingWorx fare riferimento a Lingue supportate.
STRING
targetRepositoryName
Nome dell'oggetto repository di file in cui deve essere memorizzato il file di output contenente le voci di verifica localizzate.
THINGNAME
targetPath
Posizione in cui deve essere scritto il file di output.
STRING
targetFileName
Nome del file di output in cui devono essere memorizzati i dati di verifica localizzati.
STRING
startDate
Data e ora della prima voce di verifica che si desidera esportare. Vengono esportate tutte le voci di verifica con data e ora successive alla data e all'ora della prima voce di verifica esportata e precedenti rispetto a endDate.
DATETIME
endDate
Data e ora dell'ultima voce di verifica che si desidera esportare. Vengono esportate tutte le voci di verifica con data e ora precedenti rispetto alla data e all'ora dell'ultima voce di verifica esportata e successive a startDate.
DATETIME
query
Interrogazione in formato JSON per il filtraggio e l'ordinamento dei dati di verifica. Non esiste alcun valore di default per questo parametro. Per un esempio fare riferimento alla sezione Esempio di esportazione dei dati di verifica online riportata di seguito.
Esempio di esportazione dei dati di verifica online
Di seguito è riportato un esempio di una chiamata a questo servizio:

AuditSubsystem.ExportOnlineAuditData("en", myExportRepository, "/auditExport/",
"export_02-03_one_hour", 2020-02-03 18:50:03.000, 2020-02-03 19:50:03.000,
{
"filters": {
"type": "OR",
"filters": [{
"type": "EQ",
"fieldName": "user",
"value": "Administrator",
"isCaseSensitive": false
},
{
"type": "Between",
"fieldName": "timestamp",
"from": 1570195753953,
"to": 1570195753961
},
{
"type": "IN",
"fieldName": "source",
"values": ["test_tt", "test"],
"isCaseSensitive": false
},}
]
},
"sorts": [
{
"fieldName": "source",
"isAscending": true,
"isCaseSensitive": true
},
{
"fieldName": "timestamp",
"isAscending": true,
"isCaseSensitive": true
}
]
})
Questo esempio crea un'esportazione in inglese in myExportRepository nel percorso /auditExport/export_02-03_one_hour.zip. Il contenuto è costituito da tutti i messaggi di verifica online, in base alle date di inizio e di fine specificate. La dimensione del file ZIP esportato dipende dalla quantità di dati raccolti tra le date di inizio e di fine. Nella tabella seguente è riportato il contenuto dell'esportazione, in base alle date di inizio e di fine:
Data di inizio
Data di fine
Contenuto dell'esportazione
2020-02-03 18:50:03.000 (una data e un'ora specifiche)
2020-02-03 19:50:03.000 (una data e un'ora specifiche)
Tutti i dati online e non in linea dalla data di inizio alla data di fine, che in questo esempio corrispondono (2020–02–03), per un intervallo di un'ora (dalle 18:50:03.000 alle 19:50:03.000).
null
2020-02-03 19:50:03.000 (una data e un'ora specifiche)
Tutti i dati online antecedenti la data e l'ora di fine (2020-02-03 19:50:03.000). Con la data di inizio impostata su null, l'esportazione può contenere un grande volume di dati di verifica, a seconda della quantità di messaggi di verifica nello spazio di archiviazione del database e della regola di conservazione dei dati online.
2020-02-03 18:50:03.000 (una data e un'ora specifiche)
null
Tutti i dati online tra la data e l'ora di inizio e la data e l'ora correnti, specificate impostando la data di fine su null.
null
null
TUTTI i dati di verifica online. Questa impostazione non è consigliata in quanto potrebbe richiedere molto tempo.
Nell'esempio, il file export_02-03_one_hour.zip crea un file di archiviazione denominato AuditArchiveDirectPersistence/Export/export_02-03_one_hour.json.
Di seguito è riportato un esempio di JSON nel file di esportazione, AuditArchiveDirectPersistence/Export/export_02-03_one_hour.json:

{
"rows":[
{
"auditCategory":"Modeling",
"application":"ThingWorxCore",
"sourceType":"Thing",
"id":"4164",
"source":"ExampleThing",
"message":"Created Thing \"ExampleThing\"",
"user":"ExampleUser",
"timestamp":1580773803
},
...
...
]
}
Le informazioni restituite per questo esempio di persistenza diretta comprendono i dettagli seguenti:
Proprietà
Descrizione
auditCategory
Nome della categoria del messaggio di verifica. Nell'esempio riportato sopra, la categoria è Modeling. Per informazioni sulle categorie di verifica, vedere Categorie di verifica.
application
Nome dell'applicazione che ha generato il messaggio di verifica. Per i messaggi di verifica generati dalla versione di base di ThingWorx Platform, il valore è impostato su ThingworxCore.
sourceType
Tipo associato all'applicazione che ha generato questo messaggio di verifica (Thing).
source
Applicazione ThingWorx o eseguibile che ha generato questo messaggio di verifica. Nell'esempio, l'origine ExampleThing.
id
Si tratta di un identificatore univoco generato automaticamente per la voce di verifica. In questo esempio, l'id è 4164.
message
Testo del messaggio di verifica.
user
Nome di accesso dell'utente che stava eseguendo l'applicazione quando è stato generato il messaggio di verifica.
timestamp
In tempo epoch, data e ora in cui è stato generato il messaggio di verifica.
Cosa succede ai dati online dopo un'esportazione?
I dati online rimangono nello spazio di archiviazione online dopo un'esportazione. I dati possono essere eliminati manualmente dallo spazio di archiviazione online eseguendo il servizio ArchiveAuditHistory o impostando automaticamente AuditArchiveScheduler.
Operazioni di archiviazione, eliminazione e pulizia di verifica
Dati di verifica online e non in linea (persistenza diretta)
Pulizia degli archivi di verifica non in linea
È stato utile?