Skip to main content

Item Window Render Process in Aras Innovator

Item window is a typical way to display item data, this article is to investigate the render process of it. And then, check the trigger timing of "onFormPopulated" and "onLoad".


When user open an item, Window Render Process (see Figure 1) will be executed. There is an action "render" which mainly handles form details (see Figure 2), here calls Form Render Process.
When HTML elements are loaded, system will trigger form event "onFormPopulated" if it exists.
After Form Render Process finished, system will trigger form event "onLoad" if it exists, and then Window Render Process is finished.
But if user save/lock/unlock an item, system will only execute Form Render Process.
With above points, the trigger timing and main difference between "onFormPopulated" and "onLoad" are clear:
  • onFormPopulated: execute every time while item window update form data.
  • onLoad: execute only one time while item window opened.

Figure 1. Window Render Process

Figure 2. Form Render Process

Comments

Post a Comment

Popular posts from this blog

aras.uiShowItemEx Method (aras Object)

aras.uiShowItemEx Method Shows Item with Item node. Syntax aras.uiShowItem( itemNd , viewMode , isOpenInTearOff ) Parameters Name Type Description itemNd Object Required. Item node. viewMode String Optional. Unknown purpose but only supports the following values: tab view (Default) openFile new ※Each supported value will get same result. Therefore, call method and pass undefined for this parameter is OK. isOpenInTearOff Boolean Optional. Specifies whether show Item with tear-off window. true - open in a tear-off window. false - open in a tab. (Default) Return Value An AsyncResult object or a Boolean. Returns AsyncResult object if the Item winodw is opened successfully, otherwise returns false. See Also aras Object Aras Innovator Client Framework

aras.uiShowItem Method (aras Object)

aras.uiShowItem Method Gets Item by Item ID and then shows the Item. Syntax aras.uiShowItem( itemTypeName , itemID , viewMode ) Parameters Name Type Description itemTypeName String Required. Name of the ItemType. itemID String Required. ID of the Item. viewMode String Optional. Unknown purpose but only supports the following values: tab view - This is default. openFile new ※Each supported value will get same result. Therefore, call method without this parameter is OK. Return Value An AsyncResult object or a Boolean. Returns AsyncResult object if the Item winodw is opened successfully, otherwise returns false. See Also aras Object Aras Innovator Client Framework

window.handleItemChange Method (Instance Window Object)

window.handleItemChange Method Changes current Item's property value. If Item is not locked, the function will do nothing. Syntax window.handleItemChange( propNm , propVal , dataType , datePattern ) Parameters Name Type Description propNm String Required. Property name. propVal String Required. Property value. dataType String Optional. Property data type. If the data type is "date", this parameter is required, otherwise it is not necessary to pass. datePattern String Optional. Date pattern, supports the following values: short_date (Default) short_date_time long_date long_date_time See Also Instance Window Object Aras Innovator Client Framework