Gestion des applications

Le paquet LiveUser_Admin vous permet de gérer les applications utilisées au sein de LiveUser. Il fournit une série de méthodes pour interagir avec la table «liveuser_applications».

L'exemple 1 fourni avec ce paquet PEAR devrait vous aider à commencer rapidement.

Quelques méthodes sont disponibles pour la gestion des applications:

• addApplication: pour ajouter une application à la liste des applications
• updateApplication: pour modifier une application dans la liste des applications
• removeApplication: pour enlever une application de la liste des applications
• getApplications: pour consulter la liste des applications

Nous commencerons par ajouter une application, puis nous la modifierons. Nous pouvons alors créer une liste de toutes les applications dans la table avant d'en enlever une.

Voici l'exemple complet:

Télécharger «LUA_test_app.php»

Ajouter une application (addApplication)

function addApplication($data)

Paramètre(s)

Cette méthode nécessite 1 paramètre:

• un vecteur avec une paire clé/valeur pour chaque champ de «liveuser_applications»

La manière la plus simple est de fournir le nom de l'application seulement. Dans ce cas, la méthode allouera automatiquement un identifiant pour l'application (en utilisant la table «liveuser_applications_seq»).

Autrement, vous pouvez aussi fournir le nom de l'application et son identifiant.

Valeur retounée

Cette méthode retourne:

• «false» en cas d'erreur
• le nouvel identifiant de l'application en cas de succès

Exemple

Pour ajouter un nom d'application:

   ...
    $application_name = 'Another application';
    $data = array('application_define_name' => $application_name);
    $appId = $LUA->perm->addApplication($data);
   ...

Pour ajouter un nom et un identifiant d'application

   ...
    $application_id = 5;
    $application_name = 'Another application';
    $data = array('application_id' => $application_id,
                  'application_define_name' => $application_name);
    $appId = $LUA->perm->addApplication($data);
   ...

Ceci donne le résultat suivant:

Mettre à jour une application (updateApplication)

function updateApplication($data, $filter)

Paramètre(s)

Cette méthode nécessite 2 paramètres:

• un vecteur contenant une paire clé/valeur contenant les valeurs mises à jour
• un vecteur contenant une paire clé/valeur pour sélectionner l'enregistrement à mettre à jour

Attention: Si aucun paramètre n'est fourni, toutes les applications seront modifiées.

Valeur retournée

Cette méthode retourne:

• «false» en cas d'erreur
• «true» autrement

Exemple

   ...
    $new_application_name = 'Another application';
    $application_id = 5;
    $data = array('application_define_name' => $new_application_name);
    $filters = array('application_id' => $application_id);
    $updateApp = $LUA->perm->updateApplication($data, $filters);
   ...

Ceci donne le résultat suivant:

Enumérer les applications (getApplications)

function getApplications($params = array())

Paramètre(s)

Cette méthode nécessite 1 paramètre, c-à-d un vecteur contenant quelques paramètres pour la sélection:

• «filter»: un vecteur contenant une paire clé/valeur pour appliquer le critère de sélection

Valeur retournée

Cette méthode retourne:

• «false» en cas d'erreur
• «true» autrement

Exemple

Obtenir la liste de toutes les applications:

   ...
    $applications = $LUA->perm->getApplications();
   ...

Obtenir une liste filtrée des applications:

   ...
    $application_id = 5;
    $filter = array('filters' => array('application_id' => $application_id));
    $applications = $LUA->perm->getApplications($filter);
   ...

Ceci donne le résultat suivant:

Supprimer une application (removeApplication)

function removeApplication($filters)

Cette méthode supprimera une application et toutes les aires fonctionnelles associées.

Paramètre(s)

Cette méthode nécessite 1 paramètre:

• un vecteur avec une paire clé/valeur pour sélectionner l'enregistrement à enlever de «liveuser_applications»

Attention: Si aucun paramètre n'est fourni, toutes les applications seront enlevées.

Valeur retournée

Cette méthode retourne:

• «false» en cas d'erreur
• «true» autrement

Exemple

   ...
    $application_id = 5;
    $filter = array('application_id' => $application_id);
    $removeApp = $LUA->perm->removeApplication($filter);
   ...

Ceci donne le résultat suivant:

Obtenir de l'information sur la dernière erreur (getErrors)

function getErrors()

Dans le cas où une fonction retourne «false», celà signifie qu'il y a un problème. Vous pouvez obtenir l'information relative à l'erreur en appelant cette méthode.

Paramètre(s)

Cette méthode ne nécessite aucun paramètre.

Valeur retournée

Cette méthode retourne:

• l'information concernant l'erreur

Exemple

   ...
    $data = array('application_id' => $application_id,
                  'application_define_name' => $application_name);
    $appId = $LUA->perm->addApplication($data);

    if ($appId == false)
      {
      echo 'Add_app: error on line: '.__LINE__;
      print_r($LUA->getErrors());
      }
    else
      {
      echo 'Application with id ' . $appId . ' created';
      }
   ...