Conferme di ricezione: le conferme che un record è stato ricevuto e salvato. Nel web service è il tipo RECEVEIDCLASS (valore 42 di DataType); gli oggetti sono della classe ReceveidClass e viaggiano nella lista ObjectListReceveidClass della richiesta e della risposta.
È il mattone della sincronizzazione incrementale. Ogni conferma dice al server: «il record di questo tipo, con questa chiave, è arrivato alla postazione Guid». Da quel momento le QUERY della stessa postazione non lo restituiscono più, finché non viene modificato. Si inviano con INSERTORMODIFY e tipo RECEVEIDCLASS; DataImport lo imposta il server.
Scheda tecnica
| Voce | Valore |
|---|
| Tipo di dato | RECEVEIDCLASS = 42 |
| Classe | ReceveidClass |
| Lista nella richiesta e nella risposta | ObjectListReceveidClass |
| Tabella letta da QUERY | ImportRecord — è il nome da usare davanti alle colonne in SQLFilter |
| Operazioni ammesse | QUERY (3), INSERTORMODIFY (0), DELETE (1), TRUNCATETABLE (2) |
| Chiave per le conferme di ricezione | Type|Key|Guid — come si usa |
I campi di ReceveidClass
La colonna Obbligatorio riporta i campi chiave e quelli controllati dal server prima di salvare; Predefinito è il valore che il campo assume se non lo invii; Colonna è il nome del campo nel database, da usare nei filtri di lettura.
| Campo | Tipo | Obbligatorio | Predefinito | Colonna | A cosa serve |
|---|
Type | DataType | — | BRAND | — | Tipo del record confermato (DataType). |
Guid | Testo | — | vuoto | guidpostazione | Identificativo della postazione (lo stesso GuidPC della richiesta). |
Key | Testo | — | vuoto | key | Chiave del record, con i valori separati dal carattere |. |
DataImport | Data e ora | — | nessuna data | dataimport | Data e ora della conferma, impostate dal server. |
Esempi
Inserimento o aggiornamento di un record (valori di esempio). Ricorda che INSERTORMODIFY riscrive tutti i campi: quelli che non invii tornano al valore predefinito, quindi per modificare un record esistente invia il record completo.
JSON · INSERTORMODIFY{
"DataOperation": 0,
"TypeObject": 42,
"GuidPC": "gestionale-01",
"AllInsert": false,
"ObjectListReceveidClass": [
{
"Guid": "gestionale-01",
"Key": "COD001",
"DataImport": "2026-03-15T00:00:00"
}
]
}
Lettura con filtro: fino a 100 record, ignorando le conferme di ricezione.
JSON · QUERY{
"DataOperation": 3,
"TypeObject": 42,
"GuidPC": "gestionale-01",
"SQLFilter": "ImportRecord.tabella = 'COD001'",
"QueryParameter": {
"IgnoreImportRecord": true,
"StartingRecord": 1,
"LimitRecord": 100
}
}
Le regole su formati, date, numeri e compressione sono in formato e trasporto; esempi completi in esempi di codice.