Readonly ABORT_Readonly DATA_Readonly DOMSTRING_Readonly HIERARCHY_Readonly INDEX_Readonly INUSE_Readonly INVALID_Readonly INVALID_Readonly INVALID_Readonly INVALID_Readonly INVALID_Readonly NAMESPACE_Readonly NETWORK_Readonly NOT_Readonly NOT_Readonly NO_Readonly NO_Readonly QUOTA_Readonly SECURITY_Readonly SYNTAX_Readonly TIMEOUT_Readonly TYPE_Readonly URL_Readonly VALIDATION_Readonly WRONG_Optional causeReadonly codeReadonly ABORT_Readonly DATA_Readonly DOMSTRING_Readonly HIERARCHY_Readonly INDEX_Readonly INUSE_Readonly INVALID_Readonly INVALID_Readonly INVALID_Readonly INVALID_Readonly INVALID_Readonly NAMESPACE_Readonly NETWORK_Readonly NOT_Readonly NOT_Readonly NO_Readonly NO_Readonly QUOTA_Readonly SECURITY_Readonly SYNTAX_Readonly TIMEOUT_Readonly TYPE_Readonly URL_Readonly VALIDATION_Readonly WRONG_Optional causeReadonly codeReadonly messageReadonly nameOptional stackStatic Readonly ABORT_Static Readonly DATA_Static Readonly DOMSTRING_Static Readonly HIERARCHY_Static Readonly INDEX_Static Readonly INUSE_Static Readonly INVALID_Static Readonly INVALID_Static Readonly INVALID_Static Readonly INVALID_Static Readonly INVALID_Static Readonly NAMESPACE_Static Readonly NETWORK_Static Readonly NOT_Static Readonly NOT_Static Readonly NO_Static Readonly NO_Static Readonly QUOTA_Static Readonly SECURITY_Static Readonly SYNTAX_Static Readonly TIMEOUT_Static Readonly TYPE_Static Readonly URL_Static Readonly VALIDATION_Static Readonly WRONG_Optional stackStatic Readonly ABORT_Static Readonly DATA_Static Readonly DOMSTRING_Static Readonly HIERARCHY_Static Readonly INDEX_Static Readonly INUSE_Static Readonly INVALID_Static Readonly INVALID_Static Readonly INVALID_Static Readonly INVALID_Static Readonly INVALID_Static Readonly NAMESPACE_Static Readonly NETWORK_Static Readonly NOT_Static Readonly NOT_Static Readonly NO_Static Readonly NO_Static Readonly QUOTA_Static Readonly SECURITY_Static Readonly SYNTAX_Static Readonly TIMEOUT_Static Readonly TYPE_Static Readonly URL_Static Readonly VALIDATION_Static Readonly WRONG_Notes:
+Notes:
Embed: The method embeds Cadenza in the given iframe.hideMainHeaderAndFooter and hideWorkbookToolBar parameters - the parameters cannot override the configuration of an embedding target.locationFinder and mapExtent parameters - when both are given, the mapExtent takes precedence.Private Readonly #basePrivate Readonly #debugPrivate Readonly #iframePrivate #iframePrivate Readonly #originPrivate #subscriptionsPrivate Readonly #webPrivate #requiredPrivate #targetThe base URL of the Cadenza server this client is requesting
-The iframe this client is using for embedding Cadenza.
-Private #createPrivate #downloadPrivate #fetchPrivate Readonly #basePrivate Readonly #debugPrivate Readonly #iframePrivate #iframePrivate Readonly #originPrivate #subscriptionsPrivate Readonly #webPrivate #requiredPrivate #targetThe base URL of the Cadenza server this client is requesting
+The iframe this client is using for embedding Cadenza.
+Private #createPrivate #downloadPrivate #fetchstring
URLSearchParams
AbortSignal | undefined
String | undefined If body is set, the fetch will be a post.
-Private #getPrivate #logPrivate #onPrivate #onMessageEvent<CadenzaEvent<never, never>>
-Private #postPrivate #postPrivate #getPrivate #logPrivate #onPrivate #onMessageEvent<CadenzaEvent<never, never>>
+Private #postPrivate #postPosts an event to Cadenza and returns a Promise for the response.
It is guaranteed that a response refers to a specific request, even if multiple request are executed in parallel.
-Optional detail: unknownPrivate #showEmbed Create a geometry.
+Optional detail: unknownPrivate #showEmbed Create a geometry.
Note: Under the hood, creating a geometry is similar to editing a geometry.
That's why the events use the editGeometry prefix.
The workbook map view in the background
@@ -72,16 +72,16 @@Server Download data from a workbook view.
Note: The file name, if not provided, is generated from the name of the workbook view and the current date.
The workbook view to fetch data from.
The data type you want to get back from the server.
Currently, "csv", "excel" and "json" are supported for table and indicator views
and "pdf" for views of type "JasperReports report".
Optional __namedParameters: { Rest ...args: anyFor invalid arguments
-Embed Edit a geometry.
The workbook map view in the background
The geometry
Optional __namedParameters: { Rest ...args: anyA Promise for when the iframe is loaded
Server Fetch the intersection areas from a workbook map view layer in JSON format for a given area.
+Rest ...args: anyServer Fetch the intersection areas from a workbook map view layer in JSON format for a given area.
The workbook view to fetch object info from.
Layer path to identify the layer (identified using layer paths or print names)
The intersection geometry
Optional __namedParameters: { Rest ...args: anyA Promise for the fetch response
Server Fetch data from a workbook view.
+Server Fetch data from a workbook view.
The workbook view to fetch data from.
The data type you want to get back from the server.
Currently, "csv", "excel" and "json" are supported for table and indicator views
and "pdf" for views of type "JasperReports report".
Optional __namedParameters: { Rest ...args: anyA Promise for the fetch response
For invalid arguments
-Fetch object info from a workbook map view.
+Fetch object info from a workbook map view.
The workbook view to fetch object info from.
Layer path to identify the layer (identified using layer paths or print names)
The IDs of the objects to select
Optional __namedParameters: { Rest ...args: anyA Promise for the fetch response
For invalid arguments
-Subscribe to a postMessage() event.
Subscribe to a postMessage() event.
The event type
The subscriber function
An unsubscribe function
-Embed Select objects in a workbook map.
+Embed Select objects in a workbook map.
The workbook map view
Optional __namedParameters: { Rest ...args: anyA Promise for when the iframe is loaded
For invalid arguments
@@ -128,7 +128,7 @@Embed Show a page, workbook, worksheet or workbook view in an iframe.
The source to show
Optional __namedParameters: { Rest ...args: anyA Promise for when the iframe is loaded
Embed Show a workbook map view in an iframe.
The workbook map view to show
Optional __namedParameters: { Rest ...args: anyA Promise for when the iframe is loaded
An Error implementation for errors in the communication with Cadenza.
An Error implementation for errors in the communication with Cadenza.
Note: For invalid parameters, the Cadenza client will throw "normal" Errors.
The technical identifier of the error
A description of the error
-Private #typeOptional causeOptional stackStatic Optional prepareOptional override for formatting stack traces
+Private #typeOptional causeOptional stackStatic Optional prepareOptional override for formatting stack traces
Static stackStatic captureStatic stackStatic captureCreates an instance of the Cadenza JS client.
+Creates an instance of the Cadenza JS client.
Optional options: CadenzaClientOptionsOptions
For invalid arguments
-Creates an instance of the Cadenza JS client.
+Creates an instance of the Cadenza JS client.
The base URL of the Cadenza server
Optional options: CadenzaClientOptionsOptions
This overload is deprecated since and will eventually be removed. Please use the other overload.
For invalid arguments
-Cadenza JS is a JavaScript library to use the disy Cadenza APIs conveniently without having to deal with technical details like parameter encoding or the postMessage() Web API.
The base URL of the Cadenza server
-Whether to enable debug logging
-An iframe for embedding Cadenza or the iframe's ID. +
Whether to enable debug logging
+An iframe for embedding Cadenza or the iframe's ID.
The iframe is required only for methods that embed Cadenza in an iframe, so e.g. not for CadenzaClient#fetchData.
If you want to embed Cadenza in multiple iframes, you need to create an instance of the CadenzaClient per iframe.
An external link that Cadenza uses to resolve the +
An external link that Cadenza uses to resolve the target origin when posting events. This is required if Cadenza and your application are not running on the same origin. Please ensure that the user has view privilege for that link!
-A Cadenza postMessage() event
A Cadenza postMessage() event
Optional event details (depending on the event type)
-The event type
-The event type
+A tuple qualifying a Cadenza external link
+A tuple qualifying a Cadenza external link
You get the repositoryName and externalLinkId from the URL of the external link's page in the Cadenza management center:
<baseUrl>/admin/repositories/<repositoryName>/external-links/<externalLinkId>?...
The name of the link's repository
+A adapted GeoJSON feature object.
-A adapted GeoJSON feature object.
+The area of a Polygon feature
The geometry
-The area of a LineString feature
The id of the feature
-The formated properties
-The geometry
+The area of a LineString feature
The id of the feature
+The formated properties
+A adapted GeoJSON feature collection object
-A GeoJSON geometry object
-Instructs Cadenza to zoom to a provided {@Link Geometry}
-A well-known Cadenza page
-When the user executed a POST message action, which is defined on an external link in the Cadenza management center.
-When the user executed a POST message action, which is defined on an external link in the Cadenza management center.
+When the user changed the selection.
+When the user changed the selection.
For a selection in a workbook map view with activated feature info, the values also include the simplified geometries of the selected objects.
-When the user executed a POST message drill-through.
+When the user executed a POST message drill-through.
The event includes a data row for every item in the workbook selection, each row consisting of the values of the attributes that were selected for the POST message content. If the drill-through was executed from a map view, each row includes the geometry of the selected object as the last value.
-See also: JSON Representation of Cadenza Object Data
Optional context?: stringOptional context?: stringWhen the user cancelled the geometry editing.
-When the user cancelled the geometry editing.
+When the user submitted the geometry.
-When the user submitted the geometry.
+When the user changed the geometry.
-When the user changed the geometry.
+An error event that is mapped to a CadenzaError
-Optional message?: stringAn error event that is mapped to a CadenzaError
+Optional message?: stringAn event type to subscribe to using CadenzaClient#on
-An event type to subscribe to using CadenzaClient#on
+When the user opened the object info flyout.
-When the user opened the object info flyout.
+When the user cancelled the selection.
-When the user cancelled the selection.
+When the user submitted the selection.
+When the user submitted the selection.
For a selection in a workbook map view with activated feature info, the values also include the simplified geometries of the selected objects.
-A data type
+A data type
See JSON Representation of Cadenza Object Data for JSON data.
-The ID of a Cadenza embedding target
+The ID of a Cadenza embedding target
Embedding targets are called 🇩🇪 "Einbettbarer Inhalt" / 🇺🇸 "Embeddable content" throughout the Cadenza UI and help. They're managed within the respective workbook:
The name of an embedding target (as entered in the UI) is its ID.
-An array of numbers representing an extent: [minx, miny, maxx, maxy]
-An array of numbers representing an extent: [minx, miny, maxx, maxy]
+Filter variable names and values
+Filter variable names and values
Variables of type String, Integer, Long, Double and Date can be set.
Note: Since numbers in JavaScript are Double values (more info on MDN), for Long variables, the API is currently limited to the Double value range.
-A GeoJSON geometry type
+A GeoJSON geometry type
Note: The GeoJSON geometry type "GeometryCollection" is currently not supported.
-A specific string type that is not assignable from another string
A specific string type that is not assignable from another string
The idea is to have a specific type e.g. for the EmbeddingTargetId instead of a plain string.
You don't need to actually add that __type property. In TS code, just use a
type assertion
(e.g. cadenzaClient.show('<embeddingTargetId>' as EmbeddingTargetId)).
The mode in which a workbook should be operated
-The mode in which a workbook should be operated
+A part of a table to export
-A part of a table to export
+The name of a Cadenza UI feature
+The name of a Cadenza UI feature
Note: Supported features are:
"workbook-design" - The workbook designer"workbook-view-management" - Add/Edit/Remove workbook views (Is included in 'workbook-design'.)Identifies a layer within a workbook map view +
Identifies a layer within a workbook map view using the print names of the layer and - if the layer is grouped - its ancestors
-
Deprecated
MDN Reference
+