File Based Item Import For Non-PIM Cloud Customers - Rel 11
File Based Item Import For Non-PIM Cloud Customers - Rel 11
File Based Item Import For Non-PIM Cloud Customers - Rel 11
NOTE: This revenue recognition disclaimer is required for any white paper that addresses functionality
or products that are not yet generally available. Most white papers will NOT need this disclaimer. To
determine whether your paper requires this disclaimer, read the revenue recognition policy. If you have
further questions about your content and the disclaimer requirements, e-mail [email protected].
To remove both the disclaimer and the page that it appears on, first display hidden characters by
clicking on the Paragraph icon on the Home toolbar. Notice that there is a section break displayed as a
double-dotted line at the bottom of this page. It is a small, square icon that appears to the left of the
Quick Style Gallery. Highlight all the text on this page and press the Delete key. Continue to press
Delete until the page disappears and your cursor is on the Table of Contents page. Be sure not to
remove the section break, or the formatting of the title page will be incorrect. Delete this note before
publishing.
Introduction 1
Security Information 20
FAQs 25
What are the item entities that can be imported using FBDI templates? 25
What values should be passed for KFF fields – Sales Account, Expense Account? 26
Best Practices 26
Conclusion 26
Oracle Fusion Product Hub (FPH) on-premise customers can leverage all of the above methods to
import items. However, customers using the Oracle Fusion Product Hub Cloud Service (FPH-Cloud)
do not have access to directly update the database tables and hence cannot use direct SQL insert
method. Some customers may still need to import items for use in other products like Oracle Fusion
Sales Cloud, Oracle Fusion Purchasing etc., but are not explicitly licensed for Oracle Fusion Product
Hub. These customers have an implicit license to use Oracle Fusion Product Model, which provides
the basic functionality to create an item for use in their licensed products. Customers with implicit
license for Oracle Fusion Product Model can import items using the following methods only:
Direct SQL insert into open interface tables (Not available for SaaS Cloud customers)
Structured CSV Import
Web Services (Fusion Applications Release 8 and above)
As with FPH-Cloud, cloud customers with implicit license for Oracle Fusion Product Model, do not
have access to database and hence cannot use direct SQL insert method.
This white paper details the steps to import items using the Structured CSV method only. Intended
audience is any user trying to import items in Oracle Fusion Applications.
Oracle Fusion Applications provides various ways to integrate its functional capabilities with other Oracle
applications as well as third party and legacy applications. The Oracle Enterprise Repository (OER) for Oracle
Fusion Applications is a one-stop shop for discovering the metadata for Oracle Fusion Applications and provides the
artifacts used for such integrations and for use in implementations.
https://fusionappsoer.oracle.com/oer/index.jsp
http://docs.oracle.com/cloud/latest/scmcs_gs/OEFSC/toc.htm
http://docs.oracle.com/cloud/latest/scmcs_gs/index.html
Click on the File Based Data Imports. The region expands and lists all the objects available for import.
Extensible Flexfields are not supported for customers not licensed for Oracle Fusion Product Hub (On
premise or Cloud Services). Hence, tables with %EGO% in the table name are not supported for Oracle Fusion
Sales Cloud or Oracle Fusion Procurement only customers.
Important considerations for the template file (please also read the instructions in the “Instructions and CSV
Generation Tab):
2. The interface table tabs contain sample data, that can be used as a guideline to understand how to populate
the fieds
3. The first row in each sheet contains column headers that represent the interface table columns. The columns
are in the order that the control file expects them to be in the data file.
4. Each column header contains bubble text about the expected data type and, in some cases, instruction text. If
you cannot read the complete bubble text, right click in the header cell and select “Edit Comment”. Now that the
bubble text is in edit mode, you can expand the text box containing the bubble text.
5. You must enter data that conforms to what the control file can accept and process for the associated database
column. Columns have been formatted, where applicable, to match the expected data type to eliminate data
entry errors.
7. Amount columns must not contain a thousand separator and must use a period (.) as the decimal separator.
8. Columns that must be whole numbers have data validation to allow only whole numbers
9. For columns that require internal ID values, refer to the bubble text for additional guidance about finding these
values.
10. Do not change the order of the columns in the Excel sheets. Changing the order of the columns will cause the
load process to fail.
11. Do not delete columns that are not used. Deleting columns will cause load process to fail. You can hide
columns that you do not intend to use; if needed, during the data creation process, but please reset to unhidden
before upload.
The user enters the data into the tabs in the ItemImportTemplate.xslm template file based on the object type. For
example: the users exports or extracts data from their internal systems and determines which items from their
internal system will be imported. The user will review the EGP_SYSTEM_ITEMS_INTERFACE tab column headers
to determine the required data and formation, and enter the data into the columns in the spread sheet with a row in
the spreadsheet corresponding to an item that they want to import. In some cases the data from the internal systems
might require modifications to conform to the formats used in the work sheet.
EGP_SYSTEM_ITEMS_INTERFACE. This interface table corresponds to Item operational attributes and Item
organization assignments. The operational attributes are listed in the sheet and user has to provide values for these.
EGP_ITEM_REVISION_INTERFACE – This interface table corresponds to the item revision and other metadata
related to item revision information. Revision level metadata information has to be optionally listed.
EGP_TRADING_PARTNER_ITEMS_INTF – This interface table corresponds to various trading partner item details.
Trading partner items include Competitor item, Manufacturer item, Customer item and their details.
Oracle Fusion Sales Cloud and Oracle Fusion Procurement customers NOT licensed for Oracle Fusion Product Hub
(On premise or Cloud Services) will be entering the details in these sheets only.
Refer to the bubble text on each column header for on the data and data type the column requires. For more
information on each interface table, see Oracle Enterprise Repository for Oracle Fusion Applications, select
Type=Tables.
The ItemImportTemplate.xslm file contains sample data in each of the interface table Tabs, remove the sample data
for tabs that are not used.
Populate the following mandatory columns of all the interface tables: Item Number, Organization, Item Class,
Primary UOM
Source System Code: Item Management has a seeded Source System Code: “PIMDH” that will be used for imports
by default. Source System represent external systems to the Item Management and should be changed only for
customers using Oracle Fusion Product Hub (On premise or Cloud Services), if needed. Others should use 'PIMDH'
as the only source system.
Item Class: Item Management seeds the Item Class called “Root Item Class”. Unless you are licensed for Oracle
Fusion Product Hub (On premise or Cloud Services), this item class should be used to create items and for imports.
(See note 1613075.1)
UOM columns, users can populate the UOM codes or the UOM Names. The UOM area created during initial setup
of the environment using the Oracle Functional Setup Manager applications. The task to create the UOM is called
“Manage Units of Measure”
Organzation Code: Organizations are created during initial setup of the environment. Items are always created in a
Master Organizations. The Master Organization is created in the Oracle Functional Setup Manager applications. The
task to create item organizations is called “Manage Item Organizations"
The system will prompt the user to save the file to the desktop location several times. The first request will save the
ItemImportTemplate.xlsm file, the second will ask the folder where the ZIP file will be saved and the next set of Save
requests will be for each of the interface tables data in the tabs
A dialog will be displayed after all of the interface table tab content is saved.
During the CSV ZIP file generation, the user only has to save the spreadsheets that contain data to be imported.
Example
Transaction Type=CREATE
Batch ID =1000 (This is the value used when submitting Item Import)
Select the desk top location for the CSV ZIP file that is generated
Save the CSV file for the EgpSystemItemsInterface which contains the items that being created.
Save the remainder of the CSV files if data is being imported in these files, otherwise you can cancel the saves for
the unused interface files
Review the ZIP file, you should see one CSV file in the compressed file for each interface table that you are loading
data with.
The next step in the process is to upload the CSV zip file to the designated location in the Oracle Cloud, in this case
a folder within the Oracle UCM system.
UCM is an enterprise content management system that manages web content, documents, imaging management,
and digital assets for the Oracle Fusion Applications. UCM will be used as standard location for file based data
import files.
Log into the Fusion application as the user with necessary privileges to upload file to scm/item/import.
From the Navigator link in the top left hand corner of user interface, select “File Import and Export” action link under
the Tools region.
On the File Import and Export page, click the create icon in the Search Result table header. The Upload File dialog
will be launched.
Click on the Browse button, the File Upload selector dialog will be launched, where you select the ZIP file that you
created for the import.
Select the Account from the choice list. The Account value represents the UCM account and the specified UCM
folder. The Account used for item import is “scm/item/import”.
Click the Save and Close button to initial the uploading of the zip file to UCM.
Refresh/Requery so that the search results will show the process ID.
From the Navigator link, select “Scheduled Process” action in the Tools Section
Type=Job
Name = Load Interface File for Import ( Use Search action at bottom of choice list) (Note: Search for Schedule Job
nam is case-sensitive)
Click the Submit button to start the process (upper right hand corner of user interface)
when submitted, a dialog is launched with the Process ID for the process for moving the data from UCM to the Item
Management interface tables. Note the Process Id. Click on the OK button to close the dialog and click on the Close
button in the Process Details to close the dialog.
Note: The parent process is Load Interface File for Import. The child processes are – Transfer File, Load File to
Interface. You can view the log files to see error (if applicable)
Continue to monitor the process status until completed successfully, Status should be “Succeeded”.
From the Navigator link, select “Scheduled Process” action in the Tools Section, the Scheduled Processes user
interface will be loaded.
Click on the “Scheduled New Process” button in the Search Result table header, the Schedule New Process dialog
will be launched.
Type=Job
Batch ID= 9991999 (A unique identifier of the batch used to import the items. Should match the value entered in the
uploaded file). Populate any other parameters- based on your needs.
After you click the Submit button a dialog is launched with the Process ID for the process for importing the data in
the Item Management interface tables, validating it and moving the data to the Item Management production tables.
Note the Process Id. Click on the OK button to close the dialog and click on the Close button in the Process Details
to close the dialog.
View log file for any errors (if applicable), by selecting the row in the Search Results table and clicking the View Log
button.
Successfully imported items and related child entities can be queried, modified and validated in Items Workarea
The following is the process for purging item interface table data.
Click on the “Scheduled New Process” button in the Search Result table header, the Schedule New Process dialog
will be launched.
Type=Job
Load Request ID= ID number of the process for which data needs to be purged.
After you click the Submit button a dialog is launched with the Process ID for the process of purging the data in the
item interface tables. Based on the options selected, such data will be extracted and uploaded to UCM from where
the data can be downloaded. Note the process ID. The extracted data location will be available in the process log,
that can be downloaded using a webservice. For more details about this common process, pls refer here.
Security Information
The security for this process has two components –
1. Functional security for the User to access the task to Upload the data to UCM (Access to the File Import
and Export link)
2. Data security for allowing access to the specific folder within UCM for the upload (Access to UCM)
The Item Management product supports the requirement for this duty role through the Product Data Steward Job
Role. If the File Import and Export action is not available to the user, the administrator needs to either assign the
duty “File Import and Export Management Duty” to the user or Job Role associated with the Users. The duty role
can be assigned using the Oracle Authorization Policy Manager (APM) or the Job Role can be assigned to the User
using Oracle Identity Manager (OIM) . Both applications require an administrator login to perform the operations.
The Administrator must use Oracle Authorization Policy Manager (APM) to grant access to the user, using the steps
below:
For=Application Roles
In=IDCCS
Click on the External Role Mapping tab. The External Role Mapping contains all Job Roles that have access to the
folder represented by the Upload data for Item Import duty.
If the External Roles Mapping table is blank this means that no current Job Roles have been mapped to the duty for
the UCM folder “scm/item/import”. The Administrator needs to add the Job Roles in the user interface for the
External Role Mapping.
To check if the Job Role is mapped to the duty for “scm/item/import”, Select row corresponding to the job role in the
External Role Mapping table, and click the Find Policies button in the top right corner. Choose Default Policy
Domain.
FAQs
What are the item entities that can be imported using FBDI templates?
» The following item entities can be imported using FBDI templates (depending on the license).
Items
* Extensible Flexfields are not supported in Item Management; the Customer must license Oracle Product Hub
to use Extensible Flexfields.
++
Item Category Assignments and Style Variant Attributes are not used by Sales Catalog.
#
Spoke System Cross References cannot be created via FBDI. Oracle Product Hub license is needed for
importing Spoke System Items
What values should be passed for KFF fields – Sales Account, Expense Account?
Provide the display values of the KFF. Don’t provide KFF Code combination ID. Display value will be in the format of
xxx.xxx.xxxx.xxxx. The cell can accommodate upto 4000 characters.
Best Practices
Conclusion
Following the above process will ensure all the data gets imported.
CONNECT W ITH US
blogs.oracle.com/oracle
Copyright © 2016, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the
contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other
facebook.com/oracle warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or
fitness for a particular purpose. We specifically disclaim any liability with respect to this document, and no contractual obligations are
formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any
twitter.com/oracle means, electronic or mechanical, for any purpose, without our prior written permission.
oracle.com Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and
are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are
trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 0116