Description du service : Webservice retournant les sciper/nom/email relatifs aux différents 'rôles IT' dans les unités ENAC
Version : 1.1
Auteur  : ENAC-IT / Jean-Daniel Bonjour

Adresse : http://enacit.epfl.ch/roles-it/index.php

Paramètres (tous les 3 sont obligatoires, sinon affichage de cette page d'aide) :

- unite= acronyme | *
    acronyme => retourne les infos demandées (selon role et format) de l'unité acronyme
    * => retourne les infos demandées pour toutes les unités, précédées de :
        si format=sciper, nom ou email => acronyme_unite
        si format=json => acronyme_unite + espace_support + cf_unite
        si format=tsv  => acronyme_institut + espace_support + chef_nom + cf_unite + numero_unite + acronyme_unite
        
    Concernant espace_support : 1 -> it1, 2 -> it2, 3 -> it3

- role= chef | correspondant | support | stockage | *
    retourne les infos demandées (selon format) du rôle spécifié
    * => retourne tous les rôles ; ATTENTION cette option n'est autorisée que si format=json

    Remarques concernant l'héritage des rôles :
    - si une unité n'a pas de 'correspondant' IT, ce rôle est automatiquement assigné au 'chef' d'unité
    - si une unité n'a pas de responsable de 'support', ce rôle est assigné au 'correspondant'
    - pour les autres rôles, s'ils ne sont pas affectés à qqun ils sont assignés au responsable de 'support'


- format= sciper | nom | email | json | tsv
    sciper | nom | email => retourne le champ spécifié uniquement
    json => retourne les 3 champs: sciper + nom + email (au format JSON)
    tsv  => retourne les 3 champs: sciper + nom + email (au format tab-separated)


Exemples :

- JSON, tous les rôles dans 1 labo : http://enacit.epfl.ch/roles-it/?unite=ibeton&role=*&format=json
- TSV, un rôle dans 1 labo         : http://enacit.epfl.ch/roles-it/?unite=ibeton&role=support&format=tsv
- EMAIL d'un rôle dans 1 labo      : http://enacit.epfl.ch/roles-it/?unite=ibeton&role=support&format=email
- NOM d'un rôle dans 1 labo        : http://enacit.epfl.ch/roles-it/?unite=ibeton&role=chef&format=nom

- Pour générer une liste email triée par noms de famille, par exemple celle des resp. de support
  (on enlève l'unité, trie par noms, supprime les doublons, merge tout sur une ligne séparé par virgule) :
    curl -s "http://enacit.epfl.ch/roles-it/?unite=*&role=support&format=email" | sed 's/^.*\t//' | sort -t'.' -k2 | uniq | sed -z 's/\n/,/g' | sed 's/,$/\n/'


Paramètre d'administration (usage réservé) :

- regenerer : regénère la BD (après que la BD originale ait été éditée)