UNPKG

terriajs

Version:

Geospatial data visualization platform.

3,391 lines (983 loc) 81.8 kB
<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <title>JSDoc: Class: TerriaJsonCatalogFunction</title> <script src="scripts/prettify/prettify.js"> </script> <script src="scripts/prettify/lang-css.js"> </script> <!--[if lt IE 9]> <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script> <![endif]--> <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css"> <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css"> </head> <body> <div id="main"> <h1 class="page-title">Class: TerriaJsonCatalogFunction</h1> <section> <header> <h2><span class="attribs"><span class="type-signature"></span></span>TerriaJsonCatalogFunction<span class="signature">(terria)</span><span class="type-signature"></span></h2> </header> <article> <div class="container-overview"> <h4 class="name" id="TerriaJsonCatalogFunction"><span class="type-signature"></span>new TerriaJsonCatalogFunction<span class="signature">(terria)</span><span class="type-signature"></span></h4> <div class="description"> <p>A <a href="CatalogFunction.html">CatalogFunction</a> that issues an HTTP GET to a service with a set of query parameters specified by the <a href="TerriaJsonCatalogFunction.html#inputs">TerriaJsonCatalogFunction#inputs</a> property, and expects to receive back TerriaJS catalog/share JSON.</p> <p>When this <code>CatalogFunction</code> is added to the catalog, TerriaJS automatically creates a user interface for it based on the inputs. When the user clicks &quot;Run Analysis&quot;, it issues an HTTP GET with the user-specified inputs supplied as part of the query string. The returned TerriaJS catalog/share JSON can add items to the workbench, configure the catalog, change the camera view, and more.</p> <p>Example:</p> <pre class="prettyprint source"><code>{ &quot;name&quot;: &quot;Simple Example&quot;, &quot;type&quot;: &quot;terria-json&quot;, &quot;url&quot;: &quot;https://putsreq.com/PK2GvS6jHfWhlBmkadrG&quot;, &quot;inputs&quot;: [ { &quot;id&quot;: &quot;position&quot;, &quot;type&quot;: &quot;point&quot;, &quot;name&quot;: &quot;Position&quot;, &quot;description&quot;: &quot;The position to pass to the service.&quot;, &quot;formatter&quot;: &quot;longitudeCommaLatitude&quot; }, { &quot;id&quot;: &quot;someOtherParameter&quot;, &quot;type&quot;: &quot;string&quot;, &quot;name&quot;: &quot;Some Other Parameter&quot;, &quot;description&quot;: &quot;This is another parameter that will be passed to the service.&quot; } ] }</code></pre><p>For this <code>CatalogFunction</code> TerriaJS will present a user interface with two elements: a position on the map and a string. When invoked, TerriaJS will GET a URL like: <code>https://putsreq.com/PK2GvS6jHfWhlBmkadrG?position=151.0%2C-33.0&amp;someOtherParameter=some%20text</code></p> <p>The service is expected to return JSON using the <code>application/json</code> content type, and have a body with any of the following:</p> <ul> <li>A single catalog member</li> </ul> <p>For example:</p> <pre class="prettyprint source"><code>{ &quot;type&quot;: &quot;csv&quot;, &quot;data&quot;: &quot;POSTCODE,value\n2000,1&quot; }</code></pre><p>The catalog member will be added to the catalog inside a catalog group directly below this <code>CatalogFunction</code>. Catalog items will also be added to the workbench unless <code>isEnabled</code> is explicitly set to false.</p> <p>If the catalog item does not have a name, as in the above example, its name will be the name of this <code>CatalogFunction</code> followed by the date and time it was invoked in ISO8601 format. If the catalog item does not have a description, it will be given a description explaining that this is the result of executing a service and will include the input parameters sent to the service.</p> <ul> <li>An array of catalog members</li> </ul> <p>An array of catalog members as described above.</p> <p>For example:</p> <pre class="prettyprint source"><code>[ { &quot;type&quot;: &quot;csv&quot;, &quot;data&quot;: &quot;POSTCODE,value\n2000,1&quot; }, { &quot;name&quot;: &quot;My Result WMS Layer&quot;, &quot;type&quot;: &quot;wms&quot;, &quot;url&quot;: &quot;http://ereeftds.bom.gov.au/ereefs/tds/wms/ereefs/mwq_gridAgg_P1A&quot;, &quot;layers&quot;: &quot;Chl_MIM_mean&quot; } ]</code></pre><ul> <li>A catalog file</li> </ul> <p>For example:</p> <pre class="prettyprint source"><code>{ &quot;catalog&quot;: [ { &quot;name&quot;: &quot;National Datasets&quot;, &quot;type&quot;: &quot;group&quot;, &quot;items&quot;: [ { &quot;name&quot;: &quot;My Result WMS Layer&quot;, &quot;type&quot;: &quot;wms&quot;, &quot;url&quot;: &quot;http://ereeftds.bom.gov.au/ereefs/tds/wms/ereefs/mwq_gridAgg_P1A&quot;, &quot;layers&quot;: &quot;Chl_MIM_mean&quot;, &quot;isEnabled&quot;: true } ] } ], &quot;initialCamera&quot;: { &quot;west&quot;: 141.0, &quot;south&quot;: -26.0, &quot;east&quot;: 157.0, &quot;north&quot;: -9.0 } }</code></pre><p>Please note that in this case, catalog items are <em>not</em> automatically enabled or named. The <code>name</code> property is required. If <code>isEnabled</code> is not set to <code>true</code>, the catalog item will not appear on the workbench.</p> <ul> <li>Share data</li> </ul> <p>Similar to the above except that it allows multiple init sources (catalog files) and has a version property for backward compatibility. For example:</p> <pre class="prettyprint source"><code>{ &quot;version&quot;: &quot;0.0.05&quot;, &quot;initSources&quot;: [ { &quot;catalog&quot;: [ { &quot;name&quot;: &quot;National Datasets&quot;, &quot;type&quot;: &quot;group&quot;, &quot;items&quot;: [ { &quot;name&quot;: &quot;My Result WMS Layer&quot;, &quot;type&quot;: &quot;wms&quot;, &quot;url&quot;: &quot;http://ereeftds.bom.gov.au/ereefs/tds/wms/ereefs/mwq_gridAgg_P1A&quot;, &quot;layers&quot;: &quot;Chl_MIM_mean&quot;, &quot;isEnabled&quot;: true } ] } ], }, { &quot;initialCamera&quot;: { &quot;west&quot;: 141.0, &quot;south&quot;: -26.0, &quot;east&quot;: 157.0, &quot;north&quot;: -9.0 } } ] }</code></pre> </div> <h5>Parameters:</h5> <table class="params"> <thead> <tr> <th>Name</th> <th>Type</th> <th class="last">Description</th> </tr> </thead> <tbody> <tr> <td class="name"><code>terria</code></td> <td class="type"> <span class="param-type"><a href="Terria.html">Terria</a></span> </td> <td class="description last"><p>The Terria instance.</p></td> </tr> </tbody> </table> <dl class="details"> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_TerriaJsonCatalogFunction.js.html">Models/TerriaJsonCatalogFunction.js</a>, <a href="Models_TerriaJsonCatalogFunction.js.html#line179">line 179</a> </li></ul></dd> </dl> </div> <h3 class="subsection-title">Extends</h3> <ul> <li><a href="CatalogFunction.html">CatalogFunction</a></li> </ul> <h3 class="subsection-title">Members</h3> <h4 class="name" id="_memoizedInfoItemsSourceLookup"><span class="type-signature"></span>_memoizedInfoItemsSourceLookup<span class="type-signature"></span></h4> <div class="description"> <p>Lookup table for _sourceInfoItemNames, access through CatalogMember#_infoItemsWithSourceInfoLookup</p> </div> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#_memoizedInfoItemsSourceLookup">CatalogMember#_memoizedInfoItemsSourceLookup</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line196">line 196</a> </li></ul></dd> </dl> <h4 class="name" id="cacheDuration"><span class="type-signature"></span>cacheDuration<span class="type-signature"> :String</span></h4> <div class="description"> <p>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).</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">String</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#cacheDuration">CatalogMember#cacheDuration</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line104">line 104</a> </li></ul></dd> </dl> <h4 class="name" id="contextItem"><span class="type-signature"></span>contextItem<span class="type-signature"> :<a href="CatalogItem.html">CatalogItem</a></span></h4> <div class="description"> <p>A catalog item that will be enabled while preparing to invoke this catalog function, in order to provide context for the function.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type"><a href="CatalogItem.html">CatalogItem</a></span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogFunction.html#contextItem">CatalogFunction#contextItem</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogFunction.js.html">Models/CatalogFunction.js</a>, <a href="Models_CatalogFunction.js.html#line47">line 47</a> </li></ul></dd> </dl> <h4 class="name" id="customProperties"><span class="type-signature"></span>customProperties<span class="type-signature"> :Object</span></h4> <div class="description"> <p>Gets or sets the dictionary of custom item properties. This property is observable.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Object</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#customProperties">CatalogMember#customProperties</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line117">line 117</a> </li></ul></dd> </dl> <h4 class="name" id="description"><span class="type-signature"></span>description<span class="type-signature"> :String</span></h4> <div class="description"> <p>Gets or sets the description of the item. This property is observable.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">String</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#description">CatalogMember#description</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line44">line 44</a> </li></ul></dd> </dl> <h4 class="name" id="forceProxy"><span class="type-signature"></span>forceProxy<span class="type-signature"> :Boolean</span></h4> <div class="description"> <p>Gets or sets whether or not this member should be forced to use a proxy. This property is not observable.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Boolean</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#forceProxy">CatalogMember#forceProxy</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line111">line 111</a> </li></ul></dd> </dl> <h4 class="name" id="hasDescription"><span class="type-signature"></span>hasDescription<span class="type-signature"> :Boolean</span></h4> <div class="description"> <p>Tests whether a description is available, either in the 'description' property or as a member of the 'info' array.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Boolean</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#hasDescription">CatalogMember#hasDescription</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line326">line 326</a> </li></ul></dd> </dl> <h4 class="name" id="hideSource"><span class="type-signature"></span>hideSource<span class="type-signature"> :boolean</span></h4> <div class="description"> <p>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).</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">boolean</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#hideSource">CatalogMember#hideSource</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line174">line 174</a> </li></ul></dd> </dl> <h4 class="name" id="id"><span class="type-signature"></span>id<span class="type-signature"> :String</span></h4> <div class="description"> <p>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.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">String</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#id">CatalogMember#id</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line124">line 124</a> </li></ul></dd> </dl> <h4 class="name" id="info"><span class="type-signature"></span>info<span class="type-signature"> :Array.&lt;Object></span></h4> <div class="description"> <p>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.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Array.&lt;Object></span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#info">CatalogMember#info</a> </li></ul></dd> <dt class="tag-default">Default Value:</dt> <dd class="tag-default"><ul class="dummy"> <li>[]</li> </ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line57">line 57</a> </li></ul></dd> </dl> <h4 class="name" id="infoSectionOrder"><span class="type-signature"></span>infoSectionOrder<span class="type-signature"> :Array.&lt;String></span></h4> <div class="description"> <p>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.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Array.&lt;String></span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#infoSectionOrder">CatalogMember#infoSectionOrder</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line64">line 64</a> </li></ul></dd> </dl> <h4 class="name" id="initialMessage"><span class="type-signature"></span>initialMessage<span class="type-signature"> :Object</span></h4> <div class="description"> <p>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.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Object</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#initialMessage">CatalogMember#initialMessage</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line97">line 97</a> </li></ul></dd> </dl> <h4 class="name" id="inputs"><span class="type-signature"></span>inputs<span class="type-signature"> :Array.&lt;<a href="FunctionParameter.html">FunctionParameter</a>></span></h4> <div class="description"> <p>Gets or sets the input parameters to the service.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Array.&lt;<a href="FunctionParameter.html">FunctionParameter</a>></span> </li> </ul> <dl class="details"> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_TerriaJsonCatalogFunction.js.html">Models/TerriaJsonCatalogFunction.js</a>, <a href="Models_TerriaJsonCatalogFunction.js.html#line192">line 192</a> </li></ul></dd> </dl> <h4 class="name" id="isGroup"><span class="type-signature"></span>isGroup<span class="type-signature"> :Boolean</span></h4> <div class="description"> <p>Gets a value that tells the UI whether this is a group. Groups, when clicked, expand to show their constituent items.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Boolean</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#isGroup">CatalogMember#isGroup</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line262">line 262</a> </li></ul></dd> </dl> <h4 class="name" id="isHidden"><span class="type-signature"></span>isHidden<span class="type-signature"> :Boolean</span></h4> <div class="description"> <p>Gets or sets a value indicating whether this item is hidden from the catalog. This property is observable.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Boolean</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#isHidden">CatalogMember#isHidden</a> </li></ul></dd> <dt class="tag-default">Default Value:</dt> <dd class="tag-default"><ul class="dummy"> <li>false</li> </ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line89">line 89</a> </li></ul></dd> </dl> <h4 class="name" id="isLoading"><span class="type-signature"></span>isLoading<span class="type-signature"> :Boolean</span></h4> <div class="description"> <p>Gets or sets a value indicating whether the group is currently loading. This property is observable.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Boolean</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogFunction.html#isLoading">CatalogFunction#isLoading</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogFunction.js.html">Models/CatalogFunction.js</a>, <a href="Models_CatalogFunction.js.html#line40">line 40</a> </li></ul></dd> </dl> <h4 class="name" id="isPromoted"><span class="type-signature"></span>isPromoted<span class="type-signature"> :Boolean</span></h4> <div class="description"> <p>Gets or sets a value indicating whether this item is kept above other non-promoted items. This property is observable.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Boolean</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#isPromoted">CatalogMember#isPromoted</a> </li></ul></dd> <dt class="tag-default">Default Value:</dt> <dd class="tag-default"><ul class="dummy"> <li>false</li> </ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line81">line 81</a> </li></ul></dd> </dl> <h4 class="name" id="isUserSupplied"><span class="type-signature"></span>isUserSupplied<span class="type-signature"> :Boolean</span></h4> <div class="description"> <p>Gets or sets a value indicating whether this member was supplied by the user rather than loaded from one of the <a href="Terria.html#initSources">Terria#initSources</a>. User-supplied members must be serialized completely when, for example, serializing enabled members for sharing. This property is observable.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Boolean</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#isUserSupplied">CatalogMember#isUserSupplied</a> </li></ul></dd> <dt class="tag-default">Default Value:</dt> <dd class="tag-default"><ul class="dummy"> <li>true</li> </ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line73">line 73</a> </li></ul></dd> </dl> <h4 class="name" id="isWaitingForDisclaimer"><span class="type-signature"></span>isWaitingForDisclaimer<span class="type-signature"> :boolean</span></h4> <div class="description"> <p>Whether this catalog member is waiting for a disclaimer to be accepted before showing itself.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">boolean</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#isWaitingForDisclaimer">CatalogMember#isWaitingForDisclaimer</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line166">line 166</a> </li></ul></dd> </dl> <h4 class="name" id="name"><span class="type-signature"></span>name<span class="type-signature"> :String</span></h4> <div class="description"> <p>Gets or sets the name of the item. This property is observable.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">String</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#name">CatalogMember#name</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line38">line 38</a> </li></ul></dd> </dl> <h4 class="name" id="nameInCatalog"><span class="type-signature"></span>nameInCatalog<span class="type-signature"> :String</span></h4> <div class="description"> <p>Gets or sets the name of this catalog member in the catalog. By default this is just <code>name</code>, but can be overridden.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">String</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#nameInCatalog">CatalogMember#nameInCatalog</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line216">line 216</a> </li></ul></dd> </dl> <h4 class="name" id="parent"><span class="type-signature"></span>parent<span class="type-signature"> :<a href="CatalogGroup.html">CatalogGroup</a></span></h4> <div class="description"> <p>The parent <a href="CatalogGroup.html">CatalogGroup</a> of this member.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type"><a href="CatalogGroup.html">CatalogGroup</a></span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#parent">CatalogMember#parent</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line139">line 139</a> </li></ul></dd> </dl> <h4 class="name" id="propertiesForSharing"><span class="type-signature"></span>propertiesForSharing<span class="type-signature"> :Array.&lt;String></span></h4> <div class="description"> <p>Gets the set of names of the properties to be serialized for this object when <a href="CatalogMember.html#serializeToJson">CatalogMember#serializeToJson</a> is called for a share link.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Array.&lt;String></span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#propertiesForSharing">CatalogMember#propertiesForSharing</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line314">line 314</a> </li></ul></dd> </dl> <h4 class="name" id="serializers"><span class="type-signature"></span>serializers<span class="type-signature"> :Object</span></h4> <div class="description"> <p>Gets the set of functions used to serialize individual properties in <a href="CatalogMember.html#serializeToJson">CatalogMember#serializeToJson</a>. 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.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Object</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogFunction.html#serializers">CatalogFunction#serializers</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogFunction.js.html">Models/CatalogFunction.js</a>, <a href="Models_CatalogFunction.js.html#line111">line 111</a> </li></ul></dd> </dl> <h4 class="name" id="shareKeys"><span class="type-signature"></span>shareKeys<span class="type-signature"> :Array.&lt;String></span></h4> <div class="description"> <p>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 <a href="CatalogMember.html#id">CatalogMember#id</a>.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Array.&lt;String></span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#shareKeys">CatalogMember#shareKeys</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line132">line 132</a> </li></ul></dd> </dl> <h4 class="name" id="shortReport"><span class="type-signature"></span>shortReport<span class="type-signature"> :String</span></h4> <div class="description"> <p>A short report to show on the now viewing tab. This property is observable.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">String</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#shortReport">CatalogMember#shortReport</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line145">line 145</a> </li></ul></dd> </dl> <h4 class="name" id="shortReportSections"><span class="type-signature"></span>shortReportSections<span class="type-signature"> :Array.&lt;ShortReportSection></span></h4> <div class="description"> <p>The list of collapsible sections of the short report. Each element of the array is an object literal with a <code>name</code> and <code>content</code> property.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Array.&lt;ShortReportSection></span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#shortReportSections">CatalogMember#shortReportSections</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line152">line 152</a> </li></ul></dd> </dl> <h4 class="name" id="showsInfo"><span class="type-signature"></span>showsInfo<span class="type-signature"> :Boolean</span></h4> <div class="description"> <p>Gets a value indicating whether this catalog member can show information. If so, an info icon will be shown next to the item in the data catalog.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Boolean</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogFunction.html#showsInfo">CatalogFunction#showsInfo</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogFunction.js.html">Models/CatalogFunction.js</a>, <a href="Models_CatalogFunction.js.html#line61">line 61</a> </li></ul></dd> </dl> <h4 class="name" id="terria"><span class="type-signature"></span>terria<span class="type-signature"> :<a href="Terria.html">Terria</a></span></h4> <div class="description"> <p>Gets the Terria instance.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type"><a href="Terria.html">Terria</a></span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#terria">CatalogMember#terria</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line273">line 273</a> </li></ul></dd> </dl> <h4 class="name" id="type"><span class="type-signature"></span>type<span class="type-signature"> :String</span></h4> <div class="description"> <p>Gets the type of data item represented by this instance.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">String</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#type">CatalogMember#type</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line239">line 239</a> </li></ul></dd> </dl> <h4 class="name" id="typeName"><span class="type-signature"></span>typeName<span class="type-signature"> :String</span></h4> <div class="description"> <p>Gets a human-readable name for this type of data source, such as 'Web Map Service (WMS)'.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">String</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#typeName">CatalogMember#typeName</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line250">line 250</a> </li></ul></dd> </dl> <h4 class="name" id="uniqueId"><span class="type-signature"></span>uniqueId<span class="type-signature"> :String</span></h4> <div class="description"> <p>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.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">String</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#uniqueId">CatalogMember#uniqueId</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line343">line 343</a> </li></ul></dd> </dl> <h4 class="name" id="updaters"><span class="type-signature"></span>updaters<span class="type-signature"> :Object</span></h4> <div class="description"> <p>Gets the set of functions used to update individual properties in <a href="CatalogMember.html#updateFromJson">CatalogMember#updateFromJson</a>. 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.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">Object</span> </li> </ul> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogFunction.html#updaters">CatalogFunction#updaters</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogFunction.js.html">Models/CatalogFunction.js</a>, <a href="Models_CatalogFunction.js.html#line97">line 97</a> </li></ul></dd> </dl> <h4 class="name" id="url"><span class="type-signature"></span>url<span class="type-signature"> :String</span></h4> <div class="description"> <p>Gets or sets the URL of the REST server. This property is observable.</p> </div> <h5>Type:</h5> <ul> <li> <span class="param-type">String</span> </li> </ul> <dl class="details"> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_TerriaJsonCatalogFunction.js.html">Models/TerriaJsonCatalogFunction.js</a>, <a href="Models_TerriaJsonCatalogFunction.js.html#line186">line 186</a> </li></ul></dd> </dl> <h3 class="subsection-title">Methods</h3> <h4 class="name" id="connectsWithRoot"><span class="type-signature"></span>connectsWithRoot<span class="signature">()</span><span class="type-signature"></span></h4> <div class="description"> <p>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.</p> </div> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#connectsWithRoot">CatalogMember#connectsWithRoot</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line541">line 541</a> </li></ul></dd> </dl> <h4 class="name" id="enableWithParents"><span class="type-signature"></span>enableWithParents<span class="signature">()</span><span class="type-signature"></span></h4> <div class="description"> <p>&quot;Enables&quot; 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.</p> </div> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#enableWithParents">CatalogMember#enableWithParents</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line553">line 553</a> </li></ul></dd> </dl> <h4 class="name" id="findInfoSection"><span class="type-signature"></span>findInfoSection<span class="signature">(sectionName)</span><span class="type-signature"> &rarr; {Object}</span></h4> <div class="description"> <p>Finds an <a href="CatalogMember.html#info">CatalogMember#info</a> section by name.</p> </div> <h5>Parameters:</h5> <table class="params"> <thead> <tr> <th>Name</th> <th>Type</th> <th class="last">Description</th> </tr> </thead> <tbody> <tr> <td class="name"><code>sectionName</code></td> <td class="type"> <span class="param-type">String</span> </td> <td class="description last"><p>The name of the section to find.</p></td> </tr> </tbody> </table> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogMember.html#findInfoSection">CatalogMember#findInfoSection</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="tag-source"><ul class="dummy"><li> <a href="Models_CatalogMember.js.html">Models/CatalogMember.js</a>, <a href="Models_CatalogMember.js.html#line528">line 528</a> </li></ul></dd> </dl> <h5>Returns:</h5> <div class="param-desc"> <p>The section, or undefined if no section with that name exists.</p> </div> <dl> <dt> Type </dt> <dd> <span class="param-type">Object</span> </dd> </dl> <h4 class="name" id="getParameterValues"><span class="type-signature"></span>getParameterValues<span class="signature">()</span><span class="type-signature"> &rarr; {Object}</span></h4> <div class="description"> <p>Gets the current parameters to this function.</p> </div> <dl class="details"> <dt class="inherited-from">Inherited From:</dt> <dd class="inherited-from"><ul class="dummy"><li> <a href="CatalogFunction.html#getParameterValues">CatalogFunction#getParameterValues</a> </li></ul></dd> <dt class="tag-source">Source:</dt> <dd class="ta