Wizzard Home | Prospetti |

Cod.	Ultima revisione	Cod. Sviluppo
636	2018/07/20 - PG

ATTENZIONE QUESTA GUIDA E' IN FASE DI REDAZIONE E REVISIONE (COOMING SOON)

Sistema Log New version

Quest'area analitica è in fase di sviluppo e attualmente gestisce per ora i log SOLO per l'app IOS salvo i dati strettamente legati ad attività server.
Nel caso è indicato nel singolo report.

Struttura dei log

I log vengono registrati nel Client per eventi specifici definiti di seguito.
Eventi non presenti in questa lista non vengono registrati.

Ciascuna  log sono un formato Raw di registrazione di un evento per il qual sono registrate una serie di informazioni utili ad essere poi elaborati
da sistemi statistici e di reportistica 

Un esempio di log registrato dal sistema è il seguente :

enterpriseuser001@zotsell.com [10/Oct/1999:21:15:05 +0500] "folders/24/31/..../89?product_id=345673" OK "Gadgets/2.5.001 (iPad; iOS 11.4.1; Scale/2.00) [en] F74C9E2D-A5D8-4A7A-82CA-DC7C31346D6A [ABCD] 1.23457590,1.45673890"

I dati contenuti nei log sono tutti di tipo stringa.

Gli elementi principali che costituiscono la  struttura di un singolo log è la seguente:

#utente# #date_log# "#path#" #status_code# "#user_agent#"

Di seguito indicazione di ciascun elemento

#utente#

E' l'utente che ha eseguito il login nel client e lo individua unicamente potrebbe essere l id utente in login , il numero di cell , l'email ecc.
Per l'app IOS Zotsell è l'Email dellutente.  
E' possibile distinguere i log dello stesso utente  su differenti device tramite la verifica del device id registrato nell'elemento  

---

#date_log#

Il formato data che viene registrato è il seguente 

[dd/MMM/yyyy:hh:mm:ss +-hhmm]

---

#path#

Indica il percorso nel client che l'utente ha eseguito per generare l'evento che il log registra.
Ad esempio per il log di visualizzazione di una scheda prodotto sarà il percorso eseguito nel client per visualizzare la scheda a partire dal modulo schelto (Schema).
Il path è composto da :

1. #schema# = corrisponde al modulo Es: catalog , orders, documents, contacts
2. #separatore# = ":"
3. #path# = Posizione all'interno del modulo fino alla vista finale

Esempi:

Accesso a una cartella

catalog:folders/24/31/..../89

Accesso a una articolo in cartella

catalog:folders/24/31/..../89?product_id=345673

---

#status_code#

Indica il tipo di risultato a seguito della richiesta dell'azione specifica che il log registra (Esito).

I Per il tipo di codifica si è deciso di aderire ad un facsimile di quanto utilizzato  per il protocollo http:

https://httplab.it/httpStatusCode


I due valori utilizzati per ora sono : 

• 200 - OK la richiesta ha avuto esito positivo, operazione riuscita. 
• 500 - Errore interno operazione non riuscita.

Esempi:

---

#user_agent#

Serve per registrare :

1. APPVER = Versione App
2. OS = OS in uso
3. LANG = Lingua
4. DEVID = Device id
5. AGENTCODE = Codice agente
6. GEO = Geolocalizzazione

La stringa #user_agent# risulterà quindi
" APPVER OS [LANG] DEVID [AGENTCODE] GEO"


Esempio stringa #user_agent#

"Gadgets/2.5.001 (iPad; iOS 11.4.1; Scale/2.00) [en] F74C9E2D-A5D8-4A7A-82CA-DC7C31346D6A [001] 1.23457590,1.45673890"

** 6) Geolocalizzazione 
E' solo predisposto ma non registrato per una serie di complicazioni da valutare:
- E' sempre necessaria l'autorizzazione dell'utente
- E' invasiva 
- Necessita   in background un sistema di aggiornamento degli spostamenti che rallenta ogni singola funzione di registrazione log per ovviare servirebbe:

---

Path

Di seguito eventi che si vogliono registrare nei log  loro  path ed  esempi.

Generali

Login

Registra l'azione di login in app (Login a seguito bottone di login)
 
Path: 

"login:"

Esempio:


Verifica delle credenziali di login  solitamente alla riapertura dell'app

Path:

"login:check"

Esempio:
enterpriseuser001@zotsell.com [09/Oct/2018 11:41:17 +0200] " login:check" 200 "ZotSell-8E/2.5.51 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

---

Apertura App

Avvio dell'app da spenta. Il Log viene registrato solo se l'utente si è già autenticato in precedenza dopo l'installazione app o aggiornamento versione

Path: 

"app:open"

Esempio:
enterpriseuser001@zotsell.com [09/Oct/2018 11:40:51 +0200] " app:open" 200 "ZotSell-8E/2.5.51 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

---

Spegnimento App

Spegnimento dell'app . Il Log viene registrato solo se l'utente si è già autenticato in precedenza dopo l'installazione app o aggiornamento versione

Path: 

"app:close"

Esempio:

---

Attivazione app

Attivazione app quando in background

Path: 

"app:foreground"

Esempio:

enterpriseuser001@zotsell.com [09/Oct/2018 11:39:41 +0200] "app:foreground" 200 "ZotSell-8E/2.5.49 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

---

Disattivazione app

Messa in background dell'app

Path: 

"app:background"

Esempio:

---

Sincronizzazione

Log registrati in fase di sincronizzazione dati

Avvio sincronizzazione completa

Ad essa seguono i log di tutte le attività di sincronizzazione che registrano in succession specifici Log
Path: 

"sync:full"

Esempio:

Sincronizzazione bloccata

E' attivo quando oil setting "disable_sync" è attivo nel server  e le sincronizzazoni sono bloccate

"sync:lock"

Esempio:

---

Extras

Microtask sincronizzazione Extras 

Estrazione lista risorse 

Genera la lista delle risorse presenti in ipad

Path:

sync:resources/write/list

Esempio

Invia lista risorse a server

Invia la lista delle risorse presenti in ipad al server

Path:

sync:resources/upload/list

Esempio

Download lista Extras: 

sync:extra/download/list

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:20:08 +0200] "sync:extra/download/list" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

Download  Extras

sync:extra/download/items

Esempio

Download DB Risorse

sync:extra/download/ipad_resources.sqlite.zip

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:20:24 +0200] "sync:extra/download/ipad_resources.sqlite.zip" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

Scompatta DB risorse

sync:extra/unzip/ipad_resources.sqlite.zip

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:20:24 +0200] "sync:extra/unzip/ipad_resources.sqlite.zip" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

Elimina risorse obsolete

sync:resources/remove

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:20:25 +0200] "sync:resources/remove" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

Download risorse importanti

sync:resources/download/important

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:20:36 +0200] "sync:resources/download/important" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

Download DB supporto Extra

sync:extra/download/app_support.sqlite.zip

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:20:37 +0200] "sync:extra/download/app_support.sqlite.zip" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

Scompatta DB supporto Extra

sync:extra/download/app_support.sqlite.zip

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:20:37 +0200] "sync:extra/unzip/app_support.sqlite.zip" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

---

 Contatti

Microtask sincronizzazione Contatti 

Richiesta DB

Path: 

sync:contacts/download/ipad_contacts.sqlite.zip

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:20:38 +0200] "sync:contacts/download/ipad_contacts.sqlite.zip" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

Decompressione DB

Path:

sync:contacts/unzip/ipad_contacts.sqlite.zip

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:20:38 +0200] "sync:contacts/unzip/ipad_contacts.sqlite.zip" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

 Importazione DB

Path:

sync:contacts/import/ipad_contacts.sqlite

Esempio

---

Catalogo

Microtask sincronizzazione Catalogo 

Richiesta DB

Path:

sync:catalog/download/ipad_catalog.sqlite.zip

Esempio

Decompressione DB

Path:

sync:catalog/unzip/ipad_catalog.sqlite.zip

Esempio

Importazione DB

Path:

sync:catalog/import/ipad_catalog.sqlite

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:21:01 +0200] "sync:catalog/import/ipad_catalog.sqlite" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

---

Documenti

Microtask sincronizzazione Documenti 

Richiesta DB

Path:

sync:documents/download/ipad_docs.sqlite.zip

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:21:02 +0200] "sync:documents/download/ipad_docs.sqlite.zip" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

Decompressione DB

Path:

sync:documents/unzip/ipad_docs.sqlite.zip

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:21:02 +0200] "sync:documents/unzip/ipad_docs.sqlite.zip" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

Avvio Importazione DB

Path:

sync:documents/import/ipad_docs.sqlite

Esempio

---

Reports

Microtask sincronizzazione Reports 

Rchiesta DB

Path:

sync:reports/download/ipad_reports.sqlite.zip

Esempio

Decompressione DB

Path:

sync:reports/unzip/ipad_reports.sqlite.zip

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:21:03 +0200] "sync:reports/unzip/ipad_reports.sqlite.zip" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

Importazione DB

Path:

sync:reports/import/ipad_reports.sqlite

Esempio

---

Mappa

Microtask sincronizzazione Reports

Richiesta DB

Path:

sync:reports/download/ipad_reports.sqlite.zip

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:21:04 +0200] "sync:geotargeting/download/ipad_geotargeting.sqlite.zip" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

Decompressione DB

Path:

sync:reports/unzip/ipad_reports.sqlite.zip

Esempio

Importazione DB

Path:

sync:reports/import/ipad_reports.sqlite

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:21:04 +0200] "sync:geotargeting/import/ipad_geotargeting.sqlite" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

---

Ordini

Microtask sincronizzazione Ordini  

Richiesta lista ordini

Path:

sync:orders/download/list

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:21:04 +0200] "sync:orders/download/list" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

Reset DB

Questo log è funzione del setting di reset . Appare solo quando il setting è true

Path:

sync:orders/reset

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:21:04 +0200] "sync:orders/reset " 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

Download items

Path:

sync:orders/download/items

Esempio

Importazione DB

Path:

sync:orders/import/items

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:21:04 +0200] "sync:sync:orders/import/items" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

---

Tasks

Microtask sincronizzazione Tasks
 

Richiesta lista tasks

Path:

sync:tasks/download/list

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:21:04 +0200] "sync:tasks/download/list" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

Reset DB

Questo log è funzione del setting di reset . Appare solo quando il setting è true

Path:

sync:tasks/reset

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:21:04 +0200] "sync:tasks/reset " 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

Download items

Path:

sync:tasks/download/items

Esempio

Importazione DB

Path:

sync:tasks/import/items

Esempio
enterpriseuser001@zotsell.com [10/Oct/2018 09:21:04 +0200] "sync:sync:orders/import/items" 200 "ZotSell-8E/2.5.52 (iPad; iPhone OS 9.3.5; Scale/2.00) [it] 7DEC5CDD-E13F-48B6-8AAF-2ECD8FA0FCA1 [001]"

---

Fine sync

Registra la fine del processo di sincronizzazione senza stop
Path: 

"sync:end"

Esempio:

---

Stop sync

Registra lo stop forzato del processo di sincronizzazione
Path: 

"sync:stop"

Esempio:

---

..... Serve definirei anche gli invii ordine e task Esempio:










..... Serve definire in dettaglio per ciascun tipo a partire dai più semplici

### Download singola risorsa manualmente
"download:resources/pippo.jpg"
o
"download:resources?filename=pippo.jpg"
#### Download singola risorsa gallery
"download:resources?gallery=pippo.jpg,topolino.jpg,"
### Download singolo ordine
"download:orders/#entityid#"
o
"download:orders?entity_id=#entityid#"
### Invo syncronizzazione
#### Invio full ordini
"upload:orders/full"
#### Invio singolo ordine
"upload:orders?entity_id=#entityid#"
#### Invio full task
"upload:tasks/full"
#### Invio singolo ordine
"upload:tasks?entity_id=#entityid#"
### Accesso da spalla a  moduloo contatti
"menu:contacts"
### Accesso da dashboard a  modulo contatti
"dashboard:contacts"
### Accesso a scheda cliente 
"contacts:detail?contact_id=#contact#"
### Accesso a tab vendite scheda cliente 
"contacts:detail?contact_id=#contact#&tab=sales_data"
.....

Client	Issue Implementativa	Stato
IOS App8E	67973
Android
Web

Attenzione Ove non indicato Completato sulla colonna Stato indica che la caratteristica non è ancora implementata in quell'ambiente.
La presenza di un indicazione nella colonna Issue Implementativa indica che la caratteristica è programmata nello Sviluppo
Ove non presente nulla significa che non è ancora schedulata o pragrammata l'implementazione nell'ambiente specifico