Exportation vers un fichier CSV (Générateur de rapports et SSRS)Exporting to a CSV File (Report Builder and SSRS)

L’extension de rendu CSV (valeurs séparées par des virgules) permet de rendre les rapports paginés sous la forme d’une représentation aplatie des données d’un rapport dans un format standardisé, texte brut qui peut être facilement lu et échangé avec de nombreuses applications.The Comma-Separated Value (CSV) rendering extension renders paginated reports as a flattened representation of data from a report in a standardized, plain-text format that is easily readable and exchangeable with many applications.

L'extension de rendu CSV utilise un caractère en tant que délimiteur de chaîne pour dissocier les champs et les lignes. Le délimiteur peut être configuré pour être un caractère autre que la virgule.The CSV rendering extension uses a string character delimiter to separate fields and rows, with the string character delimiter configurable to be a character other than a comma. Le fichier résultant peut être ouvert dans un tableur comme Microsoft ExcelMicrosoft Excel ou utilisé comme format d'importation pour d'autres programmes.The resulting file can be opened in a spreadsheet program like Microsoft ExcelMicrosoft Excel or used as an import format for other programs. Le rapport exporté devient un fichier .csv et retourne un type MIME texte/csv.The exported report becomes a .csv file, and returns a MIME type of text/csv.

Si vous souhaitez utiliser des données liées aux graphiques, barres de données, graphiques sparkline, jauges et indicateurs dans Microsoft ExcelMicrosoft Excel, exportez le rapport vers un fichier CSV, puis ouvrez le fichier dans MicrosoftMicrosoft Excel.If you want to work with data related to charts, data bars, sparklines, gauges, and indicators in Microsoft ExcelMicrosoft Excel, export the report to a CSV file, and then open the file in MicrosoftMicrosoft Excel.

Pour plus d’informations sur l’exportation au format CSV, consultez Exporter des rapports (Générateur de rapports et SSRS).See Export Reports (Report Builder and SSRS) for details on how to export to CSV format.

Note

Vous pouvez créer et modifier des fichiers de définition de rapport (.rdl) paginés dans le Générateur de rapports et dans le Concepteur de rapports dans SQL Server Data Tools.You can create and modify paginated report definition (.rdl) files in Report Builder and in Report Designer in SQL Server Data Tools. Chaque environnement de création offre différentes possibilités pour créer, ouvrir et enregistrer des rapports et des éléments connexes.Each authoring environment provides different ways to create, open, and save reports and related items.

Rendu CSV CSV Rendering

Si un rapport CSV est rendu avec les paramètres par défaut, il présente les caractéristiques suivantes :When rendered using the default settings, a CSV report has the following characteristics:

  • La chaîne séparateur de champs par défaut est la virgule (,).The default field delimiter string is a comma (,).

    Note

    Vous pouvez changer de séparateur de champs et utiliser n'importe quel caractère voulu, y compris TABULATION, ce en modifiant les paramètres d'informations de périphérique.You can change the field delimiter to any character that you want, including TAB, by changing the device information settings. Pour plus d'informations, consultez CSV Device Information Settings.For more information, see CSV Device Information Settings.

  • La chaîne de délimiteur d’enregistrement est le retour chariot et saut de ligne (<cr ><lf >).The record delimiter string is the carriage return and line feed (<cr><lf>).

  • La chaîne d'identificateur de texte est le guillemet double (").The text qualifier string is a quotation mark (").

    Le convertisseur CSV n'ajoute pas d'identificateurs autour de toutes les chaînes de texte.The CSV renderer does not add qualifiers around all text strings. Les identificateurs de texte sont ajoutés uniquement lorsque la valeur contient le caractère délimiteur ou lorsque la valeur comporte un saut de ligne.Text qualifiers are added only when the value contains the delimiter character or when the value has a line break.

  • Si le texte contient une chaîne de séparateur ou d'identificateur incorporée, l'identificateur est placé autour du texte et les chaînes d'identificateur incorporées sont doublées.If the text contains an embedded delimiter string or qualifier string, the text qualifier is placed around the text, and the embedded qualifier strings are doubled.

  • La mise en forme et la mise en page sont ignorées.Formatting and layout are ignored.

    Les éléments suivants sont ignorés lors du rendu :The following items are ignored during rendering:

  • En-tête de pagePage header

  • Pied de pagePage footer

  • Éléments de rapport personnalisésCustom report items

  • LigneLine

  • ImageImage

  • RectangleRectangle

  • Sous-totaux automatiquesAutomatic subtotals

    Les autres éléments de rapport sont triés, de haut en bas, puis de gauche à droite.The remaining report items are sorted, from top to bottom, then left to right. Chaque élément est ensuite rendu dans une colonne.Each item is then rendered to a column. Si le rapport comporte des éléments de données imbriqués comme des listes ou des tableaux, les éléments parents sont répétés dans chaque enregistrement.If the report has nested data items like lists or tables, the parent items are repeated in each record.

    Le tableau suivant indique l'apparence des éléments de rapport lors du rendu :The following table indicates the appearance of report items when rendered:

ÉlémentItem Comportement de renduRendering behavior
Zone de texteText box Effectue le rendu du contenu de la zone de texte.Renders the contents of the text box. En mode par défaut, les éléments sont mis en forme en fonction des propriétés de mise en forme de l'élément.In default mode, items are formatted based on the item's formatting properties. En mode conforme, la mise en forme peut être modifiée par les paramètres d'informations de périphérique.In compliant mode, formatting can be changed by device information settings. Pour plus d'informations sur les modes de rendu CSV, voir ci-dessous.For more information about CSV rendering modes, see below.
TableTable Effectue le rendu en développant la table et en créant une ligne et une colonne pour chaque ligne et colonne au niveau de détails le plus bas.Renders by expanding the table and creating a row and column for each row and column at the lowest level of detail. Les colonnes et les lignes de sous-total ne comprennent pas de titres de colonne ou de ligne.Subtotal rows and columns do not have column or row headings. Les rapports d'extraction ne sont pas pris en charge.Drillthrough reports are not supported.
MatriceMatrix Effectue le rendu en développant la matrice et en créant une ligne et une colonne pour chaque ligne et colonne au niveau de détails le plus bas.Renders by expanding the matrix and creating a row and column for each row and column at the lowest level of detail. Les colonnes et les lignes de sous-total ne comprennent pas de titres de colonne ou de ligne.Subtotal rows and columns do not have column or row headings.
ListeList Effectue le rendu d'un enregistrement pour chaque instance ou ligne de détails dans la liste.Renders a record for each detail row or instance in the list.
Sous-rapportSubreport L'élément parent est répété pour chaque instance du contenu.The parent item is repeated for each instance of the contents.
GraphiqueChart Effectue le rendu en créant une ligne pour chaque valeur de graphique et étiquette de membre.Renders by creating a row for each chart value and member labels. Les étiquettes de séries et de catégories dans les hiérarchies sont aplaties et incluses dans la ligne pour une valeur de graphique.Labels from series and categories in hierarchies are flattened and included in the row for a chart value.
Barre de donnéesData bar Effectue le rendu comme un graphique.Renders like a chart. En règle générale, une barre de données n'inclut pas de hiérarchies ou d'étiquettes.Typically, a data bar does not include hierarchies or labels.
Graphique sparklineSparkline Effectue le rendu comme un graphique.Renders like a chart. En règle générale, un graphique sparkline n'inclut pas de hiérarchies ou d'étiquettes.Typically, a sparkline does not do not include hierarchies or labels.
JaugeGauge Effectue le rendu en tant qu'enregistrement unique avec les valeurs maximale et minimale de l'échelle linéaire, les valeurs de début et de fin de la plage et la valeur du pointeur.Renders as a single record with the minimum and maximum values of the linear scale, start and end values of the range, and the value of the pointer.
IndicateurIndicator Effectue le rendu en tant qu'enregistrement unique avec le nom de l'état actif, les états disponibles et la valeur de données.Renders as a single record with the active state name, available states, and the data value.
CarteMap Restitue une ligne avec les étiquettes et valeurs de chaque membre cartographique d'une couche.Renders a row with the labels and values for each map member of a map layer.

Si la carte comporte plusieurs couches, les valeurs dans les lignes varient selon que les couches utilisent des régions de données cartographiques identiques ou différentes.If the map has multiple layers the values in the rows varies depending on whether the map layers use the same or different map data regions. Si plusieurs couches utilisent la même région de données, les lignes contiennent des données de toutes les couches.If multiple map layers use the same data region, the rows contain data from all layers.

Données hiérarchiques et groupéesHierarchical and Grouped Data

Les données hiérarchiques et groupées doivent être aplaties pour être représentées au format CSV.Hierarchical and grouped data must be flattened in order to be represented in the CSV format.

L'extension de rendu aplatit le rapport en arborescence qui représente les groupes imbriqués dans la région de données.The rendering extension flattens the report into a tree structure that represents the nested groups within the data region. Pour aplatir le rapport :To flatten the report:

  • Une hiérarchie de ligne est aplatie avant une hiérarchie de colonne.A row hierarchy is flattened before a column hierarchy.

  • Les colonnes sont ordonnées comme suit : zones de texte dans le corps ordonnées de gauche à droite et de haut en bas, suivies des régions de données ordonnées de gauche à droite et de haut en bas.Columns are ordered as follows: text boxes in body order left-to-right, top-to-bottom followed by data regions ordered left-to-right, top-to-bottom.

  • Dans une région de données, les colonnes sont ordonnées comme suit : membres d'angle, membres de hiérarchie de ligne, membres de hiérarchie de colonne et enfin cellules.Within a data region, the columns are ordered as follows: corner members, row hierarchy members, column hierarchy members, and then cells.

  • Les régions de données d'homologue sont des régions de données ou des groupes dynamiques qui partagent une région de données commune ou un ancêtre dynamique commun.Peer data regions are data regions or dynamic groups that share a common data region or dynamic ancestor. Les données d'homologue sont identifiées par une création de branche au niveau de l'arborescence aplatie.Peer data is identified by branching of the flattened tree.

    Pour plus d'informations, consultez Tables, matrices et listes (Générateur de rapports et SSRS).For more information, see Tables, Matrices, and Lists (Report Builder and SSRS).

Modes du convertisseur Renderer Modes

L'extension de rendu CSV peut fonctionner dans deux modes : l'un est optimisé pour Excel, l'autre pour les applications tierces qui requièrent une conformité stricte à la spécification CSV décrite dans le document RFC 4180.The CSV rendering extension can operate in two modes: one is optimized for Excel and the other is optimized for third-party applications that require strict CSV compliance to the CSV specification in RFC 4180. Selon le mode que vous utilisez, les régions de données d'homologue sont gérées différemment.Depending on which mode you use, peer data regions are handled differently.

Mode par défautDefault Mode

Le mode par défaut est optimisé pour Excel.The default mode is optimized for Excel. En cas de rendu en mode par défaut, le rapport est rendu sous la forme d'un fichier CSV contenant plusieurs sections de données avec rendu CSV.When rendered in default mode, the report is rendered as a CSV file with multiple sections of CSV-rendered data. Chaque région de données d'homologue est délimitée par une ligne vide.Each peer data region is delimited by an empty line. Les régions de données d'homologue situées dans le corps du rapport sont rendues sous la forme de blocs de données distincts dans le fichier CSV.Peer data regions within the report body are rendered as separate blocks of data within the CSV file. Le résultat est un fichier CSV dans lequel :The result is a CSV file in which:

  • Les zones de texte individuelles situées dans le corps du rapport sont rendues une fois en tant que premier bloc de données dans le fichier CSV.Individual text boxes within the report body are rendered once as the first block of data within the CSV file.

  • Chaque région de données d'homologue de niveau supérieur dans le corps du rapport est rendue dans son propre bloc de données.Each top-level peer data region in the report body is rendered in its own data block.

  • Les régions de données imbriquées sont rendues en diagonale dans le même bloc de données.Nested data regions are rendered diagonally into the same data block.

Mise en formeFormatting

Les valeurs numériques sont rendues dans leur état mis en forme.Numeric values are rendered in their formatted state. Excel peut reconnaître les valeurs numériques mises en forme, telles que la devise, le pourcentage et la date, et met en forme les cellules de façon appropriée lors de l'importation du fichier CSV.Excel can recognize formatted numeric values, such as currency, percentage and date, and format the cells appropriately when importing the CSV file.

Mode conformeCompliant Mode

Le mode conforme est optimisé pour les applications tierces.Compliant mode is optimized for third-party applications.

Régions de donnéesData Regions

Seule la première ligne du fichier contient les en-têtes de colonne et chaque ligne contient le même nombre de colonnes.Only the first row of the file contains the column headers and each row has the same number of columns.

Mise en formeFormatting

Les valeurs sont dépourvues de mise en forme.Values are unformatted.

Interactivité Interactivity

L'interactivité n'est pas prise en charge par les formats CSV générés par ce convertisseur.Interactivity is not supported by either CSV formats generated by this renderer. Les éléments interactifs suivants ne sont pas rendus :The following interactive elements are not rendered:

  • Liens hypertexteHyperlinks

  • Afficher ou masquerShow or Hide

  • Explorateur de documentsDocument Map

  • Liens d'extraction ou interactifsDrillthrough or clickthrough links

  • Tri d'utilisateur finalEnd user sort

  • En-têtes fixesFixes headers

  • SignetsBookmarks

Paramètres d'informations de périphérique Device Information Settings

Vous pouvez modifier certains paramètres par défaut de ce convertisseur, notamment le mode de rendu, les caractères à utiliser comme séparateurs et ceux à utiliser comme chaîne par défaut d'identificateur de texte, ce en modifiant les paramètres d'informations de périphérique.You can change some default settings for this renderer, including which mode to render in, which characters to use as delimiters and which characters to use as the text qualifier default string, by changing the device information settings. Pour plus d'informations, consultez CSV Device Information Settings.For more information, see CSV Device Information Settings.

Voir aussiSee Also

Pagination dans Reporting Services (Générateur de rapports et SSRS) Pagination in Reporting Services (Report Builder and SSRS)
Comportements de rendu (Générateur de rapports et SSRS) Rendering Behaviors (Report Builder and SSRS)
Fonctionnalités interactives des différentes extensions de rendu de rapport (Générateur de rapports et SSRS) Interactive Functionality for Different Report Rendering Extensions (Report Builder and SSRS)
Rendu des éléments de rapport (Générateur de rapports et SSRS) Rendering Report Items (Report Builder and SSRS)
Tables, matrices et listes (Générateur de rapports et SSRS) Tables, Matrices, and Lists (Report Builder and SSRS)