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

Le contrôle d'exportation traite tous les aspects de l'exportation de l'état. Grâce à cette fonction, vous pouvez afficher un aperçu préliminaire de l'état 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.

    <%@ 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" %>



  2. Créez un objet ReportExportControl.

    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 Formats d'exportation.

Pour spécifier le format d'exportation
  1. Créez un objet ExportOptions.

    ExportOptions exportOptions = new ExportOptions();



  2. Spécifiez le format d'exportation en appelant la méthode setExportFormatType et en lui transmettant une constante ReportExportFormat représentant le format souhaité.

    exportOptions.setExportFormatType(ReportExportFormat.RTF);



    Remarque :    Vous trouverez la liste des constantes valides spécifiant les formats d'exportation dans la documentation de la classe ReportExportFormat figurant dans la Référence API Java de Crystal Reports pour Rational Application Developer.

Certains formats contiennent des options supplémentaires qui peuvent être configurées pour personnaliser l'exportation de l'état. 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é.

    Dans ce cas, le format d'exportation étant RTF, un objet RTFWordExportFormatOptions est créé.

    RTFWordExportFormatOptions RTFExpOpts = new RTFWordExportFormatOptions();



  2. Configurez les options que vous voulez définir.

    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);



  3. Appelez la méthode setFormatOptions de l'objet ReportExportOptions en lui attribuant l'objet des options de format.

    exportOptions.setFormatOptions(RTFExpOpts);    



Pour initialiser le contrôle d'exportation
  1. Définissez la source d'état du contrôle en appelant sa méthode setReportSource et en transmettant à la méthode une référence à l'objet source d'état que vous avez créé.

    exportControl.setReportSource(reportSource);



  2. Appelez la méthode setExportOptions en lui transmettant l'objet ExportOptions que vous avez créé auparavant.

    exportControl.setExportOptions(exportOptions);



  3. Il est possible que vous vouliez également appeler la méthode setExportAsAttachment.

    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 l'état exporté avant de l'ouvrir. Autrement, si le navigateur prend en charge l'ouverture du type de fichier exporté, l'état 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/