Configuration File: chaise-config.js

Chaise uses a set of default configuration parameters. You can overwrite them through the chaise-config.js file and/or the search parameters in the URL.

A Chaise deployment includes a sample config file (chaise-config-sample.js) at the root directory that you can edit and then rename to chaise-config.js.

Each chaise config property below can be defined in each place that we allow for a chaise configuration with a few exceptions noted below. Chaise config uses a set order for determining which chaise configuration's properties will be used. The order that the properties will be checked and then applied are as follows:

Default values defined in chaise configuration document.
Any properties defined at the root of the object returned from chaise-config.js.
Any matching configRules in the order they appear in the configRules array. Properties in the last matching rule will take precedence
Any properties defined at the root of the object returned from the "tag:isrd.isi.edu,2019:chaise-config" annotation.
Step 3 from above, but with the configRules from the "tag:isrd.isi.edu,2019:chaise-config" annotation.

Notes: as the configRules are checked, properties set in step 2 will be overridden by properties defined in step 3 that have the same name. This allows the server wide configuration to be a base configuration for the chaise apps and allows for further configuration based on a combination of hostname and catalog id. This applies for step 4 and 5 as well when reading the values from the catalog annotation.

If a property appears in the same configuration twice, the property defined later will be used.

General Configuration:
Navbar Configuration:
Login Configuration:
Display Configuration:
Data Entry Configuration:
- asciiTextValidation
Export Configuration:
Share and Cite Configuration:
- resolverImplicitCatalog
- shareCite
System Columns Configuration:
System Configuration:
Other Configuration:
- footerMarkdown
- assetDownloadPolicyURL

General Configuration:

ermrestLocation

The location of the ERMrest service.

⚠️ This property is only allowed in chaise-config.js file. Defining this on the catalog annotation has no effect.

Type: String - URL
Default value: window.location.protocol + // + window.location.host + /ermrest

Sample syntax:

ermrestLocation: "www.isrd.isi.edu/ermrest"

defaultCatalog

Use this parameter to specify which catalog Chaise shows by default.

⚠️ This property is only allowed in chaise-config.js file. Defining this on the catalog annotation has no effect.

It is strongly recommended defining this in your chaise-config.js file. This property is used to fetch the catalog annotation information for pages that rely on chaise-config.js but don’t have a catalog id in the path. For example, the navbar on static pages uses this property to try to fetch a catalog annotation for configuring the navbar.

When a user navigates to “/chaise/recordset” and omits the rest of the path, the defaultCatalog paired with defaultTable are used to generate a valid recordset link for the user.

Type: String - Catalog ID
Sample syntax:
```
defaultCatalog: "1"
```

defaultTable

Use this parameter to specify which table Chaise shows by default for the current catalog.

Type: Object

General syntax:

defaultTable: {
   schema: <schema name>,
   table: <table name>
}

Sample syntax:

defaultTable: {
   schema: "isa",
   table: "dataset"
}

Navbar Configuration:

headTitle

The application name to display in the browser tab and browser history.

Type: String
Default behavior: "Chaise" will be used
Sample syntax:
```
headTitle: "Chaise development"
```

navbarBanner

Use this parameter to define banners that will be displayed on top or below the banner.

Type: Object or array of objects.
Default behavior: no banner will be shown

General syntax:

One banner:

navbarBanner: {
  markdownPattern: <markdown-pattern>,
  dismissible: <boolean>,
  position: <position>,
  key: <key-string>,
  acls: [
    show: <group-list>
  ]
}

Multiple banners:

navbarBanner: [
  {
    {
      markdownPattern: <markdown-pattern>,
      dismissible: <boolean>,
      position: <position>,
      key: <key-string>,
      acls: [
        show: <group-list>
      ]
    },
    ...
  }
]

Attributes:
- markdownPattern: String - What should be displayed in the banner. If results in an empty string, the banner will be ignored.
- dismissible: Boolean (optional) - Whether users should be able to dismiss the banner.
- position: "bottom" or "top" (optional) - By default the banner will be displayed above the navbar and using this attribute you can change that.
- key: String (optional) - Used in the class attribute that is attached to the banner using the chaise-navbar-banner-container-<key> format. For instance if the key is defined as "feedback", you can use .chaise-navbar-banner-container-feedback to refer to this banner.
- acls: Object optional - has one attribute array (show) used to define lists of globus groups or users that can see the banner. If missing, ["*"] will be used as the default. An empty array ([]) will hide the banner for everyone.

Sample syntax:

navbarBanner: {
  markdownPattern: "Let us know how you use and what you think of this data repository. [Please fill out the survey](https://survey.com)!"
}

navbarBrand

The URL for the branding logo in the top navigation bar.

Type: String - URL
Sample syntax:
```
navbarBrand: "/"
```

navbarBrandText

The value to be displayed in the navigation bar.

Type: String
Default behavior: "Chaise" will be used
Sample syntax:
```
navbarBrandText: "Chaise development"
```

navbarBrandImage

The URL for an image to be displayed in the navigation bar.

Type: String - URL
Sample syntax:
```
navbarBrandImage: "/path/to/logo.png"
```

navbarMenu

Use this parameter to customize the menu items displayed in the navbar at the top of all Chaise apps by supplying an object with your links and/or dropdown menus. Consult the chaise-config-sample.js file for more details about format.

Type: Object

General syntax:

navbarMenu: {
  acls: { show: [], enable:[] },
  newTab: <true|false>,
  children: [
    {
      nameMarkdownPattern: <pattern>,
      urlPattern: <pattern>,
      type: <menu|url|header>,
      children: [ <menuOption>, ... ],
      acls: { show: [], enable:[] },
      newTab: <true|false>
    },
    <menuOption>,
    ...
  ],
}

navbarMenu attributes
- acls: Object optional - has two attribute arrays ('show' and 'enable') used to define lists of globus groups or users that can see and click that link. Define this property here in navbarMenu to have all children and children of children inherit the same link functionality. If either array, show or enable, or both are missing, ["*"] will be used as the default. An empty array ([]) will hide the link or disable it for everyone
- newTab: Boolean optional - set to true to open the link in a new tab. Define this property here in navbarMenu to have all children and children of children inherit the same link functionality. If undefined at root, newTab is treated as true.
- children: Array - used to specify dropdowns, you can nest as many dropdowns as you need.
menuOption attributes
- type: String - set the type of the menu option to change how it is displayed. Types include: menu, url, header. More info for each type can be found below.
- nameMarkdownPattern: String required - label of the menu item. Will be computed by performing Pattern Expansion on the pattern to obtain a markdown-formatted text value which will be rendered using a markdown renderer.
  - name (DEPRECATED): use nameMarkdownPattern instead
  - markdownName (DEPRECATED): use nameMarkdownPattern instead
- urlPattern: String - this menu item's url. URLs can be absolute or relative to the document root. URLs support templating primarily for catalog substition.
  - url (DEPRECATED): use urlPattern instead
- children: Array - used to specify dropdowns, you can nest as many dropdowns as you need.
- acls: Object optional - has two attribute arrays ('show' and 'enable') used to define lists of globus groups or users that can see and click that link. Follows the same rules for defaults defined above.
- newTab: Boolean optional - set to true to open the link in a new tab. Each child menu item checks for a newTab property on itself, if nothing is set, the child inherits from it's parent. - header (DEPRECATED): use type = header instead
Values allowed for type attribute
- menu: display the menu item with a sub menu. Valid if children Array is defined and length is greater than 0.
- url: display the menu item as a url link. Valid if urlPattern evaluates into a non null value
- header: display the menu item as an unclickable header with bold text

Sample syntax:

navbarMenu: {
    newTab: false,
    children: [
        {"name": "Search","children": [
            {"name": "Gene Expression Data", "children": [
                {"name": "Genes", "url": "/chaise/recordset/#2/Common:Gene"},
                {"name": "Sequencing Data (GUDMAP pre-2018)", "children": [
                    {"name": "Series", "url": "/chaise/recordset/#2/Legacy_RNASeq:Series"},
                    {"name": "Samples", "url": "/chaise/recordset/#2/Legacy_RNASeq:Sample"},
                    {"name": "Protocols", "url": "/chaise/recordset/#2/Legacy_RNASeq:Protocol"}
                ]},
                {"name": "Specimens", "url": "/chaise/recordset/#2/Gene_Expression:Specimen"}
            ]},
            {"name": "Cell & Animal Models", "children": [
                {"name": "Parental Cell Lines", "url": "/chaise/recordset/#2/Cell_Line:Parental_Cell_Line"},
                {"name": "Mouse Strains", "url": "/chaise/recordset/#2/Cell_Line:Mouse_Strain"}
            ]}
        ]},
        {"name": "Create", "children": [
            {"name": "Protocol", "children": [
                {"name": "Protocol", "url": "/chaise/recordedit/#2/Protocol:Protocol"},
                {"name": "Subject", "url": "/chaise/recordedit/#2/Protocol:Subject"},
                {"name": "Keyword", "url": "/chaise/recordedit/#2/Vocabulary:Keyword"}
            ]}
        ]},
        {"name": "Help", "children": [
            {"name": "Using the Data Browser", "url": "https://github.com/informatics-isi-edu/gudmap-rbk/wiki/Using-the-GUDMAP-RBK-Data-Browser"},
            {"name": "Submitting Data", "url": "https://github.com/informatics-isi-edu/gudmap-rbk/wiki"},
            {"name": "Create Citable Datasets", "url": "https://github.com/informatics-isi-edu/gudmap-rbk/wiki/Create-citable-datasets"},
            {"name": "Cite Consortium Data", "url": "/about/usage.html"}
        ]}
    ]
}

Login Configuration:

logoutURL

The URL to the logout page, root if not defined.

Type: String - URL
Default behavior: assumed that the logout page is at the root
Sample syntax:
```
logoutURL: "/"
```

dataBrowser

The URL to continue after a logout. Also used when an error is thrown and we don't know where to redirect the user.

Type: String - URL
Default behavior: navigate the user to the root of the server (homepage) on logout
Sample syntax:
```
dataBrowser: "/"
```

signUpURL

Use this parameter to specify what the "Sign Up" link in the navbar should link to. If signUpURL is unspecified, the navbar will not display a "Sign Up" link.

Type: String - URL
Default behavior: no signup link will be shown
Sample syntax:
```
signUpURL: "<your-url>"
```

termsAndConditionsConfig

Use this property to enforce joining a globus group before continuing use of the application as a logged in user. This config property defaults to null when undefined. If the property is not an object containing all of the above 3 properties, this will be set to null.

Type: Object
Default behavior: group inclusion check won't be enforced to continue login

General syntax:

termsAndConditionsConfig: {
   groupId: <url>,
   joinUrl: <url>,
   groupName: <group displayname>
}

termsAndConditionsConfig attributes
- groupId: String - the identifier to the group (looks like a URL for globus groups, see example below)
- joinUrl: String - URL to the join the required group
- groupName: String - the name of the group as it appears in globus

Sample syntax:

termsAndConditionsConfig: {
   groupId: "https://auth.globus.org/962d5add-ff9a-11eb-8932-d71f8cc57c67",
   joinUrl: "https://app.globus.org/groups/962d5add-ff9a-11eb-8932-d71f8cc57c67/join",
   groupName: "Josh test group"
}

loggedInMenu

Use this parameter to customize the menu items displayed in the navbar under the login dropdown after a user has logged into the system by supplying an object with your links and/or dropdown menus.

Type: Object
Default behavior: The user's full name will be shown. Upon clicking, a dropdown menu will appear with a "My Profile" link that opens a modal popup to see information about the logged in user. The other dropdown menu option will be "Logout".

General syntax:

loggedInMenu: {
  displayNameMarkdownPattern: <pattern>,
  menuOptions: [
    {
      nameMarkdownPattern: <pattern>,
      urlPattern: <pattern>,
      type: <menu|url|header|my_profile|logout>,
      children: [ <menuOption>, ... ],
      acls: { show: [], enable:[] },
      newTab: <true|false>
    },
    <menuOption>,
    ...
  ] || <menuOption>,
  acls: { show: [], enable:[] },
  newTab: <true|false>
}

loggedInMenu attributes:
- menuOptions: Array || Object - If defined as an Array, the array replaces the dropdown menu with the listed menuOption objects. Each menuOption is required to have a nameMarkdownPattern defined and should have a type defined to properly display the option. If no type is defined, the type will try to be inferred by checking for children or urlPattern. If both are defined, children is preferred and the type is set to menu. If defined as an Object, the Object is assumed to be a menuOption and will be used to replace the display and dropdown functionality. The same types listed below are allowed except for the menu type.
- displayNameMarkdownPattern: String optional - The visual presentation of the login display in the right hand corner of the navigation bar. Will be computed by performing Pattern Expansion on the pattern to obtain a markdown-formatted text value which will be rendered using a markdown renderer.
- acls: Object optional - has two attribute arrays ('show' and 'enable') used to define lists of globus groups or users that can see and click the links in the dropdown menu. Define this property here in loggedInMenu to have all children and children of children inherit the same link functionality. If either array, show or enable, or both are missing, ["*"] will be used as the default. An empty array ([]) will hide the link or disable it for everyone
- newTab: Boolean optional - set to true to have links in the dropdown menu open in a new tab. Define this property here in loggedInMenu to have all children and children of children inherit the same link functionality. If undefined at root, newTab is treated as true.
menuOption attributes
- type: String - set the type of the menu option to change how it is displayed. Types include: menu, url, header, my_profile, logout. More info for each type can be found below.
- nameMarkdownPattern: String required - label of the menu item. Will be computed by performing Pattern Expansion on the pattern to obtain a markdown-formatted text value which will be rendered using a markdown renderer. Replaces the name and markdownName properties defined for navbarMenu.
- urlPattern: String - this menu item's url. URLs can be absolute or relative to the document root. URLs support templating primarily for catalog substition. Replaces the url property of navbarMenu.
- children: Array - used to specify dropdowns, you can nest as many dropdowns as you need.
- acls: Object optional - has two attribute arrays ('show' and 'enable') used to define lists of globus groups or users that can see and click that link. Follows the same rules for defaults defined above.
- newTab: Boolean optional - set to true to open the link in a new tab. Each child menu item checks for a newTab property on itself, if nothing is set, the child inherits from it's parent.
Values allowed for type attribute
- menu: display the menu item with a sub menu. Valid if children Array is defined and length is greater than 0.
- url: display the menu item as a url link. Valid if urlPattern evaluates into a non null value
- header: display the menu item as an unclickable header with bold text
- my_profile: display the existing "My Profile" menu item that opens the profile modal. If not defined in the list, "My Profile" menu item will not be shown
- logout: display the existing "Log Out" menu item that logs the user out. If not defined in the list, the "Log Out" menu item will not be shown

Sample syntax:

loggedInMenu: {
  menuOptions: [
    { nameMarkdownPattern: "User Profile", type: "my_profile" },
    { nameMarkdownPattern: "CFDE User Profile", type: "url", urlPattern: "/chaise/record/#registry/CFDE:user_profile/id={{#encode $session.id}}{{/encode}}" },
    { nameMarkdownPattern: "Logout", type: "logout" }
  ],
  displayNameMarkdownPattern: "{{$session.display_name}}"
}

Display Configuration:

customCSS

The URL for a style sheet file to be applied to the application header (<head> tag). This is typically a relative URL to a dedicated stylesheet in the CSS folder of the related static site repo (For example, in RBK, it's /assets/css/chaise.css in the rbk-www repo). More information can be found here.

Type: String - URL
Sample syntax:
```
customCSS: "/assets/css/chaise.css"
```

maxRecordsetRowHeight

Set this property to false if you don't want content to be clipped in tables else set it to a number which represents the maximum row height when not expanded.

Type: Boolean || Number
Default behavior: 160 will be used if no value is supplied
Sample syntax:
```
maxRecordsetRowHeight: 200
```

confirmDelete

If false, the user will not be prompted by a modal when deleting an item

Type: Boolean
Default behavior: user will be prompted with a dialog to confirm they want to delete
Sample syntax:
```
confirmDelete: false
```

editRecord

If present and equal to false, the chaise pages will hide all the edit and create buttons regardless of user ACLs. Chaise will also disallow users from accessing recordedit app in this case.

Type: Boolean
Default behavior: Allows for inserting and editing records through the recordedit page if the user has proper ACLs.
Sample syntax:
```
editRecord: false
```

deleteRecord

If present and equal to false, the chaise pages will hide all the delete buttons regardless of user ACLs. Otherwise chaise will consult the user ACL for conditonally hiding or showing delete buttons.

Type: Boolean
Default behavior: Chaise pages display delete buttons based on user ACLs.
Sample syntax:
```
deleteRecord: false
```

allowErrorDismissal

Set this property to true if you want to allow dismissable error message dialogs. This property when defined as true will cause a degraded UX experience that will prevent future errors from being thrown and other functionality might not behave as expected. This should ONLY be used in development environments.

Type: Boolean
Default behavior: All terminal error message display an error message dialog that is not dismissable
Sample syntax:
```
allowErrorDismissal: true
```

showWriterEmptyRelatedOnLoad

This property only applies to users with write permission to the main record being viewed. Set to false to hide all empty related tables on record page load ignoring the heuristics defined for writers. Set to true to show all empty related tables on record page load ignoring the heuristics.

Type: Boolean
Default behavior: the heuristics to show empty related tables based on the user being able to write to at least one of them will be used
Sample syntax:
```
showWriterEmptyRelatedOnLoad: false
```

hideTableOfContents

If true, hides the table of contents panel on the record app.

Type: Boolean
Default behavior: table of contents will be visible
Sample syntax:
```
hideTableOfContents: true
```

disableExternalLinkModal

Set this to true to disable the external link notification.

Type: Boolean
Default behavior: a notification that you are navigating to an external page in 5 seconds will show
Sample syntax:
```
disableExternalLinkModal: true
```

hideGoToRID

Use this property to hide the RID search box in the navbar. The RID search box is present in the navbar when resolverImplicitCatalog !== null (meaning the resolver is in use) and hideGoToRID !== true

Type: Boolean
Default behavior: the RID search box will show in the navbar to the left of the login button or the logged in user information
Sample syntax:
```
hideGoToRID: true
```

facetPanelDisplay

Use this property to change the settings related to the facet panel.

Type: Object
Default behavior: The facet panel will be displayed for all tables. It will be opened in the compact context (recordset app) and closed in all other subcontexts.

General syntax:

facetPanelDisplay: {
    open: [_context_],
    closed: [_context_],
    maxFacetDepth: number
}

Attributes:
- open: An array of contexts that the facet panel should be open for on page load. Since facet panels are displayed on context and subcontexts associated with compact, only these annotations would be appropriate here. * may be used but will be treated the same as compact. If a context is present in both open and closed, open will take priority. If the current context is not mentioned in either open or closed, it will try to inherit its value from a parent context. Defining only one array, open or closed, will assume the other property is equal to [].
- closed: An array of contexts that the facet panel should be closed for on page load.
- maxFacetDepth: A number indicating how many levels of facets we should allow. The following are the acceptable values:
  - 0: disable the faceting feature.
  - 1: The default behavior. Facet panel is displayed on the initial recordset page or recordset popups. But it's not offered on the facet popups.
  - 2: Facet panel is displayed on the initial recordset page or recordset popups. It's also displayed on the facet popups.
  - 2+: Not allowed for now, as we think allowing more facets would confuse the users. When we encounter this value, we will use the maximum we support (2).

Sample syntax:

facetPanelDisplay: {
    open: ["compact/select/association"],
    maxFacetDepth: 2
}

templating

Use this property to change the default engine that is used for templating throughout chaise and ermrestjs.

Type: Object
Default behavior: mustache will be used as the default template engine.

General syntax:

templating: {
    engine: 'handlebars' or 'mustache'
}

templating attributes:
- engine: The template engine used in ermrestjs.

Sample syntax:

templating: {
    engine: 'handlebars'
}

hideRecordeditLeaveAlert

Use this property to avoid recordedit app from showing an alert when users are trying to navigate away.

Type: Boolean
Default behavior: Recordedit app will warn users when they are about to navigate away from recordedit to preserve the editted content.
Sample syntax:
```
hideRecordeditLeaveAlert: true
```

Data Entry Configuration:

asciiTextValidation

Use this proprety to ensure users can only use ASCII characters while entering text values in the recordedit app.

⚠️ This is just a client-side validation and only affects the inputs in the recordedit app.

Type: Boolean
Default behavior: Users can use any characters while entering values in the recordedit app.
Sample syntax:
```
asciiTextValidation: true
```

Export Configuration:

disableDefaultExport

When the export annotation is missing from table and schema, ermrestjs will use the heuristics to generate a default export template. Set this attribute to true to avoid using the heuristics.

Type: Boolean
Default behavior: ermrestjs will use the heuristics to generate a default export template
Sample syntax:
```
disableDefaultExport: true
```

exportServicePath

You can use this variable to switch between different export services that might be available in the deployment.

Type: String
Default behavior: "/deriva/export/" will be used as the defailt path
Sample syntax:
```
exportServicePath: "/deriva/export/"
```

exportConfigsSubmenu

Use this property to modify the display setting for the "Configurations" submenu in the export menu. This option would allow users to download the raw config file that is used for communicating with export service.

Type: Object
- Default behavior: the "Configurations" submenu is not displayed.
- Sample syntax:
```
"exportConfigsSubmenu": {
 "acls": {
   "show": ["*"],
   "enable": ["*"]
 }
}
```
- Attributes:
  - acls: Object optional - has two attribute arrays ('show' and 'enable') used to define lists of globus groups or users that can see and open the "Configurations" submenu.
    - If either array, show or enable, or both are missing, ["*"] will be used as the default.
    - An empty array ([]) will hide the option or disable it for everyone

Share and Cite Configuration:

resolverImplicitCatalog

Set to a catalog id, N, if your resolver accepts /id/X instead of /id/N/X and you prefer to share records with this shorter URL. If the property is null, the resolver functionality will be turned off and the default permalink will be used. Anything else will be ignored and the default behavior will be applied which is to always use the catalog-qualified form, /id/N/X.

Type: String || null
Default behavior: assume the resolver service uses the catalog-qualified form, /id/N/X
Sample syntax:
```
resolverImplicitCatalog: "1"
```

shareCite

Use this property to modify the display settings for the "share and cite" button and dialog on Record app.

Type: Object
Default behavior: the share and cite button is viewable and enabled for everyone

Sample syntax:

"shareCite": {
 "acls": {
   "show": ["*"],
   "enable": ["*"]
 }
}

Attributes:
- acls: Object optional - has two attribute arrays ('show' and 'enable') used to define lists of globus groups or users that can see and click on the share and cite button.
  - If either array, show or enable, or both are missing, ["*"] will be used as the default.
  - An empty array ([]) will hide the button or disable it for everyone.

System Columns Configuration:

systemColumnsDisplayCompact

If set to true, apply the system columns heuristics when no visible columns list is defined. This will put the RID system column as the first self referencing key column. 'RCB', 'RMB', 'RCT', 'RMT' will be placed at the very end of the list respectively. If set to an array, only system columns in the array will be displayed in the order mentioned earlier. Defining this property as [] will hide all system columns. Setting to false will fall back to the default behavior. This applies to compact and all subcontexts.

Type: Boolean || Array
Default behavior: system columns will be displayed based on how ermrest returns the set of all columns

Sample syntax:

systemColumnsDisplayCompact: ["RMB", "RMT"]

systemColumnsDisplayDetailed

See above description for systemColumnsDisplayCompact. This property behaves the same way except only for the detailed context.

Type: Boolean || Array
Default behavior: system columns will be displayed based on how ermrest returns the set of all columns
Sample syntax:
```
systemColumnsDisplayDetailed: true
```

systemColumnsDisplayEntry

See above description for systemColumnsDisplayCompact. This property behaves the same way except only for the entry contexts.

Type: Boolean || Array
Default behavior: system columns will be displayed based on how ermrest returns the set of all columns

Sample syntax:

systemColumnsDisplayEntry: ["RMT", "RCT"]

System Configuration:

internalHosts

If external link notification is enabled, Chaise will use this array to determine whether the current host is external. List any hostnames that should be considered internal. If defined, <current hostname> will not be automatically added to the list.

Type: Array
Default behavior: the current hostname will be treated as an internal host

Sample syntax:

internaleHosts: ["dev.rebuildingakidney.org", "dev.gudmap.org"]

includeCanonicalTag

This variable can be used to force chaise to include a tag in the tag that defines the canonical link for each of the entities and other resource pages.

Type: Boolean
Default behavior: canonical tag will not be included
Sample syntax:
```
includeCanonicalTag: true
```

logClientActions

Set this to false to disable the logging of client side actions which occurs when users interact with the app in ways that don't generate a request to the database.

Type: Boolean
Default behavior: client actions that don't normally interact with the database will be logged
Sample syntax:
```
logClientActions: false
```

configRules

Allows for host specific configuration rules. Each object in the array contains 2 properties, host and config. host is expected to be in the format of a single string value or an array of string values. host is being matched against the hostname for the current browser location. config mimics the chaise-config properties. All chaise config properties can be defined in this block except this property (configRules).

Type: Array

General syntax:

configRules: [
  {
    host: <host url> || [<host url>, <host url>],
    config: {}
  },
  { ... },
  ...
]

Sample syntax:

configRules: [
    {
        host: ["www.rebuildingakidney.org", "staging.rebuildingakidney.org", "dev.rebuildingakidney.org"],
        config: {
            headTitle: "RBK",
            navbarBrand: "/resources/"
        }
    }, {
        host: ["www.gudmap.org", "staging.gudmap.org", "dev.gudmap.org"],
        config: {
            headTitle: "GUDMAP",
            navbarBrand: "/"
        }
    }
]

savedQueryConfig

Use this property to define the path to the saved query table for the saved query feature. The storageTable is required to be an object with 4 properties, catalog, schema, table, and columnNameMapping. This config property defaults to null when undefined. If savedQueryConfig is not an object with an object containing all of the above 3 properties, this will be set to null. The defaultName object has 3 properties that can be defined to change when a simplified default name syntax is applied.

Type: Object
Default behavior: the saved query feature will be turned off

General syntax:

savedQueryConfig: {
  storageTable: {
    catalog: <catalog id>,
    schema: <schema name>,
    table: <table name>,
    columnNameMapping: {
      catalog: <string>,
      schemaName: <string>,
      tableName: <string>,
      userId: <string>,
      queryId: <string>,
      queryName: <string>,
      description: <string>,
      facets: <string>,
      encodedFacets: <string>,
      lastExecutionTime: <string>
    }
  },
  defaultName: {
      facetChoiceLimit: <int>,
      facetTextLimit: <int>,
      totalTextLimit: <int>,
  },
}

storageTable attributes
- catalog: String - catalog id where the saved query table is
- schema: String - schema name in above catalog where below table is stored
- table: String - table name for saving queries to
- columnNameMapping: Object - all attributes are required for saved query functionality to work properly. These are the column names in the model that the data will be stored to. The columns require specific types: description as longtext | markdown, facets as jsonb, encodedFacets as longtext, lastExecutionTime as timestamp[tz], and all others are type text
defaultName attributes
- facetChoiceLimit: Set this value to define when to show a compressed facet syntax based on how many choices are selected. By default this value is 5. Set this to 0 to always show the compressed syntax.
- facetTextLimit: Set this value to define when to show a compressed facet syntax based on the total string length of the facet choices when appended together. By default this value is 60. Set this to 0 to always show the compressed syntax.
- totalTextLimit: Set this value to define when to show a shortened facet syntax based on the total string length of all facets text when appended together. By default this value is 200. Set this to 0 to always show the further shortened syntax.

Sample syntax:

savedQueryConfig: {
   storageTable: {
       catalog: "73448",
       schema: "faceting",
       table: "saved_query",
       columnNameMapping: {
         queryId: "query_id",
         catalog: "catalog",
         schemaName: "schema_name",
         tableName: "table_name",
         userId: "user_id",
         queryName: "name",
         description: "description",
         facets: "facets",
         encodedFacets: "encoded_facets",
         lastExecutionTime: "last_execution_time"
       }
   },
   defaultName: {
       facetChoiceLimit: 2,
       facetTextLimit: 40,
       totalTextLimit: 150,
   }
}

Other Configuration:

footerMarkdown

If present, it creates a footer at the bottom of the app with the markdown text.

Type: String
Default behavior: no footer will be shown

Sample syntax:

footerMarkdown: "* Please check [Privacy Policy](/privacy-policy/){target='_blank'}"

assetDownloadPolicyURL

Set this property to the url that points to the download policy for when an asset is fetched but the user is unauthorized to fetch that asset.

Type: String - URL
Default behavior: no asset policy link will be shown in the error modal
Sample syntax:
```
assetDownloadPolicyURL: "<your url>"
```

Files

chaise-config.md

Latest commit

History

chaise-config.md

File metadata and controls

Configuration File: chaise-config.js

Table of Contents:

General Configuration:

ermrestLocation

defaultCatalog

defaultTable

Navbar Configuration:

headTitle

navbarBanner

navbarBrand

navbarBrandText

navbarBrandImage

navbarMenu

Login Configuration:

logoutURL

dataBrowser

signUpURL

termsAndConditionsConfig

loggedInMenu

Display Configuration:

customCSS

maxRecordsetRowHeight

confirmDelete

editRecord

deleteRecord

allowErrorDismissal

showWriterEmptyRelatedOnLoad

hideTableOfContents

disableExternalLinkModal

hideGoToRID

facetPanelDisplay

templating

hideRecordeditLeaveAlert

Data Entry Configuration:

asciiTextValidation

Export Configuration:

disableDefaultExport

exportServicePath

exportConfigsSubmenu

Share and Cite Configuration:

resolverImplicitCatalog

shareCite

System Columns Configuration:

systemColumnsDisplayCompact

systemColumnsDisplayDetailed

systemColumnsDisplayEntry

System Configuration:

internalHosts

includeCanonicalTag

logClientActions

configRules

savedQueryConfig

Other Configuration:

footerMarkdown

assetDownloadPolicyURL