SocrataCatalogGroup

SocrataCatalogGroup

new SocrataCatalogGroup(terria)

Source:

A CatalogGroup representing a collection of layers from a Socrata server. Only spatial layers with a defined Map visualisation are shown, using WMS.

Parameters:
Name Type Description
terria Terria

The Terria instance.

Extends

Members

(static) defaultSerializers :Object

Source:

Gets or sets the set of default serializer functions to use in CatalogMember#serializeToJson. Types derived from this type should expose this instance - cloned and modified if necesary - through their CatalogMember#serializers property.

Type:
  • Object

(static) defaultUpdaters :Object

Source:

Gets or sets the set of default updater functions to use in CatalogMember#updateFromJson. Types derived from this type should expose this instance - cloned and modified if necesary - through their CatalogMember#updaters property.

Type:
  • Object

_memoizedInfoItemsSourceLookup

Source:
Inherited From:

Lookup table for _sourceInfoItemNames, access through CatalogMember#_infoItemsWithSourceInfoLookup

cacheDuration :String

Source:
Inherited From:

Gets or sets the cache duration to use for proxied URLs for this catalog member. If undefined, proxied URLs are effectively cachable forever. The duration is expressed as a Varnish-like duration string, such as '1d' (one day) or '10000s' (ten thousand seconds).

Type:
  • String

customProperties :Object

Source:
Inherited From:

Gets or sets the dictionary of custom item properties. This property is observable.

Type:
  • Object

dataCustodian :String

Source:

Gets or sets a description of the custodian of the data sources in this group. This property is an HTML string that must be sanitized before display to the user. This property is observable.

Type:
  • String

description :String

Source:
Inherited From:

Gets or sets the description of the item. This property is observable.

Type:
  • String

filterQuery :Array.<String>

Source:

Gets or sets the filter query to pass to Socrata when querying the available data sources and their groups. Each string in the array is passed to Socrata as an independent search string and the results are concatenated to create the complete list.

Type:
  • Array.<String>

forceProxy :Boolean

Source:
Inherited From:

Gets or sets whether or not this member should be forced to use a proxy. This property is not observable.

Type:
  • Boolean

groupBy :String

Source:

Gets or sets a value indicating how datasets should be grouped. Valid values are:

  • none - Datasets are put in a flat list; they are not grouped at all.
  • category - Datasets are grouped according to their category in Socrata.
Type:
  • String

hasDescription :Boolean

Source:
Inherited From:

Tests whether a description is available, either in the 'description' property or as a member of the 'info' array.

Type:
  • Boolean

hideSource :boolean

Source:
Inherited From:

Indicates that the source of this data should be hidden from the UI (obviously this isn't super-secure as you can just look at the network requests).

Type:
  • boolean

id :String

Source:
Inherited From:

An optional unique id for this member, that is stable across renames and moves. Use uniqueId to get the canonical unique id for this CatalogMember, which is present even if there is no id.

Type:
  • String

info :Array.<Object>

Source:
Inherited From:
Default Value:
  • []

Gets or sets the array of section titles and contents for display in the layer info panel. In future this may replace 'description' above - this list should not contain sections named 'description' or 'Description' if the 'description' property is also set as both will be displayed. The object is of the form {name:string, content:string}. Content will be rendered as Markdown with HTML. This property is observable.

Type:
  • Array.<Object>

infoSectionOrder :Array.<String>

Source:
Inherited From:

Gets or sets the array of section titles definining the display order of info sections. If this property is not defined, DataPreviewSections's DEFAULT_SECTION_ORDER is used. This property is observable.

Type:
  • Array.<String>

initialMessage :Object

Source:
Inherited From:

A message object that is presented to the user when an item or group is initially clicked The object is of the form {title:string, content:string, key: string, confirmation: boolean, confirmText: string, width: number, height: number}. This property is observable.

Type:
  • Object

isGroup :Boolean

Source:
Inherited From:

Gets a value that tells the UI whether this is a group. Groups, when clicked, expand to show their constituent items.

Type:
  • Boolean

isHidden :Boolean

Source:
Inherited From:
Default Value:
  • false

Gets or sets a value indicating whether this item is hidden from the catalog. This property is observable.

Type:
  • Boolean

isOpen :Boolean

Source:
Inherited From:

Gets or sets a value indicating whether the group is currently expanded and showing its children. This property is observable.

Type:
  • Boolean

isPromoted :Boolean

Source:
Inherited From:
Default Value:
  • false

Gets or sets a value indicating whether this item is kept above other non-promoted items. This property is observable.

Type:
  • Boolean

isUserSupplied :Boolean

Source:
Inherited From:
Default Value:
  • true

Gets or sets a value indicating whether this member was supplied by the user rather than loaded from one of the Terria#initSources. User-supplied members must be serialized completely when, for example, serializing enabled members for sharing. This property is observable.

Type:
  • Boolean

isWaitingForDisclaimer :boolean

Source:
Inherited From:

Whether this catalog member is waiting for a disclaimer to be accepted before showing itself.

Type:
  • boolean

items :Array.<CatalogMember>

Source:
Inherited From:

Gets the collection of items in this group. This property is observable.

Type:

name :String

Source:
Inherited From:

Gets or sets the name of the item. This property is observable.

Type:
  • String

nameInCatalog :String

Source:
Inherited From:

Gets or sets the name of this catalog member in the catalog. By default this is just name, but can be overridden.

Type:
  • String

parent :CatalogGroup

Source:
Inherited From:

The parent CatalogGroup of this member.

Type:

path :String

Source:
Inherited From:

The complete path of this member's location.

Type:
  • String

preserveOrder

Source:
Inherited From:

Gets or sets flag to prevent items in group being sorted. Subgroups will still sort unless their own preserveOrder flag is set. The value of this property only has an effect during {@CatalogGroup#load} and {@CatalogItem#updateFromJson}.

propertiesForSharing :Array.<String>

Source:
Inherited From:

Gets the set of names of the properties to be serialized for this object for a share link.

Type:
  • Array.<String>

serializers :Object

Source:
Overrides:

Gets the set of functions used to serialize individual properties in CatalogMember#serializeToJson. When a property name on the model matches the name of a property in the serializers object literal, the value will be called as a function and passed a reference to the model, a reference to the destination JSON object literal, and the name of the property.

Type:
  • Object

shareKeys :Array.<String>

Source:
Inherited From:

An array of all possible keys that can be used to match to this catalog member when specified in a share link - used for maintaining backwards compatibility when adding or changing CatalogMember#id.

Type:
  • Array.<String>

shortReport :String

Source:
Inherited From:

A short report to show on the now viewing tab. This property is observable.

Type:
  • String

shortReportSections :Array.<ShortReportSection>

Source:
Inherited From:

The list of collapsible sections of the short report. Each element of the array is an object literal with a name and content property.

Type:
  • Array.<ShortReportSection>

terria :Terria

Source:
Inherited From:

Gets the Terria instance.

Type:

type :String

Source:
Overrides:

Gets the type of data member represented by this instance.

Type:
  • String

typeName :String

Source:
Overrides:

Gets a human-readable name for this type of data source, such as 'Web Map Service (WMS)'.

Type:
  • String

uniqueId :String

Source:
Inherited From:

The canonical unique id for this CatalogMember. Will be the id property if one is present, otherwise it will fall back to the uniqueId of this item's parent + this item's name. This means that if no id is set anywhere up the tree, the uniqueId will be a complete path of this member's location.

Type:
  • String

updaters :Object

Source:
Overrides:

Gets the set of functions used to update individual properties in CatalogMember#updateFromJson. When a property name in the returned object literal matches the name of a property on this instance, the value will be called as a function and passed a reference to this instance, a reference to the source JSON object literal, and the name of the property.

Type:
  • Object

url :String

Source:

Gets or sets the URL of the Socrata server. This property is observable.

Type:
  • String

Methods

(protected) _getValuesThatInfluenceLoad() → {Array}

Source:
Overrides:

When implemented in a derived class, gets an array containing the current value of all properties that influence this group's load process. See CatalogGroup#load for more information on when and how this is used. The base class implementation returns an empty array.

Returns:

The array of values that influence the load process.

Type
Array

(protected) _load() → {Promise}

Source:
Overrides:

When implemented in a derived class, this method loads the group. The base class implementation does nothing. This method should not be called directly; call CatalogGroup#load instead.

Returns:

A promise that resolves when the load is complete.

Type
Promise

add(item)

Source:
Inherited From:

Adds an item or group to this group.

Parameters:
Name Type Description
item CatalogMember

The item to add.

connectsWithRoot()

Source:
Inherited From:

Goes up the hierarchy and determines if this CatalogMember is connected with the root in terria.catalog, or whether it's part of a disconnected sub-tree.

enableWithParents()

Source:
Inherited From:

"Enables" this catalog member in a way that makes sense for its implementation (e.g. isEnabled for items, isOpen for groups, and all its parents and ancestors in the tree.

findFirstItemByName(name) → {CatalogMember}

Source:
Inherited From:

Finds the first item in this group that has the given name. The search is case-sensitive.

Instead of using this function, consider using Catalog#shareKeyIndex to look the item up, as this works in constant time and allows lookups to continue working for items that have been renamed or moved as long as they have a stable shareKey set. This function is retained mainly for backwards-compatibility with existing share links that used names for matching.

Parameters:
Name Type Description
name String

The name of the item to find.

Returns:

The first item with the given name, or undefined if no item with that name exists.

Type
CatalogMember

findInfoSection(sectionName) → {Object}

Source:
Inherited From:

Finds an CatalogMember#info section by name.

Parameters:
Name Type Description
sectionName String

The name of the section to find.

Returns:

The section, or undefined if no section with that name exists.

Type
Object

load() → {Promise}

Source:
Inherited From:

Loads the contents of this group, if the contents are not already loaded. It is safe to call this method multiple times. The CatalogGroup#isLoading flag will be set while the load is in progress. Derived classes should implement CatalogGroup#_load to perform the actual loading for the group. Derived classes may optionally implement CatalogGroup#_getValuesThatInfluenceLoad to provide an array containing the current value of all properties that influence this group's load process. Each time that CatalogGroup#load is invoked, these values are checked against the list of values returned last time, and CatalogGroup#_load is invoked again if they are different. If CatalogGroup#_getValuesThatInfluenceLoad is undefined or returns an empty array, CatalogGroup#_load will only be invoked once, no matter how many times CatalogGroup#load is invoked.

Returns:

A promise that resolves when the load is complete, or undefined if the group is already loaded.

Type
Promise

remove(item)

Source:
Inherited From:

Removes an item or group from this group.

Parameters:
Name Type Description
item CatalogMember

The item to remove.

serializeToJson(optionsopt) → {Object}

Source:
Inherited From:

Serializes the data item to JSON.

Parameters:
Name Type Attributes Description
options Object <optional>

Object with the following properties:

Properties
Name Type Attributes Description
propertyFilter function <optional>

Filter function that will be executed to determine whether a property should be serialized.

itemFilter function <optional>

Filter function that will be executed for each item in a group to determine whether that item should be serialized.

Returns:

The serialized JSON object-literal.

Type
Object

sortFunction()

Source:
Inherited From:

Gets or sets the function to be used when sorting the group's items. This function takes two CatalogItem parameters and should return a negative, zero, or positive value depending on the order in which they should be sorted.

sortItems(sortRecursivelyopt)

Source:
Inherited From:

Sorts the items in this group.

Parameters:
Name Type Attributes Default Description
sortRecursively Boolean <optional>
false

true to sort the items in sub-groups as well; false to sort only the items in this group.

toggleOpen()

Source:
Inherited From:

Toggles the CatalogGroup#isOpen property of this group. If it is open, calling this method will close it. If it is closed, calling this method will open it.

updateFromJson(json, optionsopt) → {Promise}

Source:
Inherited From:

Updates the catalog member from a JSON object-literal description of it. Existing collections with the same name as a collection in the JSON description are updated. If the description contains a collection with a name that does not yet exist, it is created. Because parts of the update may happen asynchronously, this method returns at Promise that will resolve when the update is completely done.

Parameters:
Name Type Attributes Description
json Object

The JSON description. The JSON should be in the form of an object literal, not a string.

options Object <optional>

Object with the following properties:

Properties
Name Type Attributes Description
onlyUpdateExistingItems Boolean <optional>

true to only update existing items and never create new ones, or false is new items may be created by this update.

isUserSupplied Boolean <optional>

If specified, sets the CatalogMember#isUserSupplied property of updated catalog members to the given value. If not specified, the property is left unchanged.

Returns:

A promise that resolves when the update is complete.

Type
Promise