| Status | |
|---|---|
| Owner | BIRSE-ext, Gary |
| Stakeholders | |
| Jira Request ID | |
| Jira Development ID |
High- Level Specification
| Parameter | Value |
|---|---|
| Application System | SAP S4/HANA SyWay |
| Business Process Reference | 06.10 Manage Inventory and Logistics 06.11 Manage Warehouse and Logistics |
Functional Overview
This mobile app will allow barcodes to be decoded and will also provide an Data Capture option.
Barcode Decoding
Based on scanning a barcode, the application will show the raw content of the barcode, the barcode symbology and all the individual field content based on GS1 application identifiers.
This option will be used for troubleshooting any barcodes that cannot be processed by the Logistics Mobility Solution.
Data Capture
The application will also provide an Data Capture option where multiple barcodes can be scanned, and stored on SAP in a custom table.
When the app is executed on a desktop, a reporting option will allow users to display the details of the scanned barcodes and transfer the results to a spreadsheet.
The Data Capture option will be useful to the business in a variety of scenarios including the capture of SSCC numbers for a specific selection of materials, for reporting or further processing on SAP.
The application is to be named “GS1 Barcode Decoder”.
Scope and Objectives
Allows any barcode to be decoded and allows data capture of multiple barcodes.
Process Flow Diagram
Step | Description | Comment |
|---|---|---|
| 1 | Scan a barcode | Raw data, symbology and field content of barcode is displayed. |
| 2 | Use Data Capture option to scan multiple barcodes. | Field content of all barcodes scanned is stored on SAP. |
| 3 | Report captured data | Field content of all barcodes scanned is shown and can be transferred to a spreadsheet. |
Assumptions
None
Dependencies
None
Security, Integrity and Controls
None
Configuration Requirements
None
Language Requirements
This app will be available in all SyWay languages.
See KDD055 - Multi-Language Support.
Special Requirements
None
Design Rationale
Functional Requirements
Initial Screen
The application will prompt for the user to scan a barcode.
A “Data Capture” button will allow the user to go to Data Capture mode where all scanned barcodes will be stored in a transaction list (Like other handheld apps) and finally saved and stored on SAP in a custom table.
A reporting option “Report Captured Data” will show only when the app is executed in desktop mode.
When a barcode is scanned, the barcode value will be decoded to derive all field content based on GS1 application identifiers.
See Appendix for the GS1 application identifiers that need to be included in the decoding logic.
The application will display the raw content of the barcode, the symbology and all field values.
Data Capture
When the Data Capture option is selected, the screen will change to show that this mode is enabled.
The user must enter a group name as this will later allow selection of the scanned information on the desktop. The group number can be any alphanumeric value and there is no validation on this field other than it being a mandatory field.
The group name field will initially show the text “Enter a group name.”.
At the time of posting if no group name has been entered then show the error “Enter a group name.”.
Any barcode scanned will still be decoded with the existing decode logic but now scanned data will be stored in a scanned list like other handheld apps. In the scanned list the user will have the option to delete individual scans or all scans and to finally post the scanned data to SAP.
The scanned list will only show the SSCC number when present in the barcode or the entire barcode content when an SSCC is not present, but all decoded fields from the barcode scanned will be stored.
Processing Data
At the time of saving the data captured, additional information will be determined based on the SAP database and then all scanned data and additional data will be added to a custom table in SAP.
Additional Data
Field | Description |
Type | “HU” when the scanned ID is identified as an existing HU in SAP. Otherwise show “<Unknown>” |
Symbology | The Symbology of the barcode. e.g. GS1 Data Matrix |
Packaging Material | For HUs, the packaging material VEKP-VHILM |
Higher-Level HU | For HUs, show the HU number of any parent HU (VEKP-UEVEL) |
Highest-Level HU | For HUs, repeatedly read VEKP for each higher-level HU (VEKP-UEVEL) until the HU with no higher-level HU is found. Show the HU of this highest-level HU. NB. For single level HUs, the higher and highest HU numbers will be the same. |
Material | The material number for the HU. If the HU has more than one material then show the text “*MIX*”. |
Batch | The batch number for the HU. If the HU has more than one batch then show the text “*MIX*”. |
Scanned data.
Each field of scanned data in a GS1 barcode, as identified in the existing GS1 Decoder logic, will be stored in a dedicated field in the custom table.
GS1 Fields |
AI00 SSCC |
AI240 Material |
AI10 Batch |
AI20 Pack Hierarchy |
AI37 Count |
Data Capture Report
When the GS1 Decoder app is executed in desktop mode, a button will be available for “Data Capture Report”. This option will allow the user to report on the previously captured data based on a selection by Userid, date and group name.
The report results will list all fields in the custom table and provide the option to download to Excel.
Recommended UI Technology
This app will be developed using Neptune DXP Open Edition. The app will appear on the Neptune launchpad.
Application Screen
Wireframe or Mock-Up
See example screens in Functional Requirements section.
Screen Behavior
See example screens in Functional Requirements section.
Screen Navigation
Standard navigation.
Data Integration
| Field | Table-Field Name | Comments / Calculation / Field Manipulation / Input / Output / Validation rule / Value help |
|---|---|---|
| Barcode scanned | Custom table | Barcode content will be decoded and stored in custom table. |
Custom Tables
Data Capture table
| Field | Description | Data Type/Length | Validation rule / Value help |
|---|---|---|---|
| Group | Group Name | CHAR 20 | |
Type | Type of barcode | CHAR 10 | |
Symbology | Symbology of barcode scanned | CHAR 20 | |
HU | HU number | CHAR 18 | |
Packaging Material | Packaging material of scanned HU | CHAR 40 | |
Higher-Level HU | Higher-Level HU of scanned HU | CHAR 18 | |
Highest-Level HU | Highest-Level HU of scanned HU | CHAR 18 | |
Material | Material of scanned HU | CHAR 40 | |
Batch | Batch of scanned HU | CHAR 10 | |
AI00 SSCC | SSCC number on barcode | CHAR 18 | |
AI240 Material | Material number on barcode | CHAR 40 | |
AI10 Batch | Batch number on barcode | CHAR 10 | |
AI20 Pack Hierarchy | Pack Hierarchy on barcode | CHAR 20 | |
AI37 Count | Count on barcode | CHAR 20 | |
| Production Date | Production date on barcode | DATE | |
| Expiry Date | Expiry Date on barcode | DATE |
Master data
None
| Field | Description | Data Type/Length | Validation rule / Value help |
|---|---|---|---|
Configuration table
None
| Field | Description | Data Type/Length | Validation rule / Value help |
|---|---|---|---|
Tooltips
None
Front-End
This app can be executed on a mobile device or in desktop mode.
Mobile Services
Not applicable.
Authentication & Authorization
None
Accessibility
Not applicable.
Volumetrics
The data capture option should support the scanning of hundreds of barcodes, as required.
Performance Consideration
Not applicable.
Error Handling
Errors to appear in a pop up window that needs to be acknowledged by the user.
Testing
How to Test
Test Conditions and Expected Results
| ID | Condition | Expected Result |
|---|---|---|
| 1 | Scan a GS1 Data Matrix label from Loftware. | Barcode symbology and correct GS1 field content is shown. |
| 2 | Scan an as-is QR code. | Barcode symbology and content is correctly shown. |
| 3 | Scan a barcode from a vendor label | Barcode symbology and content is correctly shown. |
| 4 | Use the data capture option to scan several GS1 Data Matrix barcodes | Barcodes are correctly captured and stored on SAP. |
| 5 | Use the Data Capture report option to report the values scanned. | Barcode details are correctly reported and can be opened in a spreadsheet format. |
Test Considerations/Dependencies
None
Other Information
None
Development Details
Package
| Package Name | Parent Package |
|---|---|
UI Implementation
UI Type | UI Name | Fiori Catalogue | Design Rationale Reference |
|---|---|---|---|
API Implementation
| API Type | API Name | Purpose / High Level Logic | API Product | Design Rationale Reference |
|---|---|---|---|---|
Other Development Objects
| Object Type | Object Name | Purpose/High Level Logic | Design Rationale Reference |
|---|---|---|---|
Appendix
See also
Insert links and references to other documents which are relevant when trying to understand this decision and its implications. Other decisions are often impacted, so it's good to list them here with links. Attachments are also possible but dangerous as they are static documents and not updated by their authors.