Funzione: Employees -> List

Questa funzione permette la ricerca dentro al database dipendenti.

Parametri

Campo	Obbligatorio	Descrizione	Valori Ammessi
query	facoltativo	Parametri di ricerca Oggetto JSON tramite il quale è possibile specificare le chiavi di ricerca: (chiave = valore). Vedere sezione oggetto query più sotto per maggiori spiegazioni	Oggetto JSON
results	facoltativo	Numero dei risultati da visualizzare per pagina.	Numero. Predefinito: 10 risultati
page	facoltativo	Pagina da visualizzare Il sistema crea un numero di pagine sfogliabili in base al numero di risultati della ricerca e a quanti risultati si desidera vedere per pagina `results`	Numero. Predefinito: pagina 1
orderBy	facoltativo	Ordine di visualizzazione dei risultati Vedere sezione chiavi OrderBy supportate più sotto per maggiori spiegazioni	Stringa di testo contenente una chiave OrderBy supportata

Oggetto Query

Campo	Obbligatorio	Tipologia di ricerca	Descrizione	Valori Ammessi
general	facoltativo	estesa	Nome, email del dipendente che si desidera ricercare.	Stringa di testo
name	facoltativo	estesa	Nome del dipendente che si desidera ricercare.	Stringa di testo
email	facoltativo	estesa	Indirizzo email del dipendente che si desidera ricercare.	Stringa di testo
tax_code	facoltativo	estesa	Codice fiscale del dipendente che si desidera ricercare.	Codice alfanumerico

Chiavi OrderBy Supportate

OrderBy	Descrizione
employee_id\|ASC	Ordinato per codice identificativo del dipendente ascendente
employee_id\|DES	Ordinato per codice identificativo del dipendente discendente
contact_name\|ASC	Ordinato per nome del dipendente ascendente
contact_name\|DES	Ordinato per nome del dipendente discendente

Risultato

Campo	Obbligatorio	Descrizione	Valori Ammessi
nav	obbligatorio	Oggetto contenente i dati di navigazione.	Oggetto JSON
nav.page	obbligatorio	Numero di pagina visualizzato	Numero
nav.tot_pages	obbligatorio	Numero di pagine totali	Numero
nav.results	obbligatorio	Numero di risultati per pagina visualizzati	Numero
nav.tot_results	obbligatorio	Numero di risultato totali della ricerca	Numero
nav.orderBy	obbligatorio	Ordine di ricerca realmente applicato	Stringa di testo.
dataset	obbligatorio	Oggetto contenente i risultati	Oggetto JSON
dataset[n]	facoltativo	Oggetto contenente il risultato n	Oggetto JSON

La ricerca sui dipendenti genera come risultati oggetti "Anagrafiche Personale". Per visualizzare la struttura di un oggetto Anagrafiche Personale, guarda il risultato della funzione employees->get

Esempi

Esempio di ricerca di un dipendente inserito su Sirio.


require("SirioService.php");

//Creo l'oggetto per eseguire il servizio
$sirio = new SirioService();

//Parametri
$dataset = [
	"q" => [						// "q" sta per "query"
		"general" => "Mario"		
	],
	"r" => 20,						// "r" sta per "results" , numero risultati per pagina
	"p"   =>	1,					// "p" sta per "page", numero della pagina da visualizzare
	"s"    => "employee_id|DES"		// "s" sta per "sort"
];

//Eseguo il comando
$result = $sirio->sendCommand("employees", "list", $dataset);

/*
{
	nav: {
		page: 1,
		tot_pages: 1,
		results: 20,
		tot_results: 3,
		orderBy: "employee_id|DES"
	},
	dataset: {
		0: {
			employee_id: 2,
			iban: IT00000000000,
			contract_ral: 000,
			contract_months: 0,
			hours_weekly: 0,
			hours_effective: 8,
			status: 0,
			date_recruitment: 2017-06-01,
			date_dismissal: 2017-12-20,
			contact_name: Rossi Mario,
			entity_code: 200643eb8c16de8d5614ce9c4bc4bc24,
			entity_type: 100,
			entity_nationalitycode: IT,
			org_name: "",
			org_vat_code: "",
			org_tax_code: "",
			name: Mario,
			surname: Rossi,
			tax_code: RSSMRA82T28F205H,
			address_street: Via Milano,
			address_street_number: 1,
			address_city: Milano,
			address_province: MI,
			address_postalcode: 20100,
			address_countrycode: IT,
			contact_tel: "",
			contact_fax: "",
			contact_mobile: null,
			contact_email: MARIOROSSI@ABC.COM,
			date_created: 2017-06-09 13:59:48,
			date_updated: null
		},
		1: {
			...
		},
		2: {
			...
		},
		...
	}
}

*/

Manuale Utenti

Manuale Sviluppatori