You are on page 1of 14

2/8/2015

Document469339.1

OracleWMSPersonalizationFramework(DocID469339.1)
InthisDocument
Abstract

INTRODUCTION

History
Details

ARCHITECTURE

PERSONALIZATIONFEATURES

PERSONALIZATIONRESTRICTIONS

PROFILEOPTIONSUSEDBYMWAPERSONALIZATIONFRAMEWORK

References

APPLIESTO:
OracleWarehouseManagementVersion11.5.10.0to12.2[Release11.5.10to12.2]
Informationinthisdocumentappliestoanyplatform.

ABSTRACT
INTRODUCTION
OracleWarehouseManagementSystemisarealtimeexecutionsystemthatenablesamajorityofthetransactionsto
beexecutedonthemobiledevicesandcapturestherelatedinformation.Whiletheproductisgrowingfeaturerichby
therelease,thevarietyofitsexpandingcustomerbaseisincreasingrapidlytoo.Thenumberofcustomersthatare
interestedinanddemandingtotailortheexecutionofthesemobiletransactionstotheircustombusinessprocesses
andproceduresisincreasing.
Thefollowingaresomeofthevarietyofreasonswhytheuserwantstocustomizethemobilepagesattheirfacility.
Themanagementisconfidentthattheirmobileoperatorsarewellqualifiedandcanbereliedupon,hencewouldlike
toreducetheamountofinformationthatneedstobeverifiedandconfirmedthroughthemobiledevices.Thiswill
reducethenumberofscansandhenceimprovethespeedandoverallefficiencyatwhichthemobiletransactionscan
beexecuted.
Defaultsomeofthefieldsbasedonthevariousbusinessrulesthatareusedattheirfacilityanddonotneedthe
operatorstoinput.
CaptureadditionalinformationtomeettherequirementsofthebusinessprocessesandproceduresusingtheLPN
Descriptiveflexfield.
TheprojectwilleliminatetheneedtocustomizetheWMSmobileUIpagesandreducetheimplementationtimeforthe
growingWMScustomerbase.Patch6662606providesthecapabilityofpersonalizingOracleWarehouseManagement
pagesforrelease11.5.10.WMSPersonalizationFrameworkisdeliveredwithreleases12.1.Xforwardandisnot
availableforrelease12.0.X.
Inrelease12.1.1andhighercustomersmayalsodefinetheirownvalidationlogicforanyeditablefieldonanymobile
applicationpagewithoutactuallycustomizingit.Thisisaccomplishedviathefilecustomlistener.java.Pleasereferto
Note1621549.1foradditionalinformation.
Also,pleasereviewtheSupportPolicyannouncementsforEBusinessSuiteReleases11.5.10,12.0,12.1and12.2
foundinNote1494891.1.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=1269bi46pd_70&id=469339.1

1/14

2/8/2015

Document469339.1

HISTORY
Authors:BhanuVanjakuandPuneetSood
CreateDate:30NOV2007

DETAILS
ARCHITECTURE
ThefollowingdiagramrepresentsthearchitectureofMWAPersonalizationFramework.

CustomerscanusetheMWAPersonalizationFrameworkmenuoption,whichisavailableundertheexistingWarehouse
ManagerresponsibilitysSetupmenuoption,topersonalizetheWMSMobilepages
Personalizationcanbedoneatthreedifferentlevels.Thelevelsinorderofdecreasingprecedenceare:
1.Responsibility
2.Organization
3.Function

PERSONALIZATIONFEATURES
Customerscannowachievethefollowingwithoutmakinganycodechanges:
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=1269bi46pd_70&id=469339.1

2/14

2/8/2015

Document469339.1

Hidefieldsandbuttons.
Changethepromptsforthefieldsandbuttons.
Providedefaultvaluestothefields.
a.Ifthereisnodefaultvalueprovidedusingpersonalizationframeworkthensystemtriestogetthedefaultvaluefrom
acustomjavaclassasexplainedinappendixA.
Copythevalueofafieldtotheanotherfield.
Seteditablefieldsasreadonly.
Setnonmandatoryfieldsasmandatory.
Enable/DisabletheLPNDescriptiveFlexField.DFFcanalsobemadeasareadonlyfield

PERSONALIZATIONRESTRICTIONS
Anygivenfieldonapagecanbehiddenprovidedanyoneofthefollowingistrue.
1.Thefieldisnotarequiredfield.
2.Thefieldisrequiredbutavaliddefaultvalueissetthroughthispersonalizationframework.
3.Thefieldisadisplayonlyfield.
Aneditablefieldcanbemadereadonlywhenanyonethefollowingistrue.
1.Thefieldisnotarequiredfield.
2.Thefieldisrequiredbutavaliddefaultvalueissetthroughthepersonalizationframework.

PROFILEOPTIONSUSEDBYMWAPERSONALIZATIONFRAMEWORK
MWA:EnablePersonalization
YoushouldsetthisprofileoptiontoYesforpersonalizationtotakeeffect.Thisprofileoptioncanbesetatsite,
application,responsibilityanduserlevel.
MWA:CachePersonalizedMetadata
ThisprofileoptionshouldbesettoYesatsitelevelonaproductioninstanceforfasterperformance.Thisprofile
optionisspecificallycreatedforPersonalizationAdministratortoquicklyreviewthepersonalizationchangeswithout
havingtobouncethemobileserverbysettingittoNoatuserlevel.
Personalizationissupportedforthefollowingpages:
1.PickLoadPage
PickLoadPagecanbeaccessedusingacceptanytasksmenu(MobileWMSTasksInterleaveAcceptFunction)orby
usingpaperbasedpickingmenu(MobileWMSManualPickingFunction).PersonalizationdoneatthefunctionMobile
WMSManualPickingwillbepickedupirrespectiveofthecurrentfunctionifthecurrentpageisPickLoadPage.
2.PickDropPage
PickDropPagecanbeaccessedusingtheDropLoadedLPNsmenu(MobileWMSDropLoadedLPNsFunction).
3.ManualLoadPage
ManualLoadPagecanbeaccessedusingthemenuManualLoadavailableundermanualtasks(MobileWMSInbound
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=1269bi46pd_70&id=469339.1

3/14

2/8/2015

Document469339.1

ManualLoadFunction).
4.ItemLoadPage(ManualLoadSelectContentsPage)
UsercannavigatetoitemloadpageifSelectContentsbuttonisclickedonmanualloadpage.
5.MoveAnyLPNpage
6.DropPage(MoveAnyLPNSelectItemspage)
IftheformfunctionparameterSUGGESTIONissettoLINESforthefunctionMobileWMSMoveAnyLPNthenuserwill
beabletonavigatetoPutawayDropPage.
7.UpdateLPNPage
8.MobilePOReceiptpage
9.MobilePOReceiptInformationPage
UsercannavigatetoPOReceiptInformationpageifDonebuttonisclickedonPOReceiptpage.
10.LPNShipPage
11.MobileShipConfirmPage
Usercannavigatetomobileshipconfirmpageifcontinue/shipbuttonisclickedonLPNShippage
PERSONALIZINGMOBILEPAGES
StepsforPersonalizingaMobilePage
Step1:NavigatetotheselfserviceWarehouseManagerresponsibilityandchooseMWAPersonalizationframework
optionundertheSetupsubmenu.ThisoptionisalsoavailableintheMWAServerManagerresponsibility.Thismenu
optiontakestheusertothePersonalizationHomepage
Step2:TheListofvaluesfortheMobilepagefielddisplaysthefunctionnameandthemobilepages,whichcanbe
personalized.SelectapageandclickthePersonalizebutton.

Step3:Allthecurrentfieldsandbuttonsforthepagearedisplayed.ChooseafieldfromtheFieldslisttableand
clicktheEditicon

topersonalizethefield.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=1269bi46pd_70&id=469339.1

4/14

2/8/2015

Document469339.1

Step4:Anewpageisdisplayedwhichlistsallthepropertiesofthefieldthatcanbepersonalized.Maketherequired
personalizationandhittheApplybuttontosaveyourpersonalizationfortheselectedfield.Repeatthisstepforallthe
fieldsyouwouldliketopersonalizeonthispage.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=1269bi46pd_70&id=469339.1

5/14

2/8/2015

Document469339.1

Step5:Navigatetothemobilepageandreviewyourpersonalizationdoneforthepage.Note:Iftheprofileoption
MWA:CachePersonalizedMetadataissettoYesthen,thepersonalizationmadewillcomeintoeffectonlyafter
bouncingthemobileserver.

DefaultUpdateLPNPagePersonalizedUpdateLPNPage
ThePersonalizedUpdateLPNPagedisplaysthepagenameas*UpdateLPN(W1)The*indicatesthatthepage
involvedhasbeenpersonalized.
TheabovepictureshowsthebeforeandafterviewoftheUpdateLPNpagewiththefollowingpersonalization:
LPNfieldspromptchangedtoCustomLPN.
Defaultvalueissettoweightfieldandismadereadonly.
LPNAttributesLPNDFFisenabled/renderedfortheLPNfield.
ContentVol.fieldismadehidden.
Containerfieldismademandatory/required.
UpdateLPNbuttonspromptischangedtoCustomUpdate.
Activate/DeactivatePersonalization
PersonalizationcreatedforapagecanbeActivated/Deactivatefromtheactivate/deactivatepersonalizationpage.

EnablingDescriptiveFlexFieldsforaMobilePage
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=1269bi46pd_70&id=469339.1

6/14

2/8/2015

Document469339.1

AnewDescriptiveFlexfield(DFF)hasbeenseededfortheWMSLicensePlateNumberTable.Oraclehasseededthe
DFFonallthepagesbeingenabledforpersonalization.TheusershavetoenabletheDFFforthepagestheywantto
havetheDFFdisplayed.

UpdateAllowed:Whenuncheckedandatleastoneoftheattributecolumnshavedata,alltheDFFAttributeswillbe
renderedasreadonly.Ifnot,theuserwillbeallowedtoenter/updatetheDFFattributefields

Headers:Optionallychooseoneormorefields,fromthepage,tobedisplayedasheadersontheDFFwindow.
HeaderfieldsareignorediftheyarenotvisibleonthepageatthetimetheDFFwindowisinvoked(ControlF)bythe
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=1269bi46pd_70&id=469339.1

7/14

2/8/2015

Document469339.1

user.ThisheaderfielddefinitionsareignoredwhentheDFFattributefieldsaredisplayedinlinewiththepage.

LPNDFFenabledonUpdateLPNpagewithDisplayAftersettoLPN.

TheLPNDFFisenabledontheUpdateLPNpagewithDisplayInlinesettoFalse.TheDFFwindowisinvokedusing
(ControlF).

LPNDFFenabledontheUpdateLPNpagewithDisplayInlinesettoTrue.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=1269bi46pd_70&id=469339.1

8/14

2/8/2015

Document469339.1

APPENDIXA:Providingdefaultvaluefromacustomclass
IfthereisnodefaultvalueprovidedthroughtheMWAPersonalizationframeworkasshowninthefollowingscreenshot
thenthesystemwilltrytogetthevaluefromacustomclassFieldDefaultValueHandlerImpl.classthatcontainsuser
definedlogic.

PleasemakesurethatthisclassiscompiledwithOracleapps.zipintheclasspath.
Aftercompilation,makesurethatafileFieldDefaultValueHandlerImpl.classiscreated.Pleasemovethisfileto
$CUSTOM_DIRECTORY/xxx/customandadd$CUSTOM_DIRECTORYtotheclasspathofyourmobileserver.
$CUSTOM_DIRECTORY,canbeanydirectoryonthefilesystem.

//FieldDefaultValueHandlerImpl.java
packagexxx.custom
importoracle.apps.mwa.beans.FieldBean
importoracle.apps.mwa.beans.PageBean
importoracle.apps.mwa.container.Session
importoracle.apps.mwa.presentation.telnet.personalization.*
importoracle.apps.mwa.presentation.telnet.personalization.FieldDefaultValueHandler
//FieldDefaultValueHandlerImplshouldextendtheabstractclassFieldDefaultValueHandler
publicclassFieldDefaultValueHandlerImplextendsFieldDefaultValueHandler
{
publicFieldDefaultValueHandlerImpl()
{
}

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=1269bi46pd_70&id=469339.1

9/14

2/8/2015

Document469339.1

publicstaticStringgetCustomDefaultValue(Sessionsession,PageBeanpageBean,FieldBeanfieldBean)
{
//Userhasaccesstothecurrentsession,currentpageandcurrentfieldbean.PleaserefertoWMS/INV/MWA
//javadocsforgettingmoredetailsonhowtocustomizeusingtheprovidedmethods.Usercanplacetheneeded
custom
//logicinthismethod
Stringval
if(fieldBean.getName().equals("LPN")&&
pageBean.getName().equals("oracle.apps.wms.pup.server.UpdateLPNPage"))
{
val="CustomDefaultValue"
returnval
}
returnnull
}
}
APPENDIXB:ScopeOfMobilePersonalizationFeature
ThefollowingtableliststhescopeoftheMobilePersonalizationfeatureavailableforapplicationreleases11.5.10CU2
and12.1.Xalongwiththerecommendedprocessguidelinestoaddresscustomerreportedissues.Thisfeature
leveragesMWAfunctionalitytopersonalizethefollowingMobileUIscreens.
Product Function

UserFunction
Name

Javaclass

INV

INV_MOB_PO_RCPT

MobilePO
Receipt

oracle.apps.inv.rcv.server.RcptGenPage

INV

MobilePO
Receipt
Information1*

oracle.apps.inv.rcv.server.RcptInfoPage

WMS

WMS_MANUAL_PICKING_MOB

MobileWMSPick oracle.apps.wms.td.server.MainPickPage
Load

WMS

WMS_DROP_LOADED_LPNS_MOB MobileWMSPick oracle.apps.wms.td.server.PickDropPage


Drop

WMS

WMS_IN_MANLD_MOB

MobileWMS
Inbound
ManualLoad

oracle.apps.wms.td.server.PutawayPage

WMS

MobileWMS
ManualLoad
Select
Contents2*

oracle.apps.wms.td.server.ItemLoadPage

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=1269bi46pd_70&id=469339.1

10/14

2/8/2015

Document469339.1

WMS

WMS_LPN_SHIP

MobileLPNShip

oracle.apps.inv.wshtxn.server.ShipLPNPage

WMS

MobileShip
Confirm3*

oracle.apps.inv.wshtxn.server.DeliveryLPNPage

WMS

WMS_MOVE_ANY_LPN_MOB

MobileWMS
MoveAny
LPN

oracle.apps.wms.td.server.PutawayPage

WMS

MobileWMS
MoveAnyLPN
(SelectItem)4*

oracle.apps.wms.td.server.PutawayDropPage

WMS

WMS_UPDATE

MobileWMS
UpdateLPN

oracle.apps.wms.pup.server.UpdateLPNPage

WIP

WMA_LPN_CMPASSY

Assembly
CompletionBy
LPN5*

oracle.apps.wip.wma.page.LpnCompletionPage

OPM

GME_MOBILE_ISSUE_ING

GMEMobile
Issue
Ingredients5*

oracle.apps.gme.invtxn.server.IssueIngredientPage

OPM

GME_MOBILE_CMPLT_PROD

GMEMobile
Complete
Product5*

oracle.apps.gme.invtxn.server.CompleteProductPage

OPM

GME_MOBILE_CREATE_PND_LOT GMEMobile
CreatePending
Lot5*

oracle.apps.gme.invtxn.server.CreatePendingLotPage

OPM

GME_MOBILE_BACKFLUSH

GMEMobile
Backflush5*

oracle.apps.gme.invtxn.server.BackflushMaterialPage

INV

INV_MOB_PO_RCPT

LotAttributes
PagePO
Receipt5*6*

oracle.apps.inv.utilities.server.LotAttPage

INV

INV_MOB_ALIAS_ISS

MobileAlias
Issue5*

oracle.apps.inv.invtxn.server.IssueTrxPage

INV

INV_MOB_ALIAS_RCPT

MobileAlias
Receipt5*

oracle.apps.inv.invtxn.server.RcptTrxPage

INV

WMS_ASN_RECEIPT

MobileASN
Receipt5*

oracle.apps.inv.rcv.server.RcptGenPage

INV

INV_MOB_CYCL_COUNT

MobileCycle
Count5*

oracle.apps.inv.count.server.CycleCountPage

INV

WMS_INSPECT

MobileInspect
LPN5*

oracle.apps.inv.rcv.server.InspectPage

INV

INV_MOB_INQUIRY

MobileItem
Inquiry5*

oracle.apps.inv.invinq.server.ItemOnhandQueryPage

INV

INV_MOB_LPN_INQUIRY

MobileLPN
Inquiry5*

oracle.apps.inv.utilities.server.LPNDetailPage

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=1269bi46pd_70&id=469339.1

11/14

2/8/2015

Document469339.1

INV

INV_MOB_PHYS_COUNT

MobilePhysical
Count5*

oracle.apps.inv.count.server.PhyInvPage

WMS

WMS_SPLIT

MobileWMSLPN oracle.apps.wms.pup.server.PackUnpackSplitPage
Split5*

WMS

WMS_MANUAL_PICKING_MOB

MobileWMS
Manual
Picking5*7*

oracle.apps.wms.td.server.DetailPickPage

WMS

WMS_PACK

MobileWMS
Pack5*

oracle.apps.wms.pup.server.PackUnpackSplitPage

WMS

WMS_UNPACK

MobileWMS
Unpack5*

oracle.apps.wms.pup.server.PackUnpackSplitPage

INV

INV_MOB_MO_REPL

MobileMove
oracle.apps.inv.count.server.EnterReplenishCountPage
Order
Replenishment8*

INV

INV_MOB_ORG_XFER

MobileOrg
Transfer8*

INV

INV_MOB_REPL_KANBAN

MobileReplenish oracle.apps.inv.kanban.server.RpKBPage
Kanban8*

INV

INV_MOB_SUB_XFER

MobileSub
Transfer8*

oracle.apps.inv.invtxn.server.OrgTransferPage

oracle.apps.inv.invtxn.server.SubXferPage

Details

1*

PageisinvokedwhenuserpressesDoneonMobilePO
Receiptpage

2*

PageisinvokedwhenuserpressesSelectContentson
MobileManualLoadPage

3*

PageisinvokedwhenuserpressesContinue/Shipon
MobileLPNShippage

4*

Pageisinvokedwhentheformfunctionparameter
Suggestion=Linesisaddedforthe
functionWMS_MOVE_ANY_LPN_MOB

5*

Availablefrom12.1onwards(withPatch13446342
:R12.MWA.B)

6*

PageisinvokedduringPOreceipttransactionforlot
controlleditems.

7*

Pageisinvokedwhenusernavigatesto'ItemDetails'
pagewhileperformingmobilepick
loadtransaction.

8*

Availablefrom12.1.3onwards(withPatch18081430
:R12.WMS.B.delta.8)

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=1269bi46pd_70&id=469339.1

12/14

2/8/2015

Document469339.1

Product

ProductID

WMS

385

INV

508

WIP

572

OPM

742

RecommendedSupport/BugloggingprocessforMobilePersonalizationfeature
PleaserefertoMetalinkNote469339.1forcompletedetailsaboutthisfeature.
Whencustomersreportapersonalizationrelatedissue,aTARneedstobeloggedagainsttheapplicationproduct
involved(385/508/572/742).Theproductsupportinvolvedwilltroubleshoottheissueusingthefollowingguidelines
IssuereportedPersonalizationchangesarenotreflectedinMobileUI
EnsurethefollowingprofilevaluesaresetfortheuserYMWA:EnablePersonalization=YesYMWA:Cache
PersonalizedMetadata
Nononeedtobouncethemobileservertoreflectthepersonalizationchanges
Yesneedtobouncethemobileservertoreflectthepersonalizationchanges
Oraclemandatesbouncingofthemobileserverincaseanyprofilevaluesarechanged
Ensurethatthepersonalizationisactiveattheleveldesired(function/organization/responsibilitylevel)
PleasepressCTRLXonthemobileUIinvolvedandnotetheport#,function,CLASSPATHandthepageclass.
Verifythedataobtainedwiththedetailsmentionedinthetableonpage(1)
Verifythatuserisusingthebouncedport(ifapplicable)
Verifythattheclasspathdoesnotpickthecustomfiles
Defaultingusingcustomclassdoesnotwork
Removeallcustomcodeandkeepadefaultvaluetobereturnedandtestforsuchcases.Ifitworks,thentheissue
iswiththecustomcode
Incaseofanyissuesspecifictoonlycertainfield(s)/page(s)thenthebugneedstobeloggedagainstapplication
productinvolved
Ifthereisanyissueforallthefieldsinallthepages,thetarneedstobetransferredtoMWAsupport
DFFspecificissues
PleaseensurethattheDFFisfrozen
DFFneedstoberecompiledafteranychangesandmobileneedstobebouncedafterthat
EnsurethattheDFFhascorrectvaluesets/validationlogic
IftheissueisspecifictothedisplayoptionoftheDFF(inline/notinline),thetarneedstobetransferredtoMWA
support
IssuereportedPersonalizationchangesarenotpossibleoncertainfieldsonsupportedpages
Theseissuesneedtobebuggedagainsttherespectiveproductteam.

Copyright2008Oracle.Allrightsreserved.OracleisaregisteredtrademarkofOracle.Various
productandservicenamesreferencedhereinmaybetrademarksofOracle.Allotherproductand
servicenamesmentionedmaybetrademarksoftheirrespectiveowners.
Disclaimer:Thisdocumentisprovidedforinformationpurposesonlyandthecontentshereofare
subjecttochangewithoutnotice.Oracledoesnotwarrantthatthisdocumentiserrorfree,nordoesit
provideanyotherwarrantiesorconditions,whetherexpressedorallyorimpliedinlaw,including
impliedwarrantiesandconditionsofmerchantabilityorfitnessforaparticularpurpose.Oracle
specificallydisclaimsanyliabilitywithrespecttothisdocumentandnocontractualobligationsare
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=1269bi46pd_70&id=469339.1

13/14

2/8/2015

Document469339.1

formedeitherdirectlyorindirectlybythisdocument.Thisdocumentmaynotbereproducedor
transmittedinanyformorbyanymeans,electronicormechanical,foranypurpose,withouttheprior
writtenpermissionofOracle.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=1269bi46pd_70&id=469339.1

14/14

You might also like