Mise à jour d'un module EMu

La méthode insert est utilisée pour ajouter un nouvel enregistrement au module.

Arguments

La méthode prend deux arguments :

• values

  Spécifie toutes les valeurs de données à insérer dans l’enregistrement nouvellement créé.

  Les valeurs des données doivent être un tableau associatif. Les index du tableau doivent être des noms de colonnes.

• columns

  Permet de préciser quelles colonnes doivent être renvoyées une fois l’enregistrement créé. La valeur de column est spécifiée exactement de la même manière que dans la méthode fetch. Voir Spécification des colonnes pour plus de détails.

  Note: Il est très courant d’inclure irn comme l’une des colonnes à renvoyer. Cela permet d’obtenir la clé de l’enregistrement nouvellement créé.

Valeur de retour

La méthode renvoie un tableau associatif. Ce tableau associatif contient une entrée pour chaque colonne demandée. Ceci est identique au tableau associatif renvoyé pour chaque ligne dans le cadre de la méthode fetch.

Exemple

$parties = new IMuModule('eparties', $session) ;  /* Spécifiez les valeurs à insérer. */ $values = array ( 'NamFirst' => 'Chris', 'NamLast' => 'Froome', 'NamOtherNames_tab' => array  ( 'Christopher', 'Froomey' ) ) ;  /* Spécifiez les valeurs des colonnes à retourner après l'insertion. */ $columns = array ( 'irn', 'NamFirst', 'NamLast', 'NamOtherNames_tab' ) ;  /* Insérer le nouvel enregistrement. */ try { $result = $parties->insert($values, $columns) ; } catch (Exception $e) { print("Error : $e\n") ; exit(1) ; }  /* Afficher les valeurs retournées. */ $irn = $result['irn']; $first = $result['NamFirst']; $last = $result['NamLast']; $others = $result['NamOtherNames_tab']; printf("%s, %s (%d)\n", $last, $first, $irn); print("Other names:\n"); foreach ($others as $other) { print("\t$other\n"); } exit(0);

Si l’insertion d’enregistrements est autorisée, cela générera un résultat similaire à ce qui suit :

Froome, Chris (435)

Other names:

Christopher

Froomey

Si l’insertion d’enregistrements est refusée par le serveur, cela générera un résultat similaire à ce qui suit :

Erreur : ModuleUpdatesNotAllowed (authenticated,default) [500]

La méthode update permet de modifier un ou plusieurs enregistrements existants. Cette méthode fonctionne de façon très similaire à la méthode fetch. La seule différence réside dans l’argument values, qui contient un ensemble de valeurs à appliquer à chaque enregistrement spécifié.

Arguments

La méthode prend cinq arguments :

• flag
• offset
• count

  Ces arguments sont identiques à ceux utilisés par la méthode fetch. Ils définissent la position de départ et la taille du bloc d’enregistrements à mettre à jour.

• values

  Spécifie les colonnes à mettre à jour dans le bloc d’enregistrements spécifié. L’argument values doit être une référence de hachage. Les clés du hachage doivent être des noms de colonne.

  Cet argument est identique à l’argument values de la méthode insert.

• columns

  Permet de préciser quelles colonnes doivent être renvoyées une fois l’enregistrement créé. La valeur de column est spécifiée exactement de la même manière que dans la méthode fetch. Voir Spécification des colonnes pour plus de détails.

  Cet argument est identique à l’argument columns de la méthode insert.

Valeur de retour

La méthode update renvoie un objet IMuModuleFetchResult (identique à celui renvoyé par la méthode fetch). Il contient les valeurs du bloc d’enregistrements sélectionné après l’application des mises à jour.

Exemple

/* Trouver tous les enregistrements de Personnes / Organisations dont le prénom est "Chris" et le nom de famille ** "Froome". */ $parties = new IMuModule('eparties', $session); $terms = new IMuTerms(); $terms->add('NamFirst', 'Chris'); $terms->add('NamLast', 'Froome'); $parties->findTerms($terms); /* Spécifiez la colonne à mettre à jour et la nouvelle valeur.. */ $values = array ( 'NamFirst' => 'Christopher', ); /* Spécifiez les valeurs des colonnes à renvoyer après la mise à jour.. */ $columns = array ( 'irn', 'NamFirst', 'NamLast' ); /* Exécuter la mise à jour. */ try { $result = $parties->update('start', 0, -1, $values, $columns); } catch (Exception $e) { print("Error: $e\n"); exit(1); }  /* Afficher les valeurs retournées. */ print("Count: $result->count\n"); print("Hits: $result->hits\n"); print("Rows:\n"); foreach ($result->rows as $row) { $rowNum = $row['rownum']; $irn = $row['irn']; $first = $row['NamFirst']; $last = $row['NamLast']; printf("\t%d. %s, %s (%d)\n", $rowNum, $last, $first, $irn); } exit(0);

Si la mise à jour des enregistrements est autorisée, l'exemple générera un résultat similaire au suivant :

Count: 1

Hits: 1

Rows:

1. Froome, Christopher (435)

La méthode remove est utilisée pour supprimer un ou plusieurs enregistrements existants.

Arguments

La méthode prend trois arguments :

• flag

• offset
• count

  Ces arguments définissent la position de départ et la taille du bloc d’enregistrements à supprimer. Elles sont identiques à celles utilisées par les méthodes fetch et update.

Valeur de retour

La méthode renvoie un entier qui spécifie le nombre d’enregistrements qui ont été supprimés.

Exemple

/* Trouver tous les enregistrements de Personnes / Organisations dont le prénom est « Christopher » et le nom de famille ** « Froome ». */ $parties = new IMuModule('eparties', $session); $terms = new IMuTerms(); $terms->add('NamFirst', 'Christopher'); $terms->add('NamLast', 'Froome'); $parties->findTerms($terms);  /*Supprimer tous les enregistrements correspondants. */ try { $result = $parties->remove('start', 0, -1); } catch (Exception $e) { print("Error: $e\n"); exit(1); } print("Removed $result record(s)\n"); exit(0);

Si la suppression d’enregistrements est autorisée, l’exemple générera un résultat similaire au suivant :

Removed 1 record(s)