Step 1: Configure your profile widget

AD

As a Network administrator, you can create and customize the profile widget in your Network instance. When you save the configuration, Network generates the code that web developers will use to embed the profile widget in your internal application.

Prerequisites

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.

  • 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 profile widget

  1. In the Admin console, click System Interfaces > Network Widgets.

    The Network Widgets page displays a list of widgets that are configured in your Network instance.

  2. Click Add Network Widget.
  3. In the New Network Widget dialog, select Profile Widget. Click OK.

Widget details

Define the following information in the Details section.

  1. Name and Description.

  2. System - Select a source system.

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

General Settings

Customize your widget.

  1. Authentication - Type the domain name for the internal website that will host the widget.

    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.

    Examples

    • Network Portal - If you are embedding the widget into the Network portal, use *.veevanetwork.com or your instance URL; for example, verteo.veevanetwork.com.

    • Salesforce - If you are embedding the widget into a Salesforce Visualforce™ page, use *.visual.force.com.

    Hosting website requirements

    • Production widgets - For security, the hosting website must use the HTTPS protocol. If the website does not use HTTPS, the widget cannot be accessed.

      Example

    • Sandbox widgets - These widgets can be hosted on websites that use the HTTP or HTTPS protocol.

      Allowing HTTP for sandbox provides flexibility to developers to test the widgets on a local host server.

      Note: If developers are implementing the widgets using a local host server, add an asterisk (*) to the domain list in the widget.

      Example

  2. Languages - Any languages that should display in your search widget.

    English is defined by default. Click +Add Language to specify additional languages.

  3. 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.

  4. Change Request - Clear this field. This option is enabled by default for new widgets. If you want users to submit change requests through the widget, see Configure your DCR widget.

  5. Hashtags - Network hashtags display in enabled Profile widgets by default. Hashtags are automatically applied to records to summarize important details.

    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. 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 example, you might create a layout that contains only the fields that are essential for your business purposes.

Branding

Customize the style of the widget.

  1. Images - Upload a logo for the widget header.

    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. The maximum height and width is 24px by 24px.

    The uploaded image displays in the Preview section.

  2. Fonts - The font family to be used in the widget. By default, Open Sans is selected.
  3. Colors - Customize the colors for your widget.
    • Primary Button Color - Used for all action buttons. Default, #005FB2
    • Primary Button Hover Color - Used when for hover on an action button. Default, #16325c
    • Secondary Color - Used for the entity icon. Default, #005FB2
    • Link Color - Used for all links. Default, #3A77BC

To understand how these style settings map to the widget, review the branding example below.

Example widget branding

Labels

The languages that you defined for the widget are listed. Type the Widget Title label for each language.

By default, the title is Network Profile. It can be a maximum of 80 characters.

Save 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.

 

< Profile widget

Step 2: Embed the profile widget >