Appel du widget Statut à l'aide du code source

Création et utilisation de widgets › Intégration de widgets pour la demande de services et la gestion de demandes › Utilisation du widget Statut et d'autres widgets pour permettre aux utilisateurs d'accéder aux demandes › Utilisation des widgets Statut et Liste des demandes pour permettre aux gestionnaires de demandes d'approuver et de rejeter des demandes › Appel du widget Statut à l'aide du code source

Appel du widget Statut à l'aide du code source

Dans Liferay, vous pouvez appeler le widget Statut en créant le portlet et en indiquant le code source. Examinez les étapes suivantes pour produire l'exemple précédent du widget Statut. Suivez-les comme modèle pour configurer l'affichage et le comportement du widget Statut dans votre implémentation.

Procédez comme suit:

Sur la page du portail, effectuez ces actions pour créer le portlet :
1. Cliquez sur Add, Web Content Display.
2. Cliquez sur l'icône + (Add, Web Content).
  La fenêtre New Web Content s'affiche.
3. Spécifiez les champs obligatoires et fermez la fenêtre.
Le nouveau portlet s'ajoute à Liferay.
Cliquez sur Edit Controls en haut de la page.
Passez la souris sur le portlet, puis cliquez sur l'icône en forme de crayon (Edit Web Content).
Le portlet des paramètres s'affiche.
Dans la fenêtre Contenu, cliquez sur Source.
Le conteneur Source s'ouvre pour être modifié.
Examinez les paramètres sources et clés suivants pour le précédent exemple du widget Statut. Utilisez-les comme modèle pour indiquer votre source.
Procédez comme suit :
- Fermez le conteneur Source.
- Publiez et passez en revue le portlet mis à jour.
- Si nécessaire, affinez vos spécifications jusqu'à ce que le widget réponde à vos exigences.

Paramètres sources et clés

La source pour l'exemple de widget Statut suit :

<script type="text/javascript" src="http://nom-hôte:numéro-port/usm/explorer/scripts/status.widget.js"></script>

<script> CA_Catalog.buildWidget({type: 'status', renderTo: 'status1', layout:'layout-2', openIn: '_widget', hideCart: true} ); </script>

<div align="center" id="status1" style="width: 400px; margin-bottom: 10px; height: 100px">

	&nbsp;</div>

La première ligne référence le fichier JavaScript pour le widget Statut.

La deuxième ligne spécifie le JavaScript avec des paramètres de configuration pour le widget Statut.

Remarque : Séparez les paramètres par une virgule, mais ne mettez pas de virgule après le dernier paramètre.

La troisième ligne spécifie l'élément DOM dans lequel le widget Statut est rendu.

Les paramètres clés et des explications suivent pour l'appel de fonction CA_Catalog.buildWidget dans l'exemple de widget Statut.

informations d'identification

Pour les widgets, il est recommandé d'utiliser l'authentification unique. Toutefois, si vous nécessitez des informations d'identification pour ce widget, indiquez-les dans cet appel de fonction. Utilisez le format suivant:

nom d'utilisateur : "nom d'utilisateur", mot de passe : "mot de passe"

type:"status"

Indique que le widget est un widget Statut.

renderTo:"status1"

Indique que le widget est rendu dans l'élément DOM dont l'ID est status1.

layout:'layout-2'

Affiche les options du widget Statut sous forme de boutons dans une ligne unique. Les options sont Panier, Ouvert, Clôturé et En attente.

De même, indiquez layout-1 pour afficher les options verticalement : chaque option s'affiche sur sa propre ligne dans une table.

openIn:"_widget"

Indique que d'autres widgets situés sur la même page écoutent des événements à partir du widget Statut et qu'ils y répondent. Dans ce scénario, lorsque l'utilisateur clique sur une option du widget Statut, un autre widget répond en ouvrant la cible. Les cibles sont les suivantes :

Option	Fonction cible	Widget
Panier	Panier	Modifier la demande
Ouvert	Demandes ouvertes	Liste des demandes
Fermé	Demandes clôturées	Liste des demandes
En attente	Demandes en attente d'une action	Liste des demandes

Pour permettre à ces fonctions cibles de s'exécuter correctement lorsque les utilisateurs cliquent sur l'option correspondante dans le panier, les widgets suivants ajoutent à la page :

Ouvrir dans indique la méthode d'ouverture d'une cible lorsque l'utilisateur clique sur le widget Statut. D'autres valeurs sont possibles pour ce paramètre :

_self

Ouvre la cible dans le catalogue, sur la même page.

_top

Effectue la même fonction que _self, sauf que la cible s'ouvre dans le cadre supérieur du navigateur. Si la cible est un cadre, le premier cadre associé dans l'élément d'option de service est sélectionné.

_blank

Ouvre la cible dans une nouvelle page.

_url

Ouvre la cible à l'aide d'une adresse URL personnalisée. L'URL peut inclure un espace réservé pour l'ID de l'objet du contexte source, par exemple, le service.

Exemple :

http://www.google.com?id={id}

Remarque : Vous pouvez également spécifier les paramètres suivants, comme illustré dans le code source : Taux d'actualisation (en minutes) et Masquer le panier.