Professional Documents
Culture Documents
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
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