Créer la fonction Actualiser

Cette section présente un exemple de JavaScript que vous pouvez utiliser pour passer la sélection en cours de la page HTML vers le portail BI et avoir le portail BI actualiser tous les composants, à part lui-même.

Comment : Créer la fonction Actualiser

Dans Developer Studio, dans la fenêtre de dialogue Propriétés et paramètres, ouvrez Onglet conception.
Sur le formulaire, cliquez sur le bouton Exécuter. Ne cliquez pas sur le bouton Exécuter de Developer Studio.
Sur le côté droit du formulaire, basculer le panneau de Propriétés vers Evénements dans la partie inférieure, en utilisant les onglets.
Trouvez l'événement onclick et cliquez sur l'ellipse à la fin de champ.
Cette action vous permet de basculer sur la section JavaScript intégré et crée une fonction appelée form1Submit_onclick.
Dans la fonction, créer un appel à la fonction refreshReports que vous êtes en train d'écrire. La fonction complétée form1Submit_onclick est donc :
```
//Begin function form1Submit_onclick
function form1Submit_onclick(ctrl) {
  refreshReports();
}
//End function form1Submit_onclick
```

En dessous de fonction, placez le code pour créer la fonction refreshReports.

function refreshReports(){
  var name = this.window.name;
  parent.BipIframeInterface.setAllAmpersValues(name, IbComposer_getAllAmpersValues());
  parent.BipIframeInterface.refresh(parent.BipIframeInterface.REFRESH_ALL_BUT_SELF , name);
}

Remarque : la troisième ligne est renvoyée dans ce document, mais elle devrait apparaître sur une seule ligne lorsque vous écrivez dans le constructeur HTML.

Les trois lignes sont réparties de la manière suivante :

Ligne 1 :

var name = this.window.name;

Cette ligne prend le nom de la fenêtre en cours. Ceci est requis en tant que paramètres dans la ligne 2.

Ligne 2:

parent.BipIframeInterface.setAllAmpersValues(name,IbComposer_getAllAmpersValues());

Cette ligne doit être divisée en deux segments.

Segment 1 :

IbComposer_getAllAmpersValues())

Cette fonction reçoit les valeurs courantes, sélectionnées à partir de tous les contrôles présents sur une page Constructeur HTML, en tant qu'une chaîne unique que vous pouvez ajouter à la fin d'un appel par URL.

Segment 2 :

parent.BipIframeInterface.setAllAmpersValues

Cette fonction prend le nom de la fenêtre en cours et de la chaîne renvoyée par Segment 1 (ou tout autre chaîne que vous fournissez), et demande au portail de rajouter cette chaîne à la fin de toute requête exécutée sur toutes les pages du portail. Il existe un troisième paramètre optionnel qui peut être envoyé pour restreindre les variables sur une page spécifique. Voir un exemple d'une telle page spécifique ci-dessous.

parent.BipIframeInterface.setAllAmpersValues(name, "&ampers…", parent.BipIframeInterface.AMPERS_PAGE_ONLY);

Ligne 3 :

parent.BipIframeInterface.refresh(parent.BipIframeInterface.REFRESH_ALL_BUT_SELF , name);

Cette fonction actualise tous les cadres sur le portail qui ont déjà été exécutés, à l'exception du cadre avec les contrôles. Ceci inclut les cadres qui ne font pas partie de la page visible en cours.

Pour n'actualiser que la page en cours :

parent.BipIframeInterface.refresh(parent.BipIframeInterface.REFRESH_ALL_BUT_SELF,
   name, null, parent.BipIframeInterface.AMPERS_PAGE_ONLY);

Dans les exemples précédents, le premier paramètre de cette fonction est toujours :

BipIframeInterface.REFRESH_ALL_BUT_SELF

Il y a d'autres possibilités, présentées dans le tableau suivant.

Type d’actualisation	Valeur du paramètre
Tous les cadres	BipIframeInterface.REFRESH_ALL
Uniquement le cadre en cours	BipIframeInterface.REFRESH_SELF_ONLY
Tous à l'exception du cadre en cours	BipIframeInterface.REFRESH_ALL_BUT_SELF
Liste spécifique (tableau) de cadres	BipIframeInterface.REFRESH_ARRAY
Cadres non présents dans la liste (tableau) de cadres	BipIframeInterface.REFRESH_ALL_BUT_ARRAY

En dessous de la fonction window_onload, ajoutez la fonction onInitialUpdate pour passer des valeurs par défaut à tous les rapports.

function onInitialUpdate(){refreshReports();}

Remarque : cette fonction fournit des valeurs par défaut pour tout rapport n'ayant peut-être pas été spécifiée. Après le chargement des contrôles par le formulaire, la fonction est appelée et la valeur par défaut du formulaire est renvoyée à tous les rapports.

L'onglet complet JavaScript intégré est montré dans l'image suivante.

Enregistrez le formulaire.

Quittez Developper Studio.