Smart Device
sdgfd
Last Modified: January 23, 2012 15:06 a1/p1 Printed On: November 7, 2006
ORACLE CONFIDENTIAL. For authorized use only. Do not distribute to third parties. Copyright 2012, Oracle and/or its affiliates. All rights reserved. This document is for informational purposes only. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described in this document remains at the sole discretion of Oracle. This document is not warranted to be error free, nor is it subject to any other warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or fitness for a particular purpose. This document in any form, software or printed matter, contains proprietary information that is the exclusive property of Oracle. This document and information contained herein may not be disclosed, copied, reproduced or distributed without the prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.
Smart Device
Table of Contents
Table of Contents..........................................................................................................................4 Overview........................................................................................................................................5 Document History.........................................................................................................................5 Business Use Cases.....................................................................................................................5 Design Element Asset Replication Activity..............................................................................5 System Data.............................................................................................................................6 Business Services..............................................................................................................6 Navigation Options.............................................................................................................8 Application Service.............................................................................................................9 User Interface and Business Rules...........................................................................................9 Menu / Submenu / Context Menu / Go To Context..............................................................9 Replication Activity Query Portal (W1REPACTQ) (New)...................................................10 Related Object Search Zone (W1-REPACTQ1)(New).......................................................11 UI Maps............................................................................................................................15 BPA Scripts.............................................................................................................................19 Asset Replication Activity BPA Script (W1-AsRpActMnt) (New)........................................19 Reapply Asset Template BPA Script (W1-AppAstTmp) (New)..........................................20 Service Scripts........................................................................................................................21 Validate Replication Related Object Query Filter (W1-ValReplRO) (New).........................21 Implementation Guidelines......................................................................................................22 Replication Guidelines......................................................................................................22 Design Element Mass Asset Disposition Update ..................................................................23 System Data...........................................................................................................................23 Business Services............................................................................................................23 Navigation Options...........................................................................................................26 Application Service...........................................................................................................27 Service Program...............................................................................................................27 Services..................................................................................................................................28 Retrieve Asset Next Dispositions Service (New)...............................................................28 Retrieve Assets using Asset Info Criteria (Update)............................................................30 User Interface and Business Rules.........................................................................................31 Menu / Submenu / Context Menu / Go To Context............................................................31 Mass Asset Disposition Update Portal (W1ASTMDU) (New).............................................32 Asset Information Query Zone (W1-ASTMDUQ1)(New)....................................................35 BPA Scripts.............................................................................................................................38 Asset Disposition Mass Update BPA Script (W1-AstMasUpd) (New)................................38 Service Scripts........................................................................................................................40 Validate Asset Information Mass Asset Disposition Filter ( W1-AsMdQ1Val) (New)..........40 Asset Info Query Zone Pre-Processing (W1-AsInfQ1ss) (Update)....................................41
Overview
This document describes the entities and processes needed to support asset replication and asset disposition mass update.
Document History
Date 2011-12-29 2012-01-13 2012-01-18 2012-01-19 Name Anette Velarde Jay Dela Cruz Jay Dela Cruz Anette Velarde Description/Reason for change Initial Version Modified for internal review Review points Review points -Added Asset column (New Asset Section) in General Asset Replication Display UI Map 2012-01-23 Anette Velarde Added Copy Service History Flag in Asset Replication UI (Display & Maintenance)
Smart Device
System Data
Business Services
Retrieve Activity Types of a Category (W1-ACTTYPCAT) (New)
This business service returns all activity types of a particular category.
Properties
Property Code Description Service Program Application Service W1-ACTTYPCAT Retrieve all activity types of a particular category FWLZDEXP Data Explorer F1-DFLTAPS Value
Schema
Field Category Row Count Results Activity Type Element name category rowCount results activityType Comments mapField="F1_VALUE" mapField="ROW_CNT" type="list" mapList="DE" Flattened element for the first column of the result set. mapField="COL_VALUE" Activity Type Description description Flattened element for the first column of the result set. mapField="COL_VALUE"
Xml Schema
<schema> <zone mapField="ZONE_CD" default="W1-ACTTYPCAT" private="true"/> <category mapField="F1_VALUE"/> <rowCount mapField="ROW_CNT"/> <results type="list" mapList="DE"> <activityType mapField="COL_VALUE"> <row mapList="DE_VAL"> <SEQNO is="1"/> </row> </activityType>
<description mapField="COL_VALUE"> <row mapList="DE_VAL"> <SEQNO is="2"/> </row> </activityTypeDesc> </results> </schema>
Properties
Property Code Description Zone Type Application Service W1-ACTTYPCAT Retrieve all activity types of a particular category F1-DE F1-DFLTS Value
Parameters
Parameter Display Description Area User Filter 1 SQL 1 Condition SQL 1 Display Columns SQL Statement 1 Column 1 for SQL 1 Column 2 for SQL 1 False type=String name=category required=true F1 C1 C2 Pseudo SQL 1 source=SQLCOL sqlcol=ACT_TYPE_CD source=SQLCOL sqlcol=ACT_TYPE_DESC Value
Pseudo SQL
SELECT A.ACT_TYPE_CD, L.DESCR100 ACT_TYPE_DESC FROM W1_ACTIVITY_TYPE A, W1_ACTIVITY_TYPE_L L WHERE A.ACT_TYPE_CD = L.ACT_TYPE_CD AND L.LANGUAGE_CD = :LANGUAGE AND A.CATEGORY_FLG = :F1
Smart Device
Navigation Options
Replication Activity Query (w1repactqTabMenu) (New)
This navigation option points to the Replication Activity Query portal. This is automatically generated when the query portal is created.
Properties
Property Code Description Navigation Option Type Navigation Mode Target Transaction Tab Page Search Transaction Search Type Search Group Script Go To Tooltip <script> Replication Activity The Navigation option that points to Replication Activity Query portal. Transaction Add Mode w1repactqTabMenu Value
Context
Field <context field> <True/False> Key Field
Usage
Navigation Usage Favorites Menu
Application Service
Replication Activity Query (W1REPACTQ) (New)
This is the application service associated with the Replication Activity Query portal and is automatically generated when the portal is created
Properties
Property Code Description W1REPACTQ This application service is associated with the Replication Activity Query portal Value
Access Modes
Access Modes Inquire (R)
Contents
Name Replication <+> Description This launches the Replication Activity Search Portal. Clicking the (+) button will invoke the Asset Replication BPA Script. Product Module
Smart Device
Layout
Properties
Property Code Description Type Navigation Option Show On Portal Preferences W1REPACTQ Replication Activity Query Stand Alone w1repactqTabMenu No Value
Portal Zones
Zone W1REPACTQRY Display True False Initially Collapsed Default Sequence 10
Layout
10
Parameters
Parameter Query Zone 1 Override Action 1 W1-REPACTQ1 type=LINK action=SCRIPT bpa='W1-RepActMnt' label=ADD_LBL class='oraZoneHeaderLink' tempstorage=[action='ADD'] Value
Dialogue Trigger
Click Add Hyperlink
Clicking the Add hyperlink will invoke the Asset Replication BPA to add a new Replication Activity.
Properties
Property Code W1-REPACTQ1 Value
11
32012 Asset Receipt Inspection Portal External Design Management Description Zone Type Application Service Width Replication Activity Related Object Search F1-DE-QUERY W1REPACTQ Full
Smart Device
Parameters
Parameter Display Description Area Filter Area UI Map Validate Filter Values Service Script User Filter 1 User Filter 2 User Filter 3 User Filter 4 User Filter 5 User Filter 6 Excel Rows SQL Display Columns SQL Statement 1 Column1 for SQL1 Column2 for SQL1 False Replication Activity Related Object Query Filter (W1AssetReplActivityQ1QryFltr ) ss='W1-ValReplRO' input=[activityType=F1 activityStatus=F2 workOrderId=F3 assetId=F4 nodeId=F5 activityId=F6] type=String xpath= activityType type=String xpath=activityStatus type=String xpath=workOrderId type=String xpath=assetId type=String xpath=nodeId type=String xpath=activityId Leave blank to enable Export to Excel on zones toolbar C4 C6 C8 C10 Pseudo SQL source=SQLCOL sqlcol=CRE_DTTM source=SPECIFIED spec=['<span style="display:none;">'C1'</span> C4] order=DESC Column3 for SQL1 Column4 for SQL1 source=SQLCOL sqlcol= ACT_ID source=FKREF fkref= W1-ACTV input=[ACT_ID=ACT_ID] label= <Activity> Column5 for SQL1 Column6 for SQL1 source=SQLCOL sqlcol=NODE_ID source=FKREF fkref= W1-NODE input=[NODE_ID=NODE_ID] label=<Node> suppress=true Value
12
Smart Device Management Design Column7 for SQL1 Column8 for SQL1
source=SQLCOL sqlcol =WO_ID source=FKREF fkref= W1-WO input=[WO_ID=WO_ID] label= <Work Order> suppress=true
Pseudo SQL
SELECT ACT.ACT_ID, ACT.NODE_ID NODE_ID, ACT.ASSET_ID ASSET_ID, ACT.WO_ID, ACT.CRE_DTTM, ACT.ACT_TYPE_CD FROM W1_ACTIVITY ACT, W1_ACTIVITY_TYPE ACTTYPE WHERE ACT.ACT_TYPE_CD= ACTTYPE.ACT_TYPE_CD AND ACTTYPE.CATEGORY_FLG ='W1RE' [(F1) AND ACT_TYPE_CD =:F1] [(F2) AND ACT.BO_STATUS_CD=:F2] [(F3) AND ACT.WO_ID=:F3] [(F4) AND ACT.ASSET_ID=:F4] [(F5) AND ACT.NODE_ID=:F5] [(F6) AND ACT.ACTIVITY_ID =:F6] ORDER BY ACT.CRE_DTTM DESC
List Contents
This query zone has the following user filters. At least one filter other than activity type and activity status must be populated, but activity type and activity status is optional. Selects all activity records that match all entered filters and the category of its activity type is W1RE - Replication.
Activity Information Information String of Activity Node Information Information String of Node Asset Information Information String of Asset Work Order Information Information String of Work Order
13
Smart Device
Properties
Property Code Description UI Map Type Related Object HTML Fragment Value W1-AssetReplActivityQ1QryFltr
Layout
Contents
Activity Type Dropdown with activity types whose category is W1RE Replication. See business service Select Activity Types Of A Category. Status Drop down. Build the drop down which consists of all states of business objects under Activity MO. Use the business service W1-RTBOST to get the activity status descriptions for Activity MO. Work Order ID Custom Search of Work Order - Multi Query Zone. Asset ID Custom Search of Asset - Multi Query Zone. Node ID Custom Search of Node - Multi Query Zone. Activity ID
14
UI Maps
General Asset Replication Maintenance UI Map (W1AssetReplActivityMaint) (New)
This UI Map is used to maintain a general asset replication activity.
Properties
Property Code Description UI Map Type Value W1-AssetReplActivityMaint General Asset Replication Activity Maintenance Complete HTML Document
Layout
Contents
Main Section Activity Type, display only Asset ID, mdField=Template Asset, custom search Node, display only and only visible when node id is populated
15
32012 Asset Receipt Inspection Portal External Design Management Work Order ID, custom search Copy Service History, checkbox, required and default No (unmarked)
Smart Device
New Assets Section A grid of information to be overriden on a template Sequence Number Badge Number Serial Number Asset, display only Buttons Upload from CSV File, information from file is used to populate the New Assets Section Download to CSV File, information from New Assets Section will be saved to a CSV File
Note. Code on how to Upload and Download a CSV File can be found in the oraHtml Attributes UI Map Tips
Schema
Xml Schema
<schema> <action suppress="true"/> <boGroup type="group"> <includeBO name="W1-AssetReplicationActivity"/> </boGroup> </schema>
Properties
Property Code Description UI Map Type W1-AssetReplActivityDisp General Asset Replication Activity Display Complete HTML Document Value
16
Layout
Dialogue Trigger
Click on Edit Button
This will execute the Asset Replication Activity Maintenance BPA Script with UPD action.
Content
Main Section Activity Info Activity Type Status Status Reason, only visible when populated
17
32012 Asset Receipt Inspection Portal External Design Management Asset, mdField=Template Asset Node Work Order Copy Service History
Smart Device
New Asset Section, initially collapsed A list of assets to be replicated Sequence Number Badge Number Serial Number Asset InfoID (will have value once replication is completed)
Reapply. Note that the label should use MD field. Only available when activity status is Completed Status Transition.
Record Info Section, initially collapsed Activity ID Business Object Status DateTime Create DateTime
Schema
Xml Schema
<schema> <action suppress="true"/> <boGroup type="group"> <includeBO name="W1-AssetReplicationActivity"/> </boGroup> <nextStates type="group"> <includeBS name="F1-RetrieveNextStates"/> </nextStates> </schema>
18
Properties
Property Code Description UI Map Type Value W1-ActivityTypeForReplication Activity Type For Replication HTML Fragment
Layout
Content
Activity Type Dropdown values will be populated from the results of the Retrieve Activity Types of a Category
Schema
Xml Schema
<schema> <activityType mdField="ACT_TYPE_CD"/> <activityTypeList type="group"> <includeBS name="W1-W1-ACTTYPCAT"/> </activityTypeList> </schema>
BPA Scripts
Asset Replication Activity BPA Script (W1AsRpActMnt) (New)
This script is used to maintain an activity and is invoked from: Menu Replication + Add hyperlink on the Replication Activity Search Zone.
19
Smart Device
Edit, Delete buttons and State Transition Buttons in General Asset Replication Activity Display UI Map.
Properties
Property Code Description Accessibility Option Script Engine Version W1-AsRpActMnt Asset Activity Replication Maintenance Accessible from Script Menu 1.0 Value
Data Area
Schema Type Business Service Service Script Service Script Service Script Object F1-DetermineBo F1-GetBOOpts F1-GetBOSOpt F1-RetBOs DA Name F1-DetermineBo F1-GetBOOpts F1-GetBOSOpt F1-RetBOs
Script Steps
This BPA is similar to the standard Activity maintenance BPA script. The difference is that the Activity Type for Replication UI Map should be invoked in order to limit the Activity Types with a Replication Category.
Properties
Property Code Description Accessibility Option W1-AppAstTmp Reapply Asset Template Accessible from Script Menu Value
20
Data Area
Schema Type Object DA Name
Script Steps
Call service script Asset Mass Replication/Update with update action. See note below.
Note: Refer to 32012 Asset Receipt Inspection BO ED for the Service Script
Service Scripts
Validate Replication Related Object Query Filter (W1-ValReplRO) (New)
This validates the filter for the Related Object query zone of the Replication Activity Portal.
Properties
Property Code Description Application Service Script Engine Version W1-ValReplRO Validate Replication Related Object Query Filter F1-DFLTAPS <script engine version> Value
Schema
Field Activity Type Activity Status Element name activityType activityStatus Comments
21
32012 Asset Receipt Inspection Portal External Design Management Work Order ID Asset ID Node ID Activity ID workOrderId assetId nodeId activityId
Smart Device
Script Steps
If Work Order ID and Asset ID and Node ID and Activity are not populated, then: Terminate with error: At least one filter must be populated other Activity Type and Activity Status
Implementation Guidelines
Replication Guidelines
Please take the following steps to finish the setup: 1. Create a completion event type using Replication Completion Event Type business object. On the completion event type, choose the General Asset Replication Completion Event business object. 2. Create an activity type using Basic Activity Type business object. Set Category to W1RE Replication. Define the completion event type defined above as the only completion event type and as required. Choose the General Asset Replication Activity business object.
The base activity business object only allows users to change badge number and/or serial number when replicating assets and everything else are kept the same as the template asset. When receiving many the same assets, the users are required to create one asset for the lot first and replicate the rest. If an implementation needs to override other information, please take the following steps to extend base functionality: 1. Create a new asset replication activity BO to accept those overrides. 2. If needed, create a new asset replication completion event BO with a new enter algorithm for the Excute status. Note that the enter plug-in on the base BO moves elements in the list by name to the asset BO. 3. Set up a completion event type and an activity type as described above.
22
System Data
Business Services
Retrieve Asset Next Dispositions (W1RetAssetNextDispostions) (New)
This business service returns the list of next possible asset dispositions for a given asset type & asset disposition or an asset id.
Properties
Property Code Description Service Program Application Service Value W1-RetAssetNextDispostions Returns the list of next possible asset dispositions for a given asset type & asset disposition or an asset id W1-ASTNXTDPOS F1-DFLTAPS
Schema
Field Asset Type Status Asset ID User ID Element name assetType status assetId userId Comments mapField="ASSET_TYPE_CD" mapField="BO_STATUS_CD" mapField="ASSET_ID" mapField="USER_ID" default=CurrentUser Include System Disposition includeSystemDispo sition dataType="boolean" default="true" mapField="INC_SYSTEM_ROLES _SW
23
32012 Asset Receipt Inspection Portal External Design Management Next Dispositions Status nextDisposition Status
Smart Device
type="list" mapList="RESULTS" Flattened element for the first column of the resultset. mapField="BO_STATUS_CD" Flattened element for the first column of the resultset. mapField="DEFAULT" Boolean
Default
default
statusReasonFlg
Flattened element for the second column of the result set. mapField="BO_STATUS_REASO N_CD"
Asset Disposition
assetDpos
Flattened element for the first column of the resultset. mapField="ASSET_DPOS_FLG" Flattened element for the first column of the resultset. mapField="DESCR" Flattened element for the first column of the resultset. mapField="ASSET_REL_FLG"
assetDposDesc
assetRelationship
Xml Schema
<schema> <assetType mapField="ASSET_TYPE_CD"/> <status mapField=" BO_STATUS_CD"/> <assetId mapField="ASSET_ID"/> <userId mapField="USER_ID"/> <includeSystemDisposition mapField="INC_SYSTEM_ROLE_SW"/> <nextDispositions type="list" mapList="RESULTS"> <status mapField="BO_STATUS_CD"/> <statusReason mapField="BO_STATUS_REASON_CD"/> <default mapField="DEFAULT_SW"/> <assetDisposition mapField="ASSET_DPOS_FLG"/> <assetDispositionDescription mapField="DESCR"/> <assetRelationship mapField="ASSET_REL_FLG"/> </nextDispositions> </schema>
24
Properties
No changes
Schema
Add BO Status Code in the Output List
Xml Schema
<schema> <input type="group"> <assetType mapField="ASSET_TYPE_CD"/> <specification mapField="SPECIFICATION_CD"/> <assetCondition mapField="ASSET_COND_FLG"/> <address mapField="ADDRESS1"/> <city mapField="CITY"/> <postal mapField="POSTAL"/> <activityId mapField="W1_ACTIVITY_ID"/> <assetCharacteristics mapField="ASSET_CHARACTERISTICS"/> <assetIdentifiers mapField="ASSET_IDENTIFIERS"/> <componentType mapField="COMPONENT_TYPE_CD"/> <componentDisposition mapField="COMPONENT_DPOS_FLG"/> </input> <output type="group"> <results type="list" mapList="RESULTS"> <assetId mapField="ASSET_ID"/> <assetType mapField="ASSET_TYPE_CD"/> <assetDisposition mapField="ASSET_DPOS_FLG"/> <attachedToAssetId mapField="ATTCH_TO_ASSET_ID"/> <nodeId mapField="NODE_ID"/> <address mapField="ADDRESS1"/> <city mapField="CITY"/> <status mapField="BO_STATUS_CD/> </results> </output> </schema>
25
Smart Device
Navigation Options
Mass Asset Disposition Update (w1astmduTabMenu) (New)
This navigation option is associated with the Asset Disposition Mass Update portal. This is automatically generated when the portal is created.
Properties
Property Code Description Navigation Option Type Navigation Mode Target Transaction Tab Page Search Transaction Search Type Search Group Script Go To Tooltip w1astmduTabMenu Mass Asset Disposition Update Transaction Change Mode w1astmduTabMenu <tab page> <search navigation key> <search type> <search group> <script> <metadata MD field> Value
Context
Field None Key Field
Usage
Navigation Usage Favorites Menu
26
Application Service
Mass Asset Disposition Update (W1ASTMDU) (New)
This is the application service associated with the Mass Asset Disposition Mass Update portal and is automatically generated when the portal is created.
Properties
Property Code Description W1ASTMDU Mass Asset Disposition Update Portal Value
Access Modes
Access Modes Inquire (R)
Service Program
Retrieve Asset Next Dispositions (W1-ASTNXTDPOS) (New)
This service invokes the Retrieve Asset Next Disposition Page Maintenance Service.
Properties
Property Service Program Name Description Type W1-ASTNXTDPOS Retrieve Asset Next Dispositions Java Value
27
Smart Device
Properties
No changes
Services
Retrieve Asset Next Dispositions Service (New)
This service program creates a list of possible Next Asset Dispositions.
Properties
Property Program Name Program Description Type Secured Service Program Actions Modules Header Value RetrieveAssetNextDispositionsService Creates a list of possible Next Asset Dispositions PageMaintenance <True/False> W1-ASTNXTDPOS Read N/A name=ASSET_TYPE_CD name=BO_STATUS_CD name=ASSET_ID name=USER_ID name= INC_SYSTEM_ROLES_SW Body Lists name=RESULTS name=RESULTS contents: BO_STATUS_CD DEFAULT BO_STATUS_REASON_CD ASSET_DPOS_FLG DESCR ASSET_REL_ FLG
28
Output
Asset Dispositions (List) Status Default, boolean Status Reason Flag Asset Disposition Asset Disposition Description Asset Relationship
Processing
If Asset ID is populated If Asset Type and Status are both populated, then Terminate with error: Both Status and Asset Type must be blank when Asset ID is provided. Get the next states for the Asset provided Determine the BO of the provided Asset by calling F1-DetermineBO business service (passing the Asset MO and the input Asset ID) Get the Status by invoking the Asset BO for read
Invoke the F1-RetrieveAllNextStates business service to get the next states (passing the Assets BO, the retrieved Status, the input User ID and set the includeSystemStates switch based on the input Include System Disposition switch Else If either Asset Type or Status is not populated, then Terminate with error: Both Status and Asset Type must be provided when Asset ID is blank. Get the next states based on the Asset Type and Status provided
29
Smart Device
Determine the BO of the provided Asset Type by calling F1-DetermineBO business service (passing the Asset Type MO and the input Asset Type) Get the Asset BO detail by invoking the Asset Type BO for read
Invoke the F1-RetrieveAllNextStates business service to get the next states (passing the retrieved Asset BO, the input Status, the input User ID and set the includeSystemStates switch based on the input Include System Disposition switch Loop through the outputs from business service F1-RetrieveAllNextStates: If Access is True Populate the Status and Default switch in the output.
Retrieve the Status Reason Flag of the status. Note that this flag is defined in the lifecycle BO. Set the output if the Status Reason Flag is populated. See design note below. Call business service Retrieve BO Status Asset Disposition
Populate the Asset Disposition and Asset Disposition in the output. Retrieve the Asset Relationship for the Asset Disposition and populate the output.
Design Note. There may be a framework service for this already, for example F1GetBoStatusReason.
Properties
Annotation needs to be changed to include BO Status Code
30
Output
Include BO Status Code
Processing
Include BO Status Code of the Asset in the columns to be retrieved.
Contents
Name Mass Asset Disposition Update Description This launches the Mass Asset Disposition Update portal Product Module
Layout
31
Smart Device
Properties
Property Code Description Type Show On Portal Preferences W1ASTMDU Mass Asset Disposition Update Stand Alone No Value
Portal Zones
Zone W1ASTMDUQRY Display True False Initially Collapsed Default Sequence 10
Parameters
Parameter Query Zone 1 Value W1-ASTMDUQ1 (Asset Information)
Dialogue Trigger
32
Query Options
Selecting an item from the drop down list invokes the associated Query Zone. Default Query Zone is Asset Information (W1-ASTMDUQ1)
Layout
Contents
Effective Date/Time Asset Disposition Values are the Current Asset Disposition passed to this map + Values returned from the Retrieve Asset Next Dispositions business service. See design note below. Onchange: Reset Node, Attached to Asset, Reason and Status (not shown but in the schema) fields If Current Asset Disposition is equal to the selected Asset Disposition, then set the Status to blank. Node
33
Smart Device
Custom search. Hidden until Asset Disposition has been selected and its asset relationship is not W1AT - Attached, passing Asset Type and Asset Disposition to the hidden filters. Attached To Asset Custom search. Hidden until Asset Disposition has been selected and its asset relationship is W1AT Attached, passing Asset Type and Asset Disposition (the target/selected disposition) to the hidden filters. Reason Values are from business service F1-BOStateSelectReasonList Hidden until Asset Disposition has been selected and different from the Current Asset Disposition and the selected Asset Disposition/Statuss Status Reason Flag is either F1OT Optional or F1RD Required. OK Button Protected until all the following fields are populated: Effective Date/Time, Asset Disposition, Node or Attached to Asset (either), Reason (if required) Cancel Button
Note. If possible, the initial value in the dropdown should be the one whose default switch is true. Perhaps this should be arranged in the service program that prepares these values.
Schema
Xml Schema
<schema> <assetType/> <currentStatus/> <currentAssetDisposition/> <currentAssetRelationship/> <status/> <statusReason/> <assetDispositionDetail type="group"> <effectiveDateTime mdField="EFF_DTTM"/> <assetDisposition mdField="ASSET_DPOS_FLG" dataType=lookupBO lookupBO=W1-AssetDisposition/> <nodeId mdField="NODE_ID" fkRef=W1-NODE/> <attachedToAssetId mdField="ATTCH_TO_ASSET_ID" fkRef=W1-ASSET/> </assetDispositionDetail> <nextAssetDispositions type="group"> <includeBS name="W1-RetAssetNextDispositions"/> </nextAssetDispositions> <statusReasons type="group"> <includeBS name="F1-BOStateSelectReasonList"/> </statusReasons> </schema>
34
Properties
Property Code Description Zone Type Application Service Width W1-ASTMDUQ1 Asset Information F1-DE-QUERY W1ASTMDU Full Value
Parameters
Parameter Display Description Area Pre Process Service Script False ss="W1-AsInfQ1ss" input=[assetType=F1 specification=F2 assetCondition=F3 address=F4 city=F5 postal=F6 activityId=F7 assetCharacteristics=F8 assetIdentifiers=F9] Note: The filtering of the Asset Disposition is done after the Pre-Processing Script. See SQL below. Filter UI Map User Filter 1 User Filter 2 User Filter 3 User Filter 4 User Filter 5 User Filter 6 User Filter 7 User Filter 8 User Filter 9 User Filter 10 Validate Filter Values Service Script W1-AssetMassDposQ1QryFltr type=String xpath=assetType type=String xpath=specification type=String xpath=assetCondition type=String xpath=address likeable=S type=String xpath=city likeable=S type=String xpath=postal likeable=S type=String xpath=activityId type=STRING xpath=assetCharacteristics type=STRING xpath=assetIdentifiers type=STRING xpath=assetDisposition ss= W1-AsMdQ1Val input=[assetType=F1 specification=F2 assetCondition=F3 address=F4 city=F5 postal=F6 activityId=F7 assetCharacteristics=F8 assetIdentifiers=F9 assetDisposition=F10] Value
35
32012 Asset Receipt Inspection Portal External Design Management SQL 1 Condition SQL 1 Display Columns SQL Statement 1 Column 1 for SQL 1 F1 F10 C1 Pseudo SQL1 source=FKREF fkref='W1-ASSET' input=[ASSET_ID=ASSET_ID] label=ASSET_ID Column 2 for SQL 1 source=SQLCOL sqlcol=STATUS label=STATUS suppress=TRUE Column 3 for SQL 1 source=SQLCOL sqlcol=ASSET_TYPE_CD suppress=TRUE Column 4 for SQL 1 source=SQLCOL sqlcol=ASSET_DPOS_FLG suppress=TRUE Column 5 for SQL 1 source=SQLCOL sqlcol=ASSET_ID suppress=TRUE Multi Select Multi Selection Action 1 available=YES
Smart Device
Script= W1-AstMasUpd (Asset Disposition Mass Update BPA Script) Type=BUTTON Label=W1_CHANGE_DPOS_LBL (Change Disposition) Refresh=ZONE List=assetList Context=[assetID=C5 assetType=C3 status=C2 disposition=C4]
Pseudo SQL 1
SELECT f1_gtt_col1_vchar as ASSET_ID, f1_gtt_col2_vchar as ASSET_TYPE_CD, f1_gtt_col3_vchar as ASSET_DPOS_FLG, f1_gtt_col8_vchar as BO_STATUS_CD FROM F1_GENERIC_GTT WHERE f1_gtt_col3_vchar=:F10
List Contents
Asset Information Information String of Asset
36
Dialogue Trigger
The multi select action 1 is a button associated with BPA script Asset Disposition Mass Update BPA script, passing in a list of Asset ID, Asset Type, Status and Disposition. The button label, using MD Field, should be Change Disposition. The refresh option should be set to ZONE, i.e. the zone needs to refresh on completion of the script.
Properties
Property Code Description UI Map Type Value W1-AssetMassDposQ1QryFltr Asset Information Query Filter HTML Fragment
Layout
Contents
Please refer to the Asset Information Search (W1-ASSETQ1) for the details of this Filter UI Map. They should be the same except for the following: o o Asset Type is required. Add Disposition (New) as another required filter. The dropdown should be very similar to the Disposition dropdown in the W1-AssetQ3QryFltr UI Map. o On change of the Asset Type, populate the dropdown values using the W1-AstTypDpn Service Script (Retrieve Asset Disposition for Asset Type)
No hidden filters
37
Smart Device
Note. Refer to 32004 Asset Portal ED for the Asset Information Search (W1-ASSETQ1) and the W1-AssetQ3QryFltr UI Map
Schema
Xml Schema
<schema> <assetType mapField="ASSET_TYPE_CD" fkRef="W1-ASTTY"/> <specification mapField="SPECIFICATION_CD" fkRef="W1-SPEC"/> <assetCondition mapField="ASSET_COND_FLG"/> <address mapField="ADDRESS1"/> <city mapField="CITY"/> <postal mapField="POSTAL"/> <activityId mapField="W1_ACTIVITY_ID"/> <assetDisposition mdField="ASSET_DPOS_FLG" dataType="lookupBO" lookupBO="W1-AssetDisposition"/> <includeMP name="W1-CharacteristicQryFltr"/> <includeMP name="W1-IdentifierQryFltr"/> <validAssetDisposition type="group"> <includeSS name="W1-AstTypDpn"/> </validAssetDisposition> </schema>
BPA Scripts
Asset Disposition Mass Update BPA Script (W1-AstMasUpd) (New)
This BPA updates the asset disposition and node of a list of assets.
Properties
Property Code Description Accessibility Option Script Engine Version W1-AstMasUpd Asset Disposition Mass Update Value
Data Area
Schema Type Object DA Name
38
W1-AssetMassDposUpdate
W1-AssetMassDposUpdate
Schema
Field Asset ID Asset Type Status Asset Disposition Element name assetId assetType status disposition Comments
Xml Schema
<schema> <assetList type="list"/> <assetId/> <assetType/> <status/> <disposition/> </assetList> </schema>
Script Steps
Loop through Asset List If the Asset Type (n) is not equal to Asset Type (n+1) or Status (n) is not equal to Status (n+1), then Terminate with error message: Unable to update Assets with different Asset Types or Statuses Get the Asset Relationship flag for the Disposition Get the Asset Relationship by invoking the Asset Disposition BO (W1AssetDisposition) for read (passing the retrieved details above) Invoke Asset Disposition Map Update UI Map. Pass the following current values, which has been ensured to be the same for all elements in the list: Asset Type Status (as Current Status) Disposition (as Current Disposition) Asset Relationship (as Current Asset Relationship)
Determine the BO of the Asset by calling F1-DetermineBO business service (passing the Asset MO and the Asset ID (1) from the schema). All Assets in the list will have the same Asset BO Based on the values returned by the UI Map, loop through Asset List and update each Asset:
39
Smart Device
Invoke the Asset BO for Read and validate the Effective Date/Time: If the new Effective Date/Time (from the map) is not later than the Effective Date/Time of the current Asset in the list, then Terminate with error: The new Effective Date/Time (%1) must be later than the current Effective Date/Time of this Asset (%2)
Invoke the Asset BO for Update and do group move from Asset Disposition Detail (of the UI Map) to the Asset BO If there are errors during the update, the whole update will be rolled back. All or nothing applies during the update.
Service Scripts
Validate Asset Information Mass Asset Disposition Filter ( W1-AsMdQ1Val) (New)
This validates the filter for the Asset Information query zone of the Mass Asset Disposition Update Portal.
Properties
Property Code Description Application Service Script Engine Version W1-AsMdQ1Val Validate Asset Information Mass Asset Disposition Filter F1-DFLTAPS <script engine version> Value
Schema
Field Asset Type specification assetCondition address city postal Element name assetType Specification AssetCondition address city postal Comments
40
Script Steps
If Asset Type is not populated, then: Terminate with error: Asset Type is a required criteria for this search
If Asset Disposition is not populated, then: Terminate with error: Asset Disposition is a required criteria for this search
Note. Since this validation script is used in a Search Zone very similar to the Asset Modules Asset Information Search, make sure all the validations in that search are included here as well.
Properties
No changes
Data Area
No changes
Schema
No changes
41
Smart Device
Script Steps
On the step that saves the list returned by the W1-RetAstUseAssetInfo Business Service, make sure that the BO Status Code is inserted as colVarchar8.
42