$app.addToHistory

Description

Ajoute une nouvelle entrée dans la table ewt_history.

Lorsque la propriété admin.enableHistory du config est activée, le moteur se charge automatiquement d'inscrire les traitements déclenchés par l'utilisateur via des commandes. Par contre les modifications apportées par les scripts ne sont pas reprises dans la table. La méthode $app.addToHistory permet d'inscrire manuellement des entrées dans la table.

Syntaxe

$app.addToHistory( values )

Paramètres

values map

Valeurs à reprendre dans la table. Le paramètre est un map au sein duquel la méthode s'attend à retrouver les éléments suivants:

context string / map

Contexte de l'élément sur lequel porte l'inscription à la table ewt_history. Le paramètre peut désigner soit un contexte (exprimé en tant que string en clair ou sous forme de hash) ou une map décrivant le contexte.

Les éléments du contexte sont répartis dans les colonnes modelName, docId, groupName, tupleId et fieldName de la table.

action string

Action à inscrire dans la colonne action de la table

actionParams

Paramètres d'action à reprendre dans la colonne actionParams de la table

oldValue

Ancienne valeur à reprendre dans la colonne oldValue de la table

newValue

Nouvelle valeur à reprendre dans la colonne newValue de la table

oldCaption

Ancien libellé à reprendre dans la colonne oldCaption de la table. Le moteur se charge de récupérer automatiquement le libellé s'il n'est pas spécifié.

newCaption

Nouvelle valeur à reprendre dans la colonne newValue de la table. Le moteur se charge de récupérer automatiquement le libellé s'il n'est pas spécifié.

comments

Commentaire(s) additionnel(s) à reprendre dans la colonne remark de la table

Note: Le nom est au pluriel pour être cohérent avec le nom de la colonne dans la table ewt_history. Cette dernière est au pluriel pour être compatible avec Oracle qui refuse qu'une colonne s'appelle simplement "comment".

Retour

Retourne toujours null

Exemple

Non disponible