Création et initialisation d'un contrôle d'exportation

Le contrôle d'exportation traite tous les aspects de l'exportation du rapport. Grâce à cette fonction, vous pouvez afficher un aperçu préliminaire du rapport exporté dans la fenêtre du navigateur ou l'exporter sous forme de pièce jointe en invitant l'utilisateur à la télécharger par le biais d'une boîte de dialogue. Le contrôle d'exportation est représenté par la classe ReportExportControl.

Pour créer un contrôle d'exportation
  1. Référencez les classes et les packages Java requis.
  2. <%@ page import="com.crystaldecisions.report.web.viewer.ReportExportControl" %>

    <%@ page import="com.crystaldecisions.reports.reportengineinterface.JPEReportSourceFactory" %>

    <%@ page import="com.crystaldecisions.sdk.occa.report.reportsource.IReportSourceFactory2" %>

    <%@ page import="com.crystaldecisions.sdk.occa.report.exportoptions.ExportOptions" %>

    <%@ page import="com.crystaldecisions.sdk.occa.report.exportoptions.ReportExportFormat" %>

    <%@ page import="com.crystaldecisions.sdk.occa.report.exportoptions.RTFWordExportFormatOptions" %>

  3. Créez un objet ReportExportControl.
  4. ReportExportControl exportControl = new ReportExportControl();

Une fois que vous avez créé l'objet ReportExportControl, vous devez spécifier le format d'exportation souhaité. Pour cet exemple, nous avons choisi RTF comme format d'exportation. Pour obtenir la liste complète des formats d'exportation, voir Fonctions du visualiseur.

Pour spécifier le format d'exportation
  1. Créez un objet ExportOptions.
  2. ExportOptions exportOptions = new ExportOptions();

  3. Spécifiez le format d'exportation en appelant la méthode setExportFormatType et en lui transmettant une constante ReportExportFormat représentant le format souhaité.
  4. exportOptions.setExportFormatType(ReportExportFormat.RTF);

    Remarque :    La liste des constantes valides spécifiant les formats d'exportation se trouve dans la documentation de la classe ReportExportFormat, dans la référence API de la Boîte à outils de Crystal Reports pour Rational Software Development Platform.

Certains formats contiennent des options supplémentaires qui peuvent être configurées pour personnaliser l'exportation du rapport. Par exemple, vous pouvez contrôler la plage de pages exportée pour quelques formats.

Pour configurer les options spécifiques au format
  1. Créez l'objet des options de format approprié.
  2. Dans ce cas, le format d'exportation étant RTF, un objet RTFWordExportFormatOptions est créé.

    RTFWordExportFormatOptions RTFExpOpts = new RTFWordExportFormatOptions();

  3. Configurez les options que vous voulez définir.
  4. Dans notre exemple, les options d'exportation sont configurées de sorte que seules les pages 1 à 3 soient exportées.

    RTFExpOpts.setStartPageNumber(1);

        RTFExpOpts.setEndPageNumber(3);

  5. Appelez la méthode setFormatOptions de l'objet ReportExportOptions en lui attribuant l'objet des options de format.
  6. exportOptions.setFormatOptions(RTFExpOpts);    

Pour initialiser le contrôle d'exportation
  1. Définissez la source de rapport du contrôle en appelant sa méthode setReportSource et en transmettant à la méthode une référence à l'objet source de rapport que vous avez créé.
  2. exportControl.setReportSource(reportSource);

  3. Appelez la méthode setExportOptions en lui transmettant l'objet ExportOptions que vous avez créé auparavant.
  4. exportControl.setExportOptions(exportOptions);

  5. Il est possible que vous vouliez également appeler la méthode setExportAsAttachment.
  6. L'affectation de la valeur "true" à cette méthode affiche une boîte de dialogue qui permet aux utilisateurs de votre application Web d'enregistrer le rapport exporté avant de l'ouvrir. Autrement, si le navigateur prend en charge l'ouverture du type de fichier exporté, le rapport exporté s'affiche directement dans la fenêtre du navigateur.

    exportControl.setExportAsAttachment(true);



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