Global Dashboard

Your Global Dashboard displays a list of reviews that you may need to act on for each of the P4 Server instances connected to P4 Code Review.

Open your global dashboard:

1. Enter the basic P4 Code Review URL without a P4 Server instance name, for example: https://swarm.company.com
2. If the log in dialog is displayed:

Single Sign-On (SSO)

If P4 AS is configured for your P4 Server and P4 Code Review, SSO can be configured by your P4 Code Review admin as either mandatory or optional:

• If SSO is mandatory, you will be directed to the sign-in process used by your Identity Provider (IdP).

• If SSO is optional, log in to P4 Code Review using one of the following methods:

  • Click Log in with SSO, you will be directed to the sign-in process used by your Identify Provider (IdP).

  • Type in your username and password, and click Log in.

1. Server:
• If your P4 Server instances do not share log in credentials, select an individual P4 Server instance from the dropdown list.
• If all of your P4 Server instances share the same log in credentials, leave set to All available servers.

If P4 AS is configured for your P4 Server and P4 Code Review, you must log into the servers individually.

2. Enter your username and password.

Select the Remember Me check box if you prefer to stay logged in between browser restarts.

P4 Servers can enforce maximum login times. You may become logged out even if Remember Me is selected. P4 Code Review administrators can change the maximum login time, see Sessions for details.

3. Click Connect.

P4 Code Review will populate the global dashboard from the P4 Server instances it connects to.

The global dashboard is displayed:

• Since it is tied to the logged in user, the global dashboard is only populated for the P4 Server instances you are logged in to in P4 Code Review.
• If you are already logged in to a P4 Server instance in P4 Code Review, the dashboard for that server will be automatically populated when you open or refresh the global dashboard.

The global dashboard is made up of three main areas:

• Toolbar: log in to P4 Server instances, log out of all P4 Server instances, and open the P4 Code Review help from the global dashboard toolbar.
• Sidebar: Log in/logout of individual P4 Server instances and view you profile for any instance that you are logged in to.
• P4 Server dashboards: view, filter and search the dashboards of the P4 Server instances you are logged in to. Jump directly to a P4 Server, review, or project by clicking on a link.

Toolbar

Log in to one or more P4 Server instances

Log In is only displayed in the global dashboard toolbar if you are not logged in to any P4 Server instances. If Log In is not available, see Log in to a P4 Server instance.

1. In the global dashboard toolbar, click Log In.

Single Sign-On (SSO)

If P4 AS is configured for your P4 Server and P4 Code Review, SSO can be configured by your P4 Code Review admin as either mandatory or optional:

• If SSO is mandatory, you will be directed to the sign-in process used by your Identity Provider (IdP).

• If SSO is optional, log in to P4 Code Review using one of the following methods:

  • Click Log in with SSO, you will be directed to the sign-in process used by your Identify Provider (IdP).

  • Type in your username and password, and click Log in.



2. Server:
• If all of your P4 Server instances share the same log in credentials, leave set to All available servers.
• If your P4 Server instances do not share log in credentials, select an individual P4 Server instance from the dropdown list.

If P4 AS is configured for your P4 Server and P4 Code Review, you must log into the servers individually.

If you have a number of P4 Server instances that use the same login credentials, select them one at a time from the dropdown list.

3. Enter your username and password.

   Select the Remember Me check box if you prefer to stay logged in between browser restarts.

   P4 Servers can enforce maximum login times. You may become logged out even if Remember Me is selected. P4 Code Review administrators can change the maximum login time, see Sessions for details.

4. Click Connect.

P4 Code Review will populate the global dashboard from the P4 Server instances it connects to.

Logout of all P4 Server instances

Logout from all instances is only displayed in the global dashboard toolbar if you are logged in to at least one P4 Server instance.

1. In the global dashboard toolbar, click Logout from all instances.
2. When prompted, click Yes to confirm that you want to logout of all of the P4 Server instances.

• If P4 AS is configured for your P4 Server, logging out of P4 Code Review will not invalidate your Identity Provider (IdP) login status. If you try to log back in to P4 Code Review while your IdP status is still valid, you will not be prompted to complete the log in steps.

If require_login is also enabled, P4 Code Review will return you to the login and your IdP will automatically log you back in. In this case log out from your Identity Provider page before logging out from P4 Code Review.

• If a custom redirect has been configured by your P4 Code Review administrator, you are logged out of all of the P4 Server instances by P4 Code Review and then redirected to the URL specified by the administrator.

The custom redirect can be set to any internal or external URL, for example:

• Company intranet, extranet, internet, FTP, or Web-mail page
• Industry news website
• Identity Provider page to invalidate your IdP log in status

Sidebar

The P4 Servers that P4 Code Review can connect to are listed in the collapsible sidebar on the left of the page. From the server list you can log in/logout from individual P4 Servers and view your user profile.

Log in status

• Not logged in to the P4 Server instance:



• Logged in to the P4 Server instance:

Log in to a P4 Server instance

1. In the sidebar, hover over the P4 Server you want to connect to.
2. Click the Log in button .

• Single Sign-On (SSO)

  If P4 AS is configured for your P4 Server and P4 Code Review, SSO can be configured by your P4 Code Review admin as either mandatory or optional:

  • If SSO is mandatory, you will be directed to the sign-in process used by your Identity Provider (IdP).

  • If SSO is optional, log in to P4 Code Review using one of the following methods:

    • Click Log in with SSO, you will be directed to the sign-in process used by your Identify Provider (IdP).

    • Type in your username and password, and click Log in.

• If you are already logged in to another P4 Server that is configured for P4 AS, your IdP status is valid and you will not be prompted to complete the log in steps.



3. Type in your username and password for the P4 Server.
   • Select the Try to log in to all available servers with these credentials checkbox if you use these credentials for more than one of the P4 Server instances. P4 Code Review will not try to log in to any P4 Server instances that are configured for P4 AS, log in to them individually using the instance Log in button in the sidebar.

   • Select the Remember Me check box if you prefer to stay logged in between browser restarts.

     P4 Servers can enforce maximum login times. You may become logged out even if Remember Me is selected. P4 Code Review administrators can change the maximum login time, see Sessions for details.

4. Click Connect.

P4 Code Review will populate the global dashboard from the P4 Server.

If you selected the Try to log in to all available servers with these credentials checkbox, P4 Code Review will populate the global dashboard for the other servers in the list that it successfully connects to.

Logout of a single P4 Server instance

1. In the sidebar, hover over the P4 Server you want to log out from.
2. Click the Gear button to open the dropdown menu.
3. Click Logout in the dropdown menu.

• If P4 AS is configured for your P4 Server, logging out of P4 Code Review will not invalidate your Identity Provider (IdP) login status. If you try to log back in to P4 Code Review while your IdP status is still valid, you will not be prompted to complete the log in steps.

If require_login is also enabled, P4 Code Review will return you to the login and your IdP will automatically log you back in. In this case log out from your Identity Provider page before logging out from P4 Code Review.

• If a custom redirect has been configured by your P4 Code Review administrator, you are logged out of the P4 Server instance by P4 Code Review. You are only redirected to the URL specified by the administrator if you are not logged in to any other P4 Server instances on the global dashboard.

The custom redirect can be set to any internal or external URL, for example:

• Company intranet, extranet, internet, FTP, or Web-mail page
• Industry news website
• Identity Provider page to invalidate your IdP log in status

P4 Server dashboards

The purpose of the global dashboard is to allow you to focus on reviews that need to be done, so that other users are not blocked. The global dashboard lists reviews by P4 Server according to the most recently modified first, and shows your role in the review.

A review is displayed on your global dashboard if any of the following criteria are met:

• You are a reviewer or required reviewer, the review status is Needs Review and you have not already voted on it.
• You are a member of a reviewer group or a required reviewer group, the review status is Needs Review and you have not already voted on it. The review will remain on your dashboard even if the group has met its criteria if you have not already voted on it.
• You are the review author and the review status is Needs Revision, or Approved (only if the review is approved but not committed).
• You are a moderator or a member of a moderator group, the review status is Needs Review, the Minimum up votes requirement for the branch is satisfied, and one of the following is true:
  • There are no required reviewers.
  • All of the required reviewers have up-voted the review.
  • You are the last remaining required reviewer for the review.

If moderator behavior is configured to require approval from one moderator per branch and the review spans multiple moderated branches:

• You will see the review in your dashboard if the review has not been approved by another moderator from your branch.
• You will be able to Approve and Commit the review if it has been approved by moderators from all of the other branches.

Example global dashboard showing a number of P4 Server dashboards:

P4 Server header bars

The dashboard for each P4 Server instance is displayed under the header bar for that instance. The header bars are collapsible allowing you to temporarily hide P4 Server instances you are not currently interested in.

Filtering

The global dashboard can be filtered to display only reviews from a particular P4 Server instance, project, authored by a particular user, or matching a role. The filter buttons filter all of the instances on the global dashboard. The filter buttons are always in view as you scroll up and down the page so that you can quickly modify the filters and see just the reviews you want to see. Click the Reset button to reset these filters.

Filtering options are:

• Instances

  You can filter by the P4 Server instance, limiting results to All Instances or to an individual instance.

• Projects

  You can filter by the project the review is part of, limiting results to All Projects or to an individual project. The Project filter will only show projects for which there are reviews in your dashboard.

• Roles

  You can filter by your specific role in a review, limiting results to reviews for which you are the author, a reviewer, a required reviewer, or a moderator. The Role filter will only show roles for which there are reviews in your dashboard.

• Authored by

  You can filter the reviews to only those that have been authored by a certain user. Type in this field to get a drop down list of users to filter by.

• Reset (only displayed if one or more filters are set):

  Clicking the Reset button resets all dashboard filters back to their defaults.

• Search

  Typing in the search field filters the reviews by description and review ID.

Review fields

The dashboard for each P4 Server shows a summary of the information for each review.

Reviews that appear here are those which are waiting for action from you. The information presented should help you prioritize what to work on next.

• Author

  The author of this review.

• ID

  The ID of this review. Click on this to go to the review page.

• Description

  The review description. It may be truncated if it is too long, in which case click on the description to expand it.

• Project(s)

  List of project branches this review covers. A review may span multiple branches and projects. Click on one of them to navigate to the project page for that branch.

• Your role

  The reason this review is in your dashboard. This can be Author, Reviewer, Required Reviewer, or Moderator.

• State

  The current status of the review. This can be Needs Review, Needs Revision, or Approved.

  The Approved state only applies to review authors, it is only shown for a review that has been approved but has not been committed.

• Type

  The type of review. This can be Pre-commit or Post-commit.

• Votes

  The double column of votes displays the number of up votes and down votes for the review.

• Last activity

  The last time that any changes were made to the review, including votes, comments, commits, and file changes.

Navigating directly to a specific P4 Server instance in P4 Code Review

If you want to quickly visit a specific P4 Server instance in P4 Code Review without going via the global dashboard, include the server name in the URL, for example: https://swarm.company.com/serverA.

Once you are viewing the P4 Server in P4 Code Review, P4 Code Review works as a standard single P4 Server-P4 Code Review system.