From 536cc4c086c6e42435911c88bae0c66ccd54221f Mon Sep 17 00:00:00 2001 From: NansiYancheva Date: Tue, 5 Nov 2024 15:59:38 +0200 Subject: [PATCH 1/4] docs(Grid): Link KBs to Excel export article --- _contentTemplates/grid/export.md | 2 -- components/grid/export/csv.md | 1 + components/grid/export/excel.md | 5 +++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/_contentTemplates/grid/export.md b/_contentTemplates/grid/export.md index 7ebfb30b81..171a4d3dcb 100644 --- a/_contentTemplates/grid/export.md +++ b/_contentTemplates/grid/export.md @@ -3,8 +3,6 @@ * Date and number formats are exported with the following format: `mm/dd/yyyy hh:mm:ss` plus the current app culture AM/PM specifier for dates, and `Convert.ToDouble(value)` for numbers (which uses the current thread culture). The Excel date formats are different than .NET date formats and Excel may not always recognize the column as dates, for example, if the entire date format from the .NET culture is used. -* Templates are not exported, because there is no provision in the framework for getting them at runtime. If a column, header or group header/footer has a template or aggregates, it will be ignored. The headers will be the `Title` of the column, the data is the data from the `Field`. If you need additional information, see if you can add it in e Field in the model, or create your own excel file (see example here). - * The Grid exports only `` instances. Other types of columns are not exported, for example command, checkbox, hierarchy, group and row-drag columns. * If the Grid is using `OnRead` and is exporting all pages, it will fire an additional `OnRead` event at the time of exporting, with a request `PageSize` of `0`. This will enable the component to obtain all data. diff --git a/components/grid/export/csv.md b/components/grid/export/csv.md index 39525d92cb..caefed66a7 100644 --- a/components/grid/export/csv.md +++ b/components/grid/export/csv.md @@ -196,6 +196,7 @@ For more advanced customizations (such as coloring the headers, bolding the titl The CSV export has the following specifics: * Column widths are not applied because a CSV document does not have such a concept. You can use any units in the grid itself, they will not be reflected in the exported document. If you need to add such structure, consider [exporting to an Excel file]({%slug grid-export-excel%}). +* Templates are not exported, because there is no provision in the framework for getting them at runtime. If a column, header or group header/footer has a template or aggregates, it will be ignored. The headers will be the `Title` of the column, the data is the data from the `Field`. If you need additional information, see if you can add it in e Field in the model, or create your own excel file (see example here). @[template](/_contentTemplates/grid/export.md#export-common-notes) diff --git a/components/grid/export/excel.md b/components/grid/export/excel.md index 9abd31bf2b..206942cc9c 100644 --- a/components/grid/export/excel.md +++ b/components/grid/export/excel.md @@ -188,15 +188,16 @@ To customize the exported file, handle the `OnBeforeExport` or `OnAfterExport` e The component allows you to control the data set that will be exported. It also provides built-in customization options for the columns such as `Width`, `Title` and more. -For more advanced customization (such as coloring the headers or bolding the titles) the Grid lets you get the `MemoryStream` of the file. Thus, you can customize it using the [`SpreadProcessing`](https://docs.telerik.com/devtools/document-processing/libraries/radspreadprocessing/overview) or the [`SpreadStreamProcessing`](https://docs.telerik.com/devtools/document-processing/libraries/radspreadstreamprocessing/overview) libraries that are available with your license. +For more advanced customization (such as coloring the headers or bolding the titles) the Grid lets you get the `MemoryStream` of the file. Thus, you can customize it using the [`SpreadProcessing`](https://docs.telerik.com/devtools/document-processing/libraries/radspreadprocessing/overview) or the [`SpreadStreamProcessing`](https://docs.telerik.com/devtools/document-processing/libraries/radspreadstreamprocessing/overview) libraries that are available with your license. Find examples on how to [format the cells of the exported Excel file with RadSpreadProcessing]({%slug grid-kb-custom-cell-formatting-with-radspreadprocessing%}) and how to [format the cells of the exported Excel file with RadSpreadStreamProcessing]({%slug grid-kb-custom-cell-formatting-with-radspreadstreamprocessing%}). -[Read more about how to customize the exported file...]({%slug grid-export-events%}) +Read more about how to [customize the exported file]({%slug grid-export-events%}). ## Notes The Excel export has the following specifics: * Excel does not understand units different than `px` for the column `Width`, and if you use them (such as `rem` or `%`), it will fail to parse them and will render a collapsed (hidden) column with zero width. +* Templates are not exported, because there is no provision in the framework for getting them at runtime. If a column, header or group header/footer has a template or aggregates, it will be ignored. The headers will be the `Title` of the column, the data is the data from the `Field`. If you need additional information, see if you can add it in e Field in the model, or create your own excel file (see example here). Find additional information on how to [export an image that is rendered in a Grid column template]({%slug grid-export-image-column-excel%}). @[template](/_contentTemplates/grid/export.md#export-common-notes) From a423e24cb1a48039f88135af58ded5a72ac19a76 Mon Sep 17 00:00:00 2001 From: NansiYancheva <106161782+NansiYancheva@users.noreply.github.com> Date: Wed, 6 Nov 2024 17:34:30 +0200 Subject: [PATCH 2/4] Update components/grid/export/csv.md Co-authored-by: Iva Stefanova Koevska-Atanasova --- components/grid/export/csv.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/components/grid/export/csv.md b/components/grid/export/csv.md index caefed66a7..16826c68d3 100644 --- a/components/grid/export/csv.md +++ b/components/grid/export/csv.md @@ -196,7 +196,7 @@ For more advanced customizations (such as coloring the headers, bolding the titl The CSV export has the following specifics: * Column widths are not applied because a CSV document does not have such a concept. You can use any units in the grid itself, they will not be reflected in the exported document. If you need to add such structure, consider [exporting to an Excel file]({%slug grid-export-excel%}). -* Templates are not exported, because there is no provision in the framework for getting them at runtime. If a column, header or group header/footer has a template or aggregates, it will be ignored. The headers will be the `Title` of the column, the data is the data from the `Field`. If you need additional information, see if you can add it in e Field in the model, or create your own excel file (see example here). +* Templates are not exported, because there is no provision in the framework for getting them at runtime. If a column, header or group header/footer has a template or aggregates, it will be ignored. The headers will be the `Title` of the column, the data is the data from the `Field`. If you need additional information, see if you can add it in a Field in the model, or create your own Excel file (see example here). @[template](/_contentTemplates/grid/export.md#export-common-notes) From 01262c59e421f6df09fc8915ee255e1f31f71901 Mon Sep 17 00:00:00 2001 From: NansiYancheva <106161782+NansiYancheva@users.noreply.github.com> Date: Wed, 6 Nov 2024 17:34:35 +0200 Subject: [PATCH 3/4] Update components/grid/export/excel.md Co-authored-by: Iva Stefanova Koevska-Atanasova --- components/grid/export/excel.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/components/grid/export/excel.md b/components/grid/export/excel.md index 206942cc9c..7c61e456d7 100644 --- a/components/grid/export/excel.md +++ b/components/grid/export/excel.md @@ -197,7 +197,7 @@ Read more about how to [customize the exported file]({%slug grid-export-events%} The Excel export has the following specifics: * Excel does not understand units different than `px` for the column `Width`, and if you use them (such as `rem` or `%`), it will fail to parse them and will render a collapsed (hidden) column with zero width. -* Templates are not exported, because there is no provision in the framework for getting them at runtime. If a column, header or group header/footer has a template or aggregates, it will be ignored. The headers will be the `Title` of the column, the data is the data from the `Field`. If you need additional information, see if you can add it in e Field in the model, or create your own excel file (see example here). Find additional information on how to [export an image that is rendered in a Grid column template]({%slug grid-export-image-column-excel%}). +* Templates are not exported, because there is no provision in the framework for getting them at runtime. If a column, header or group header/footer has a template or aggregates, it will be ignored. The headers will be the `Title` of the column, the data is the data from the `Field`. If you need additional information, see if you can add it in a Field in the model, or create your own Excel file (see example here). Find additional information on how to [export an image that is rendered in a Grid column template]({%slug grid-export-image-column-excel%}). @[template](/_contentTemplates/grid/export.md#export-common-notes) From 43958dfe0f03f72a05100d851dc5e89833355372 Mon Sep 17 00:00:00 2001 From: NansiYancheva Date: Wed, 6 Nov 2024 17:53:23 +0200 Subject: [PATCH 4/4] update after review --- components/grid/export/csv.md | 2 +- components/grid/export/excel.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/components/grid/export/csv.md b/components/grid/export/csv.md index 16826c68d3..f2172745e1 100644 --- a/components/grid/export/csv.md +++ b/components/grid/export/csv.md @@ -196,7 +196,7 @@ For more advanced customizations (such as coloring the headers, bolding the titl The CSV export has the following specifics: * Column widths are not applied because a CSV document does not have such a concept. You can use any units in the grid itself, they will not be reflected in the exported document. If you need to add such structure, consider [exporting to an Excel file]({%slug grid-export-excel%}). -* Templates are not exported, because there is no provision in the framework for getting them at runtime. If a column, header or group header/footer has a template or aggregates, it will be ignored. The headers will be the `Title` of the column, the data is the data from the `Field`. If you need additional information, see if you can add it in a Field in the model, or create your own Excel file (see example here). +* Templates are not exported, because there is no provision in the framework for getting them at runtime. If a column, header or group header/footer has a template or aggregates, it will be ignored. The headers will be the `Title` of the column, the data is the data from the `Field`. If you need additional information, see if you can add it in a Field in the model, or create your own Excel file. Find a project example on how to generate your own exported file. @[template](/_contentTemplates/grid/export.md#export-common-notes) diff --git a/components/grid/export/excel.md b/components/grid/export/excel.md index 7c61e456d7..499ca780a0 100644 --- a/components/grid/export/excel.md +++ b/components/grid/export/excel.md @@ -197,7 +197,7 @@ Read more about how to [customize the exported file]({%slug grid-export-events%} The Excel export has the following specifics: * Excel does not understand units different than `px` for the column `Width`, and if you use them (such as `rem` or `%`), it will fail to parse them and will render a collapsed (hidden) column with zero width. -* Templates are not exported, because there is no provision in the framework for getting them at runtime. If a column, header or group header/footer has a template or aggregates, it will be ignored. The headers will be the `Title` of the column, the data is the data from the `Field`. If you need additional information, see if you can add it in a Field in the model, or create your own Excel file (see example here). Find additional information on how to [export an image that is rendered in a Grid column template]({%slug grid-export-image-column-excel%}). +* Templates are not exported, because there is no provision in the framework for getting them at runtime. If a column, header or group header/footer has a template or aggregates, it will be ignored. The headers will be the `Title` of the column, the data is the data from the `Field`. If you need additional information, see if you can add it in a Field in the model, or create your own Excel file. Find a project example on how to generate your own exported file. Find additional information on how to [export an image that is rendered in a Grid column template]({%slug grid-export-image-column-excel%}). @[template](/_contentTemplates/grid/export.md#export-common-notes)