ZotSell
Wizard Home | View

Cod. Ultima revisione 7E|8E|S|B Cod. Sviluppo
481 2018/02/05 - MA Issue : 8E
Issue : A
Issue : Sell


ATTENZIONE QUESTA GUIDA E' IN FASE DI REDAZIONE E REVISIONE (Work in progress)



Esportazione Task

Di seguito la lisita di api per interagire con i Task (rapportini, attività, ecc.) acquisiti dal sistema.

Lista tipi di Tasks

Sintassi base chiamata:

https://#NOMEHOST#/manager/taskstype/key/#TOKEN#

Esempio chiamare con protocollo https: 


test-enterprise.zotsell.com/manager/taskstype/key/26d055e4444622c65c8dbf98eBa141


E' possibile poi accodare dei parametri per ottenere una modifica nelle risposte
Il parametro si indica anteponendo il carattere
? al primo parametro  
& ai successivi 

Esempio 

<br>test-enterprise.zotsell.com/manager/taskstype/key/26d055e4444622c65c8dbf98eBa141?type=jsonlinks&kind=assistenza1


type

Indica il tipo di output da generare


nessuno valore
genera una json con questa struttura 

[
    {
       "type":"assistenza1"
    },
......
    {
       "type":"assistenza2"
    }
]



txt
Genera la lista testuale dei codici task.
Es. 

	assistenza1
	assistenza2
	.....



links
Genera un html con le chiamate alle api per le liste dei vari tipi di task




jsonlinks
genera una json con come per json aggiungendo i link alla lista task (utile eventualmente per integrare in con dei programmi di automazione di scaricamento task).
 
Es. 

[
  {
    "type": "assistenza1", 
    "linkJson": "https://test-enterprise.zotsell.com/manager/tasks/key/26d055e4444622c65c8dbf98eBa141App?type=json&kind=assistenza1" 
  }, 
....
]


Lista Tasks



Sintassi base chiamata:

http://#NOMEHOST#/manager/tasks/key/#TOKEN#

Esempio: 


test-enterprise.zotsell.com/manager/tasks/key/26d055e4444622c65c8dbf98eBa141


E' possibile poi accodare dei parametri per ottenere filtri formati


type

Indica il tipo di output da generare


nessuno valore
genera una json con questa struttura 

[
    {
       "entity_id":"FB968325-C99F-435D-B58B-12B2327D5456",
       "activity_code":"TASK8E_RAPPORTINO_ASSISTENZA1_20171020121236_001"
    },
......
    {
       "entity_id":"FB968325-C99F-435D-B58B-12B2327D5456",
       "activity_code":"TASK8E_RAPPORTINO_ASSISTENZA1_20171020121236_001"
    }
]



txt
Genera la lista testuale dei codici task.
Es. 

TASK8E_RAPPORTINO_ASSISTENZA1_20171020121236_001
TASK8E_RAPPORTINO_ASSISTENZA1_20171020121706_001
.....


txtid: come txt solo che genera la lista testuale degli entity_id (utile per chiamate successive)


links
Genera un html con le chiamate alle api per le liste dei vari tipi di task



jsonlinks
genera una json con come per json aggiungendo i link alla lista task (utile eventualmente per integrare in con dei programmi di automazione di scaricamento task).

Es. 

[
  {
    "entity_id": "FB968325-C99F-435D-B58B-12B2327D5247", 
    "activity_code": "TASK8E_RAPPORTINO_RLPRO_MAXIM_20171020121236_001",
    "linkJson": "https://test-enterprise.zotsell.com/manager/tasks/FB968325-C99F-435D-B58B-12B2327D5247/key/26d055e4444622c65c8dbf98eBa141App?type=json", 
    "linkTrack": "https://test-enterprise.zotsell.com/manager/tasks/FB968325-C99F-435D-B58B-12B2327D5247/key/26d055e4444622c65c8dbf98eBa141App?type=track"
  }, 
....
]




start_date

Indica la data da cui far partire l'estrazione dei task. Il valore viene considerato dalla data fornita esclusa in poi e viene confrontata con la data del task (quella inserita dall'utente).

Valori accettabili
2017
201709
20170901
2017090101
201709010101
20170901010101
2017-09-10
2017-09-10 01:01:01


end_date

indica la data limite di estrazione task. Il valore viene considerato dalla data fornita esclusa.

Valori accettabili: vedi start_date

limit

Limitazione del numero di task.

Valori accettabili: solo interi


offset

Record da cui far partire la l'estrazione

Valori accettabili: solo interi

wstatus

Indica se estrarre o meno i task con WorkingStatus uguale a zero

Valori accettabili: qualsiasi




Esempi di chiamate 



Errori


Codice 401: non autorizzato
Messaggio: Error: You must be authorized to view this page.



Dettaglio Task



test-enterprise.zotsell.com/manager/tasks/C97D2213-4A2E-4412-96E3-21999FB145D6/key/26d055e4444622c65c8dbf98eBa141App

Di default estrae la json del task. La json del task è quella registrata in database così come arriva da app.

Parametri accettati


type
indica il tipo di output da generare

nessuno valore:
restituisce la Json del task

 
track:
restituisce il tracciato del task (potrebbe non essere presente la configurazione per il tipo specifico)



Esempi chiamate
Json Task:  https://test-enterprise.zotsell.com/manager/tasks/C97D2213-4A2E-4412-96E3-21999FB145D6/key/26d055e4444622c65c8dbf98eBa141App
Tracciato Task:  https://test-enterprise.zotsell.com/manager/tasks/C97D2213-4A2E-4412-96E3-21999FB145D6/key/26d055e4444622c65c8dbf98eBa141App?type=track


Errori
Codice 401: non autorizzato
Messaggio: Error: You must be authorized to view this page.
Codice 404: Risorsa non presente (task non trovato)
Messaggio: Error: Resources not present