Description :

               Cette méthode ajout un objet «a» à un autre objet «b» qui contient implicitement une collection de type «b».
               Pour exemple, dans un site de petites annonces immobilières, une maison (produit) sera rattachée à une personne (user).

Paramètres :

               $sName, chaîne : Indique le nom du champs qui identifiera l’objet rattaché
               $oValue, objet : Indique l’objet à rattacher

Valeur de retour :

               Retourne «true» si l’ajout a été effectué avec succès
               Retourne «false» si l’objet n’a pu être ajouté

L’exemple suivant ajout un produit à un «user» :

<?php 

   //instanciation globale  
   include_once( 'phpsimpledb.class.php' ); 
   Global $oBDD; 
   $oBDD = new PHPSIMPLEDB(); 
   
   //récupération du "user" 
   $oUser = $oBDD->getObject( "users" ); 
   $oUser->load( 21 ); 
   
   //création du produit 
   $oProduit = $oBDD->getObject( "produits" ); 
   $oProduit->setData_field( "name", "jolie maison" ); 
   
   //ajout du produit au "user" 
   $oProduit->setData_object( "users_id", $oUser ); 
   
   //sauvegarde du produit 
   $oProduit->save(); 

?>

Note : Si vous tentez de sauvegarder un nouvel objet en base, assurez-vous que toutes les valeurs obligatoires sont renseignées.
Si vous oubliez de renseigner les champs obligatoires, votre tentative de sauvegarde échouera.