Comment utiliser des classes de propriétés combinées à des Composants JavaServer Faces pour Crystal Enterprise ?

Plusieurs attributs de composants d'interface utilisateur et de propriétés de beans gérés doivent être définis sur des instances de classes de propriétés. L'exemple suivant illustre l'utilisation des ces classes de propriétés dans une application.

Exemple

Le composant Logon possède un attribut logonButton. Cet attribut doit être défini sur une instance de la classe SubmitButton qui contient les propriétés permettant de définir l'apparence et le comportement du bouton du formulaire de connexion. Pour accéder à ces propriétés et les manipuler, le composant Logon doit référencer un bean qui instancie la classe SubmitButton. Vous devez d'abord créer le bean Java.

Pour créer un bean Java
  1. Dans la vue Palette, sous l'onglet Données, cliquez sur JavaBean et faites glisser un bean sur la page, dans le concepteur visuel.
  2. Astuce :    Vous pouvez également cliquer avec le bouton droit de la souris sur Scriptage JSP dans la vue Données de page, et choisir Nouveau > JavaBean.

  3. Dans le champ Nom de la boîte de dialogue Ajout de JavaBean, saisissez logonButton1.
  4. Dans le champ Class, saisissez le nom complet de la classe SubmitButtonProps :
  5. com.businessobjects.jsf.sdk.properties.SubmitButtonProps

    Astuce :    Vous pouvez également cliquer sur le bouton situé en regard du champ Class pour rechercher une classe à ajouter. Une boîte de dialogue Sélection d'une classe s'affiche pour vous permettre de rechercher la classe en saisissant les premières lettres de son nom dans le champ Choisissez une classe.

  6. Cliquez sur Rendre ce JavaBean réutilisable pour que le bean soit disponible pour d'autres pages, puis dans la liste Portée, cliquez sur Session.
  7. Cliquez sur Initialiser les propriétés pour configurer les valeurs par défaut initiales des propriétés de la classe SubmitButton.
  8. Dans la boîte de dialogue Initialisation des propriétés du JavaBean, cliquez sur Ajouter pour ajouter une nouvelle propriété à la liste.
  9. Cliquez dans le champ Nom, puis sélectionnez une propriété dans la liste.
  10. Toutes les propriétés de la classe SubmitButton disponibles sont affichées dans la liste. Dans ce cas, vous avez accès aux propriétés telles que text, imageUrl, type, alignment et visible.

  11. Saisissez la valeur de la propriété dans le champ Valeur correspondant.
  12. Par exemple, si vous sélectionnez la propriété text, saisissez la chaîne que vous voulez afficher sur le bouton de connexion, par exemple, "Connexion" ou "Envoi".

  13. Répétez les étapes 6 à 8 autant de fois que nécessaire pour initialiser les valeurs par défaut de toutes les propriétés souhaitées.
  14. Cliquez sur OK, puis sur Terminer.

Le bean Java logonButton1 est ajouté à la page et affiché dans la vue Données de page. Ajoutez ensuite une référence à ce bean à partir du composant Logon.

Pour référencer le bean de propriété à partir de l'attribut logonButton
  1. Sélectionnez le composant Logon dans le concepteur visuel.
  2. Dans la vue Propriétés, cliquez sur le bouton figurant en regard du champ de l'attribut logonButton.
  3. Dans la boîte de dialogue Sélection d'un objet de données de page, sélectionnez logonButton1, puis cliquez sur OK.

La mise en forme et le comportement du bouton de connexion du composant Logon sont à présent gérés par les données du bean récemment créé. Vous pouvez poursuivre la configuration du bean et modifier les valeurs de ses propriétés dans la vue Données de page. Ce type de fonctionnement est commun à tous les attributs de composant qui requièrent des classes de propriétés.

En outre, les beans EnterpriseItems et Identity contiennent des propriétés qui doivent être configurées pour les classes de propriétés. Pour ajouter une référence à un bean de propriété, vous devez procéder comme pour l'ajout de composants, en initialisant la propriété du bean EnterpriseItem ou Identity à partir de la vue Données de page. Pour en savoir plus, voir Comment initialiser les valeurs par défaut des beans Java ?.

La liste des attributs de composant et des propriétés de bean géré qui requièrent des classes de propriétés est fournie dans les tableaux ci-dessous.

Remarque :    Pour obtenir une documentation détaillée sur les classes de propriétés, voir la référence API Java de Crystal Reports pour Rational Application Developer.

Composant d'interface utilisateurAttributClasse de propriétés

Logon

authentication

AuthenticationProps

Logon

logoffButton

SubmitButtonProps

Logon

logonButton

SubmitButtonProps

Logon

system

SystemProps

ItemsGrid

alerts

AlertProps

ItemsGrid

pagerStyle

PagerProps

Path

showImages

ImagesProps

Bean géréPropriétéClasse de propriétés

EnterpriseItems

paging

PagingProps

EnterpriseItems

sortBy

SortProps



Business Objects
http://www.france.businessobjects.com/
Support technique
http://www.businessobjects.com/services/support/