Skip to main content

Change site name and banner for Aras Innovator

Relevant settings are defined in "InnovatorServerConfig.xml". If you didn't change the default installation path, the file should be located in "C:\Program Files (x86)\Aras\Innovator".
Open the file, we could find a tag named "UI-Tailoring" and contains 3 attributes which are used to define site name and banner image, including "login_splash", "branding_img", and "product_name". As for "banner_url" and "banner_height", are used for customizing banner.

<?xml version="1.0" encoding="UTF-8"?>
<Innovator>
    <UI-Tailoring 
        login_splash="../images/aras-innovator.svg" 
        branding_img="../images/aras-innovator.svg" 
        product_name="Aras Innovator" 
        banner_url="../scripts/banner.aspx" 
        banner_height="50"/>
    ...
</Innovator>

Login Form

Main Window

Banner Customization

There is an important thing we need to know is that banner customization has a little difference between Aras Innovator 11 SP5 and SP9 because webpage structure has changed. In SP5, we could just create a webpage, and then set attributes "banner_url" and "banner_height" which are mentioned above, but these two attributes seem not work in SP9 and we could find their original definition in below picture.

Implement in Aras Innovator 11 SP5

Here I added 2 links to "banner.aspx" (of course you can create a new file and just change referred link in "InnovatorServerConfig.xml"), and the result is shown as below picture. It's very easy to add additional information, isn't it? By the way, if you want to change the height of banner, just set "banner_height" in "InnovatorServerConfig.xml".

...
<body>  
    <div>
        <div><img class="header-logo" src="<%=Client_Config("branding_img")%>" alt="" style="display:block;" /></div>
        <!-- Cutomized content begin -->
        <div style="position:absolute; top:25px; left:270px;">
            External Links:&nbsp;
            <a href="http://google.com" target="_blank">Google</a>&nbsp;|&nbsp;
            <a href="http://yahoo.com" target="_blank">Yahoo</a>
        </div>
        <!-- Cutomized content end -->
    </div>
</body>
...

Implement in Aras Innovator 11 SP9

When you try to change "banner_url" and "banner_height" in SP9, you will find it doesn't work any longer. What's wrong?
Let's see DOM with development tool, banner is embedded in iframe. But in SP9, iframe tag has been hidden with style "display: none". Besides, its parent has been changed to "header" tag which is unlike "div" tag, that's why "banner_height" doesn't work. Now, the height is limited by class "header-logo" whose default value is 45px.


Since banner can't be changed by original way, just open the source to modify. Open "\Innovator\Client\scripts\innovator.aspx" and insert below code, we could get the same result.

...
<header id="header">
    ...
    <img class="header-logo" src="<%=Client_Config("branding_img")%>" alt=""/>
    <!-- Cutomized content begin -->
    <div style="position:absolute; top:25px; left:270px;">
        External Links:&nbsp;
        <a href="http://google.com" target="_blank">Google</a>&nbsp;|&nbsp;
        <a href="http://yahoo.com" target="_blank">Yahoo</a>
    </div>
    <!-- Cutomized content end -->
    ...

標籤：

Comments

  1. AnonymousJuly 24, 2019 at 1:32 PM

    This is really good post. But instead of adding external links, If I want to add some text, for example: If I am part of some group like "Administrators", I want to show it Like "You are logged in as Administrators". Is it feasible, If yes then how to do it.

    Thanks in advance..

    ReplyDelete
    Replies
    1. CyLJuly 24, 2019 at 4:06 PM

      I consider basic HTML/JS knowledge with Aras client API could achieve your demand.

      Delete

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
Post a Comment
Read more

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
Post a Comment
Read more

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
Post a Comment
Read more