SAP Baseline Apps Installation Guide
Install the SAP baseline apps
This guide explains how to install the SAP baseline apps.
Prerequisites:
-
SAP ECC 6.0 is installed.
-
Mobile Enterprise Platform Version 9.0 SP9 or later is installed.
-
Mobile Enterprise Platform is configured to integrate with your SAP system.
-
All required SAP BAPIs with code updates are installed. Refer to SAP BAPIs for baseline apps.
To install the SAP baseline apps, complete the following steps.
-
Download and extract the contents of the zip file containing the app package files to a folder of your choice.
-
In Advanced Inventory Platform Manager, import the SAP_TextStrings_en.xml localization file. Refer to Import language text.
-
In Advanced Inventory Platform Manager, for each app that you want to install, upload the associated promotion package, such as _SAP_ADC_CycleCount_xx.package. Refer to Upload a promotion package.
-
In Advanced Inventory Platform Manager, register the required SAP BAPIs.
-
For a list of the BAPIs required for each SAP app, refer to SAP BAPIs for baseline apps.
-
For steps to register a BAPI, refer to Register SAP .NET functions.
-
-
In Advanced Inventory Platform Manager, publish the apps. Refer to Publish an app.
Import language text
Language text strings (including user-defined text) can be imported from language text files (for example, dsicfgLanguageText_en.xml) from one Mobile Enterprise Platform 7+ instance to another.
To import a language text file, complete the following steps in Platform Manager.
-
Go to Admin > Configuration > Localization.
-
Select Import Language File.
-
On the Language Text Import page, select the language text file to import.Step InformationNote:For a Mobile Enterprise Platform English-only release, only English is available.
-
Select Upload.Expected ResultResult: The Language Items Conflict dialog box displays to show any differences between the text strings and text IDs.
-
For each Element ID, evaluate the text strings and select one of the following options.
-
To select all current elements, under Current, choose the first radio button.
-
To select all new elements, under New, choose the first radio button.
-
-
Select Save.
Upload a promotion package
Uploading a promotion package retains the version numbers of the app and its related items. The promotion package has a manifest that contains referenced items and their versions.
Note:Starting with version 9.5 SP4, the app promotion process speed has improved up to 15% faster than previous versions. Please contact your Cloud Inventory® representative to discuss upgrade options.
Prerequisite: The promotion package you want to upload must exist as a file with the .package extension.
To upload a promotion package, complete the following steps in Platform Manager.
-
Go to Develop > Application Studio.
-
Select Upload > Promotion Package.
-
Optional. For Promo Package ID, enter an ID.
-
In the Upload Promotion Package dialog box, select Choose File.
-
Select the .package file that you want to upload and select Open.
-
Select OK.
-
If the Items Conflict dialog box displays, some of the promotion package items already exist in the target instance of Mobile Enterprise Platform. To specify how to handle each conflict, complete one of the following actions.Step InformationNote:For a user with a non-development license and pristine items, only device database tables will display.Important:We recommend that you verify each item before you select Replace. If an item is used in an app, and you replace the item with the wrong version, it may result in the app no longer functioning.
-
For each item you want to keep, select Keep. The item maintains the current version number.
-
To keep all items, in the header row, select Keep. The items maintain their current version numbers.
-
For each item you want to replace, select Replace. Replacing a item will increase the version number of that item.
-
To replace all conflicting item, in the header row, select Replace. Replacing items increases the version numbers of those items.
Expected ResultResult: If a device database table is part of the project upload, the system prompts you to provide additional information, such as the source and middle-tier connection strings, and to indicate whether to include the data replication schedules. If you specify to replace a device DB table, the system deletes the existing table and its data, and then recreates the table. This action cannot be undone. -
-
When all selections are made, select OK.
-
If the Style Group Selection dialog box displays, the uploaded promotion package includes a form that does not reference a style group. This dialog allows you to select a style group for each form included in the promotion package.Step InformationNote:This conflict happens only for packages created prior to 8.1 SP2 and if the target system contains more than one style group.
-
Select OK.
Register SAP .NET functions
Registering functions provides access to the functions to be called in apps. A function can be registered any time, but it must be registered before creating an app that uses that function.
Prerequisites: Configure the SAP .NET Connector.
To register a function to the SAP .NET connector, complete the following steps in Platform Manager.
-
Go to Develop > Connectors.
-
Select SAP .NET.
-
If your system uses more than one environment, select your desired environment.
-
On the Registered Functions page, select Register New Function(s).
-
On the Search for Functions page, for Function name, enter a value to filter the list of functions to be registered by function name. This will filter the list of functions from which functions to register are selected.
-
For Group name, enter a value to filter the list of functions to be registered by a specific group. This specifies an SAP convention that categorizes functions by group. The group name filters the list of functions.
-
For Language, enter the language in which to display the functions to register. This defines the language in which the data displays for the user.
-
Select Next.
-
On the Select Functions to Register page, choose one or more functions to register and select Select all to select all functions or just select specific functions.Step InformationNote:You can clear all selections and start over by selecting Select none.
-
Select Finish.
-
When all functions are registered, select Done.
Postrequisite: After a function is registered, it can be tested using the Test tool for that function on the Registered Functions page. Refer to Test functions.
SAP BAPIs for baseline apps
Every SAP baseline app requires that one or more associated SAP BAPIs are installed and registered on your instance of Mobile Enterprise Platform. The same SAP BAPIs are required, regardless of whether you installed the prompt response or forms version of the app.
Cycle Count
/ZDSI/IS_FIELD_VALUE_VALID
Validates plant and storage location.
/ZDSI/MATPHYSINV_GETITEMS
Retrieves list of items in physical inventory document.
/ZDSI/IS_MAT_BATCH_SERIALIZED
Verifies material, batch, and serial information.
/ZDSI/MATPHYSINV_COUNT
Posts counts to physical inventory document.
/ZDSI/UPDATE_LOG_DB
Writes updates to the Advanced Inventory Transaction Log.
Goods Issue to Cost Center
/ZDSI/GOODSMVT_CREATE
Posts the goods movement.
/ZDSI/IS_FIELD_VALUE_VALID
Validates plant and storage location.
/ZDSI/IS_MAT_BATCH_SERIALIZED
Verifies material, batch, and serial information.
/ZDSI/MMBE
Checks the quantity of the material item against the quantity on hand.
/ZDSI/UPDATE_LOG_DB
Writes updates to the Advanced Inventory Transaction Log.
Goods Issue to Production Order
/ZDSI/GOODSMVT_CREATE
Posts the goods movement.
/ZDSI/IS_FIELD_VALUE_VALID
Validates plant and storage location.
/ZDSI/IS_MAT_BATCH_SERIALIZED
Verifies material, batch, and serial information.
/ZDSI/WO_GETITEMS
Retrieves the list of materials in a production order.
Goods Issue to Plant Maintenance Order
/ZDSI/GOODSMVT_CREATE
Posts the goods movement.
/ZDSI/IS_FIELD_VALUE_VALID
Validates plant and storage location.
/ZDSI/IS_MAT_BATCH_SERIALIZED
Verifies material, batch, and serial information.
/ZDSI/WO_GETITEMS
Retrieves the list of materials in a maintenance order.
Goods Issue to Scrap
/ZDSI/GOODSMVT_CREATE
Posts the goods movement.
/ZDSI/IS_FIELD_VALUE_VALID
Validates plant and storage location.
/ZDSI/IS_MAT_BATCH_SERIALIZED
Verifies material, batch, and serial information.
/ZDSI/MMBE
Checks the quantity of the material item against the quantity on hand.
Goods Receipt to Production Order
/ZDSI/IS_FIELD_VALUE_VALID
Validates plant and storage location.
/ZDSI/IS_MAT_BATCH_SERIALIZED
Verifies material, batch, and serial information.
/ZDSI/WO_GET_ORD_DETAILS
Retrieves work order information.
/ZDSI/GOODSMVT_CREATE
Posts the goods movement.
Inventory Inquiry
/ZDSI/BATCH_PLANT_STOCK_DETAIL
Returns the material stock details for batch and plant.
/ZDSI/IS_FIELD_VALUE_VALID
Validates plant and storage location.
/ZDSI/MATERIALS_READ_QUANTITY
Returns the quantity of a material available in a storage location.
/ZDSI/MMBE
Checks the quantity of the material item against the quantity on hand.
Location to Location Transfer
/ZDSI/GOODSMVT_CREATE
Creates a new material movement.
/ZDSI/IS_FIELD_VALUE_VALID
Validates plant and storage location.
/ZDSI/IS_MAT_BATCH_SERIALIZED
Verifies material, batch, and serial information.
/ZDSI/MMBE
Checks the quantity of the material item against the quantity on hand.
/ZDSI/UPDATE_LOG_DB
Writes updates to the Advanced Inventory Transaction Log.
Plant to Plant Transfer
/ZDSI/GOODSMVT_CREATE
Creates a new material movement.
/ZDSI/IS_FIELD_VALUE_VALID
Validates plant and storage location.
/ZDSI/IS_MAT_BATCH_SERIALIZED
Verifies material, batch, and serial information.
/ZDSI/MMBE
Checks the quantity of the material item against the quantity on hand.
/ZDSI/UPDATE_LOG_DB
Writes updates to the Advanced Inventory Transaction Log.
Purchase Order Receipt
/ZDSI/GOODSMVT_CREATE
Creates a new material movement.
/ZDSI/IS_FIELD_VALUE_VALID
Validates plant and storage location.
/ZDSI/PO_LIST_ALL_ITEMS
Lists the materials list on purchase order.
/ZDSI/IS_MAT_BATCH_SERIALIZED
Verifies material, batch, and serial information.
/ZDSI/IS_UPDATE_LOG_DB
Writes updates to the Advanced Inventory Transaction Log.
Unrestricted Stock Transfer to Quality or Blocked Stock
/ZDSI/GOODSMVT_CREATE
Creates a new material movement.
/ZDSI/IS_FIELD_VALUE_VALID
Validates plant and storage location.
/ZDSI/PO_LIST_ALL_ITEMS
Lists the materials list on purchase order.
/ZDSI/IS_MAT_BATCH_SERIALIZED
Verifies material, batch, and serial information.
/ZDSI/IS_UPDATE_LOG_DB
Writes updates to the Advanced Inventory Transaction Log.
Publish an app
App publishing is the process of validating and generating a version of the app that devices can execute. The publishing process must validate all app references, formula usage, and environment-sensitive data. After the publishing succeeds, a device app file is produced. The app file can then be transferred to a device and executed. All validation occurs during the publishing process, not during the app creation process.
Note:As of 9.5 SP5, you can set app publishing to run in the background while you perform other tasks. Select Configuration > System Settings, scroll to the Publishing section, and select the Allow publishing/promote to run in the background option. In addition, use the Background publishing check interval option to set how often you want the system to run an automatic background update.
To publish an app, complete the following steps in Platform Manager.Check your list of published items by selecting the arrow icon to the right of the search field at the top of the screen. A red dot on the arrow icon indicates something new has been published. Check your list of published items by selecting the arrow icon to the right of the search field at the top of the screen. A red dot on the arrow icon indicates something new has been published.
-
Go to Develop > Application Studio > Library.
-
Select Applications.
-
Hover over the app's version number in the highest promotion level and select Publish from the menu. If the app did not successfully publish, error messages display. Complete the following substeps to resolve errors.
-
Optional. In the Publish Results dialog box, select Copy to clipboard to copy the publishing results to your clipboard.
-
Select a link to the location from which the error originated or select a link to highlight the reference in the flowchart or form, and then correct the error.
-
Optional. To display the Publish Results box again, above the search box in the taskbar, select Last Published Results -
[App name].Step InformationNote:After a successful publish, the Last Published Results... label will include the app name and version published. If the most recent publish attempt failed, the label will only include the app name. -
When all errors are corrected, publish the app.
Step InformationNote:Warnings may display when publishing, but do not prevent an app from publishing and may be corrected at your discretion. Errors must be corrected before you can publish the app. -
Result: When the app successfully publishes, a confirmation message displays along with the version numbers and IDs of the app. The app is ready to run on the mobile device.
Loading...
There was a problem loading this topic