Get Started with Data Hub Configuration Portal

The Data Hub Configuration Portal interface is designed to allow quick access to the tools and activities you need to manage and monitor Data Hub jobs:

  • Monitoring. Monitor pipeline and wrapper performance summary, job history information, and audit history details.
  • Setup. Configure pipeline settings, and map paycodes, location types, and custom drivers. Map paycodes in bulk. View your fiscal calendar values and update them in bulk. Schedule wrappers to run your pipeline jobs and run wrapper jobs ad hoc. Add wrapper override profiles.
  • Alert Management. View the alert history for mapping and pipeline jobs. Subscribe to alerts to receive emails or BigQuery updates when alerts are triggered based on criteria you configure.

You access the Configuration Portal two ways:

  • Bookmark the URL, for example, //mycompanyserver-dhub.companyenv.mykronos.com/datahub/selfservice, open in a browser, and log in.
  • Navigate from a Data Hub custom tile added to your ADP Workforce Manager Home page.

If you are not already logged in to ADP Workforce Manager, you will be prompted to log in before the Configuration Portal opens.

After Data Hub is deployed, log in to the Configuration Portal with a URL specific for your tenant and environment. You either bookmark the URL or navigate from Data Hub tile on your ADP Workforce Manager Home page. The Configuration Portal supports logging in using either basic or federated single sign-on (SSO) authentication.

Note: When you navigate from the ADP Workforce Manager Data Hub Home page tile, the type of authentication depends on how the URL for the tile was configured.

The URL syntax depends on the authentication type:

  • Basic: https://myhostname-dhub.env.mykronos.com/datahub/selfservice
  • Federated: https://myhostname-dhub-sso.env.mykronos.com/datahub/selfservice

Where

  • myhostname is the hostname of your ADP Workforce Manager tenant.
  • env is the type of Data Hub environment, either npr for non-production or prd for production.

For example, if Acme company’s production ADP Workforce Manager tenant URL is https://acme.prd.mykronos.com, the URLs for their Data Hub Configuration Portal would be:

  • Basic: https://acme-dhub.prd.mykronos.com/datahub/selfservice
  • Federated: https://acme-dhub-sso.prd.mykronos.com/datahub/selfservice

Multi-Factor Authentication (MFA) is supported. When you use MFA, you are prompted to enter a one-time passcode in addition to the username and password. The one-time passcode can be received by email, SMS (message), or an app-based token. The email and SMS message go to the registered email address or phone number of the account.

MFA is strongly recommended because it improves account security. To enable MFA in ADP Workforce Manager, go to People Information for the employee account and select MFA Required.

Note: If you are already logged in to ADP Workforce Manager when you access the Configuration Portal, you will not be prompted to log in again.

  1. Open the basic authentication URL in a browser or click the Data Hub Home page tile. The ADP Workforce Manager Log In page displays.
  2. Enter your ADP Workforce Manager Username and Password and click Log In. The Configuration Portal Home page opens.
  1. Open the federated authentication URL in a browser or click the Data Hub Home page tile. The log in page displays for the identity platform (such as ForgeRock) for which your tenant is federated.
  2. Log in using your SSO username and password. This authenticates you for single sign-on.
  3. The Configuration Portal Home page opens.

When you finish working in the Portal, sign out to end your session.

  1. From any page in the Portal, click the Main Menu on the left side of the page to expand the main navigation menu.
  2. Click Sign Out.

When you log in to Data Hub Configuration Portal, the Home page opens. The Home page includes panels from which you can see recent job history, upcoming scheduled jobs, recent alerts, and the status of your mappings, pipelines, and job scheduling. Each panel shows the current time zone where the ADP Workforce Manager server is located and the time the data in the panel was last updated. To refresh the data in a panel, clickRefresh icon.

Navigate from the Home page to see more details about your Data Hub activities. Return to the Home page at any time by clicking the Home icon on the menu bar. The Home page gives access to:

  • Recent Job History - Wrapper (1 Day). Jobs that have run in the past day or are currently running. Click a wrapper name to go to the Wrapper Job Details page for that wrapper to see more information and perform actions on the wrapper. Click View All Job History – Wrapper to see history for all wrappers.
  • Upcoming Scheduled Jobs (1 Day). Panel that shows all enabled jobs scheduled to run in the next 24 hours, the time and day the job runs, and the projected duration of the job based on the average of time the same job previously ran. If a wrapper job does not have a projected duration, then the job is paused. Click Job Scheduling to view and manage job scheduling. 
  • Recent Alerts (7 Days). Pipeline and wrapper failures and mapping alerts that have occurred in the last seven days. If an ADP Functional Expert was notified of a failure, it is noted here. Hover over the information icon for more information. Click View All Alert History to go to the Alert History page for more information.
  • Monitoring. Links to Monitoring pages, including pipeline and wrapper performance summaries, wrapper and pipeline job history details, and audit history.
  • Setup. Click the Setup links to go to the respective pages to review and configure the setup details.
    • Displays the current setup status (either Complete or Incomplete) for tenant pipeline settings, mappings, and job schedules.
    • Maintenance Job Status will show Success or Failed. Failed indicates potential issues with configuration data sync.
    • When you hover over a Status, a message displays more information. For example, if the Paycode Mapping Status is Incomplete, the hover message includes details about which paycodes do not have the Pay Category mapped.

The main navigation menu on the left side of the Data Hub Configuration Portal menu bar is organized into three task categories: Monitoring, Setup, and Alert Management.

An example of the left navigation view in Data Hub, with the Monitoring area expanded.

  1. To expand the menu, click the Main Menu on the top-left of any page.
  2. Click a category to expand it and see the sub-menu links.
  3. To search for a menu link, enter the term in the Search field. Menu links for valid search terms display. Click the x to clear the search results.
  4. To close the menu, click anywhere on the current page or click the X at the top right of the menu.

The tiles and tables on pages in Data Hub Configuration Portal can be customized and managed as follows:

  • Filter Columns. Click the down caret to the right of a column heading. A search filter opens. Enter filter criteria to see only those rows containing the value. For example, Contains > Budget. To remove the filter, click the filter Filter icon at the top-right of the view and select Clear All Filters. You can filter more than one column at a time to refine the results. For example, when you filter a second column, that filter is applied to only those rows returned by the first filter.
  • Sort Columns. To sort a column in ascending order, click the column header. To sort in descending order, click the column header again. To return to its default order, click the column header a third time.
  • Show All Filter Row. Click the filter at the top-right of a view or panel and select Show All Filter Row. This displays another row across the top of the table. Enter criteria in the filter row to filter a column. To remove the filter row, from the filter menu select Hide All Filter Row.
  • Hide/Show Columns. By default, all available columns display in a view or panel table. To hide a column, click the filter on the top-right of the view and deselect the column name. The column is removed from the table. To show the column again, select the column name in the filter menu.
  • Refresh. Many pages allow you to reload the data on the page. To refresh a page, click Refresh icon (or Refresh) on the top right. The time zone of the ADP Workforce Manager server displays on all pages and many pages show the time the page was last refreshed. This helps ensure you are looking at the most recent information. On the Home page, you refresh data for each panel rather than the entire page.
  • Forward/Backward Page Navigation. To navigate pages in the portal, click your browser's forward and backward buttons.

The Data Hub Configuration Portal interface supports the translation and locale settings applied in ADP Workforce Manager. When the display language is set for the ADP Workforce Manager server on the current tenant, the Data Hub Configuration Portal interface inherits the change. The display language is reflected in the headings, buttons, tabs, and other text. 12 languages are available, including English.

Note: User data displayed in the interface and text in certain views are not translated. Chinese language translation is not available in Data Hub R11. For more information, see the ADP Workforce Manager online help.