Interface SPI du médiateur d'analyse de site actif

Le portail fournit une interface SPI JavaScript côté client nommée Interface SPI du médiateur d'analyse de site actif. Vous pouvez l'utiliser pour implémenter les regroupeurs. L'interface SPI du médiateur d'analyse de site actif permet aux regroupeurs d'enregistrer des fonctions de rappel ; l'infrastructure du portail appelle ces fonctions pour notifier le regroupeur des modifications de DOM qui peuvent s'appliquer à l'analyse de site actif.

Vous pouvez accéder à l'interface SPI du médiateur d'analyse de site actif à l'aide de la variable JavaScript globale suivante :

com.ibm.portal.analytics.SiteAnalyticsMediator

Notez que l'objet SiteAnalyticsMediator n'est pas disponible tant que le chargement de la page n'est pas terminé. L'objet SiteAnalyticsMediator définit les fonctions JavaScript suivantes :

register: function(/*Function*/ listener): Cette fonction permet d'enregistrer une fonction d'écouteur. Vous pouvez appeler cette fonction d'écouteur à l'aide de l'infrastructure de portail en cas de modifications de DOM qui peuvent s'appliquer au regroupeur. En règle générale, un regroupeur enregistre une seule fonction. La fonction enregistrée renvoie un identificateur de chaîne qui permet de désenregistrer l'écouteur ultérieurement.
La fonction d'écouteur fournie doit respecter la signature de fonction suivante : function (/*DOMNode[]?*/ node, /*Function?*/ callback) L'argument facultatif DOMNode[] indique les zones du DOM qui ont été modifiées. Si aucune matrice DOMNode n'est fournie, le regroupeur peut supposer que d'importantes parties du DOM ont été modifiées. Dans ce cas, faites fonctionner le regroupeur sur l'objet de document global. Vous pouvez utiliser le second argument de l'infrastructure pour transmettre éventuellement une fonction de rappel. Cette fonction de rappel doit être appelée par le regroupeur une fois le processus d'analyse du DOM terminé.
deregister : function(/*String*/ listenerID): Cette fonction permet de désenregistrer une fonction d'écouteur avec l'identificateur que vous avez obtenu lors de l'enregistrement de l'écouteur.
notify : function(/*DOMNode[]?*/ node, /*Function?*/ callback): Cette fonction permet de notifier tous les écouteurs enregistrés des modifications du DOM. Si vous savez quelle zone spécifique du DOM a été modifiée, vous pouvez transmettre les noeuds DOM correspondants. Cette fonction est généralement appelée par l'infrastructure du portail pour notifier les regroupeurs enregistrés des modifications du DOM. Elle peut également être utilisée par les applications AJAX qui mettent partiellement à jour le DOM. Si aucun noeud de DOM spécifique n'est fourni, le regroupeur peut supposer que la notification fait référence à la page de portail. Si des noeuds de DOM sont fournis, la notification fait référence à des éléments de page de portail. Outre la matrice DOMNode, vous pouvez éventuellement fournir une fonction de rappel.