Widget Library

Widgets must first be defined on the Widget Library (WIDLIB) before they can be used on a home page. The Widget Library page is separated into two sections: General Information and a table of Widget Parameters at the bottom. (Note: Widgets added to other pages in Advantage cannot be refreshed individually. Instead, you must reload the page to refresh all widgets on the page.)

General InformationGeneral Information

Field Name

Description

ID

This is a unique identification automatically assigned by Advantage when a widget is added to the Widget Library. IDs less than 500000 are reserved for delivered and sample widgets. Numbering is controlled by a Unique Numbering record of ADV_WIDGET_LIBRARY.

Name

Indicates the name of the widget that appears online for user reference.

Type

Type Indicates the type of widget for editing and system processing. Valid values are:

  • Application Page – Requires the selection of a value in the Page Code field to connect to a widget page (for example, ADMWL for the Worklist of ADMN).

  • Audio – Requires a value in the Component URL that connects the widget to the external audio file.

  • Power BI Analytic – Requires the selection of a value in the Report Name field to connect to the analytic.

  • Image – Requires a value in the Component ID to connect to an image.

  • Summary Number – Requires the selection of a value in the Page Code field to connect to the summary number page.

  • Video – Requires a value in the Component URL that connects the widget to the external video file.

  • Visualization – Requires the selection of a value in the Page Code field to connect to the visualization page.

  • Power BI Dashboard – Requires the selection of a value in the Report Name field in the General Information section to connect to the dashboard.

  • Power BI Paginated Report – Requires the selection of a value in the Report Name field to connect to the paginated report.

Description

An optional description of the widget for informational purposes to expand upon what is in the Name field.

Mobile

Indicates whether the widget is to be used on a mobile or non-mobile home page.

  • If selected, the widget can only be used on a mobile home page.

  • If not selected, the widget can only be used on non-mobile home pages.

Height

Each widget requires a defined height in pixels (for example, 600px).

On a Mobile widget, Height is derived based on the Size field. It defaults to 180 px for a default size of 1X1.

Width

Each widget requires a defined width in columns. Valid values are 1 to 8.

On a Mobile widget, Width is derived based on the Size field. It defaults to 1 column for a default size of 1X1.

Size

This field is only enabled when the Mobile check box is selected.

For Mobile Widgets, indicates the size of widgets.

Application Name

An inferred field indicating the application associated with the selection made for Page Code for system processing purposes.

Page Code

The Advantage page to connect an application page, summary number, or visualization page to the Advantage page that is the widget.

Component ID

If the Type is Image, then this field indicates the image file name. The image has to be placed under RTFiles at this folder admbase/standard/images. The value in the Component ID field should be: ‘{{image/imagefilename.png}}’. If the image is new, then you must run the Key Value Metadata Generator process to add the image to the image.pdb file. The system must be bounced after pdb deployment. Then the image can be associated with a home page.  

Component URL

The URL to connect an audio or video widget to what is retrieved for the home page user.

Report Name

The Power BI Paginated Report, Power BI Dashboard, or Power BI Analytics name that will be retrieved from the Advantage Insight Server. Reports can be searched by the Power BI workspace name too.

Workspace Name

This field is visible only when the Type selected is Power BI Analytic, Power BI Dashboard, or Power BI Paginated Report. When a record is selected from the Report Name pick, the Workspace Name field is populated from the selected record in pick.

Widget ParametersWidget Parameters

Widget Parameters holds the additional attributes required for a widget to load. For example, Row level security (RLS) for analytics required an additional parameter to support the analytics to load (RLSRole = Department Security).

When creating a new record on the Widget Library page, the Add Record action in the Widget Parameters section is enabled after successfully saving information in the General Information section.

Field Name

Description

Parameter Name

Indicates the parameter necessary for the widget. You can only select from valid widget parameters established on the Widget Parameters page for the selected Widget Type (for example, RLSRole).

Parameter Value

Indicates the parameter value for the parameter. For example, if Parameter Name is RLSRole, valid values for delivered Insight Models (Datasets) are Department Security, Department Unit Security, No Security, and Employee Security. For PB reports, use PB Security or No Security. The Employee Security role is limited to the HRM reports.  

Description

Description of the parameter that is intended to capture the intended use or content of the parameter.

Report Name

If the Type field is set to Power BI Dashboard, then the Report Name field is available in the Widget Parameter grid. This field provides a pick list that lists all reports that belong to the Power BI Dashboard.

Validating Power BI widgetsValidating Power BI widgets

Power BI Analytic, Power BI Dashboard, and Power BI Paginated reports can be validated using the Validate Power BI Embedding button while creating/updating a widget on the WIDLIB page.

The validation result will appear in the form of a grid in a pop-up window. It will display the outcome of each step of the Power BI report validation process. This helps identify issues with the setup while creating the Power BI widget. If there are no errors on the validation window then a “Report Validation Successful” message is displayed verifying that setup is correct and the Power BI report will load properly.

Note: For multi-dataset Power BI Analytic or Power BI Paginated Report, the RLS role configured would be passed to all datasets. For example, a report uses two datasets (General Accounting and Accounts Receivable Transaction) and the Department Security role is configured as a widget parameter, then the same role would be passed to both and data would be retrieved accordingly.

Delivered WidgetsDelivered Widgets

Widget

Description

 Home Application

Admin Worklist

This worklist displays the Administration transactions assigned directly to a given user or were tasks taken by that user. The individual record actions available are the same as with the primary Administration worklist.

 Admin

Financial Worklist

This worklist displays the Financial transactions assigned directly to a given user or were tasks taken by that user. The individual record actions available are the same as with the primary Financial worklist.

 FIN

HRM Worklist

This worklist displays the Human Resource Management transactions assigned directly to a given user or were tasks taken by that user. The individual record actions available are the same as with the primary Human Resource Management worklist.

 HRM

PB Worklist

This worklist displays the Performance Budgeting requests assigned directly to a given user or were tasks taken by that user. The individual record actions available are the same as with the primary Performance Budgeting worklist.

PB

All Worklist Dash for Admin 

This widget displays list of work items (Admin application) from logged in users ALL (Personal and Approval Role) work list. User can open the transaction or can perform all worklist actions direct from widget.

Admin

All Worklist Dash for FIN

This widget displays list of work items (FIN application) from logged in users ALL (Personal and Approval Role) work list. User can open the transaction or can perform all worklist actions direct from widget.

FIN

All Worklist Dash for HRM

This widget displays list of work items (HRM application) from logged in users ALL (Personal and Approval Role) work list. User can open the transaction or can perform all worklist actions direct from widget.

HRM

Browsing History

This widget shows the list of pages visited by the user for the current session across Advantage. To return to a page, the user only has to select the link to be navigated back.

All

Upload spreadsheet for Admin

This widget supports the uploading of only transactions on the Administration Transaction Control reference page through a spreadsheet template.

Admin

Upload spreadsheet for FIN

This widget supports the uploading of only transactions on the Financial Transaction Control reference page through a spreadsheet template.

FIN

Upload spreadsheet for HRM

This widget supports the uploading of only transactions on the Human Resource Management Transaction Control reference page through a spreadsheet template.

HRM

Admin Last 10 Transactions

This widget shows the last 10 Administration transactions where the user took some action on the transaction other than just viewing. To return to a transaction, the user only has to select the link to be navigated back.

Admin

Financial Last 10 Transactions

This widget shows the last 10 Financial transactions where the user took some action on the transaction other than just viewing. To return to a transaction, the user only has to select the link to be navigated back.

FIN

HRM Last 10 Transactions

This widget shows the last 10 Human Resource Management transactions where the user took some action on the transaction other than just viewing. To return to a transaction, the user only has to select the link to be navigated back.

HRM

 Tasklist

This widget shows a list of all the open tasks assigned to a given user. The list pulls from the User Task listing found only in Human Resource Management. The status of tasks is identified by color codes.

HRM

Employee Leave Balance Alert

This widget shows the leave Balance for a given user of the various types of leave that are close to thresholds.

 HRM

Calendar

This widget shows a weekly view of the calendar a given user, starting with the current day and showing seven days. The widget also provides the ability to toggle between weeks and drill into the calendar page. This widget is targeted for employee roles where other Advantage activity is not displayed.

 HRM

Useful Links

This widget shows the links that have been configured in the Downloadable Forms for Administrator (ADOWN) page. Users are able to select a link to launch the specified website or attachment in a separate window.

 HRM

Timesheet Certification

This widget lists timesheets that require an employee or manager to certify. Use of this widget only applies when the timesheet certification feature is turned on in timesheet setup.   

HRM 

My Work 

This widget provides a user quick access to the HRM transactions created by and for a user that are in progress or pending approval.

HRM 

My Work 

This widget provides a user quick access to the Financial transactions created by and for a user that are in progress or pending approval.

FIN

My Travel Work

Copy of the My Work widget with the difference being that it only shows travel transactions. This widget opens travel transactions in the wizard mode when the Alternate Page Code field is completed on Transaction Control. The following Application Parameter can limit which travel transactions show: TRVL_WRK_EMP_WIDGET_DOCCD_FILTER

FIN

Upcoming Events

This widget lists upcoming events such as birthdays and anniversaries for the employees who report to a manager.

HRM

Upcoming Leave Requests

This widget lists upcoming leaves that begin in the next 30 days for the employees who report to a manager.

HRM

Manager Leave Balance Alerts

This widget shows the leave Balances of the employees who report to ta manager that are close to the thresholds.

HRM

Expiring Licenses/Certifications

This widget lists those employees who report to a manager with licenses or certificates expiring in the next 30 days.

HRM

Account Summary Widget

This widget displays the important account information to a Vendor Self Service user to include: the current 1099, EFT, and vendor status as well as who the primary account administrator is.

VSS

Announcements Widget

This widget displays all of the relevant messages and announcements the Vendor Self Service Administrator has posted to the vendor community. The announcements are displayed or hidden dynamically. Announcement settings in Vendor Self Service Administration control this feature.

VSS

Financial Balance Overview Visualization Widget

For sites that have enabled the Financial Inquiries module in Vendor Self Service, this widget displays a high-level summary of the financial transactions issued or pending on the vendor’s account, in the form of an interactive donut chart. For any further details, the vendors have to navigate to the corresponding inquiry page.

VSS

My Watchlist Widget

This widget allows a vendor to see a quick summary of the solicitations and business opportunities that they have added to their Watchlist to track or respond. 

VSS

My Commodities Widget

This widget displays a quick summary of solicitations and business opportunities that are published with commodities for which the vendor has registered.

VSS

My Activity Widget

This widget displays a summarized view of all the vendors’ transactions that need further updates or review. For example, if the vendor started a response but did not complete it, the response would show. If a buyer has amended an already published solicitation that the vendor has responded to, it would also show.

VSS

Admin Approvals

This mobile application widget navigates a user to the list of all pending Administration transactions.

Admin

Financial Approvals

This mobile application widget navigates a user to the list of all pending Financial transactions.

FIN

HRM Approvals

This mobile application widget navigates a user to the list of all pending Human Resource Management transactions.

HRM

PB Approvals

This mobile application widget navigates a user to the list of all pending Performance Budgeting requestsa

PB

My Onboarding Tasks

My Onboarding Tasks

HRM

My Information Widget       

My Information Widget 

HRM

Performance Journey

On the Employee Performance Landing page (Snapshot) this is a timeline chart that shows the progress of Primary evaluation along with the dates of various milestones and the conversation check-ins.

HRM

Performance Score History

This is a widget on the Employee Performance landing page (Snapshot) that provides bar and line chart representation of Performance Ratings achieved by an employee in the last 5 reporting periods.

HRM

Evaluation Progress

This is a widget on the Manager Performance Summary landing page, which shows the progress made by the reporting employees for the primary evaluation on assigned Goals, Trainings, and Competencies. It shows the percentage completion on each employee level and overall reporting level.

HRM

Appreciations

This Widget is available to both Manager and Employee on the Performance Landing pages. It shows the appreciations received within the department, within the team, and for self. This widget has two buttons:

  • View All - shows details for appreciation.

  • Appreciate - helps user to create and share a new appreciation.

HRM

Overall Rating Trends

This is a widget on Manager Performance Summary landing page, which shows the trend of performance ratings received by reporting members for the primary Evaluation over the last 3 reporting periods.

HRM

Review Status 

This is a widget on the Manager Performance Summary landing page, which shows the count of Primary Evaluations that are Not Started, In Progress, and completed for the reporting employees.

HRM

My Journey Status

This is a widget on the Employee Performance landing page (Snapshot), which shows the progress on assigned Goals, Trainings, and Competencies by the employee for the primary Evaluation. It shows the percentage completion on each Goal, Training, and competency and also shows the overall completion summary.

HRM

Alert

The widget displays the last 10 alerts that the user has received. Users may navigate to the Alerts page by selecting the View All option. Optional row-level actions allow users to mark an Alert as read or unread, or alerts may also be deleted.

Created primarily for Customer Self Service but may be used on other home pages to bring direct attention to alerts.

FIN

Text

The widget can be used to display both text and image or text only.

FIN

Invoice Due

Designed for Customer Self Service to display five different pieces of information for a primary account. It also allows a customer to pay 1 of 3 groups of invoices. First is the total number of invoices that are due till the current date. Next is a Current amount that is invoices due on the current date. An Overdue amount is the total due prior than the current date. Lastly is a Total Due that is the sum of the previous 2 amounts. The remainder of this widget displays the invoices with an outstanding amount of more than $0.00, with an option to select one to pay in full.

FIN

Amount Due

Designed for Customer Self Service to display four different totals for all accounts associated with the primary account. Not Yet Due is the total amount of invoices that are due after the current date.  Due in 7 Days is the total amount that is due within the next 7 days from the current date and including the current date. Overdue 1 to 30 days is the total amount past due less than 30 days. Overdue 30+ days – Total amount past due more than 30 days.

FIN

Amount Summary

Designed for Customer Self Service to display limited information such as Account (Customer ID, Legal Name and Email) of a primary account. None of the variations in this information that may come from other Vendor/Customer records associated with the primary account by sharing the same User ID are shown. Also shown is a summary of several amounts for all customer accounts associated with the parent account.

FIN

My Templates

This widget is designed to support the heavy use of transaction templates in Financial. While a user can find them on the Transaction Catalog and even bookmark them, this widget pulls together all templates that a user has bookmarked for easy access.

FIN