Home

Customization Guide

JSON Configuration File

Important Changes

Release 3.6

Release 3.1

The JSON configuration file helps control customizations for the FAD SAAS application so that you can fine tune certain colors and content to fit your organization. It consists of two parts: the interfaces and the theme. An example is provided for your reference:

{
  "interfaces": {
    "search": {
      "locationSearchCookieName": "fadLocationSearch_dh",
      "medgroupDictionary": [
        {
          "code": "arizona",
          "identifiers": "dignity-health-medical-group|arizona",
          "url": "https://www.dignityhealth.org/arizona/medical-group/arizona",
          "title": "DHMG - Arizona",
          "city": "Phoenix",
          "state": "AZ",
          "latitude": "33.448261",
          "longitude": "-112.075768",
          "getToKnowContent": "{providerDisplayFullNamePlaceHolder} is part of <a href='{medGroupUrlPlaceHolder}'>{medGroupTitlePlaceHolder}.</a>",
          "logoPath": "https://dignity-health.cshcontentstage.org/content/dam/dignity-health/logo/dh-logo.svg"
        },
        {
          "code": "enterprise",
          "identifiers": "enterprise|all",
          "url": "https://www.dignityhealth.org/dhmf",
          "title": "All Medical Groups",
          "city": "",
          "state": "",
          "latitude": "",
          "longitude": ""
        },
        {
          "code": "intel",
          "identifiers": "icc|intel",
          "url": "https://www.connectedcarehealth-ipf.com/ca/",
          "title": "Intel Connected Care",
          "city": "Sacramento",
          "state": "CA",
          "latitude": "38.558504",
          "longitude": "-121.473647"
        },
        {
          "code": "bakersfield",
          "identifiers": "dignity-health-medical-group-bakersfield|bakersfield",
          "url": "https://www.dignityhealth.org/central-california/medical-group/bakersfield",
          "title": "DHMG - Bakersfield",
          "city": "Bakersfield",
          "state": "CA",
          "latitude": "35.366959",
          "longitude": "-119.01886"
        },
        {
          "code": "dominican",
          "identifiers": "dignity-health-medical-group-dominican|dominican",
          "url": "https://www.dignityhealth.org/bayarea/medical-group/dominican",
          "title": "DHMG - Dominican",
          "city": "Santa Cruz",
          "state": "CA",
          "latitude": "36.974018",
          "longitude": "-122.030952"
        },
        {
          "code": "inland-empire",
          "identifiers": "dignity-health-medical-group-inland-empire|inland-empire",
          "url": "https://www.dignityhealth.org/socal/medical-group/inland-empire",
          "title": "DHMG - Inland Empire",
          "city": "San Bernardino",
          "state": "CA",
          "latitude": "34.1083",
          "longitude": "-117.2889"
        },
        {
          "code": "merced",
          "identifiers": "dignity-health-medical-group-merced|merced",
          "url": "https://www.dignityhealth.org/central-california/medical-group/merced",
          "title": "DHMG - Merced",
          "city": "Merced",
          "state": "CA",
          "latitude": "37.30127",
          "longitude": "-120.486198"
        },
        {
          "code": "mic",
          "identifiers": "mercy-imaging-center|mic",
          "url": "https://www.dignityhealth.org/sacramento/medical-group/mercy-imaging-centers",
          "title": "DHMG - MIC",
          "city": "Rancho Cordova",
          "state": "CA",
          "latitude": "38.574539",
          "longitude": "-121.30349"
        },
        {
          "code": "mmg",
          "identifiers": "mercy-medical-group|mmg",
          "url": "https://www.dignityhealth.org/sacramento/medical-group/mercy-medical-group",
          "title": "Mercy Medical Group",
          "city": "Sacramento",
          "state": "CA",
          "latitude": "38.57906",
          "longitude": "-121.491013"
        },
        {
          "code": "nevada",
          "identifiers": "dignity-health-medical-group-nevada|nevada",
          "url": "https://www.dignityhealth.org/las-vegas/medical-group/nevada",
          "title": "DHMG - Nevada",
          "city": "Las Vegas",
          "state": "NV",
          "latitude": "36.171909",
          "longitude": "-115.139969"
        },
        {
          "code": "north-state",
          "identifiers": "dignity-health-medical-group-north-state|north-state",
          "url": "https://www.dignityhealth.org/north-state/medical-group/north-state",
          "title": "DHMG - North State",
          "city": "Redding",
          "state": "CA",
          "latitude": "40.587509",
          "longitude": "-122.392929"
        },
        {
          "code": "northridge",
          "identifiers": "dignity-health-medical-group-northridge-family-medicine|northridge",
          "url": "https://www.dignityhealth.org/socal/medical-group/northridge",
          "title": "DHMG - Northridge",
          "city": "Los Angeles",
          "state": "CA",
          "latitude": "34.234772",
          "longitude": "-118.533882"
        },
        {
          "code": "phc",
          "identifiers": "pacific-central-coast-health-center|pcc|phc",
          "url": "https://www.dignityhealth.org/central-coast/medical-group/phc",
          "title": "PHC",
          "city": "Arroyo Grande",
          "state": "CA",
          "latitude": "35.124191",
          "longitude": "-120.577171"
        },
        {
          "code": "san-francisco",
          "identifiers": "dignity-health-medical-group-saint-francis-st-marys|san-francisco",
          "url": "https://www.dignityhealth.org/bayarea/medical-group/san-francisco",
          "title": "DHMG - San Francisco",
          "city": "San Francisco",
          "state": "CA",
          "latitude": "37.77823",
          "longitude": "-122.442503"
        },
        {
          "code": "dhmn-santa-cruz",
          "identifiers": "dhin-santa-cruz|dhmn-santa-cruz",
          "url": "https://www.dignityhealth.org/dhmf/dhmn-santa-cruz",
          "title": "DHMN – Santa Cruz",
          "city": "Santa Cruz",
          "state": "CA",
          "latitude": "36.974018",
          "longitude": "-122.030952"
        },
        {
          "code": "sequoia",
          "identifiers": "dignity-health-medical-group-sequoia|sequoia",
          "url": "https://www.dignityhealth.org/bayarea/medical-group/sequoia",
          "title": "DHMG - Sequoia",
          "city": "Redwood City",
          "state": "CA",
          "latitude": "37.484169",
          "longitude": "-122.227097"
        },
        {
          "code": "sierra-nevada",
          "identifiers": "dignity-health-medical-group-sierra-nevada|sierra-nevada",
          "url": "https://www.dignityhealth.org/sacramento/medical-group/sierra-nevada",
          "title": "DHMG - Sierra Nevada",
          "city": "Grass Valley",
          "state": "CA",
          "latitude": "39.21906",
          "longitude": "-121.06106"
        },
        {
          "code": "stockton",
          "identifiers": "dignity-health-medical-group-stockton|stockton",
          "url": "https://www.dignityhealth.org/central-california/medical-group/stockton",
          "title": "DHMG - Stockton",
          "city": "Stockton",
          "state": "CA",
          "latitude": "37.953671",
          "longitude": "-121.290749"
        },
        {
          "code": "ventura",
          "identifiers": "dignity-health-medical-group-ventura-county|ventura",
          "url": "https://www.dignityhealth.org/central-coast/medical-group/ventura-county",
          "title": "DHMG - Ventura",
          "city": "Oxnard",
          "state": "CA",
          "latitude": "34.20034",
          "longitude": "-119.180443"
        },
        {
          "code": "woodland",
          "identifiers": "dignity-health-medical-foundation|woodland",
          "url": "https://www.dignityhealth.org/sacramento/medical-group/woodland-davis",
          "title": "DHMF - Woodland",
          "city": "Woodland",
          "state": "CA",
          "latitude": "38.6786109",
          "longitude": "-121.7733285"
        }
      ]
    },
    "tenant": {
      "tenantCode": "dignity-health",
      "divisionCodes": [],
      "marketCodes": []
    },
    "logoPath": {
      "dignityLogo": "https://dignity-health.cshcontentstage.org/content/dam/dignity-health/logo/dh-logo.svg"
    },
    "providerCardLogo": {
      "enabled": true
    },
    "inMyOwnWords": {
      "title": "In my own words"
    },
    "suggestAnEdit": {
      "enabled": true,
      "linkScheme": "/ourdoctors/provider/providerupdate?Npi={0}&previousPageReturnUrl="
    },
    "emergencyCare": {
      "enabled": true,
      "linkScheme": "https://www.dignityhealth.org/emergency-care"
    },
    "quickLinks": {
      "enabled": true,
      "categories": ["Video Visits", "Primary Care", "Cardiology", "Gynecology"]
    },
    "myProviders": {
      "enabled": true,
      "linkScheme": "https://www.dignityhealth.org/login?returnUrl=/my-home/myproviders"
    },
    "helplineNumbers": {
      "enabled": true,
      "heading": "Prefer to talk to someone? We're here, 24/7",
      "numbers": [
        {
          "heading": "Arizona",
          "phone": "(855) 530-6925"
        },
        {
          "heading": "California",
          "phone": "(844) 334-8371"
        },
        {
          "heading": "Nevada",
          "phone": "(855) 550-6022"
        }
      ]
    },
    "landingPage": {
      "landingPageHeader": "Find a doctor"
    },
    "errorLinks": [
      {
        "title": "Find a doctor",
        "url": "https://www.dignityhealth.org/ourdoctors"
      },
      {
        "title": "For physicians",
        "url": "https://www.dignityhealth.org/for-physicians"
      },
      {
        "title": "Patient Portal",
        "url": "https://www.dignityhealth.org/my-home/my-care-dignity-health"
      },
      {
        "title": "Emergency care",
        "url": "https://www.dignityhealth.org/emergency-care"
      },
      {
        "title": "Pay a bill",
        "url": "https://dignityhealth.mysecurebill.com"
      },
      {
        "title": "Working for Dignity Health",
        "url": "https://www.dignityhealthcareers.org"
      }
    ],
    "videoVisitsBanner": {
      "enabled": true
    },
    "guidedFlowButton": {
      "enabled": true
    },
    "placeholders": {
      "searchTerm": {
        "desktop": "Doctor’s name, specialty, procedure, or insurance",
        "tablet": "Name, specialty, insurance",
        "mobile": "Name, specialty, insurance"
      }
    },
    "sorting": {
      "default": "BestMatch",
      "showOptions": true,
      "options": [
      {
        "name": "BestMatch",
        "label": "Best match",
        "queryParam": "bestmatch",
        "value": 2
      },
      {
        "name": "Tiered",
        "label": "TBD",
        "queryParam": "tiered",
        "value": 10
      },
      {
        "name": "Distance",
        "label": "Distance",
        "queryParam": "distance",
        "value": 5
      },
      {
        "name": "LastName",
        "label": "Last name (A - Z)",
        "queryParam": "lastname",
        "value": 4
      },
      {
        "name": "LastNameInverted",
        "label": "Last name (Z - A)",
        "queryParam": "-lastname",
        "value": 99
      }
      ]
    },
    "filters": {
      "videoVisits": {
        "enabled": true
      },
      "acceptingNewPatients": {
        "enabled": true
      },
      "availability": {
        "enabled": true
      },
      "specialty": {
        "enabled": true
      },
      "medicalGroup": {
        "enabled": true
      },
      "gender": {
        "enabled": true
      },
      "insurance": {
        "enabled": true
      },
      "language": {
        "enabled": true
      },
      "searchRadius": {
        "enabled": true,
        "defaultDistance": 10,
        "defaultDistanceMedGroupFilterApplied": 25
      }
    },
    "onlineScheduling": {
      "onlineSchedulingType": "GuidedFlow",
      "docAsapProviderLookupUrl": ""
    },
    "showNewSchedulingApp": true,
    "captcha": {
      "enabled": true
    }
  },
  "theme": {
    "fonts": {
      "fontFamily": "\"trade-gothic-next\", Arial",
      "fontCssUrl": "https://use.typekit.net/dfg1mni.css"
    },
    "colors": {
      "locationPinColor": "#ed711c",
      "locationPinOutline": "#c85200",
      "locationPinLabel": "#fff"
    },
    "colorPalette": "dhcl-dignity-health"
  }
}

You can also find another example as raw JSON here.

Interfaces

This section of the JSON controls certain items like links, medical groups, and search behavior.

"search" section

Key Description Required
code Medical group code yes
identifiers Pipe-delimited alternate identifiers yes
title Title for search results heading yes
city City for the medical group no
state State for the medical group no
latitude Latitude for the medical group no
longitude Longitude for the medical group no
getToKnowContent Template of contents to put into getToKnow section of the Provider details yes
logoPath path/url to the logo for the MedGroup yes (if logo is required for medGroup)

"getToKnownContent" tokens

The getToKnowContent string can be tokeneized. Currently, the following tokens are replaced by the application:

"tenant" section

Controls tenant-specific data for API requests

Key Description Required
tenantCode Value to use for x-tenant in http request header yes
divisionCodes array of strings that are appended to provider api query
strings to limit provider data to specific divisions
no
marketCodes array of strings that are appended to provider api query
strings to limit provider data to specific markets
no

"logoPath" section: (This section will be removed in a future release, and will use logoPath in medGroups instead)

"providerCardLogo" section:

"inMyOwnWords" section:

"suggestAnEdit" section

Controls destination and appearance of the Suggest an Edit link on the provider details page.

"emergencyCare" section

Controls the destination and appearance of the Emergency Care link found below the quicklinks section on the search landing page.

Controls the terms and appearance of the quicklinks on the search landing page.

"myProviders" section

Controls the destination and appearance of the link to a user's saved providers.

"helplineNumbers" section

Controls the contact numbers and appearance of regional helpline numbers.

Key Description Required
enabled Toggles the regional helplines section on/off yes
heading Heading section for regional helplines no
numbers Array of objects, with each object having a required heading and phone section no

"landingPage" section

Array of objects that controls the helpful links that appear on the application error page. Each object has the following properties:

"videoVisitsBanner" section

Controls whether the blue CTA banner appears on the search results page to indicate that a user can refine their search based on providers who offer video visits.

"guidedFlowButton" section

Controls whether the Schedule an Appointment button launches the guided appointment booking flow or not.

"placeholders" section (added in Release 3.1.x)

Controls whether the Schedule an Appointment button launches the guided appointment booking flow or not.

"sorting" section

Controls the appearance of sorting section on the search results page.

Key Description Required
name Name of the sorting type yes
label label to be shown in the UI yes
queryParam sort value to be shown in the browser url yes
value sort number/code to be sent to the backend yes

"filters" section

Controls the appearance of filters on the search results page. Each object corresponds to the filter it controls, and has one property:

"onlineScheduling"

Key Description Required
onlineSchedulingType Must be one of the following: GuidedFlow,DocASAP, or none yes
docAsapProviderLookupUrl path to a file containing provider npi id to doc asap id if onlineSchedulingType is GuidedFlow

"showNewSchedulingApp" section:

(true/false): Use new 'GuidedFlow' scheduling app versus legacy SiteCore one. Always true in production. Set to false for QA Testing only.

captcha section

Theme

This section of the JSON controls color schemes and fonts for the application.

"fonts" section (updated in Release 3.1)

Here you can define your own custom font to be used throughout the page:

Key Description Required
fontFamily Name of the custom font you are providing yes
fontCssUrl URL of the font css file/project yes

"colors" section

Here you can define colors for google maps.

Note: All other colors come from dhcl-color palettes as defined in the component library

"colorPalette" section