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 000000000..b2bb7536f --- /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,98 @@ +--- +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 + +- **AutoModule** + + 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. + +- **IncludeQuietZone** + + Gets or sets whether to add a blank space around the QR code. + +- **Logo** + + Specifies the image that overlays the QR code. + +- **FrameOptions** + + Gets or sets the frame 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: + +plaintext +``` +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/images/barcode-epc-qr-code.png b/reporting-for-desktop/images/barcode-epc-qr-code.png new file mode 100644 index 000000000..966a6c082 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 000000000..09f99efff 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 000000000..6748d235a 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 000000000..ab1d8dcb0 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-frame-austria-design-time-options.png b/reporting-for-desktop/images/qr-frame-austria-design-time-options.png new file mode 100644 index 000000000..cfd8c4184 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 9a47229cd..cd9006e7e 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/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 000000000..ceaf60634 --- /dev/null +++ b/reporting-for-web/articles/report-designer/use-report-elements/use-bar-codes/epc-qr-code.md @@ -0,0 +1,98 @@ +--- +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 + +- **AutoModule** + + 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. + +- **IncludeQuietZone** + + Gets or sets whether to add a blank space around the QR code. + +- **Logo** + + Specifies the image that overlays the QR code. + +- **FrameOptions** + + Gets or sets the frame 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: + +plaintext +``` +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) \ 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 000000000..966a6c082 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 000000000..232f3d77c 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 000000000..6f33ab902 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 000000000..1a1787ba2 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-frame-austria-design-time-options.png b/reporting-for-web/images/qr-frame-austria-design-time-options.png new file mode 100644 index 000000000..7a3469510 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 a31c410ef..b38c9605b 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)