Hospital Web Portal Account Management

Hospital Web Portal Account Management

This page was originally created for VetView 3.1. It has been updated to reflect changes in VetView 4.0 and later on 4-16-2025.

Search User Guides by Keyword

Web Portal Account Management

The VetView Portal allows external vendor access to VetView. The Portals are a separate installation from the main application, allowing you to have them on a different server that is linked to the external networks through your organization's firewall.    Multiple portals can be installed on a as single Tomcat server.  The portals then use the VetView API and a token key to communication to the main VetView application.

Online portal client access is managed in VetView using the Web Portal Account Management screen.  This screen is found under Navigation, in main Hospital Screens.

A screenshot of the VetView Navigation menu in Hospital.  The bottom link under Hospital Screens will always be for Web Portal Account Management no matter what other privileges the user has.
Web Portal Account Management under Navigation

If you do not see Web Portal Account management as the final option under Hospital Screens, then you may be missing the appropriate privileges.

Portal User Management Privileges

Portal User Management Privileges

The privileges for the Web Portal Account Management screen are all found under the Portal User Management heading in the Role Management Screen.  Hospital and Labs have separate access privileges, but share privileges for client creation and modification once access is granted.

A screenshot from VetView showing a detail of the Role Management screen.  This section is the privileges for Portal User Management.  These are Access Hospital Portal user Rights, Access Labs Portal user rights, modify portal hospital mappings, modify lab portal mappings, create portal user, update portal user, and delete portal user.
Portal User Rights

Portal User Account Setup

There are two ways users can gain access to the portal.

  1. Users can register for Portal access on the portal website, and then request access to a specific Lab or to your Hospital. This registration process does not give the client immediate access to the portal; lab or hospital client coordinators or other staff must authorize the requested account to complete the process.

  2. User access can be setup manually using the Web Portal Account Management section in the main VetView software, or linked to an email address on the Client Setup page

1. Provision Requested Accounts via the Web Portal Account Management screen

Search for New Requests Only in the Web Portal Account Search window at the top of the screen.  Enter in the username or email address that the client informed you that they used for registration.  You can also search for only recently created accounts by setting the Created Start and Created End date. 

A screenshot of the VetView Web Portal Account Search panel.  At the top left is the search by name field, followed by an email option, and a series of flags for Active, Inactive, Locked, Expired, and new requests only.   There is also an option to search by dates.  The Search button is the final tab stop
Web Portal Account Search panel

A list of newly requested accounts from the Hospital portal will appear in the Search Results.

A screenshot from the Web Portal Account Management screen after a search has been performed.  The search results appear output into a list.  The first tab stop will be a New Account creation button, followed by the grid of results.  Continue reading for more details on the New Account button.
Web Portal Account Search Results

Click on the Username of the account you want to activate.  The Portal User Management screen will load for that username. The Account Created date stamp will show it was generated by the Portal API. The client’s name, business name, email address, and phone number (if entered) will automatically pass in.

A screenshot from Web Portal Account Management showing a newly requested customer account.  The account has some passed in details, but is missing a hospital link, and is not yet active.
Web Account as requested from the Portal

The registration information passed in from the portal will appear in the Notes section of this page.

A detail from the Web Portal Account screen. This section is the Notes, which appear in the upper right hand corner of the screen.  Notes will automatically include all of the user registration details if the account was requested directly on the Portal.
Notes Section

To provision the account, you can change the following settings:

Set the account to Active Status:

A detail from the Portal User Management screen.  This section shows the flags on Account Status.
Active Flag on Account Status

The account can be set as inactive, expired, or locked at any time. You can also force the user to change their password with Password Expired, if there is a security incident at your organization.

If the client registered with an email address that is already in the system, you will see it in the panel that says “Possible Hospital Client Accounts, Matched by Email.” Click on the Link Accounts button to automatically provision this account.

A screenshot from the Portal User Management screen.  This section shows the Possible Hospital Client Accounts matched by Emails panel.  Click on the Link Account buttons to automatically join the internal client account to the external web portal account.
Link Account Button

If the email address is shared among many people at a clinic, you will see multiple internal Hospital accounts that can be linked. In this example, all the DVMs at a clinic use the clinic’s email address for their VetView account, and all can be linked to a single portal account.

Another detail image from Portal User Management Possible Hospital Client Accounts Matched by Emails - this time with five different DVMs linked.  Each client has a unique Link Accounts button.
Multiple Matched Hospital Client Accounts

If there is no automatic match because a different email address was used, you can select the local Hospital Client account that should be linked to this user's Web Portal account.   Click on the Add button to open the client lookup window.

A detail image from the Portal user management screen showing the Add Edit Hospital Client Links modal window to manually add a hospital account.
Add/Edit Hospital Client Links Window

Click on the Save button to add the user account to the Linked Hospital Client Accounts list.  For a web portal account that will be shared across a clinic with multiple RDVMs, you can add multiple clients. 

The Search Filters button will display choices of client role, client type, or allow you to search by a patient’s case number.

Click on the Save button at the top of the screen to apply the changes. 

2. Manually add a new account on the Web Portal Account Management Screen

If you are working with a new Lab or Hospital client in person, or you have all the account information needed to set up the web portal account ahead of time, you can manually create a new account by clicking on the New Account button at the top of the Search Results window.

A detail image from the Portal User management screen showing the New Account button as it appears at the top of the Search Results panel.
New Account Button

A blank Portal User Management screen will open.  Manually enter in your client's desired username, business name (for RDVMs and Clinics), the first name and last name of the main contact, the email address that will be associated with the account, and a phone number.  You can also enter any other important information for this client in the Notes, such as alternate contacts who will have access to the account.

A screenshot from the Portal User Management screen showing how it appears after clciking on the New Account button.
Blank Portal User Management screen

Click on the Save button to apply the changes.

The screen will reload, and you can create a password for the client under the Change Password setting, and link their lab or hospital accounts.

3. Link Client Accounts Automatically on the Client Details screen

If you are on the Client Details screen in either Labs or Hospital, and your client has an email address saved under the Contact Info, you can automatically create a Web Portal Account using the information as it is stored in client details.

A detail image from the Client User Management screen showing the Portal Information tab and the option to link an account directly on that screen to the portal user account with a matching email address.  You can also create a portal account directly from this tab without going to Portal User Management.
Portal Information on Client Management

Once you have clicked on the Create Portal Account button, the screen will reload, and you have the option of sending a password reset notice or a welcome email from this screen.

A detail image from the Client Account screen portal information tab.  This account has been created or linked and now the user provisioning the account can send out a password reset email or a welcome email.
Portal Information Email Buttons

Any other details, or linking to additional Hospital or Lab accounts, will need to be performed under the Web Portal Account Management Screen instead. 

Link Laboratory Client Accounts

On the Web Portal Account Management screen, if you have any potential matches to existing Lab Client accounts based on the email address, then a button called Lab Information will appear at the top of the screen as a link.

You must have the Access Labs Portal User Rights privileges to be able to view the Lab account settings for this client.

A detail image from the Portal User Management screen showing the Lab Information button on the top row.  This button goes to the Lab version of the Web Portal Account for this client.
Lab Information Link

Please see Lab Web Portal Account Management for details about setting up Lab Portal accounts.

Edit or Delete a Linked Hospital Client Account

Portal accounts can be modified or removed without changing the underlying Client Account in the main VetView application. Deleting the link does NOT delete the hospital account or the portal account - it simply severs the link, and the data for each remains intact. They can be rejoined at any time.

image-20250421-154039.png
Delete a linked Hospital Client Account

To remove a linked account, select the account from the list and click on the Delete button.

To edit a client account, if the wrong client account was selected, click on the Edit button and search for the correct client account.  (You may also delete and re-add as another method of fixing this.)

Other Portal Management Options

These options are universal for both Labs and Hospital.

A screenshot detail from the Portal User Account management showing the Account Status options, but also other options such as changing a password, or logging in directly as this user to troubleshoot client portal account problems.
Other portal management options

Login as User

Use this feature to automatically launch the client's portal account in another window.  This feature is useful for verifying what the client can see on their Portal screen.  This feature is only available on active accounts with at least one hospital or lab client account linked.

Change Passwords

You can perform a manual password reset for your client if they are having trouble resetting it via the web portal.

Account Status

You can adjust the status of the account with these settings.

  • Active Flag:  This account is active, and the user may log into the web portal as normal.  If a client will no longer be doing business with your lab or hospital, this may be deactivated.

  • Locked:  The account is active, but is locked.  Use this option to force the user to contact your Lab or Hospital.

  • Expired:  The account is active, but expired.  Use this option to temporarily disable an account.

  • Password Expired:  The account is active, but the password has been set to expired.  The client must reset their password to access the account.

  • Expire Date:  The account is active now, but will switch to Expired on the date listed.  This option may be useful for temp workers, interns, students, or other seasonal workers who may not be associated with large client accounts for a longer duration of time.