Step 1: Configure a search widget


Network administrators create and customize the search widget in the Network instance. When the configuration is saved, Network generates the code that web developers can use to embed the search widget in the internal application. You can also add the widget to an application to use in the Network Portal.


Ensure that you have completed the following tasks:

  • Sign the Authorized Data Use Agreement (ADUA)

    Veeva OpenData is available to access using the Network widgets. Sign the Authorized Data Use Agreement (ADUA) if you are using Veeva OpenData in a third party vendor application.

    Note: This is not required if you are using the widget in a Network Portal application.

  • Enable single sign-on (SSO)

    Ensure that SSO is configured for your Network instance and that users are assigned to an SSO security policy. For more information, see Enable single sign-on (SSO).

Add a search widget

To add a search widget:

  1. In the Admin console, click Widgets & Portal > Network Widgets.
  2. Click Add Network Widget.
  3. In the New Network Widget dialog, select Search Widget from the list.

    Review the Note section and ensure that all appropriate agreements (ADUA) are complete if you will be downloading third party source or Veeva OpenData records.

  4. Click Create Widget.

The New Search Widget page displays.


Define the following information in this section.

  1. Name and Description.
  2. System - Select a source system.

    A source system is defined for the following uses:

    • Custom keys -Custom keys can be generated when users download a record using the search widget. The system is used for the key, which enables you to export records for that system.
    • Reference aliases - You can use the system's aliases (instead of Network codes) in the JSON response returned for each search result. For example, Network's address code for the state of Connecticut is US-CT. If a source system is defined, Network returns the target reference alias value, Connecticut, instead of the Network code. Using reference aliases avoids having to define custom mappings in the code during the widget integration; all of the mappings are done in Network.

      To review the reference aliases for a source system, click System Interfaces > Reference Aliases. For more information, see Reference aliases.

  3. Type - Search Widget is selected by default.
  4. Widget Enabled - Choose Yes. The widget is not enabled by default.

General Settings

Define the domain and behavior for your widget.

  1. Authentication - Type the domain name for the internal website that will host the widget. If you are embedding the widget into the Network portal, use * or your instance URL; for example, If you are embedding the widget into a Salesforce Visualforce™ page, use *

    Multiple domain names can be added. Wildcards are supported in case the domain changes and to support multiple domains. Click +Add Domain to specify additional domains.

  2. Languages - Any languages that should display in your search widget. English is defined by default.

  3. Add Request - Allow users to submit add requests from the search widget. This setting is enabled by default for new search widgets.

    When users create a record, an add request is submitted so data stewards can validate the data and create the record in Network. The record is immediately available in your internal application so users can action it.

    Add requests that are submitted using the search widget will have the create_unverified flag set to true in the change request API. This API setting overrides the workflow setting for the request. So, if the Create Unverified workflow setting is not enabled in your Network instance, the add request from the search widget will still create an under_review record.

    For more information, see Network workflow considerations for add requests.

  4. Custom Keys - Automatically generate a custom key when a record is downloaded or added.

    This enables you to track the systems that have downloaded records.

    The custom key is created using the following format:

    • Source System: The system of the search widget.
    • Custom Key Source: <SystemName> - <WidgetName>
    • Custom Key Item: <Entity Type>-SELECT
    • Value: The Network entity ID.

    Using this information, you can configure a target subscription filter to export records added from the search widget to your downstream system.

  5. Hashtags - Network hashtags display in enabled Search widgets by default. Hashtags are automatically applied to record profiles and search results to summarize important details on the record. They can also be used for search queries.

    Click the Hashtags link to go to the Network Hashtags configuration. You can open a hashtag and go to the Visibility section to define the hashtag settings for this widget.

  6. Widget Header - Choose whether your widget should display a header.

    By default, a header is not included so the widget displays seamlessly into your internal portal. If you include a header, you can add a custom logo and title in the Branding and Labels sections below.

  7. Search Settings - Choose the search style that will be presented to your users:

    • Advanced Search Only - Users should always search using the advanced search form so they can search specific fields. Quick search is not available.
    • Quick Search and Advanced Search - Users have the option of typing search terms into the quick search bar or using the advanced search form through the link.

Entity Management

Choose the entities that users can search for with the widget.

By default, Health Care Organization and Health Care Professional are listed. For example, if you remove Health Care Organization, users will only see HCP records in their search results.

Use the handle to reorder the entities; this determines the order of their tabs on the advanced search page.

Note: Records can also be filtered using preset filters as a property in the widget's HTML code. This gives you flexibility to configure one search widget, but use it in different areas in your internal application for different purposes. For more information, see Preset filters.

  1. HCO and HCP tabs - Define the entity label that displays in each language supported by your search widget.

    By default, the labels are Health Care Organization and Health Care Professionals but, you might want to change the labels to Hospitals and Practitioners, respectively, depending on the terminology used by your users.

    Quick Search - Displays if you enabled Quick Search in the Search Settings section.

  2. Advanced Search Field Selection - Define the section labels and the fields that users can use for searching in the advanced search form.

    By default, the HCO and HCP tabs include two sections with fields. One additional section can be added. Each section can include six fields.

    The sections are designed to group similar fields. By default, the sections are grouped into the following categories:

    • Section 1 - Name fields
    • Section 2 - Location fields
    • Section 3 - Other fields.

    Note: On the Quick Search tab, the sections represent the filters that can be used on the search results page to narrow the results.

    Available actions for each section

    • Add fields -Click + Add Field to define more filter fields; six fields can be included in each section.

      Fields for all entities and sub-objects, except date fields, are available Other Fields and Name sections. The Location section includes address fields only.

      Tip: Add the ID field to Section 1 or Section 3 so users can search by ID.

    • Remove fields - Click the "x" icon beside the field.
    • Reorder fields - Use the handle beside the field name and move it to another position in the list. The order defined here determines the order in the search widget.
    • Profile layout - Choose how record profiles will display in the widget:

      • Use the Data Visibility Profile of the user - This is the default option. The user's data visibility profile (DVP) typically contains all of the fields for the record.
      • Override the DVP and assign a specific profile layout - Specify a different profile layout for record profiles and add requests. For example, for the Profile View/Edit Layout you might create a layout that contains only the fields that are essential for your business purposes.

        The Add Request Layout can be different than record profiles and change requests. This gives you more flexibility over the forms that display for users. Using a limited profile layout can generate better add requests because you can include only the fields that are essential for creating a new record.

      All of the standard and custom profile layouts in your Network instance display.

    Tip: You can configure field and object settings on custom profile layouts to simplify add and change requests submitted through Network widgets. For details, see Widget profile layouts.

Transformation Rules

Rules can be applied to transform the data that users download from the widget. The transformed data will display in the downstream system.

For details, see Apply transformation rules to Network widgets.


You can limit the addresses that display on records in downstream systems.

Rules that have been applied to the system that the widget uses displays in this section.

  • To create a rule, click Create a New Transformation Rule to open the Transformation Rules page.


Customize the style of the widget.

To understand how these style settings map to the widget, review Example 1 and Example 2 below.

  1. Images - Upload any logos that you want to add to the widget.

    Image files in .JPG and .PNG formats are supported. The image name cannot contain spaces. The image file will be automatically resized to fit in the appropriate space.

    • Widget Header Logo - Logo for the widget header (maximum height and width is 24px by 24px).
    • Quick Search Logo -Logo on the quick search widget page if you have chosen it in the search settings (maximum height and width is 120px by 380px).

    Uploaded images display in the Preview section.

  2. Font - The font family used in the widget. By default, Open Sans is selected.
  3. Colors - Customize the colors for your widget.
    • Primary Button Color: Default, #005FB2
    • Primary Button Hover Color: Default, #16325C
    • Secondary Color: Default, #005FB2
    • Link Color: Default, #3A77BC


Define the labels for each language in your search widget.

  1. Widget Title - The title on both the main search page and the search results page. By default, the title is Network Search. It can be a maximum of 80 characters.
  2. Select Record Label - The label for the button beside each search result. By default, the button is called Select. The label can be a maximum of 15 characters.

Saving changes

The widget configuration is complete. Save your changes.

Data components

If you want data components to display so users can access report data or external information about the record in the widget, add the widget to the data component configuration (Widgets & Portal > Data Components).

For details, see Data components.

< Search widget Step 2: Embed the search widget >