Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

As an administrator, you can completely customize the navbar to present users with navigation that is appropriate for your environment. Setting up custom navigation in EmpowerID is an easy process that you can perform without needing to write any custom code or create overrides files. You simply enable the navbar sections you want to customize, edit the localized text entry for

...

that navbar section you are adding to the navbar, and add the appropriate UIActions to the UINoun and UIVerb you want to associate with those customized sections.

...

Enable custom navbar sections

  1. On the navbar, expand Infrastructure Admin > EmpowerID Servers and Settings and click EmpowerID System Settings.

    This takes you to the EmpowerID System Settings page, where you can configure certain aspects of the application.

...

  1. Image Added

  2. Search for navbar.

    You should see settings for NavBarSection*Enabled, NavBarSection*Noun, NavBarSection*Verb, where * represents a whole number such as 10.

...

  1. Image Added

  2. Filter the search to NavBarSection10 to reduce the number of objects returned to just those settings for that custom section.

  3. Click the Edit button for NavBarSection10Enabled.

...

  1. Image Added

  2. Change the Value from false to true and then click SAVE.

...

  1. Image Added

  2. Recycle the EmpowerID IIS app pools and then refresh the browser.

    You should the new navbar section

...

  1. on the navbar. If you don’t see the new section, try clearing the browser cache.

    Image Added

  2. Next, let’s edit the localized text entry so that the section displays something other than NavBarSection10Title.

Edit the localized text entry for NavBarSection10

  1. On the navbar, expand Admin > Miscellaneous and click Localized Text.

    This takes you to the LocaleKeyEntry page, where you can create new localized strings and well as edit exiting ones.

...

  1. Image Added

  2. From the Localized Strings tab of the page, search for NavBarSection10Title and then click the Local Key (Unique Name) link.

...

  1. Image Added

  2. On the Locale Key Details page that appears, click the Edit icon to put the Locale Key in edit mode.

...

  1. Image Added

  2. Change the Default Value from NavBarSection10Title to something more meaningful. In our example, we are changing the value to I want to.

...

  1. Image Added

  2. Save your changes and recycle the EmpowerID IIS app pools.

  3. Refresh your browser.

    You should the title text for new navbar section update to reflect your change.

    Image Added

Next, let's update the values for the NavBarSection10Verb and NavBarSection10Noun settings to the appropriate UINouns and UIVerbs in the system that represent what do users can do in the new section. For example, if you want users to be able to reset their passwords, you could change the Noun to Password and the verb to ChangePassword.

Easy html macro
theme{"label":"solarized_dark","value":"solarized_dark"}
contentByMode{"html":"<!doctype html>\r\n<link href=\"https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css\" rel=\"stylesheet\" integrity=\"sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC\" crossorigin=\"anonymous\">\r\n<link href=\"https://docs.empowerid.com/new_docs.css\" rel=\"stylesheet\">\r\n<script src=\"https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js\" integrity=\"sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM\" crossorigin=\"anonymous\"></script>\r\n<div class = \"bd-callout bd-callout-success\">\r\n <p>You can view the default UINouns and UIVerbs by expanding <b>Admin > Miscellaneous</b> and clicking <B>Noun Verb Action Navigation</B> on the navbar.

...

\r\n If desired, you can create new UINouns and UIVerbs and then associate them with the \r\n NavBarSection10Verb and NavBarSection10Noun settings. For the purpose of this topic, \r\n we will use existing UINouns and UIVerbs.</p>\r\n <p><img src=\"https://docs.empowerID.com/assets/img/confluence/UINounDetails.png\" style=\"padding: 10px;max-height: 500px\"/></p>\r\n \r\n </div>\r\n ","javascript":"","css":""}

Update NavBarSection10 Noun and Verb

  1. On the navbar, expand Infrastructure Admin > EmpowerID Servers and Settings and click EmpowerID System Settings.

  2. Search for NavBarSection10.

  3. Click the Edit button for NavBarSection10Noun.

    Image Added

  4. Replace the Value with the desired UINoun, which in this example is Password.

    Image Added

  5. Click Save.

  6. Click the Edit button for NavBarSection10Verb.

    Image Added

  7. Replace the Value with the desired UIVerb, which in this example is ChangePassword.

  8. Click Save.


Next, lets create a

...

custom UIAction named ChangeMyPassword and configure the UIAction with the as needed.

Easy html macro
theme{"label":"solarized_dark","value":"solarized_dark"}
contentByMode{"html":"<!doctype html>\r\n<link href=\"https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css\" rel=\"stylesheet\" integrity=\"sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC\" crossorigin=\"anonymous\">\r\n<link href=\"https://docs.empowerid.com/new_docs.css\" rel=\"stylesheet\">\r\n<script src=\"https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js\" integrity=\"sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM\" crossorigin=\"anonymous\"></script>\r\n<div class = \"bd-callout bd-callout-success\">\r\n <p>You can view the default UINouns and UIVerbs by expanding <b>Admin > Miscellaneous</b> and clicking <B>Noun Verb Action Navigation</B> on the navbar. \r\n If desired, you can create new UINouns and UIVerbs and then associate them with the \r\n NavBarSection10Verb and NavBarSection10Noun settings. For the purpose of this topic, \r\n we will use existing UINouns and UIVerbs.</p>\r\n <p><img src=\"https://docs.empowerID.com/assets/img/confluence/UINounDetails.png\" style=\"padding: 10px;max-height: 500px\"/></p>\r\n \r\n </div>\r\n ","javascript":"","css":""}

Create a custom UIAction

  1. On the navbar, expand Admin > Miscellaneous and click Noun Verb Action Navigation.

    This takes you to the NounVerbsAction page, which where you create new UINouns, UIVerbs and UIActions, as well as view and edit existing ones.

...

  1. Image Added

  2. Go to the UIAction tab, and then click the Create New UIAction (blue star) button.

...

  1. Image Added

  2. Fill in the Actions Details form with the following information:

    • Action Name (no spaces)

...

    • ChangeMyPassword

    • Display Name

...

    • Change My Password

    • Description

...

    • Change

...

    • My Password

    • Locale Key (Unique Name)

...

    • – Optional

    • Locale Key for Description

...

    • – Optional

    • Verb

...

    • – Change Password

    • Noun

...

    • – Password

    • Toggle Is a Contextual Action Only so that it is not selected.

    • Select Workflow and then select Change Password

...

    • Image Added

  1. Click Save

...

After enabling the navbar section and adding UIActions to it, you need to configure access to the section and any workflows or pages grouped under the section before users will be able those navbar items. By controlling access in this way, you can completely customize which navbar items appear to which users as shown below.

...

  1. .

  2. Recycle the EmpowerID IIS app pools and then refresh your browser.

    You should see the new UIAction underneath the custom navbar section.

...

  1. Image Added


    Insert excerpt
    IL:External Stylesheet
    IL:External Stylesheet
    nopaneltrue

Div
stylefloat:left; position:fixed;
idarticleNav

IN THIS ARTICLE

Table of Contents
maxLevel4
minLevel2
stylenone
printablefalse