UGI_uDGA_9.

2_uXLoader_ Configuration Guide

Table of Contents
Introduction..............................................................................................................................................................5

Security....................................................................................................................................................................5

Installing Solution Setup for uXLoader...................................................................................................................5

Logging and Exploring into uXLoader....................................................................................................................6

uXLoader User Interface (UI) Elements..............................................................................................................6

Explore the uXLoader GUI elements...................................................................................................................6

Logging into uXLoader........................................................................................................................................8

Appendix I:............................................................................................................................................................10

Class Details for EAM Objects..............................................................................................................................10

Class Details for AIW Objects...........................................................................................................................12

Class Details for MM Objects............................................................................................................................12

Appendix II: OData Service..................................................................................................................................13

List of OData Services.......................................................................................................................................13

uXLoader EAM Synchronous and Asynchronous merged OData Services......................................................13

uXLoader EAM Search OData Services............................................................................................................13

uXLoader AIW Synchronous and Asynchronous merged OData Services.......................................................14

uXLoader AIW Search Services........................................................................................................................14

uXLoader MM Synchronous and Asynchronous merged OData Services........................................................14

uXLoader MM Search Services.........................................................................................................................14

uXLoader EAM Additional Services..................................................................................................................14

uXLoader AIW Additional Services...................................................................................................................15

uXLoader MM Additional Services...................................................................................................................15

OData Configuration..........................................................................................................................................15

Activate SAP Gateway....................................................................................................................................15

Assign System Alias and Activate OData Service.........................................................................................16

Appendix III: Reports Scheduled in Background.............................................................................................19

Appendix IV: BC-Sets...........................................................................................................................................20

Appendix V: Displaying Product information.......................................................................................................21

Appendix VI: Uninstalling uXLoader...................................................................................................................22

Appendix VII: Troubleshooting.............................................................................................................................22

Installation Errors...............................................................................................................................................22

Prerequisites for uXLoader............................................................................................................................24

Page 2 of 31
 Error Messages...................................................................................................................................................24

Error in Data.......................................................................................................................................................25

Appendix VIII: SSO with SAML Certificate........................................................................................................26

Configure Certificate File Path..........................................................................................................................30

Page 3 of 31
Introduction
uXLoader is a tool which allows you to upload large amounts of data seamlessly and process the uploaded
data using Microsoft Excel.

In other words, uXLoader helps you to upload master data in SAP MDG directly through Excel for
FLOC/EQUI/MBOM/WC/MPMI/MSPT/GNTL/EQTL/FLTL, Asset Information Workbench (AIW) and
Material (MM).

The unique features of this tool are listed as in the following:

 Uploads Master Data into SAP MDG

 Uploads large volume of data with Excel based predefined templates.
 Creates and updates master data simultaneously.

MDG Roles & Security:

uXloader uses the Standard SAP MDG security framework. Users will need the SAP standard roles for
given MDG objects. No additional roles are needed.

Installing Solution Setup for uXLoader

This section describes the process of installing the uXLoader. You can also use the same steps, if you
already have a version installed and want to upgrade to the latest release.

Use the following steps to set up Utopia add-on in Excel and the install the uXLoader.

1. Navigate to the folder on your system where the Utopia Solution Setup file is saved and
extracted.

2. Click to run the installer.

The system displays the Microsoft Office Customization Installer screen as in the following screen.

3. Click “Install” button.

A message is displayed as “The Microsoft Office customization was successfully installed”.

Page 4 of 31
The successful installation displays the Utopia add-on menu option in the Excel sheet.

If you have any specific uXLoader version installed on your machine, you must uninstall the existing version
before installing the latest version. Otherwise, the system displays a message another uXLoader version is already
installed. See Appendix VI: Uninstalling uXLoader

Logging and Exploring into uXLoader

This section describes the process of logging into uXLoader and describes its UI elements.

User should have SAP Login enabled on the system before running application.

uXLoader User Interface (UI) Elements

This section illustrates the significant uXLoader user interface elements.

Explore the Ux Loader GUI elements.

This table lists the significant GUI elements that you might be looking for in the uXLoader:

Page 5 of 31
Function Menu Option
Activate the following options: uXLoader Tab

Login button,

Welcome <User>

Help drop-down

Displays the popup to enter the system details and the login Login
credentials

Displays the default message before login Welcome Guest!

Displays the following drop-down list. Help

 Utopia Add-in Help Center

 Technical Information
- Enterprise Asset Management
- Fashion Management Solution
- Material Management
- Retail and Fashion Management
 Settings
 Language
 Utopia License
 About
 IniCreator
 ClearCache
Utopia Add-in Help Center
(inactive for this release)

Displays the documents about selected technical objects Technical Information

Displays the login information for the selected object Settings

Select the Language before login if required otherwise defaulted as Language

English

Displays the version and copyright information About

Test-Runs/Validates data Check

Processes data through MDG to create CR(s) Submit

Prepares the data file to create CR(s) Data Sheet

Displays success or failure messages Return Sheet

Displays errors Trace Log

To check Asynchronous Logs, Check Log and Fetch Log

Submit Log

Async Background check process for Error messages Check log

Async Background Submit process Submit log

User can view all the Fields/Tabs with selected technical objects and Personalization
hide/unhide the fields/tabs

User can hide Field/Tabs except Key and Mandatory fields Personalize Template

User can unhide the Fields/Tabs Reset Personalize Template

Page 6 of 31
Logging into uXLoader
Use the following steps to log in the uXLoader.

1. Launch uXLoader.

2. Click on “Login” button.

The system displays the Login popup.

Note: For Asynchronous process the checkbox “Async” must be checked and for Synchronous
process it must be unchecked.

3. Enter the details for the fields as described in the following table:

Field Description
Select SAP Object Drop-down list displays the list of supported objects

Async Checkbox to select the type of Process

SSO Checkbox for SSO (Single Sign-On) functionality

Username Enter SAP username

Password Enter the password

System ID Enter the host name

Page 7 of 31
 Port Enter the port name

Client Enter the client

“Login” button Click “Login” button to access work on Excel template.

The system displays the Welcome! <User> message and Submit Data sheet to process.

The system generates template for selected object during login to prepare data from row number 7 onwards.

Page 8 of 31
Appendix I:

Class Details for EAM Objects

This section describes the EAM details for an MDG entity.

Page 9 of 31
 S No Entity Class Name
1 EQUI /UGIEAMXL/CL_EQUIPMENT

2 FLOC /UGIEAMXL/CL_FUNCLOC

3 MBOM /UGIEAMXL/CL_MATERIAL_BOM

4 WC /UGIEAMXL/CL_WORK_CENTER

5 MSPT /UGIEAMXL/CL_MEASURING_POINT

6 MPMI /UGIEAMXL/CL_MAINTPLAN_ADAPT

7 GNTL /UGIEAMXL/CL_GENTASKLIST_ADAPT

8 EQTL /UGIEAMXL/CL_EQTASKLIST

9 FLTL /UGIEAMXL/CL_FLTASKLIST

For removing extra F4s in classification tab, below enlisted entries to be deleted from view
“/UGIEAMXL/_V_F4” in SM30 Tcode.

Field Name Field Name Lang. OBJ Name

CLASSIFICATION CHARIDEXTFORM DE Equipment

CLASSIFICATION CHARIDEXTFORM DE Functional Location

CLASSIFICATION CHARIDEXTFORM DE EQTL,GNTL,FLTL

CLASSIFICATION CHARIDEXTFORM EN Equipment

CLASSIFICATION CHARIDEXTFORM EN Functional Location

CLASSIFICATION CHARIDEXTFORM EN EQTL,GNTL,FLTL

CLASSIFICATION CHARIDEXTFORM FR Equipment

CLASSIFICATION CHARIDEXTFORM FR Functional Location

CLASSIFICATION CHARIDEXTFORM FR EQTL,GNTL,FLTL

CLASSIFICATION CHARIDEXTFORM IT Equipment

CLASSIFICATION CHARIDEXTFORM IT Functional Location

CLASSIFICATION CHARIDEXTFORM IT EQTL,GNTL,FLTL

CLASSIFICATION CHARIDEXTFORM ES Equipment

CLASSIFICATION CHARIDEXTFORM ES Functional Location

CLASSIFICATION CHARIDEXTFORM ES EQTL,GNTL,FLTL

CLASSIFICATION CLASSCL DE Equipment

Page 10 of 31
 CLASSIFICATION CLASSCL DE Functional Location

CLASSIFICATION CLASSCL DE EQTL,GNTL,FLTL

CLASSIFICATION CLASSCL EN Equipment

CLASSIFICATION CLASSCL EN Functional Location

CLASSIFICATION CLASSCL EN EQTL,GNTL,FLTL

CLASSIFICATION CLASSCL FR Equipment

CLASSIFICATION CLASSCL FR Functional Location

CLASSIFICATION CLASSCL FR EQTL,GNTL,FLTL

CLASSIFICATION CLASSCL IT Equipment

CLASSIFICATION CLASSCL IT Functional Location

CLASSIFICATION CLASSCL IT EQTL,GNTL,FLTL

CLASSIFICATION CLASSCL ES Equipment

CLASSIFICATION CLASSCL ES Functional Location

CLASSIFICATION CLASSCL ES EQTL,GNTL,FLTL

CLASSIFICATION CLSTATUS1CL DE EQTL,GNTL,FLTL

CLASSIFICATION CLSTATUS1CL EN EQTL,GNTL,FLTL

CLASSIFICATION CLSTATUS1CL FR EQTL,GNTL,FLTL

CLASSIFICATION CLSTATUS1CL IT EQTL,GNTL,FLTL

CLASSIFICATION CLSTATUS1CL ES EQTL,GNTL,FLTL

CLASSIFICATION DELETECL EN EQTL,GNTL,FLTL

Class Details for AIW Objects

This section describes the AIW details.

S No Entity Class name

1 MOCR /UGIEXCEL/CL_AIW

Class Details for MM Objects

This section describes the Material details for an MDG entity.

S No Entity Class Name

1 MATERIAL /UEXCEL/CL_MATERIAL

Page 11 of 31
Appendix II: OData Service
The following topics are discussed in the section:

 1)List of OData Services

 2)OData Configuration

1) List of OData Services:

uXLoader EAM Synchronous and Asynchronous merged

OData Services
S No Object Service

1 Equipment /UGIEAMXL/EQ_SOP_TAB_PROC_SRV

2 Functional Location /UGIEAMXL/FLOC_SOP_PROC_SRV

3 MBOM /UGIEAMXL/MBOM_SOP_TAB_PROC_SRV

4 Work Center /UGIEAMXL/WC_SOP_TAB_PROC_SRV

5 Measuring Point /UGIEAMXL/MSPT_SOP_TAB_PROC_SRV

6 Maintenance Plan /UGIEAMXL/MPMI_SOP_TAB_PROC_SRV

7 General Task List /UGIEAMXL/TLGN_SOP_TAB_PROC_SRV

8 Equipment Task List /UGIEAMXL/EQTL_SOP_TAB_PROC_SRV

9 Functional Location Task List /UGIEAMXL/FLTL_SOP_TAB_PROC_SRV

uXLoader EAM Search OData Services

S No Object Service

1 Equipment /UGIEAMXL/EQUI_DB_SRCH_SRV,
/UGIEAMXL/EQUI_HA_SRCH_SRV

2 Functional Location /UGIEAMXL/FUNCLOC_DB_SRCH_SRV,

/UGIEAMXL/FUNCLOC_HA_SRCH_SRV

3 MBOM /UGIEAMXL/PMBOMHDR_DB_SRCH_SRV,
/UGIEAMXL/PMBOMHDR_HA_SRCH_SRV

4 Work Center /UGIEAMXL/WORKCNTR_DB_SRCH_SRV,

/UGIEAMXL/WORKCNTR_HA_SRCH_SRV

5 Measuring Point /UGIEAMXL/MSPOINT_DB_SRCH_SRV,

/UGIEAMXL/MSPOINT_HA_SRCH_SRV

6 Maintenance Plan /UGIEAMXL/MPLAN_DB_SRCH_SRV,

/UGIEAMXL/MPLAN_HA_SRCH_SRV

7 General Task List /UGIEAMXL/TLGNHDR_DB_SRCH_SRV,

/UGIEAMXL/TLGNHDR_HA_SRCH_SRV

Page 12 of 31
S No Object Service

8 Equipment Task List /UGIEAMXL/TLEQHDR_DB_SRCH_SRV,

/UGIEAMXL/TLEQHDR_HA_SRCH_SRV

9 Functional Location Task List /UGIEAMXL/TLFLHDR_DB_SRCH_SRV,

/UGIEAMXL/TLFLHDR_HA_SRCH_SRV

uXLoader AIW Synchronous and Asynchronous merged OData

Services
S No Object Service

1 MOCR /UGIEXCEL/MMOP_SRV

uXLoader AIW Search Services

S No Object Service

1 MOCR /UGIEXCEL/EQUI_AIW_HA_SRCH_SRV,
/UGIEXCEL/EQUI_DB_SRCH_SRV,
/UGIEXCEL/EQUI_HA_SRCH_SRV,
/UGIEXCEL/FLOC_AIW_HA_SRCH_SRV,
/UGIEXCEL/FUNCLOC_DB_SRCH_SRV,
/UGIEXCEL/FUNCLOC_HA_SRCH_SRV,
/UGIEXCEL/PMBOMHDR_AIW_HASRCH_SRV,
/UGIEXCEL/PMBOMHDR_DB_SRCH_SRV,
/UGIEXCEL/PMBOMHDR_HA_SRCH_SRV

uXLoader MM Synchronous and Asynchronous merged OData

Services
S No Object Service

1 Material /UEXCEL/MATERIAL_PROCESSING_SRV_AS

uXLoader MM Search Services

S No Object Service

1 Material /UEXCEL/MATERIAL_DB_SRCH_SRV,
/UEXCEL/MATERIAL_HA_SRCH_SRV

uXLoader EAM Additional Services

S No Object Service

1 EAM Header text /UGIEAMXL/EAM_HEADER_TXT_SRV

2 EAM Trace Error Log /UGIEAMXL/TRACE_ERROR_LOG_SRV

Page 13 of 31
 S No Object Service

3 EAM System details service /UGIEAMXL/UTILITIES_SRV

4 EAM Search Service /UGIEAMXL/SEARCH_SRV

uXLoader AIW Additional Services

S No Object Service

1 AIW - System Details /UGIEXCEL/UTILITIES_SRV

2 AIW - Header Text /UGIEXCEL/EAM_HEADER_TXT_SRV

uXLoader MM Additional Services

S No Object Service

1 MM - System Details /UEXCEL/UTILITIES_SRV

2 MM - Header Text /UEXCEL/MATERIAL_HEADER_TXT_SRV

2)OData Configuration:
Use the following steps involved in OData configuration:

 1)Activate SAP Gateway

 2) Assign System Alias and Activate OData Service

1)Activate SAP Gateway

Use the following steps to configure OData.

1. Run to t-code SPRO

2. Navigate to the following path:
SAP NetWeaver > SAP Gateway > OData Channel > Configuration

Page 14 of 31
 3. Click on Activate or Deactivate Gateway, select “Activate” button to activate SAP Gateway. If it is
currently active it is displayed as “Deactivate” as displayed in the following screen.

2) Assign System Alias and Activate OData Service

Use the following steps to assign system alias and activate OData Service:

Page 15 of 31
1. Run t-code /IWFND/MAINT_SERVICE.

2. Select the respective service and click on “Add System Alias”.

3. Click on “New Entries” button.

Page 16 of 31
4. Enter System Alias as “LOCAL”.
5. Select “Default System” and “Metadata Default” checkbox.

6. Click on Save and assign Transport Request Number.

7. Activate SICF Node.
a. Select the technical service name.

b. Click on ICF Node and select “Activate” button.

Page 17 of 31
Appendix III: Reports Scheduled in Background
The following reports are scheduled in background for Asynchronous Process.

uXLoader EAM Check Reports

Object Report
Equipment /UGIEAMXL/BACK_CHEK_EQUI

Functional Location /UGIEAMXL/BACK_CHEK_FLOC

Material BOM /UGIEAMXL/BACK_CHEK_MBOM

Work Center /UGIEAMXL/BACK_CHEK_WC

Measuring Point /UGIEAMXL/BACK_CHEK_MSPT

Maintenance Plan /UGIEAMXL/BACK_CHEK_MPMI

General Task List /UGIEAMXL/BACK_CHECK_GNTL

Equipment Task List /UGIEAMXL/BACK_CHEK_EQTL

Functional Location Task List /UGIEAMXL/BACK_CHEK_FLTL

uXLoader EAM Submit Reports

Object Report
Equipment /UGIEAMXL/EQ_TABLE_PROCES_SOP

Functional Location /UGIEAMXL/TABLE_PROCESSOR_FLOC

Material BOM /UGIEAMXL/MBOM_TABLE_PROC_SOP

Work Center /UGIEAMXL/WC_TAB_PROCESS_SOP

Measuring Point /UGIEAMXL/MSPT_TABLE_PROC_SOP

Maintenance Plan /UGIEAMXL/MPMI_TAB_PROCES_SOP

Page 18 of 31
 Object Report
General Task List /UGIEAMXL/TLGN_TABLE_PROC_SOP

Equipment Task List /UGIEAMXL/EQTL_TABLE_PROCESS

Functional Location Task List /UGIEAMXL/FLTL_TABLE_PROC_SOP

uXLoader AIW Check Report

Object Report

MOCR /UGIEXCEL/BACK_CHECK_MMOP

uXLoader AIW Submit Report

Object Report

MOCR /UGIEXCEL/TABLE_PROCESSOR_MMOP

uXLoader MM Check Report

Object Report
Material /UEXCEL/BACKGROUND_CHECK_MAT

uXLoader MM Submit Report

Object Report
Material /UEXCEL/TABLE_PROCESSOR_MAT

Appendix IV: BC-Sets uXLoader

EAM BC-Sets:
Activate the following BC Sets for EAM.

 /UGIEAMXL/ODC_DPIM is created to capture UGI related table entries of table

/IWFND/V_MGDPIM (Assign Data Provider to Data Model).

 /UGIEAMXL/FIELD_PROPERTIES is created to capture field property related table entries of table

/UGIEAMXL/V_CONF.

 /UGIEAMXL/F4_UTILITIES_300 is created to capture value help table entries of table

/UGIEAMXL/_V_F4.

 /UGIEAMXL/ERROR_HIGHLIGHT is created to capture error highlighting entries for table

/UGIEAMXL/V_MSG. its for Equipment, Functional Location & Work Center.

Page 19 of 31
uXLoader AIW BC-Sets:
Activate the following BC Sets for AIW.

 /UGIEXCEL/BC_CONFIG is created to capture field property related table entries of table

/UGIEXCEL/V_CONF.

 /UGIEXCEL/F4_UTILITIES_300 is created to capture value help table entries of table

/UGIEXCEL/_V_F4.

uXLoader MM BC-Sets:
Activate the following BC Sets for MM.

 /UEXCEL/MESSAGE_MAPPING is created to capture message mappings related table entries

of table /UEXCEL/V_MSG.

 /UEXCEL/FIELD_PROPERTIES is created to capture field property related table entries of table

/UEXCEL/V_CONFIG.

 /UEXCEL/F4_UTILITIES_130 is created to capture value help table entries of table

/UEXCEL/_V_F4.

Appendix V: Displaying Product information

The “About” option in the uXLoader displays the details of the installed version and the copyright information of
the product.

Use the following steps to display the product information.

 Login to uXLoader. Refer Logging into uXLoader for more information.

 Click on Help dropdown and select About.
 Version of the uXLoader and copyright information are displayed as in the following screen.

Page 20 of 31
Appendix VI: Uninstalling uXLoader
Before upgrading to the latest uXLoader version, you must first uninstall the current version from the system. To
uninstall the existing version, use the following step.

Click Start and navigate to Control Panel > Programs > Uninstall uXLoader> Right-click on the
uXLoader select Uninstall.

Appendix VII: Troubleshooting

This troubleshooter section provides a listing of common errors, the reasons why you are getting these
errors and the solution to help you fix these issues that you may experience while using uXLoader.

 1)Installation Errors
 2)Error Messages
 3)Error in Data

1) Installation Errors
This section lists the various installation errors:

1. The “Login” button in Utopia tab remains invisible, after installation of uXLoader.
 Reason 1: The “Developer” tab needs to be enabled in Excel Ribbon tab.
 Resolution: In File > Options > Add-ins > Enable the Developer tab at Excel Ribbon at
Customize Ribbon option.

Page 21 of 31
 Once the button is visible, the option can be unchecked.

 Reason 2: Ulabs. ExcelAddin.SAP option in Add-in feature might have been disabled at COM Add-
ins option

 Resolution: In File > Options > Add-ins > Manage > Select COM Add-ins. Check the
Ulabs.ExcelAddin.SAP and close the Excel. Then again check the same. Login button will be visible.

Page 22 of 31
 2. No response from Excel when you click on the “Login” button.
 Reason: Either SAP GUI has not been installed or the hosts file is missing.
 Resolution: Install SAP GUI and make sure the hosts file is installed at the following location C:\
Windows\System32\drivers\etc. Verify the prerequisites as detailed:

Prerequisites for uXLoader

 Microsoft Office Excel with Add-in feature enabled
 SAP GUI
 SAP Note 2348105 need to be available in the system
 Visual Studio 2010 Runtime(x64)
 Hosts file needed to be available at C:\Windows\System32\drivers\etc to proper login into the system
 uXLlogon_Objects.ini file need to be available at C:\Users\<User>\AppData\
Roaming\SAP\Common to select object to logon to.

2) Error Messages:
Error messages displayed as in the following screen: “Name or password is incorrect (repeat logon)”

 Reason: User typed invalid credentials. For example, incorrect username.

Page 23 of 31
  Resolution: To resolve this, valid SAP credentials needs to be entered.

3)Error in Data
Error message displayed as in the following screen: An Error Occurred. The remote server returned an error:
Invalid data input.

 Reason: For example, User entered incorrect UOM.

 Check errors in "Log Trace "

 Resolution: Enter a valid UOM "KG" as specified.

Page 24 of 31
Appendix VIII: SSO with SAML Certificate:
Use the following steps to install SAML Certificate.

1. Open Microsoft Management Console (mmc) in command prompt.

2. Select Add/Remove Snap-in.

3. Select “Certificates” and click “Add” button.

4. Select “Computer account” option.

Page 25 of 31
5. Select “Local Computer”.

6. After “Finish” expand the “Certificates” node.

7. Right-Click and click “Import”.

Page 26 of 31
 8. Go to Certification Import Wizard.

9. Select the certificate from local path.

10. Select the next option as in the following screen.

Page 27 of 31
11. Complete the Certificate Import Wizard.

Page 28 of 31
Configure Certificate File Path
User can change the path and password in the ini file as mentioned path: C:\Users\<Username>\AppData\
Roaming\SAP\Common\uXLSS0_Certificate.ini.

User can change the path only and the not password from the file, as in the following screen.

i.e., User will keep the certificate in D:\SAML_ULABS_Cert\SAML_ULABS.p12 and modify the path
marked in the following screen.

Note:
One space is required between path and password.

Multiple Check and Submit Job Scheduling for Async call

For uXLoader – MM, there is a functionality to split the Check or Submit jobs into multiple jobs. This
helps in faster processing. There is a parameter /UEXCEL/MATERIAL for Material, set in
transaction code STVARV.This contains the number of records that would go into a single job.

Page 29 of 31
For example, in the above setup, if the uXLoader file contains 3000 records, then uXLoader
backend program would create 3000 divided by 250 = 12 batch jobs and 1 header job.

All these 13 jobs would get active at the same time. This will create 12 Change requests (CR).
In fetch or submit log, it gives the status of job as in progress if it is still running. It gives the
list of CRs created if the job has successfully run in the Return tab.

Page 30 of 31