Hierarchy Explorer widget

The following enhancements have been added for the Hierarchy Explorer widget in this release.

Feature message

Hierarchy Explorer is a Network widget that you can use to see all levels of an HCO's structure, making it easy to visualize their hierarchy and find new targets.

The widget is not available by default.

If Hierarchy Explorer is not enabled in your Network instance, a message displays when you try to add the widget:

Hierarchy Explorer Widget is not available. Please contact Network support to enable this widget.

Hierarchy Explorer tabs

Widget users can create tabs on the homepage to organize segments of data. Previously, Administrators had to create multiple widgets for each of the data segments their users wanted to access (for example, hospitals, IDNs, Pharmacies).

This enhancement is enabled by default. Tabs can be created by any user.

Key highlights

  • Tabs can be created to filter on segments of data.

  • Tabs can be specific to countries or available to all countries.

  • Administrators and Data Managers can create private tabs and public tabs for all users.

  • All users can create private tabs.

Supported users

All Network user can create tabs in the widget.

User Type Create Private Tab Create Public Tab
Portal User  
Standard User  
Data Steward  
Data Manager
System Administrator
System and Data Admin

Create a hierarchy tab

To create a tab:

  1. On the Hierarchy Widget homepage, click the Add (+) icon.

  2. On the New Tab dialog, define a meaningful Name. The name will display to all users that can access the tab.

    Names can contain a maximum of 25 characters.

  3. Icon - Expand the list and choose an appropriate icon.

  4. Available to me - Define who can access the tab.

    • Just Me - The tab is private. No other users can access the tab.

    • All Users - The tab is public. All users with access to the widget can view.

      Displays only for Administrators and Data Managers.

  5. Countries - Define the countries for the tab. Users can access the tab if they have a data visibility profile for that country.

    • All Countries

    • Specific Countries - Choose from the list of countries defined for the widget.

  6. Filters - Define the field and value to use to segment the accounts.

    Filters are limited to the fields in the in the Hierarchy Index file. HCO fields and Address fields are supported.

  7. Save your changes.

    The tab displays on the widget homepage. A count of records displays beside the tab name.

Manage tabs

Hover over the tab name and click the More (...) icon to open the tab options.

Available actions

The actions that display depend on the type of tab (public or private) and your user type.

Action Description Key Details
Edit tab Edit any of the details on the tab.
  • Private tabs can be promoted to public tabs only by the creator.
  • Public tabs can be demoted to private only by the creator.
  • Standard users cannot edit public tabs.
Duplicate tab Make a clone of the tab to include all of the copied settings.  
Reorder tab Move the tab to a different position.
- Move Right
- Move Left
- Move First
- Move Last

Tip: You can drag and drop a tab to any position.

  • The Recently Opened tab cannot be moved.
  • New tabs created by Administrators display immediately after the Recently Opened tab.
  • Reordering tabs does not impact other users. The order is specific to each user.
Delete tab Remove the tab from the widget.  

A message at the bottom of the menu identifies if the tab is private (Available to just you) or public (Available to Everyone).

Hierarchy Explorer search

Searching for an HCO on the homepage respects the tab that you are on when you search.

Logs

Administrators can track changes to the Hierarchy Explorer widget tabs in the System Audit History.

Tracked changes:

  • Add private and public tabs.

  • Update private and public tabs

Editing hierarchies

Business users can now add, remove, and edit affiliations directly within the Hierarchy Explorer widget.

This enhancement is available by default. Administrators can enable editing for the widget and for specific hierarchies.

Benefits

  • Easily add accounts to the hierarchy - Add accounts to any level of the hierarchy. Previously, you had to jump to different accounts to find the correct affiliation.

  • Simplify custom hierarchy management - Business users can edit custom hierarchies directly within the widget, streamlining the management process.

Key highlights

  • Editing can be enabled for specific hierarchies.

  • Add accounts or remove accounts in any level of the hierarchy.

  • Edit relationships and accounts.

  • Make the changes directly within the hierarchy view to understand the impact.

  • Preview the changes as drafts before committing them.

  • Submit DCRs against the hierarchy directly from the widget.

Enable editing

Administrators can enable editing in the Hierarchy Explorer widget configuration.

  1. In the Admin console, click Widgets & Portal > Network Widgets.

  2. Select a Hierarchy Explorer configuration.

  3. In the Editing Options section, select Enable Editing.

Enable editing for hierarchies

When editing is enabled for Hierarchy Explorer, it is available by default for the following hierarchies:

  • All Hierarchies

  • Ownership Hierarchy

Enable editing for custom hierarchies

To enable editing in the widget for custom hierarchies:

  1. In the Admin console, click Data Model > Hierarchy Management.

  2. On the Hierarchy Management page, select a hierarchy.

  3. In the Editing Options section, select Enable Editing for this hierarchy.

  4. Add to Hierarchy / Remove from Hierarchy - Define the default field values that will be included in the DCR when users add or remove affiliations in the widget.

    For example, set the Oncology Hierarchy field to Yes/True and the Relationship Type field value to Affiliation when users add HCO-HCO relationships.

    5. Supported fields

    • Reference fields that are included in the in the Hierarchy Index file.

    System fields and the Hierarchy Type field does not display.

    Note: When a new affiliation is added, the Parent HCO Status field is set to Active by default.

    Define the fields for HCO-HCO and HCP-HCO relationships.

  5. Save your changes.

Example

Set the default value for the Oncology Hierarchy field to Yes/True when users add an HCO-HCO affiliation in the Hierarchy Explorer widget.

Add affiliations

If editing is enabled for the hierarchy, affiliations can be added at any level of the hierarchy.

  1. Affiliations can be added using the following methods:

    • On the Child HCOs or Child HCPs tab, click Add Affiliation.

      This creates a Level 1 affiliation.

    • On the Child HCOs tab, click the More icon beside an HCO name and select Add Child HCO.

  2. A row is created in the hierarchy. Begin typing the affiliation name in the Search field.

    Results begin displaying accounts from your Network instance that match the keywords.

  3. Select an HCO/HCP to add as an affiliation.

  4. The HCO/HCP is added as a row on the tab. The Draft icon displays beside the account name.

    Available actions:

    • Submit - Click to send a DCR so the affiliation can be added to the account.

    • Delete - Click the Trash icon to remove the draft affiliation.

  5. If you click Submit, the New Affiliation dialog displays.

    Add the following details:

    • Fields - Add or change the field values that will be included on the DCR.

    • Notes - Add details to help the affiliation changes to be quickly approved.

    Available actions:

    • Submit - Click to send a DCR so the affiliation can be added to the account.

    • Save as Draft - Click to keep the affiliation as a draft change.

      Drafts are temporary. It is removed when you leave or refresh the page.

    • Delete - Click the Trash icon to remove the draft affiliation.

  6. If you submitted the change, a DCR is created.

    The HCO/HCP remains highlighted in green and displays a Pending Review icon. Click the icon to display details and the task ID.

Remove relationships from the hierarchy

Business users can remove HCO-HCO and HCP-HCO relationships.

To remove a relationship:

  1. HCO-HCO relationship - On the Child HCOs tab, click the More icon beside an HCO name and select Remove Affiliation.

    or

    HCP-HCO relationship - On the Child HCPs tab, click the More icon beside an HCP name and select Remove Affiliation.

  2. The Remove Affiliations dialog confirms that the affiliation is being removed from the focused HCO.

    The relationship status field will be changed from Active to Inactive according to the rules defined in the hierarchy configuration.

    Available actions:

    • Discard - Click to return to the hierarchy without removing the affiliation.

    • Submit - Click to continue to remove the affiliation.

  3. If you submitted the change, a DCR is created and sent to Network.

    The HCO/HCP remains highlighted in red and displays a red Pending Review icon. Click the icon to display details and the task ID.

    The relationship will be removed if the DCR is approved.

Edit relationships

Business users can edit HCO-HCO and HCP-HCO relationships.

  1. HCO-HCO relationship - On the Child HCOs tab, click the More icon beside an HCO name and select Edit Affiliation.

    or

    HCP-HCO relationship - On the Child HCPs tab, click the More icon beside an HCP name and select Edit Affiliation.

  2. On the Edit Affiliation dialog, define the following details:

    • Fields - Add or change the field values that will be included on the DCR.

    • Notes - Add details to help the affiliation changes to be quickly approved.

    Available actions:

    • Discard - Click to return to the hierarchy without removing the affiliation.

    • Submit - Click to continue to remove the affiliation.

  3. If you submitted the change, a DCR is created and sent to Network. The HCO remains highlighted in yellow and displays a yellow Pending Review icon. Click the icon to display details and the task ID.

    If the DCR is approved, the affiliation will be updated.

Editing account profiles

Business users can now edit accounts within Hierarchy Explorer. Changes are submitted as DCRs.

Enable editing

Administrators can enable editing in the Hierarchy Explorer widget configuration.

  1. In the Admin console, click Widgets & Portal > Network Widgets.

  2. Select a Hierarchy Explorer configuration.

  3. In the Editing Options section, select Enable Editing.

Edit an account

  1. On the Child HCOs or Child HCPs tab, click the More icon beside an HCO/HCP name and select Edit Profile.

    The profile opens in edit mode.

  2. Make any required changes to the account information, addresses, or licenses.

    Note: Affiliations cannot be edited or removed on the account profile. The Parent Affiliations section is hidden in edit mode.

  3. Save your changes.

  4. The Confirm Changes dialog displays the fields that were changed. Click Submit.

    A DCR will be routed to the record owner process the change.

Include relationship fields

Administrators can include relationship fields for accounts to provide more details about their affiliations. Previously, only fields for HCOs and HCPs were supported on the respective account. Now you can add parent HCO fields, for example, you can add Relationship Type and Record Owner Type fields.

Supported fields

Reference fields can be added as fields.

Add fields

  1. In the Admin console, click Widgets & Portal > Network Widgets.

  2. Select a Hierarchy Explorer configuration.

  3. In the Additional Fields Displayed section a heading is added for Additional ParentHCO Fields.

    Fields can be added for HCO-HCO and HCP-HCO relationships.

  4. Click Add HCO-HCO Field.

  5. Select a field.

    A maximum of three fields can be added for each relationship.

  6. Save your changes.