diff --git a/interface-elements-for-desktop/articles/rich-text-editor/document-layout-and-page-setup/divide-a-document-into-sections.md b/interface-elements-for-desktop/articles/rich-text-editor/document-layout-and-page-setup/divide-a-document-into-sections.md index 8bccddf889..d8d4d3d39b 100644 --- a/interface-elements-for-desktop/articles/rich-text-editor/document-layout-and-page-setup/divide-a-document-into-sections.md +++ b/interface-elements-for-desktop/articles/rich-text-editor/document-layout-and-page-setup/divide-a-document-into-sections.md @@ -36,4 +36,17 @@ You can change the type of the section break that has been inserted to start a s ![RTEPageSetupDialog_invoke](../../../images/img128736.png) 3. Change the **Section start** property on the **Layout** tab as required. - ![RTEChangeSectionStart](../../../images/img121271.png) \ No newline at end of file + ![RTEChangeSectionStart](../../../images/img121271.png) + + +## Section Protection + +You can protect/unprotect certain sections in your document. + +In the UI, do the following to protect/unprotect sections: + +1. Click **Protect Document** on the **Review** ribbon tab to open the [Document Protection](../document-protection/protect-and-unprotect-a-document.md) dialog. +2. In the invoked dialog, set the document protection type to *Filling in Forms* (allows users to fill in forms and form fields). +3. Select sections to be protected. When the section checkbox is selected, you can modify text only in form fields in this section. + + ![Rich Text Editor - Document Protection](../../../images/document-protection-dialog-sections.png) \ No newline at end of file diff --git a/interface-elements-for-desktop/articles/rich-text-editor/document-protection/protect-and-unprotect-a-document.md b/interface-elements-for-desktop/articles/rich-text-editor/document-protection/protect-and-unprotect-a-document.md index 6365d52f8a..c5124f306a 100644 --- a/interface-elements-for-desktop/articles/rich-text-editor/document-protection/protect-and-unprotect-a-document.md +++ b/interface-elements-for-desktop/articles/rich-text-editor/document-protection/protect-and-unprotect-a-document.md @@ -12,7 +12,7 @@ Follow the steps below to protect a document with a password. 1. On the **Review** [tab](../text-editor-ui/ribbon-interface.md), in the **Protect** group, click the **Protect Document** button. ![RTEProtectDocumentRibbonMenu](../../../images/img121364.png) -2. Specify a protection type in the invoked **Document Protection** dialog. Select **No changes (Read-only)** to restrict all actions, **Comments** - to allow leaving comments only, **Tracked Changes** - to prevent other users from creating untracked changes. +2. Specify a protection type in the invoked **Document Protection** dialog. Select **No changes (Read-only)** to restrict all actions, **Comments** - to allow users leave comments only, **Tracked Changes** - to prevent other users from creating untracked changes, **Filling in Forms** -to allows users to fill in forms and form fields. ![DocumentProtectionTypes](../../../images/img121365_1.png) @@ -39,6 +39,9 @@ Before [adding protection](#protect-a-document) to a document, you can specify c 5. Continue to select the document regions and give users permission to edit them. 6. After specifying all required parts, [enable protection](#protect-a-document). + +You can also restrict document modifications with **Document Protection** and **Unprotect Document** dialogs. For more information, refer to the following topic: [Sections](../document-layout-and-page-setup/divide-a-document-into-sections.md). + ## Remove Protection from a Document 1. On the **Review** [tab](../text-editor-ui/ribbon-interface.md), in the **Protect** group, click the **Unprotect Document** button. diff --git a/interface-elements-for-desktop/articles/rich-text-editor/pictures-and-text-boxes/insert-a-picture.md b/interface-elements-for-desktop/articles/rich-text-editor/pictures-and-text-boxes/insert-a-picture.md index 983d0d410b..bb5d7f5a4f 100644 --- a/interface-elements-for-desktop/articles/rich-text-editor/pictures-and-text-boxes/insert-a-picture.md +++ b/interface-elements-for-desktop/articles/rich-text-editor/pictures-and-text-boxes/insert-a-picture.md @@ -4,6 +4,7 @@ author: Boris Zaitsev legacyId: 8550 --- # Insert a Picture + You can insert graphics in the document, and convert it to inline or floating. The **Rich Text Editor** supports the following graphic types: @@ -14,10 +15,12 @@ The **Rich Text Editor** supports the following graphic types: * Tagged Image Format (*.tif, *.tiff) * Microsoft Enhanced Metafile (*.emf) * Windows Metafile (*.wmf) +* Scalable Vector Graphics (*.svg) +>[!NOTE] +>SVG images are preserved as vector graphics when you export documents to Open XML formats (DOCX, DOTX, DOTM, DOCM). When exporting to non-Open XML formats, SVG images are rasterized. - -To insert a picture into your document, position the caret to the desired location and on the **Insert** [tab](../text-editor-ui/ribbon-interface.md), in the **Illustrations** group, click the **Picture** button. +To insert a picture into your document, position the caret at the location, and click the **Picture** button in the **Illustrations** group of the **Insert** [tab](../text-editor-ui/ribbon-interface.md). ![RTEInsertInlinePict](../../../images/img121261.png) diff --git a/interface-elements-for-desktop/articles/spreadsheet/pictures-and-hyperlinks/insert-a-picture.md b/interface-elements-for-desktop/articles/spreadsheet/pictures-and-hyperlinks/insert-a-picture.md index 7b2604e0ff..6239417a97 100644 --- a/interface-elements-for-desktop/articles/spreadsheet/pictures-and-hyperlinks/insert-a-picture.md +++ b/interface-elements-for-desktop/articles/spreadsheet/pictures-and-hyperlinks/insert-a-picture.md @@ -4,6 +4,7 @@ author: Natalya Senichkina legacyId: 15755 --- # Insert a Picture + The **Spreadsheet** allows you to insert pictures in a worksheet. You can insert graphics of the following type. @@ -14,6 +15,10 @@ You can insert graphics of the following type. * Tagged Image Format (*.tif, *.tiff) * Microsoft Enhanced Metafile (*.emf) * Windows Metafile (*.wmf) +* Scalable Vector Graphics (*.svg) + +>[!NOTE] +>SVG images are preserved as vector graphics when you export documents to Open XML formats (XLSX, XLSM, XLTX, and XLTM). When exporting to non-Open XML formats, SVG images are rasterized. To insert a picture, follow the instructions below. 1. On the **Insert** tab, in the **Illustrations** group, click the **Picture** button. diff --git a/interface-elements-for-desktop/images/document-protection-dialog-sections.png b/interface-elements-for-desktop/images/document-protection-dialog-sections.png new file mode 100644 index 0000000000..63943ac65d Binary files /dev/null and b/interface-elements-for-desktop/images/document-protection-dialog-sections.png differ diff --git a/interface-elements-for-desktop/images/img121365.png b/interface-elements-for-desktop/images/img121365.png index b30ee84f3b..8b995e0931 100644 Binary files a/interface-elements-for-desktop/images/img121365.png and b/interface-elements-for-desktop/images/img121365.png differ diff --git a/interface-elements-for-desktop/images/img121365_1.png b/interface-elements-for-desktop/images/img121365_1.png index 6538e8972f..d6dd21cbef 100644 Binary files a/interface-elements-for-desktop/images/img121365_1.png and b/interface-elements-for-desktop/images/img121365_1.png differ diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes.md b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes.md index de7c35ef88..79a2439a27 100644 --- a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes.md +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes.md @@ -45,4 +45,6 @@ See the following topics to learn about the supported two-dimensional barcodes: * [GS1- Data Matrix](use-bar-codes/gs1-data-matrix.md) * [Intelligent Mail](use-bar-codes/intelligent-mail.md) * [PDF417](use-bar-codes/pdf417.md) -* [QR Code](use-bar-codes/qr-code.md) \ No newline at end of file +* [QR Code](use-bar-codes/qr-code.md) +* [GS1 QR Code](use-bar-codes/gs1-qr-code.md) +* [EPC QR Code](use-bar-codes/epc-qr-code.md) \ No newline at end of file diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/add-bar-codes-to-a-report.md b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/add-bar-codes-to-a-report.md index 0282fd1829..df7fdafd2e 100644 --- a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/add-bar-codes-to-a-report.md +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/add-bar-codes-to-a-report.md @@ -35,6 +35,86 @@ The following are some additional barcode options: * Use the **Padding** property to specify the indent between bars and the barcode's inner boundaries. +## Frames for QR Codes + +For QR Codes ([QR Code](qr-code.md), [GS1 QR Code](gs1-qr-code.md), and [EPC QR Code](epc-qr-code.md)), you can use the **Frame Options** property to configure the frame around the barcode. The Corner and Rectangle frames are available for all types of QR Codes. + +### Corner Frame + +The corner frame looks as follows: + +![](../../../../../images/qr-code-corner-frame.png) + +You can specify the following properties for corner frames: + + * **Frame Color** + + Specifies the frame color. + + * **Frame Width** + + Specifies the frame width in pixels. + + * **Padding** + + Specifies the distance between the frame and QR code. + + * **Text** + + Specifies the text that displayed in the frame. + + * **Text Alignment** + + Specifies how the text is aligned with the frame line. + + * **Text Color** + + Specifies the color of the text in the frame. + + * **Text Position** + + Specifies how the text is positioned against the QR code. + +### Rectangular Frame + +The rectangular frame looks as follows: + +![](../../../../../images/qr-code-rectangle-frame.png) + +You can specify the following properties for corner frames: + + * **Corner Radius** + + Specifies rounded corners for the rectangular frame in pixels. + + * **Frame Color** + + Specifies the frame color. + + * **Frame Width** + + Specifies the frame width in pixels. + + * **Padding** + + Specifies the distance between the frame and QR code. + + * **Text** + + Specifies the text that displayed in the frame. + + * **Text Alignment** + + Specifies how the text is aligned with the frame line. + + * **Text Color** + + Specifies the color of the text in the frame. + + * **Text Position** + + Specifies how the text is positioned against the QR code. + ## Bind to Data You can [bind](../bind-controls-to-data.md) the bar code's **Text** property to a data field obtained from a report's data source. Click the control's smart tag, expand the **Expression** drop-down list and select the data field. diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/bar-code-recognition-specifics.md b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/bar-code-recognition-specifics.md index e229ea15b0..78ce6d31ff 100644 --- a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/bar-code-recognition-specifics.md +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/bar-code-recognition-specifics.md @@ -28,6 +28,12 @@ At present, only [export to PDF](/interface-elements-for-desktop/articles/print- For [XLSX](/interface-elements-for-desktop/articles/print-preview/print-preview-for-winforms/exporting/xlsx-specific-export-options.md) and [XLS](/interface-elements-for-desktop/articles/print-preview/print-preview-for-winforms/exporting/xls-specific-export-options.md) export, the output resolution can be set up manually using the **Rasterization Resolution** property. +## Specify the DPI of the Device Used to Print the Bar Code + +The **Target Device Dpi** property allows you to specify the DPI of the device on which you wish to print your barcode. The `XRBarCode` control automatically adjusts bar density based on this property's value. + +Use the **Target Device Dpi** property to ensure that the bar code is scanned correctly on the target device. This is especially important if your printing device has a non-standard DPI setting. + ## Common Issues This document section provides solutions to the most common issues that you may encounter when creating barcodes. diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/epc-qr-code.md b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/epc-qr-code.md new file mode 100644 index 0000000000..f40e654f42 --- /dev/null +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/epc-qr-code.md @@ -0,0 +1,97 @@ +--- +title: EPC QR Code +author: Polina Tyureva +--- +# EPC QR Code + +An EPC QR Code (European Payments Council Quick Response Code) is a two-dimensional barcode used to initiate a [SEPA credit transfer (SCT)](https://www.europeanpaymentscouncil.eu/what-we-do/sepa-credit-transfer). The following guideline contains general information about this type of barcode and defines the data format for EPC QR Codes: [Quick Response Code - Guidelines to Enable the Data Capture for the Initiation of a SEPA Credit Transfer](https://www.europeanpaymentscouncil.eu/sites/default/files/kb/file/2022-09/EPC069-12%20v3.0%20Quick%20Response%20Code%20-%20Guidelines%20to%20Enable%20the%20Data%20Capture%20for%20the%20Initiation%20of%20an%20SCT_0.pdf). + +![EPC QR Code Barcode](../../../../../images/barcode-epc-qr-code.png) + +## Add a Bar Code to a Report + +1. Drag the **Barcode** item from the report controls toolbox tab and drop it onto the report. + + ![](../../../../../images/drag-and-drop-barcode.png) + +2. Set the control’s **Symbology** property to **EPC QR Code**. + + ![](../../../../../images/epc-qr-code-in-designer.png) + +3. Specify [common](add-bar-codes-to-a-report.md) barcode properties and properties [specific](#specific-properties) to **EPC QR Code**. + +## Specific Properties + +- **Auto Module** + + Gets or sets whether the Module property value should be calculated automatically based on the barcode size. + +- **Version** + + Gets or sets the bar code’s size. + +- **Include Quiet Zone** + + Gets or sets whether to add a blank space around the QR code. + +- **Logo** + + Specifies the image that overlays the QR code. + +- **Frame Options** + + Gets or sets the [frame for QR codes](add-bar-codes-to-a-report.md#frames-for-qr-codes). + +## Specify the Data + +EPC QR Codes require data in a specific format. For more information, refer to the following European Payments Council guideline: [Quick Response Code - Guidelines to Enable the Data Capture for the Initiation of a SEPA Credit Transfer](https://www.europeanpaymentscouncil.eu/sites/default/files/kb/file/2022-09/EPC069-12%20v3.0%20Quick%20Response%20Code%20-%20Guidelines%20to%20Enable%20the%20Data%20Capture%20for%20the%20Initiation%20of%20an%20SCT_0.pdf). + +You can specify the barcode data in the following ways: + +### The Text property. + +Pass the data string to Text property. Each data element should be on a new line. Double-click the control to specify the content (editors in the Property grid do not support multi-line text): + +![](../../../../../images/epc-qr-code-data.png) + +In the image above, the following data elements are specified: + +| Data Element | Value | +|----------|-------------| +| Service Tag:| BCD | +| Version: | 001 | +| Encoding: | 1 | +| Identification:| SCT | +| BIC: | BPOTBEB1 | +| Beneficiary Name: | Red Cross of Belgium | +| IBAN: | BE72000000001616 | +| Transfer Amount:| EUR1 | +| Transfer Reason:| CHAR | +| Creditor Reference: | Empty line | +| Remittance Information: | Urgency fund | +| Information: | Empty line | + + +This field is bindable. For more information on data binding, review the following help topic: [Bind Report Controls to Data](../bind-controls-to-data.md). + +### The ConvertDataToEPC function. + +Use the `ConvertDataToEPC` function from the Expression Editor to bind to the `Text` property. + +You can specify the data as shown below: + +``` +ConvertDataToEPC('Red Cross of Belgium', 'BE72000000001616', 'BPOTBEB1','20.0', '', 'Urgency fund', 'CHAR', 'Sample EPC QR code') +``` + +![](../../../../../images/convert-to-epc-function.png) + +You can not change the default values for Version and Encoding with this function. The default value for the Version data element is `002` and `UTF-8` for the Encoding. + +## Display a “Zahlen mit Code” Frame + +You can also apply a frame with the words “Zahlen mit Code” (to the right from the bottom to the top) to an EPC QR Code. The frame is used to highlight the function of the codes and to secure the identification. For more information, refer to the following Payment Services Austria (PSA) document: [Application of QR-Code for initiating of credit transfers](https://zv.psa.at/de/download/qr-code/339-qr-code-und-bcd-definition-3-en/file.html). + +This frame already contains predefined settings according to the standard. To set this frame, go to Barcode Tasks → Symbology → FrameOptions, and select **Payment Services Austria Frame**. + +![](../../../../../images/qr-frame-austria-design-time-options.png) diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/gs1-qr-code.md b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/gs1-qr-code.md index 2adcadecfc..91b553a9dd 100644 --- a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/gs1-qr-code.md +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/gs1-qr-code.md @@ -43,3 +43,7 @@ In the [property grid](../../report-designer-tools/ui-panels/property-grid-tabbe * **Version** Specifies the barcode's size. + +* **Frame Options** + + Gets or sets the [frame for QR codes](add-bar-codes-to-a-report.md#frames-for-qr-codes). \ No newline at end of file diff --git a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/qr-code.md b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/qr-code.md index c900172b89..3eae8620d6 100644 --- a/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/qr-code.md +++ b/reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/qr-code.md @@ -41,4 +41,8 @@ In the [property grid](../../report-designer-tools/ui-panels/property-grid-tabbe * **Logo** - Specifies the image that overlays the QR code. + Specifies the image that overlays the QR code. + +* **Frame Options** + + Gets or sets the [frame for QR codes](add-bar-codes-to-a-report.md#frames-for-qr-codes). diff --git a/reporting-for-desktop/images/barcode-epc-qr-code.png b/reporting-for-desktop/images/barcode-epc-qr-code.png new file mode 100644 index 0000000000..966a6c082f Binary files /dev/null and b/reporting-for-desktop/images/barcode-epc-qr-code.png differ diff --git a/reporting-for-desktop/images/convert-to-epc-function.png b/reporting-for-desktop/images/convert-to-epc-function.png new file mode 100644 index 0000000000..09f99efff8 Binary files /dev/null and b/reporting-for-desktop/images/convert-to-epc-function.png differ diff --git a/reporting-for-desktop/images/epc-qr-code-data.png b/reporting-for-desktop/images/epc-qr-code-data.png new file mode 100644 index 0000000000..6748d235a6 Binary files /dev/null and b/reporting-for-desktop/images/epc-qr-code-data.png differ diff --git a/reporting-for-desktop/images/epc-qr-code-in-designer.png b/reporting-for-desktop/images/epc-qr-code-in-designer.png new file mode 100644 index 0000000000..ab1d8dcb02 Binary files /dev/null and b/reporting-for-desktop/images/epc-qr-code-in-designer.png differ diff --git a/reporting-for-desktop/images/qr-code-corner-frame.png b/reporting-for-desktop/images/qr-code-corner-frame.png new file mode 100644 index 0000000000..af7ff849d8 Binary files /dev/null and b/reporting-for-desktop/images/qr-code-corner-frame.png differ diff --git a/reporting-for-desktop/images/qr-code-rectangle-frame.png b/reporting-for-desktop/images/qr-code-rectangle-frame.png new file mode 100644 index 0000000000..8a94c46ccf Binary files /dev/null and b/reporting-for-desktop/images/qr-code-rectangle-frame.png differ diff --git a/reporting-for-desktop/images/qr-frame-austria-design-time-options.png b/reporting-for-desktop/images/qr-frame-austria-design-time-options.png new file mode 100644 index 0000000000..cfd8c41847 Binary files /dev/null and b/reporting-for-desktop/images/qr-frame-austria-design-time-options.png differ diff --git a/reporting-for-desktop/toc.yml b/reporting-for-desktop/toc.yml index 9a47229cd1..cd9006e7e4 100644 --- a/reporting-for-desktop/toc.yml +++ b/reporting-for-desktop/toc.yml @@ -223,6 +223,8 @@ href: articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/qr-code.md - name: GS1 QR Code href: articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/gs1-qr-code.md + - name: EPC QR Code + href: articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/epc-qr-code.md - name: SSCC (Serial Shipping Container Code) href: articles/report-designer/report-designer-for-winforms/use-report-elements/use-bar-codes/sscc.md - name: UPC Shipping Container Symbol (ITF-14) diff --git a/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes.md b/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes.md index 24644e25d7..fcd53505ce 100644 --- a/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes.md +++ b/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes.md @@ -44,4 +44,6 @@ See the following topics to learn about the supported two-dimensional barcodes: * [GS1- Data Matrix](use-bar-codes/gs1-data-matrix.md) * [Intelligent Mail](use-bar-codes/intelligent-mail.md) * [PDF417](use-bar-codes/pdf417.md) -* [QR Code](use-bar-codes/qr-code.md) \ No newline at end of file +* [QR Code](use-bar-codes/qr-code.md) +* [QR Code](use-bar-codes/gs1-qr-code.md) +* [EPC QR Code](use-bar-codes/epc-qr-code.md) \ No newline at end of file diff --git a/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/add-bar-codes-to-a-report.md b/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/add-bar-codes-to-a-report.md index 276c4ea983..7a848afe93 100644 --- a/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/add-bar-codes-to-a-report.md +++ b/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/add-bar-codes-to-a-report.md @@ -33,6 +33,86 @@ The following are some additional barcode options: * Use the **Padding** property to specify the indent between bars and the barcode's inner boundaries. +## Frames for QR Codes + +For QR Codes ([QR Code](qr-code.md), [GS1 QR Code](gs1-qr-code.md), and [EPC QR Code](epc-qr-code.md)), you can use the **Frame Options** property to configure the frame around the barcode. The Corner and Rectangle frames are available for all types of QR Codes. + +### Corner Frame + +The corner frame looks as follows: + +![](../../../../images/qr-code-corner-frame.png) + +You can specify the following properties for corner frames: + + * **Frame Color** + + Specifies the frame color. + + * **Frame Width** + + Specifies the frame width in pixels. + + * **Padding** + + Specifies the distance between the frame and QR code. + + * **Text** + + Specifies the text that displayed in the frame. + + * **Text Alignment** + + Specifies how the text is aligned with the frame line. + + * **Text Color** + + Specifies the color of the text in the frame. + + * **Text Position** + + Specifies how the text is positioned against the QR code. + +### Rectangular Frame + +The rectangular frame looks as follows: + +![](../../../../images/qr-code-rectangle-frame.png) + +You can specify the following properties for corner frames: + + * **Corner Radius** + + Specifies rounded corners for the rectangular frame in pixels. + + * **Frame Color** + + Specifies the frame color. + + * **Frame Width** + + Specifies the frame width in pixels. + + * **Padding** + + Specifies the distance between the frame and QR code. + + * **Text** + + Specifies the text that displayed in the frame. + + * **Text Alignment** + + Specifies how the text is aligned with the frame line. + + * **Text Color** + + Specifies the color of the text in the frame. + + * **Text Position** + + Specifies how the text is positioned against the QR code. + ## Bind to Data You can [bind](../bind-controls-to-data.md) the bar code's **Text** property to a data field obtained from a report's data source. Click the **Text** property's ellipsis button in the [Expressions](../../report-designer-tools/ui-panels/expressions-panel.md) panel. The invoked [Expression Editor](../../report-designer-tools/expression-editor.md) allows you to select a data field or construct a complex binding expression with two or more data fields. diff --git a/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/bar-code-recognition-specifics.md b/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/bar-code-recognition-specifics.md index 2e38b21589..7217f1fc4b 100644 --- a/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/bar-code-recognition-specifics.md +++ b/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/bar-code-recognition-specifics.md @@ -28,6 +28,12 @@ At present, only [export to PDF](../../../document-viewer/exporting/pdf-specific For [XLSX](../../../document-viewer/exporting/xlsx-specific-export-options.md) and [XLS](../../../document-viewer/exporting/xls-specific-export-options.md) export, the output resolution can be set up manually using the **Rasterization Resolution** property. +## Specify the DPI of the Device Used to Print the Bar Code + +The **Target Device Dpi** property allows you to specify the DPI of the device on which you wish to print your barcode. The `XRBarCode` control automatically adjusts bar density based on this property's value. + +Use the **Target Device Dpi** property to ensure that the bar code is scanned correctly on the target device. This is especially important if your printing device has a non-standard DPI setting. + ## Common Issues This document section provides solutions to the most common issues that you may encounter when creating barcodes. diff --git a/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/epc-qr-code.md b/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/epc-qr-code.md new file mode 100644 index 0000000000..b88f68a473 --- /dev/null +++ b/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/epc-qr-code.md @@ -0,0 +1,97 @@ +--- +title: EPC QR Code +author: Polina Tyureva +--- +# EPC QR Code + +An EPC QR Code (European Payments Council Quick Response Code) is a two-dimensional barcode used to initiate a [SEPA credit transfer (SCT)](https://www.europeanpaymentscouncil.eu/what-we-do/sepa-credit-transfer). The following guideline contains general information about this type of barcode and defines the data format for EPC QR Codes: [Quick Response Code - Guidelines to Enable the Data Capture for the Initiation of a SEPA Credit Transfer](https://www.europeanpaymentscouncil.eu/sites/default/files/kb/file/2022-09/EPC069-12%20v3.0%20Quick%20Response%20Code%20-%20Guidelines%20to%20Enable%20the%20Data%20Capture%20for%20the%20Initiation%20of%20an%20SCT_0.pdf). + +![EPC QR Code Barcode](../../../../images/barcode-epc-qr-code.png) + +## Add a Bar Code to a Report + +1. Drag the **Barcode** item from the report controls toolbox tab and drop it onto the report. + + ![](../../../../images/eurd-web-add-bar-code-to-report.png) + +2. Set the control’s **Symbology** property to **EPC QR Code**. + + ![](../../../../images/epc-qr-code-in-designer.png) + +3. Specify [common](add-bar-codes-to-a-report.md) barcode properties and properties [specific](#specific-properties) to **EPC QR Code**. + +## Specific Properties + +- **Auto Module** + + Gets or sets whether the Module property value should be calculated automatically based on the barcode size. + +- **Version** + + Gets or sets the bar code’s size. + +- **Include Quiet Zone** + + Gets or sets whether to add a blank space around the QR code. + +- **Logo** + + Specifies the image that overlays the QR code. + +- **Frame Options** + + Gets or sets the [frame for QR codes](add-bar-codes-to-a-report.md#frames-for-qr-codes). + +## Specify the Data + +EPC QR Codes require data in a specific format. For more information, refer to the following European Payments Council guideline: [Quick Response Code - Guidelines to Enable the Data Capture for the Initiation of a SEPA Credit Transfer](https://www.europeanpaymentscouncil.eu/sites/default/files/kb/file/2022-09/EPC069-12%20v3.0%20Quick%20Response%20Code%20-%20Guidelines%20to%20Enable%20the%20Data%20Capture%20for%20the%20Initiation%20of%20an%20SCT_0.pdf). + +You can specify the barcode data in the following ways: + +### The Text property. + +Pass the data string to Text property. Each data element should be on a new line. Double-click the control to specify the content (editors in the Property grid do not support multi-line text): + +![](../../../../images/epc-qr-code-data.png) + +In the image above, the following data elements are specified: + +| Data Element | Value | +|----------|-------------| +| Service Tag:| BCD | +| Version: | 001 | +| Encoding: | 1 | +| Identification:| SCT | +| BIC: | BPOTBEB1 | +| Beneficiary Name: | Red Cross of Belgium | +| IBAN: | BE72000000001616 | +| Transfer Amount:| EUR1 | +| Transfer Reason:| CHAR | +| Creditor Reference: | Empty line | +| Remittance Information: | Urgency fund | +| Information: | Empty line | + + +This field is bindable. For more information on data binding, review the following help topic: [Bind Report Controls to Data](../bind-controls-to-data.md). + +### The ConvertDataToEPC function. + +Use the `ConvertDataToEPC` function from the Expression Editor to bind to the `Text` property. + +You can specify the data as shown below: + +``` +ConvertDataToEPC('Red Cross of Belgium', 'BE72000000001616', 'BPOTBEB1','20.0', '', 'Urgency fund', 'CHAR', 'Sample EPC QR code') +``` + +![](../../../../images/convert-to-epc-function.png) + +You can not change the default values for Version and Encoding with this function. The default value for the Version data element is `002` and `UTF-8` for the Encoding. + +## Display a “Zahlen mit Code” Frame + +You can also apply a frame with the words “Zahlen mit Code” (to the right from the bottom to the top) to an EPC QR Code. The frame is used to highlight the function of the codes and to secure the identification. For more information, refer to the following Payment Services Austria (PSA) document: [Application of QR-Code for initiating of credit transfers](https://zv.psa.at/de/download/qr-code/339-qr-code-und-bcd-definition-3-en/file.html). + +This frame already contains predefined settings according to the standard. To set this frame, go to Behavior → Symbology → FrameOptions, and select **Payment Services Austria Frame**. + +![](../../../../images/qr-frame-austria-design-time-options.png) diff --git a/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/gs1-qr-code.md b/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/gs1-qr-code.md index e5c5758860..15af54f82e 100644 --- a/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/gs1-qr-code.md +++ b/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/gs1-qr-code.md @@ -16,7 +16,7 @@ author: Polina Tyureva 2. Set the control’s **Symbology** property to **QR Code GS1**. - ![](../../../../images/barcode-gs1-qr-code.png) + ![](../../../../images/gs1-qr-code-web-report-designer.png) 3. Specify [common](add-bar-codes-to-a-report.md) barcode properties and properties [specific](#specific-properties) to **GS1 QR Code**. @@ -43,4 +43,8 @@ In the [property grid](../../report-designer-tools/ui-panels/properties-panel.md * **Version** Specifies the barcode's size. + +* **Frame Options** + + Gets or sets the [frame for QR codes](add-bar-codes-to-a-report.md#frames-for-qr-codes). \ No newline at end of file diff --git a/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/qr-code.md b/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/qr-code.md index 2095f4fc0a..8c758a2b37 100644 --- a/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/qr-code.md +++ b/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/qr-code.md @@ -40,3 +40,6 @@ In the [property grid](../../report-designer-tools/ui-panels/properties-panel.md Specifies the barcode's size. +* **Frame Options** + + Gets or sets the [frame for QR codes](add-bar-codes-to-a-report.md#frames-for-qr-codes). \ No newline at end of file diff --git a/reporting-for-web/images/barcode-epc-qr-code.png b/reporting-for-web/images/barcode-epc-qr-code.png new file mode 100644 index 0000000000..966a6c082f Binary files /dev/null and b/reporting-for-web/images/barcode-epc-qr-code.png differ diff --git a/reporting-for-web/images/convert-to-epc-function.png b/reporting-for-web/images/convert-to-epc-function.png new file mode 100644 index 0000000000..232f3d77c0 Binary files /dev/null and b/reporting-for-web/images/convert-to-epc-function.png differ diff --git a/reporting-for-web/images/epc-qr-code-data.png b/reporting-for-web/images/epc-qr-code-data.png new file mode 100644 index 0000000000..6f33ab9028 Binary files /dev/null and b/reporting-for-web/images/epc-qr-code-data.png differ diff --git a/reporting-for-web/images/epc-qr-code-in-designer.png b/reporting-for-web/images/epc-qr-code-in-designer.png new file mode 100644 index 0000000000..1a1787ba26 Binary files /dev/null and b/reporting-for-web/images/epc-qr-code-in-designer.png differ diff --git a/reporting-for-web/images/qr-code-corner-frame.png b/reporting-for-web/images/qr-code-corner-frame.png new file mode 100644 index 0000000000..af7ff849d8 Binary files /dev/null and b/reporting-for-web/images/qr-code-corner-frame.png differ diff --git a/reporting-for-web/images/qr-code-rectangle-frame.png b/reporting-for-web/images/qr-code-rectangle-frame.png new file mode 100644 index 0000000000..8a94c46ccf Binary files /dev/null and b/reporting-for-web/images/qr-code-rectangle-frame.png differ diff --git a/reporting-for-web/images/qr-frame-austria-design-time-options.png b/reporting-for-web/images/qr-frame-austria-design-time-options.png new file mode 100644 index 0000000000..7a34695101 Binary files /dev/null and b/reporting-for-web/images/qr-frame-austria-design-time-options.png differ diff --git a/reporting-for-web/toc.yml b/reporting-for-web/toc.yml index a31c410efb..b38c9605b8 100644 --- a/reporting-for-web/toc.yml +++ b/reporting-for-web/toc.yml @@ -244,6 +244,8 @@ href: articles/report-designer/use-report-elements/use-bar-codes/qr-code.md - name: GS1 QR Code href: articles/report-designer/use-report-elements/use-bar-codes/gs1-qr-code.md + - name: EPC QR Code + href: articles/report-designer/use-report-elements/use-bar-codes/epc-qr-code.md - name: SSCC (Serial Shipping Container Code) href: articles/report-designer/use-report-elements/use-bar-codes/sscc.md - name: UPC Shipping Container Symbol (ITF-14)