RS-100457-EBS - Labware Integration PDF

Requirements Specification
for the EBS Labware Integration

Document Number: RS-100457
for
EBS - Labware Integration
RS-100457
Revision 03
Confidential and Proprietary

Revision: 03
Approval Date: 10/18/2015
Page 1 of 19
Revision 03
Page 2 of 19
Revision 03
TABLE OF CONTENTS
1
PURPOSE OF THE DOCUMENT ............................................................................................... 3
USER REQUIREMENTS SPECIFICATION .............................................................................. 4
2.1 BUSINESS NEEDS ............................................................................................................................ 4

2.2 REQUIREMENTS:............................................................................................................................. 4
3
FUNCTIONAL REQUIREMENTS SPECIFICATION .............................................................. 7
3.1 FUNCTIONAL REQUIREMENT......................................................................................................... 7

3.2 FUNCTIONAL DESIGN / MAPPING ................................................................................................ 9
4
TECHNICAL REQUIREMENTS SPECIFICATION ............................................................... 13
4.1 ITEM CATEGORY DEFINITION ...................................................................................................... 13

4.2 APPLICATION LOOKUP ................................................................................................................ 14
4.3 SOA COMPOSITE DESIGN ............................................................................................................ 15
5
REVISION HISTORY ................................................................................................................. 19

Revision: 03
Page 3 of 19
Revision 03
1 Purpose of the Document

The purpose of this document is to capture the User, Functional, and Design Specifications for
the custom interface using Oracle Service Oriented Architecture (SOA) for transferring data
from Oracle EBS to Labware LIMS system.

Revision: 03
Page 4 of 19
Revision 03
2 User Requirements Specification

2.1
Business Needs
EBS Labware SOA interface will automate the data transfer between Oracle EBS and Labware
when a new lot is created for a:
Raw Material item
Intermediate item
2.2
Requirements:
2.2.1
The Interface will be automatically triggered in various business situations, as

described below
Description
Req No.
2.2.1.1
Critical (C)/
Non-Critical (N)
Raw material lot

The below listed data points must be transferred to Labware staging
table when new lot record created for Z2000 series buy items in all
inventory organizations defined under BioMarin Pharmaceutical
Inc & BioMarin International Ltd entities.
2.2.1.1.1
Lot Number
Site
Organization Code
Item
Transaction Quantity
Date Received
Manufacturer
Supplier Lot Number
Child Lot Flag
2.2.1.1.2
A static text of NOVATO must be displayed for Site column

when lots are created in inventory organizations defined under
BioMarin Pharmaceutical Inc entity.
2.2.1.1.3
A static text of SHANBALLY must be displayed for Site column

BioMarin International Ltd entity.

Revision: 03
Page 5 of 19
Revision 03
2.2.1.1.4
The Transaction Quantity value must be transferred to Labware

after converting the received quantity equal to container unit of
measure if received in case unit of measure.
2.2.1.1.
5
The Child Lot Flag must be a constant value of N.
2.2.1.1.6
The interface must not transfer the lot number to Labware staging
table if it is already transferred over.
2.2.1.2
Intermediate lot
The below listed data points must be transferred to Labware staging
table lot record created for any make items in all inventory
organizations defined under BioMarin Pharmaceutical Inc &
BioMarin International Ltd entities.
2.2.1.2.1
2.2.1.2.2
Lot Number
Site
Organization Code
Item
Production Date
Child Lot Flag
The interface must transfer only the parent lot record for items with
child lot attribute enabled in items master except for bioreactor
items like C0624, C0404 where the system must transfer both
parent and child lot record separately.
2.2.1.2.3
A static text of NOVATO must be displayed for Site column

BioMarin Pharmaceutical Inc entity.
2.2.1.2.4
A static text of SHANBALLY must be displayed for Site column

BioMarin International Ltd entity.
2.2.1.2.5
The Child Lot Flag value must be Y when transferring child lots
associated to Bioreactor items like C0624, C0404 and the value
must be N for all other lot records.
The interface must transfer lot records only once to Labware staging
table irrespective of the inventory organization, even if the same lot
record is created multiple times in different inventory organizations
in EBS.
2.2.1.3

Revision: 03

Revision: 03
Page 6 of 19
Revision 03
Page 7 of 19
Revision 03
3 Functional Requirements Specification

This section refers to the functional requirement specifications of the custom interface using
Oracle Service Oriented Architecture (SOA) for transferring data from Oracle EBS to Labware
LIMS system.
3.1
Functional Requirement
3.1.1
An item category structure BMR_LABWARE_TXR_ORGS has to be created to

define inventory organizations with respective site codes from where the lot
records to be transferred from EBS to Labware (2.2.1.1.1, 2.2.1.2.1).
3.1.2
An Application Object Library lookup BMR_LABWARE_TXR_RM_ITEMS

has to be created to define the inventory item series associated to the lot
records to be transferred from EBS to Labware (2.2.1.1.1).
3.1.3
The interface program must pick, validate and transfer the lot from Oracle EBS
to Labware staging table within maximum of 5 minutes from the time the lot
record generated in Oracle EBS.
3.1.4
The interface program must transfer a lot record only once from EBS to
Labware even if the same lot record is created multiple times in EBS. (2.2.1.3).
3.1.5
The users must have the ability to control/extend the items and inventory
organizations to be included in the transfer process.
3.1.6
The system must trigger an email notification if a lot record errors out in SOA
server.
3.1.7
Raw Material (Buy item) lot transfer:

3.1.7.1
The interface program must transfer the following data points from
Oracle EBS to Labware upon raw material (Buy item) lot creation in
EBS:
3.1.7.1.1
Lot Number
The interface must transfer the selected lot number.
3.1.7.1.2
Site
The interface must transfer the site name assigned to the
inventory organization where the selected lot number is
created.
3.1.7.1.3
Organization Code

Revision: 03
Page 8 of 19
Revision 03
The interface must transfer the 3-letter inventory

organization code where the selected lot number is
received.
3.1.7.1.4
Item
The interface must transfer the item number associated
to the lot number being processed.
3.1.7.1.5
Transaction Quantity
The interface must transfer the received quantity of the
lot record being processed. The quantity must be
converted equivalent to Each unit of measure if the lot
is received in unit of measures starting with Case and
no conversion needed if the lot is received in other units
of measure.
The interface must not transfer the lot record if the
receipt quantity is 0 or NULL.
3.1.7.1.6
Date Received
The interface must transfer the actual receipt date of the
lot record being processed.
3.1.7.1.7
Manufacturer
The interface must transfer manufacturer associated to
the lot record being processed.
3.1.7.1.8
Supplier Lot Number

The interface must transfer supplier lot number
associated to the lot record being processed.
3.1.7.1.9
Child Lot Flag

The interface must transfer a constant value of N.
3.1.8
Intermediate (Make item) lot transfer:

3.1.8.1
The interface program must transfer the following data points from
Oracle EBS to Labware upon intermediate (make items) lot creation
in EBS:
3.1.8.1.1
Lot Number

Revision: 03
Page 9 of 19
Revision 03
The interface must transfer the selected lot number.

3.1.8.1.2
Site
The interface must transfer the site name assigned to the
inventory organization where the selected lot number is
created.
3.1.8.1.3
Organization Code
The interface must transfer the 3-letter inventory
organization code where the selected lot number is
created.
3.1.8.1.4
Item
The interface must transfer the item number associated
to the lot number being processed.
3.1.8.1.5
Production Date
The interface must transfer the creation date of the lot
record being processed.
3.1.8.1.6
Child Lot Flag

The interface must transfer a constant value Y for the
Bioreactor items which is enabled with child lot item
attribute like C0624 or C0404.
The interface must transfer a constant value N for all
other lot records.
3.1.8.2
The interface program must transfer the Child Lot Flag value as per
the conditions listed below.
3.1.8.2.1 The value must be Y for the Bioreactor items which are
enabled with child lot like C0624 or C0404.
3.1.8.2.2 The value must be N for all other intermediate lot records.
3.2
Functional Design / Mapping

Revision: 03
Page 10 of 19
Revision 03
3.2.1 The data points for different sections can be derived from the below listed Oracle
EBS application fields in Material Transactions, Lot Transactions, Categories,
Item Lots, About This Record & Unit of Measure Conversions form.
3.2.1.1
Responsibility & Navigation

Note: The navigation & the responsibility referred below are only for
reference purpose and the listed forms can be accessed using other
applicable responsibilities as well.
3.2.1.2
3.2.1.1.1
Material Transactions Form: BMR US Inventory >

Transactions > Material Transactions > Find (Button).
3.2.1.1.2
Lot Transactions Form: BMR US Inventory > Transactions >

Material Transactions > Find (Button) > Lot / Serial (Button).
3.2.1.1.3
Categories Form: BMR US Inventory > Setup > Items >

Categories > Category Codes > Find (Button).
3.2.1.1.4
Item Lots Form: BMR US QA Approval Manager -> Lots ->

Find (Button).
3.2.1.1.5
About This Record Form: BMR US QA Approval Manager ->

Lots -> Find (Button) -> Help -> Record History.
3.2.1.1.6
Unit of Measure Conversions Form: BMR US Inventory >

Setup > Unit of Measure > Conversions.
EBS Field Mappings

3.2.1.2.1
Raw Material (Buy Item) lot transfer:

3.2.1.2.1.1 Lot Number
This value can be derived from the Lot field on
Lot Transactions form for the lot record being
processed.
3.2.1.2.1.2 Site
This value can be derived from the Site segment
on Item Categories form for the inventory

Revision: 03
Page 11 of 19
Revision 03
organization code associated to the lot record being

processed.
3.2.1.2.1.3 Organization Code
This value can be derived from the 3-letter
inventory organization displayed on the Material
Transactions form.
3.2.1.2.1.4 Item
This value can be derived from the Item field on
Material Transactions form for the lot record
being processed.
3.2.1.2.1.5 Transaction Quantity
This value can be derived from the Transaction
Quantity field on Lot Transactions form for the
lot record being processed.
The value will be converted based on unit of
measure conversions defined on Unit of Measure
Conversions form.
Note: The interface will just transfer the quantity
value, not the negative sign displayed on the Lot
Transactions form.
3.2.1.2.1.6 Date Received
This value can be derived from the Date field on
Material Transactions form for the lot record
being processed.
3.2.1.2.1.7 Manufacturer
This value can be derived from the Manufacturer
segment in Lot Attributes DFF on Item Lots form
for the lot record being processed.
Note: If the manufacturer value is blank in Lot
Attributes DFF, the system must verify
C_ATTRIBUTE1 column in
MTL_TRANSACTION_LOT_NUMBERS table and
transfer the value.
3.2.1.2.1.8 Supplier Lot Number

Revision: 03
Page 12 of 19
Revision 03
This value can be derived from the Supplier Lot

Number field on Lot Transactions form for the lot
record being processed.
3.2.1.2.1.9 Child Lot Flag
This is a constant value of N.
3.2.1.2.2
Intermediate (Make Item) lot transfer:

3.2.1.2.2.1 Lot Number
This value can be derived from the Lot field on
Item Lots form for the lot record being processed.
3.2.1.2.2.2 Site
This value can be derived from the Site segment
on Item Categories form for the inventory
organization code associated to the lot record being
processed.
3.2.1.2.2.3 Organization Code
This value can be derived from the 3-letter
inventory organization displayed on the Material
Transactions form.
3.2.1.2.2.4 Item
This value can be derived from the Item field on
Item Lots form for the lot record being processed
3.2.1.2.2.5 Production Date
This value can be derived from the Creation Date
field on About This Record form of the lot record
being displayed.
3.2.1.2.2.6 Child Lot Flag
This value will be derived based on conditions
listed in step 3.1.8.2.

Revision: 03
Page 13 of 19
Revision 03
4 Technical Requirements Specification

4.1
Item Category Definition
An item category BMR_LW_INVORGS will be defined with two segments Org & Site for
capturing the site code for the inventory organizations from where the lot records to be
transferred from EBS to Labware.
4.1.1
Item Category Definition

4.1.1.1
Value Set
The following value set will be created using Application Developer
responsibility
Navigation: Application -> Validation -> Set
Value Set Name
BMR_LW_INVORGS
Description
BMR Labware Raw Material Lot Transfer Inventory Orgs
List Type
List of Values
Security Type
No Security
Format Type
Number
Maximum Size
Numbers Only (0-9)
Yes
Validation Type
Table
Table Application
(SELECT A.ORGANIZATION_ID,A.ORGANIZATION_CODE||''||B.NAME AS ORG FROM MTL_PARAMETERS
A,HR_ALL_ORGANIZATION_UNITS B WHERE
A.ORGANIZATION_ID = B.ORGANIZATION_ID)X
Table Name
Table Columns
Value
Name
X.ORGANIZATION_ID
Type
Number
Size
9
Meaning
X.ORG
Varchar2
240
ID
ORDER BY X.ORG
Where/Order By
4.1.1.2
Item Category

Revision: 03
Page 14 of 19
Revision 03
The following item category structure will be created using BMR US

Administrator responsibility
Navigation: Inventory -> Flexfields -> Key -> Segments
Application
Flexfiled Title
Inventory
Item Categories
Structures
Code
Title
Number
Name
Window Prompt
Description
BMR Labware Raw Material Transfer
Organizations
Column
Value Set
BMR_LABWARE_TXR_ORGS
BMR_LABWARE_TXR_ORGS
10
Org
Org
SEGMENT1
BMR_LW_INVORGS
20
Site
Site
SEGMENT2
20 Characters
4.1.1.3
Category Codes
The item category codes will be added to the item category structure
created in step 4.1.1.2 using BMR US Inventory responsibility
Navigation: Setup -> Items -> Categories -> Category Codes
Any new inventory organization created under BioMarin Pharmaceutical Inc & BioMarin
International Ltd entities will be added to this category structure as part of organization
definition. The category codes are captured in CS-101875 Inventory document.
4.2
Application Lookup
An application lookup BMR_LABWARE_TXR_RM_ITEMS will be defined to capture the

inventory item series those lot records to be transferred from EBS to Labware.
The following application lookup will be created using Application Developer responsibility
Navigation: Application -> Lookups -> Application Object Library
Type
BMR_LABWARE_TXR_RM_ITEMS
Meaning
BMR EBS-Labware Transfer Raw Material Items
Application
BioMarin Custom Application
Code
Meaning
Description

Revision: 03
Z2
Z2000 RANGE
4.3
Page 15 of 19
Revision 03
Z2000 Range Items
SOA Composite Design

4.3.1
SQL Package
A SQL package BMR_LABWARE_INTEGRATION_PKG will be created to
validate the lot record processed by SOA composite
4.3.2
SOA composite for Data Transfer

A SOA composite section will be created to read lot record from
MTL_LOT_NUMBERS table whenever a new record is inserted and will update
ATTRIBUTE15 column with a value BPEL_LOT_READ upon successfully
reading the lot record from the table.
The new lot record will be validated using the SQL package created in section
4.3.1 and will initiate the record into BMR_BPEL_DATA_TRACK table for data
tracking and transferring the data to Labware upon successful validation
The SOA composite will be designed to wake up every 3 minutes once to process
the new lot records with ATTRIBUTE15 column NULL.

Revision: 03
4.3.3
Page 16 of 19
Revision 03
SOA composite for Error Tracking & Notification

A SQL table BMR_BPEL_LOG will be created to capture the error details
occurring in SOA composite during lot record transfer from EBS to Labware
A SOA composite section will be created to catch and insert the errors to the table
and a trigger BMR_BPEL_LOG_TRG will be created on the table to send email
notifications when records are inserted into the table

Revision: 03
4.3.4
Page 17 of 19
Revision 03
Tables and Views

The below listed tables and views are used in the SQL package for validating and
deriving the required data elements

Revision: 03
Table / View Name
Select
Insert
Update
Page 18 of 19
Revision 03
Delete
Base table
MTL_UNITS_OF_MEASURE_VL
MTL_UOM_CONVERSIONS
MTL_TRANSACTION_TYPES
MTL_MATERIAL_TRANSACTIONS
MTL_SYSTEM_ITEMS
MTL_PARAMETERS
MTL_TRANSACTION_LOT_NUMBERS
MTL_LOT_NUMBERS
FND_LOOKUP_VALUES_VL
MTL_CATEGORIES
FND_ID_FLEX_STRUCTURES
FM_FORM_MST
FM_MATL_DTL
BMR_BPEL_DATA_TRACK
BMR_BPEL_LOT

Revision: 03
Page 19 of 19
Revision 03
5 Revision History
Revision
No.
Description of Change
Document
Author /
Editor
Date
New document, ref: Ticket# 1759746 and

PR#25556
Ramesh
Krishnasamy
Oct 09, 2013
Ramesh
Krishnasamy
June 19, 2014
RS-100457
00
01
02
03
Updated sections# 2.2.1.1, 2.2.1.2, 3.2.1.2.1.7,

4.1.1.2 & 4.1.1.3 with ref to ticket# 2575110, CR#
38798 for fixing the blank manufacturer value
issue and rollout Labware interface to
SHANBALLY site.
Updated sections# 2.2.1.2 & 4.1.1.3 with ref to
ticket# 4216138, CR# 50614
The sections# 2.2.1 & 4.1.1.3 updated with ref to
ticket# 6210420, PR# 69143
Ramesh
Krishnasamy
Ramesh
Krishnasamy

Revision: 03
Dec 01, 2014

Sep 18, 2015
Document Approval Certificate

The individuals listed have approved this document using an electronic signature in the BioMarin Livelink ECM System.
UserName: Kris Pillai (kpillai)

Title: Sr. Engineer, ERP Computer System Validation, IT
Date: Tuesday, 13 October 2015, 12:25 PM Pacific Daylight Time
Meaning: I represent Validation and approve this document.
================================================
UserName: Siva Samidurai (ssamidurai)

Title: ERP Manager, Manufacturing and Supply Chain, IT
Date: Tuesday, 13 October 2015, 10:15 PM Pacific Daylight Time
Meaning: I represent IT and approve this document.
================================================
UserName: Norman Jung (njung)

Title: Technical Manager QA CSV
Date: Wednesday, 14 October 2015, 10:02 AM Pacific Daylight Time
Meaning: I represent QA and approve this document.
================================================
UserName: Ramesh Krishnasamy (rkrishnasamy)

Title: Manager, Business Technical Oracle ERP
Date: Sunday, 18 October 2015, 07:13 PM Pacific Daylight Time
Meaning: I am the System Owner and I approve this document.
================================================
This Document Contains Confidential and Proprietary Information of BioMarin Pharmaceutical.

Do Not Copy Or Distribute Without Permission
Revision: 03

RS-100457-EBS - Labware Integration PDF

Загружено:

Сведения о документе

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

RS-100457-EBS - Labware Integration PDF

Загружено:

Авторское право:

Доступные форматы

Requirements Specification

for the EBS Labware Integration

Confidential and Proprietary

Approval Date: 10/18/2015

PURPOSE OF THE DOCUMENT ............................................................................................... 3

USER REQUIREMENTS SPECIFICATION .............................................................................. 4

2.1 BUSINESS NEEDS ............................................................................................................................ 4

FUNCTIONAL REQUIREMENTS SPECIFICATION .............................................................. 7

3.1 FUNCTIONAL REQUIREMENT......................................................................................................... 7

TECHNICAL REQUIREMENTS SPECIFICATION ............................................................... 13

4.1 ITEM CATEGORY DEFINITION ...................................................................................................... 13

REVISION HISTORY ................................................................................................................. 19

Confidential and Proprietary

Approval Date: 10/18/2015

1 Purpose of the Document

Confidential and Proprietary

Approval Date: 10/18/2015

2 User Requirements Specification

The Interface will be automatically triggered in various business situations, as

Raw material lot

Supplier Lot Number

Child Lot Flag

A static text of NOVATO must be displayed for Site column

A static text of SHANBALLY must be displayed for Site column

Confidential and Proprietary

Approval Date: 10/18/2015

The Transaction Quantity value must be transferred to Labware

The Child Lot Flag must be a constant value of N.

Child Lot Flag

A static text of NOVATO must be displayed for Site column

A static text of SHANBALLY must be displayed for Site column

Confidential and Proprietary

Approval Date: 10/18/2015

Confidential and Proprietary

Approval Date: 10/18/2015

3 Functional Requirements Specification

An item category structure BMR_LABWARE_TXR_ORGS has to be created to

An Application Object Library lookup BMR_LABWARE_TXR_RM_ITEMS

Raw Material (Buy item) lot transfer:

Confidential and Proprietary

Approval Date: 10/18/2015

The interface must transfer the 3-letter inventory

Supplier Lot Number

Child Lot Flag

Intermediate (Make item) lot transfer:

Confidential and Proprietary

Approval Date: 10/18/2015

The interface must transfer the selected lot number.

Child Lot Flag

Functional Design / Mapping

Confidential and Proprietary

Approval Date: 10/18/2015

Responsibility & Navigation

Material Transactions Form: BMR US Inventory >

Lot Transactions Form: BMR US Inventory > Transactions >

Categories Form: BMR US Inventory > Setup > Items >

Item Lots Form: BMR US QA Approval Manager -> Lots ->

About This Record Form: BMR US QA Approval Manager ->

Unit of Measure Conversions Form: BMR US Inventory >

EBS Field Mappings

Raw Material (Buy Item) lot transfer:

Confidential and Proprietary

Approval Date: 10/18/2015