update ndc u barcode

Author: oblomov-dev

docs/.vitepress/config.mjs

@@ -101,6 +101,12 @@ export default defineConfig({
           { text: 'Translation, i18n', link: '/development/translation' },
           { text: 'Popups, Popover', link: '/development/popups' },
           { text: 'Troubleshooting', link: '/development/troubleshooting' },
+          { text: 'Specifics', collapsed : "false" , items: [
+            { text: 'Barcode Scanning', link: '/development/barcodes' },
+            { text: 'File Download, Upload', link: '/development/files', },
+            { text: 'Native Device Capabilities', link: '/development/ndc' },
+           ]
+          },
         ]
       },
       {
@@ -178,4 +184,4 @@ export default defineConfig({
     outline: { 
       level: [2,6]
     }
-})
+})

docs/configuration/performance.md

@@ -6,7 +6,7 @@ outline: [2, 4]
 
 abap2UI5 is fast! Almost everything is processed in the backend, leveraging the ABAP stack, which performs significantly faster than client-side or browser-based processing. <br>
 
-Frontend logic is kept to a minimum: no loops are executed, no unnecessary logic is added, and everything is passed directly to the UI5 framework. <br>
+Frontend logic is kept to a minimum: no business logic is executed, and everything is passed directly to the UI5 framework, focusing solely on user interface rendering. <br>
 
 abap2UI5 has been successfully tested with tables containing large numbers of entries and columns. So, you can confidently develop your app — performance should not be a concern.
 

docs/configuration/security.md

@@ -3,21 +3,25 @@ outline: [2, 3]
 ---
 
 # Security
+abap2UI5 is a backend-centric framework. All logic and business data remain securely on the backend, and the frontend only receives the data necessary to render the view. This approach helps maintain security while providing efficient functionality.
 
 ### HTTP Endpoint
 The abap2UI5 framework operates as an HTTP handler. You create this HTTP handler and call the abap2UI5 API within it. End users can access abap2UI5 by calling the endpoint externally, with security managed similarly to any other UI5 application.
 
-### Authorization
-Authorization is managed at the ICF (Internet Communication Framework) node level. You have full control over configuring your ICF node by adjusting visibility, login procedures, and other authorization settings.
+### Authentication 
+Authorization is handled at the ICF (Internet Communication Framework) node level. You have complete control over configuring the ICF node, including visibility settings, login procedures, and other security parameters.
 
-### Authentication
-Authentication settings are customizable by the app developer and can be managed at the application level or node level. For more information on configuring authentication for your endpoint refer to the details [here.](/configuration/authorization)
+### Authorization
+The app developer has full flexibility in managing authorization settings. These can be configured either at the application level or service node level. For detailed guidance on setting up authentication for your endpoint, refer to [this page.](/configuration/authorization)
 
 ### Backend Code
-abap2UI5 is delivered as custom code. Once installed, you "own" the code, allowing you to use or modify it as necessary. However, to benefit from future updates, it is recommended not to directly alter the main code line.
+abap2UI5 is delivered as custom code. Once installed, you have full ownership of the code, giving you the flexibility to modify it to suit your needs. However, to ensure compatibility with future updates, we recommend avoiding direct modifications to the core code base.
 
 ### Frontend Code
-The frontend of the application is a Single Page Application (SPA) built using SAPUI5 or OpenUI5. It is delivered from the HTTP endpoint upon the first request, following best practices for modern web applications.
+The frontend of the application is a Single Page Application (SPA) built using SAPUI5 or OpenUI5. It is delivered from the HTTP endpoint upon the first request, adhering to best practices for modern web applications. 
+
+### Business Logic
+The business logic of the abap2UI5 app is not sent to the client. All business-related processes remain securely on the server, ensuring sensitive data is never exposed on the frontend.
 
 ### Content-Security-Policy
 To enhance security, abap2UI5 uses a Content Security Policy (CSP) by default. CSP helps prevent attacks like cross-site scripting (XSS) and data injection by restricting which resources the browser is allowed to load. CSP is configured to allow only trusted sources such as ui5.sap.com, sapui5.hana.ondemand.com, and sdk.openui5.org, among others.

docs/development/barcodes.md

@@ -0,0 +1,34 @@
+# Barcode Scanning 
+
+Since UI5 version 1.102, the `sap.ndc.BarcodeScannerButton` control is part of the UI5 library, making barcode scanning simple and straightforward.
+
+The barcode scanner control can be used like any other UI5 control with abap2UI5. Below is a snippet demonstrating the basic functionality. You can add your custom barcode handling after the scanning event is triggered:
+
+```abap
+METHOD z2ui5_if_app~main.
+
+    client->view_display( z2ui5_cl_xml_view=>factory(
+        )->page(
+            )->barcode_scanner_button(
+                dialogtitle = `Barcode Scanner`
+                scansuccess = client->_event( 
+                    val   = 'SCAN_SUCCESS' 
+                    t_arg = VALUE #( 
+                        ( `${$parameters>/text}` )
+                        ( `${$parameters>/format}` ) ) )
+        )->stringify( ) ).
+
+    IF client->get( )-event = 'SCAN_SUCCESS'.
+        DATA(lv_input)  = client->get_event_arg( 1 ).
+        DATA(lv_format) = client->get_event_arg( 2 ).
+        "custom processing...
+        client->message_box_display( |Scan finished: { lv_input } { lv_format }| ).
+    ENDIF.
+
+ENDMETHOD.
+```
+Check out `z2ui5_cl_demo_app_124` to see barcode scanning in action.
+
+::: tip **UI5 Versions**
+Please note that this feature is only available when bootstrapping with the UI5 version and does not work with OpenUI5.
+:::

docs/development/events.md

@@ -23,7 +23,7 @@ METHOD z2ui5_if_app~main.
     CASE client->get( )-event.
         WHEN 'BUTTON_POST'.
             client->message_box_display( |Your name is { name }| ).
-     ENDCASE.
+    ENDCASE.
  
 ENDMETHOD.
 ```

docs/development/files.md

@@ -0,0 +1 @@
+# File Download, Upload

docs/development/ndc.md

@@ -0,0 +1,7 @@
+# Native Device Capabilities
+
+
+#### Geolocation
+
+
+#### Camera

docs/development/popups.md

@@ -3,10 +3,10 @@ outline: [2, 4]
 ---
 # Popups, Popovers
 
+UI5 offers functionality for displaying popups and popovers that overlay only specific areas of the view. Let’s see how this can be implemented using abap2UI5.
 
 ### Popup
 
-
 #### General
 
 To display a popup, use the method `client->popup_display` instead of `client->view_display`:
@@ -61,6 +61,9 @@ ENDMETHOD.
 #### Separated App
 For better source code structure, it's possible to encapsulate popups in separate classes and call them through [navigation](/development/navigation).
 
+#### Stack
+If you need to manage a stack of multiple popups, remember that abap2UI5 displays only one popup at a time on the frontend. However, you can maintain a popup stack in your backend logic and re-display the previous popup as needed. Check out `Z2UI5_CL_DEMO_APP_161`.
+
 ### Popover
 To display a popover, use the method `client->popover_display` and specify the ID of the control where you want the popover to appear:
  ```abap
@@ -122,4 +125,4 @@ Several pre-built popup classes are available for specific scenarios:
 * z2ui5_cl_pop_to_inform
 * z2ui5_cl_pop_to_select
 
-This collection of popups can be further extended to cover additional common use cases. Contributions are welcome!
+This collection can be further expanded to cover additional common use cases. Contributions are always welcome!

docs/development/troubleshooting.md

@@ -3,6 +3,7 @@ outline: [2, 6]
 ---
 
 # Troubleshooting
+Since all logic is written in ABAP, you can debug everything in the ABAP environment, just make sure to set an external breakpoint, as abap2UI5 apps are called externally via HTTP.
 
 ### Backend
 Set a breakpoint in your abap2UI5 app to debug your code. Verify that the XML view is generated correctly and check that all events are triggered on the backend as expected.
@@ -16,5 +17,7 @@ To begin, press `Ctrl+F12` to open the built-in debugger tools in abap2UI5
 Here, you can inspect the XML View and check the Data Model bound to the view.
 
 ##### UI5 Inspector
+Another useful option is SAP’s default debugging tool, the [UI5 Inspector.](https://chromewebstore.google.com/detail/ui5-inspector/bebecogbafbighhaildooiibipcnbngo?hl=es)
 
-Another useful option is SAP’s default debugging tool, the [UI5 Inspector.](https://chromewebstore.google.com/detail/ui5-inspector/bebecogbafbighhaildooiibipcnbngo?hl=es)
+##### Issues
+If your code looks correct, but you suspect a bug in the abap2UI5 framework, try to create a small sample that reproduces the issue. Open an issue in the abap2UI5 repository so we can investigate and fix the bug.

docs/get_started/about.md

@@ -2,52 +2,54 @@
 outline: [2, 6]
 ---
 # About
-
-Welcome to abap2UI5 – an open-source project designed to enable UI5 app development purely in ABAP.
+Welcome to abap2UI5 – an open-source framework designed to enable UI5 app development purely in ABAP. 
 
 ##### Features
-abap2UI5 provides a purely ABAP-based approach for developing UI5 applications, with no need for JavaScript, OData, or RAP. It recalls the simplicity of classic ABAP, where just a few lines of code could generate input forms and tables using Selection Screens and ALVs.
+Whether you're developing in the cloud or on-premise, abap2UI5 simplifies UI5 development, making it fast and efficient without the need for JavaScript, OData, or RAP. It recalls the simplicity of classic ABAP, where just a few lines of code could generate input forms and tables using Selection Screens and ALVs.
 
 ##### Evolution
-Launched in 2023 as a personal project, abap2UI5 initially focused on offering basic selection screen functionality for ABAP Cloud, accompanied by an introductory blog post on the SAP Community Network (SCN). With the support of the ABAP open-source community, it has grown significantly, adding a broad range of features. Today, abap2UI5 is a thriving, community-driven initiative.
+Launched in 2023 as a personal project, abap2UI5 initially focused on offering basic selection screen functionality for ABAP Cloud, accompanied by an introductory blog post on the SAP Community Network (SCN). With the support of the ABAP open-source community, it has grown significantly, adding a broad range of features. Today, abap2UI5 is a community-driven project, with contributions and feedback helping shape its development.
+
+##### Development
+Creating UI5 applications with abap2UI5 is straightforward: define a new ABAP class, implement a method from the abap2UI5 interface, and your app is ready. Each app is supported as an abapGit project, which simplifies installation across different systems and version control. 
+
+##### Architecture
+abap2UI5 follows a "thin frontend" approach, handling all processing, logic, and data management in the backend. This simplifies the setup, reduces the need for client-side actions (such as clearing caches), and keeps business logic and sensitive data on the server. The approach also enhances performance by leveraging server-side processing.
+
+##### System Footprint
+The abap2UI5 system footprint is kept as small as possible including only essential classes and interfaces in the base version. Additional functionality can be added by installing optional addons.
 
 ##### Compatibility
 ![alt text](image-15.png){ width=50% }
-abap2UI5 is compatible with both ABAP Cloud and Standard ABAP, supporting all ABAP releases from version 7.02 to ABAP for Cloud. It runs seamlessly on systems including R/3 NetWeaver, S/4HANA On-Premise, and S/4HANA Private Cloud, as well as cloud environments such as the BTP ABAP Environment and S/4HANA Public Cloud.
+abap2UI5 is compatible with both ABAP Cloud and Standard ABAP, supporting ABAP releases from version 7.02 to ABAP for Cloud. It works on R/3 NetWeaver, S/4HANA On-Premise, S/4HANA Private Cloud, and cloud environments such as the BTP ABAP Environment and S/4HANA Public Cloud.
 
 ##### Installation
 ![alt text](image-14.png){ width=50% }
-The framework consists solely of classes and interfaces, making it easy to install via abapGit, with no additional deployment required. Communication with the client is established by creating a new HTTP service.
-
-##### Development
-Creating UI5 applications in abap2UI5 is straightforward: define a new ABAP class and implement a single method from the abap2UI5 interface. Each app is fully supported as an abapGit project, allowing seamless installation across different systems.
+The framework consists solely of ABAP classes and interfaces, making it easy to install via abapGit, with no additional deployment steps required. You only need to create a new HTTP service to establish communication with the client.
 
 ##### ABAP Cloud
-abap2UI5 relies exclusively on released APIs, making it ideal for both on-stack and side-by-side extensions in the new ABAP for Cloud language version. Within your app, you’re free to utilize modern ABAP capabilities such as CDS, ABAP SQL, and EML.
-
-##### Clean Core
-By using only released APIs, abap2UI5 ensures your app is "cloud-ready and upgrade-stable," aligning with clean core principles and guaranteeing compatibility with future upgrades.
+abap2UI5 uses only released APIs, making it suitable for both on-stack and side-by-side extensions in ABAP for Cloud. You can use modern ABAP syntax features like CDS, ABAP SQL, and EML within your app.
 
 ##### ABAP Classic
-The abap2UI5 framework does not use any newer ABAP syntax features. This makes it also compatible for on-premise and R/3 NetWeaver systems, enabling development in classic ABAP (Tier 3) extensions. A downported version is available for systems below ABAP 7.50.
+The framework does not rely on newer ABAP syntax features, ensuring compatibility with on-premise and R/3 NetWeaver systems. A downported version is available for systems running ABAP versions earlier than 7.50.
 
-##### Architecture
-The abap2UI5 system footprint is kept as small as possible. The base version includes only essential classes and interfaces, and additional functionality can be incorporated by installing optional [addons.](/addons/addons)
+##### Clean Core
+By relying only on released APIs, abap2UI5 ensures that your applications remain "cloud-ready" and "upgrade-stable," aligning with SAP's clean core principles.
 
 ##### Security
 Since you configure the HTTP handler yourself, you retain complete control over all external communications, ensuring security.
 
 ##### Productive Usage
-abap2UI5 is technically just an implementation of an HTTP handler and can be used as any other HTTP service in a productive scenario.
+abap2UI5 is essentially an HTTP handler implementation and can be used like any other HTTP service in a production environment.
 
 ##### Launchpad
-Apps developed with abap2UI5 can be integrated into Fiori Launchpads on S/4 Systems or Build Workzone websites on SAP BTP, as well as into tiles on S/4HANA Public Cloud.
+Apps developed with abap2UI5 can be integrated into Fiori Launchpads on S/4 Systems, SAP Build Workzone websites on SAP BTP, and tiles on S/4HANA Public Cloud.
 
 ##### Support
 Support for abap2UI5 is provided by the community on a best-effort basis. If you need assistance, submit an issue or join the abap2UI5 community on Slack.
 
 ##### Contribution
-Contributions are encouraged! Whether through bug fixes, feature additions, documentation enhancements, or community engagement, your involvement helps the project thrive. Consider submitting a pull request, sharing feedback, or helping spread the word about abap2UI5.
+Contributions are welcome! Whether through bug fixes, feature requests, or documentation improvements, your involvement helps improve abap2UI5. You can submit pull requests, provide feedback, or share your experience with the community.
 
 ##### Sponsor
-abap2UI5 is maintained by dedicated developers who volunteer their time. If you or your company benefit from abap2UI5, but cannot contribute directly, please consider supporting the project in other ways. More details are available [here.](/resources/sponsor)
+abap2UI5 is maintained by volunteers. If you or your company benefit from the project but cannot contribute directly, consider supporting the project in other ways. More details are available [here.](/resources/sponsor)