Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Project settings object is used to define project specific features. It references only datasets. Also, apart from other metadata objects, there can be only one project settings object in a project.

...

This example has a projectTemplate object with settings related to project templates.

Example of a projectSettings object with trustedOrigins
Code Block
{
    "name": "project_settings_template",
    "type": "projectSettings",
    "content": {
        "geoSearchCountries": [
            "GB"
        ],
        "geoSearchProviders": [
            "Mapbox"
        ],
        "trustedOrigins": [
            "http://stories.clevermaps.io",
            "https://www.stories.clevermaps.io:443"
        ]
    }
}

This example has a trustedOrigins array with URL whitelisted for iFrame postMessage API.

Example of a projectSettings object with defaultViews
Code Block
{
    "name": "project_settings_template",
    "type": "projectSettings",
    "content": {
        "geoSearchCountries": [
            "GB"
        ],
        "geoSearchProviders": [
            "Mapbox"
        ],
        "defaultViews": [
            "/rest/projects/$projectId/md/views?name=catchment_area_view",
            "/rest/projects/$projectId/md/views?name=restaurants_rating_view"
        ]
    }
}

This example has a defaultViews array with URLs of views to be displayed in UI/dumped into project dump for all project members.

Key description

content

Key

Type

Optionality

Description

Constraints

geoSearchCountries

array

Status
colourRed
titlerequired

array of ISO 3166 alpha-2 country codes, to which the geographic search will be limited

(A-Z)

geoSearchProviders

array

Status
colourRed
titlerequired

list of geosearch providers

default = [Mapbox]

[Mapbox]

projectTemplate

object

Status
colourGreen
titleoptional

object containing settings related to project templates


trustedOrigins

array

Status
colourGreen
titleoptional

list of whitelisted URL for iFrame postMessage API. Add a URL if you want to communicate with iFrame from your page.

protocol://host.name.domain(:PORT)?

allowUnsecuredOrigins

boolean

Status
colourGreen
titleoptional

allows embedding of current project to any URL and communicate via postMessage API. Enabling this option could have a security impact, please consider security risk of this setting.

Values in

tructedOrgins

trustedOrgins are ignored once allowUnsecuredOrigins is set to true.

default = false


defaultViews

array

Status
colourGreen
titleoptional

list of views (URLs corresponding to views) to be displayed in UI/dumped into project dump for all project members

"^/rest/projects/(\\$projectId|[a-z0-9]{16})/md/views(\\?name=[a-z0-9_-]+|/[a-z0-9]+)$"

content.projectTemplate

Key

Type

Optionality

Description

Constraints

templateDatasets

array

Status
colourGreen
titleoptional

array of dataset links

size => 1

content.projectTemplate.dataset

Key

Type

Optionality

Description

Constraints

dataset

string

Status
colourGreen
titleoptional

URL link to the dataset, which will be loadable with data during custom create project

/rest/projects/$projectId/md/datasets?name={datasetName}

Visual representation

Project settings do not have a visual representation in the application.