Appel du widget Parcourir à 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 Demande pour permettre aux utilisateurs de demander des services › Appel du widget Parcourir à l'aide du code source

Appel du widget Parcourir à l'aide du code source

Dans Liferay, vous pouvez appeler le widget Parcourir en créant le portlet et en indiquant le code source. Examinez les étapes suivantes pour produire l'exemple précédent du widget Parcourir. Suivez-les comme modèle pour configurer l'affichage et le comportement du widget Parcourir 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 Parcourir. 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 Parcourir suit :

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

<script type="text/javascript"> CA_Catalog.buildWidget({type: 'browse', renderTo: 'browse1', rootId: 10001, linkColor: 'inherit', borderColor: 'black', layout:'layout-1', openIn:'_widget', search: true } ); </script>

<div id="browse1" style="margin-bottom: 10px; height: 700px">
	&nbsp;</div>

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

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

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 Parcourir est rendu.

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

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:"browse"

Spécifie que le widget est un widget Parcourir.

renderTo:"browse1"

Spécifie que le widget est rendu dans l'élément DOM dont l'ID est browse1.

rootId:10001

Spécifie l'ID de l'objet du dossier ou du service affiché par le widget Parcourir. Dans cet exemple, 10001 est le dossier racine du catalogue de l'unité business.

Vous pouvez spécifier un dossier unique ou une liste de services séparée par des virgules à l'aide de leurs ID d'objet.

Remarque : Vous pouvez également masquer l'arborescence (la liste de dossiers située à gauche). Pour masquer l'arborescence, indiquez le paramètre hideTree:true. Par défaut, ce paramètre est défini sur hideTree:false.

layout:'layout-1'

Affiche les icônes et les noms des services qui s'affichent dans le widget Parcourir.

De même, spécifiez layout-2 pour afficher les noms, les icônes et les descriptions des services.

openIn:"_widget"

Indique qu'un autre widget situé sur la même page écoute des événements à partir du widget Parcourir et qu'il y répond. Dans ce scénario, lorsque l'utilisateur clique sur un service, le widget Demande répond en ouvrant le service. Vous devez ajouter le widget Demande à cette page pour activer cette fonction.

OpenIn indique la méthode d'ouverture d'un service dans le widget Demande lorsque l'utilisateur clique sur le service dans le widget Parcourir. D'autres valeurs possibles pour le paramètre OpenIn suivent :

_self

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

_top

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

_blank

Ouvre le service dans le catalogue, sur une nouvelle page. L'utilisateur demande le service sur cette page.

_url

Ouvre le service à l'aide d'une adresse URL personnalisée. L'adresse URL peut inclure un espace réservé pour l'ID de l'objet du service. Exemple :

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

search: true

Indique que le widget Parcourir inclut le champ de recherche. Les utilisateurs peuvent utiliser ce champ pour effectuer une recherche dans le catalogue des services, d'après des noms ou des termes clés.

Remarque : Vous pouvez également spécifier les paramètres suivants, comme illustré dans le code source : Afficher les offres proposées, Couleur des liens, Couleur des bordures et Couleur de l'arrière-plan.