API di piattaforma > JamioPlug > JamioPlug Survey

Genera un link ad un questionario unico, ovvero che può essere compilato da un numero di soggetti definito e noto che accedono al Survey tramite un link diverso da quello posseduto da altri soggetti diversi da questi noti.

Metodo

PlugSurvey/GetUniqueSurveyLink

Input
Name	Description	Type	Optional
token	Token di sessione (per la sessione corrente nel dominio corrente potrebbe essere null o vuoto)	String	Y
storageConfigurationReference	Collegamento alla configurazione del Plug Elastic Storage da utilizzare. Circa le proprietà: Name è valorizzato con un Nickname di una configurazione, URL nullo e Type Undefined. Il Name della configurazione viene utilizzato nel nome dell’indice del questionario.	Reference
templateReference	Collegamento del documento o componente che contiene il template.	Reference
surveyName	Nome del questionario.	String
sourceName	Nome sorgente. Di default il valore è Survey.	String	Y
dueDate	Data e ora massima in cui è possibile compilare il questionario.	DateTime	Y
readableAfterCompletion	True se il questionario deve essere leggibile anche dopo il completamento o la scadenza. Il valore di default è false.	Boolean	Y
linkedResourceReference	Risorsa eventualmente collegata.	Reference	Y
initData	Eventuali dati di inizializzazione dei campi del questionario (Questi devono corrispondere ai campi presenti nel template del questionario).	Dataset	Y
Output
Name	Description	Type	Optional
returnValue	Collegamento al questionario creato.	Reference

Commenti

La risoluzione del template avviene secondo il seguente pattern:

•se templateReference non punta ad un documento o ad un componente di tipo file viene generato un errore;

•se templateReference punta ad un componente di tipo file, si assume che il file associato a tale componente sia il file di testo che contiene il JSON del template;

•se templateReference punta ad un documento:

ose non presente un componente di tipo file viene generato un errore;

ose il componente principale è di tipo file, si assume che il file associato a tale componente sia il file di testo che contiene il JSON del template;

ose il documento contiene un unico componente di tipo file si assume che il file associato a tale componente sia il file di testo che contiene il JSON del template;

oaltrimenti viene generato un errore.

Il template riportato in templateReference può essere generato utilizzando Jamio Survey Designer.

Per tutte le altre condizioni al di fuori di quelle indicate nella tabella sopra riportata, viene generato un errore.