13.6.3.29 Doc::getLatestId()

13.6.3.29.1 Description

int|bool(false) getLatestId ( bool $fixed      = false,
                              bool $forcequery = false )

Si le document est révisable, ou est associé à un cycle de vie, alors la méthode getLatestId permet d'obtenir l'identifiant de la dernière révision du document.

13.6.3.29.1.1 Avertissements

Aucun.

13.6.3.29.2 Liste des paramètres

(bool) fixed

fixed permet d'indiquer qu'on souhaite obtenir l'identifiant de la dernière révision figée (voir propriété lmodify).

Par défaut fixed vaut false, et c'est l'identifiant de la dernière révision qui est retourné (indépendamment du fait que ce soit une révision figée ou non).

(bool) forcequery

forcequery permet de forcer l'exécution d'une requête en base de données pour rechercher la dernière révision.

Par défaut forcequery vaut false, et une nouvelle requête en base de données n'est pas exécutée pour la recherche de la dernière révision. Si ce paramètre n'est pas passé à true l'id retourné est le dernier id connu lors de la récupération du document en base.

13.6.3.29.3 Valeur de retour

La méthode retourne l'identifiant de la dernière révision lorsque cette dernière est trouvée, sinon le booléen false est retourné en cas d'erreur.

13.6.3.29.4 Erreurs / Exceptions

La méthode retourne false si :

• la propriété id du document est vide.

13.6.3.29.5 Historique

13.6.3.29.5.1 Release 3.2.5

La méthode getLatestId remplace la méthode précédemment nommée latestId.

L'utilisation de latestId est obsolète depuis la version 3.2.5 de dynacase-core.

13.6.3.29.6 Exemples

• Exemple #1

/*
 * Obtenir l'identifiant de la dernière révision
 * de la facture.
 */
$latestId = $facture->getLatestId();
 
/*
 * Imprimer cette dernière révision de la facture.
 */
imprimerFacture($latestId);

13.6.3.29.7 Notes

Aucune.

13.6.3.29.8 Voir aussi

• Propriété lmodify
• Doc::revise