API that HTML5 controls can call to interact with IEC code

class CDSWebVisuAccess(width, height)

Provides functions that HTML5 elements can call to interact with IEC code.

Input to the constructor (Available with Visualization 4.4.0.0): width: the width of the element height: the height of the element

Before Visualization 4.4.0.0: Html5 elements cannot access this API directly in the constructor. They need to wait for the iFrame to be loaded. Therefore the elements can use the “load” event of the window like this:

StaticElementElementWrapper = function() { window.addEventListener(“load”, this.init); };

CDSWebVisuAccess.checkSimpleValue(methodName, param)

Checks if a scalar value can be written into the configured variable.

Arguments:

  • methodName (String) – The method name as configured in the column “Call method” in the HTML5 editor.

  • param (*) – The scalar value that will be sent to the IEC application. Can be number, bigint, date or another type.

Returns:

Promise.<value> – Promise.Resolve() is called if the value can be written into the specified variable. Otherwise, the promise is rejected.

CDSWebVisuAccess.sendSimpleValue(methodName, param)

Sends a scalar value to IEC code.

Arguments:

  • methodName (String) – The method name as configured in the column “Call method” in the HTML5 editor.

  • param (*) – The scalar value that will be sent to the IEC application.

Returns:

Promise.<value> – A promise that is resolved or rejected.

CDSWebVisuAccess.checkComplexValue(methodName, param, indexCount, index0, index1, index2)

Checks if a certain value of a complex value (array-like structure) can be written to into the configured variable.

Arguments:

  • methodName (String) – The method name as configured in the column “Call method” in the HTML5 editor.

  • param (*) – The scalar value that will be sent to the IEC application. Can be of the types number, bigint, date or others.

  • indexCount (Number) – Number of dimensions of the configured datatype. E.g. 2 for a simple table. Maximum is 3.

  • index0 (Number) – Zero-Based index in the first dimension.

  • index1 (Number) – Zero-Based index in the second dimension.

  • index2 (Number) – Zero-Based index in the third dimension.

Returns:

Promise.<value> – Resolve() is called if the value can be written into the specified variable. Otherwise, the promise is rejected.

CDSWebVisuAccess.sendComplexValue(methodName, param, indexCount, index0, index1, index2)

Sends a certain value of a complex value (array-like structure) to the configured variable in the application.

Arguments:

  • methodName (String) – The method name as configured in the column “Call method” in the HTML5 editor.

  • param (*) – The scalar value that will be sent to the IEC application.

  • indexCount (Number) – Number of dimensions of the configured datatype. E.g. 2 for a simple table. Maximum is 3.

  • index0 (Number) – Zero-Based index in the first dimension.

  • index1 (Number) – Zero-Based index in the second dimension.

  • index2 (Number) – Zero-Based index in the third dimension.

Returns:

Promise.<value, indexCount, index0, index1, index2> – A promise that is resolved or rejected.

CDSWebVisuAccess.sendMouseEvent(event)

Sends a mouse event for this Html element to the IEC application. If the element has input actions like ‘OnMouseClick’ or ‘OnMouseDown’ configured, these events can be triggered here.

Arguments:
Returns:

Promise – A resolved promise. Not relevant.

CDSWebVisuAccess.setScrollRange(methodName, startIndex, endIndex, scrollDimension)

Notifies the IEC application about which parts of the array values should be sent. Can be used for example with a scrollable table element that only receives the values that are currently visible. New values may be requested after the user has scrolled.

Arguments:

  • methodName (String) – The method name as configured in the column “Call method” in the HTML5 editor.

  • startIndex (Number) – Specifies the zero-based start of the array range.

  • endIndex (Number) – Specifies the zero-based end of the array range.

  • scrollDimension (Number) – The dimension of the array values that should be retrieved.

Returns:

Promise – A resolved promise. Not relevant.

CDSWebVisuAccess.getTypeDesc(typeId)

Returns the type description for the corresponding type Id. Typically the method call of an element has the following signature: function(value, type, typeid) {…} The value is the value itself and the typeid identifies the type description which provides further information about the value like size or dimensions in case of an array type.

Arguments:

  • typeId (Number) – The type Id that comes from the element’s method call together with the value.

Returns:

Promise.<typeDesc> – A promise that contains a JSON object with the members descripted in the type descriptions section starting with TypeDesc..

CDSWebVisuAccess.getTextFile(filenameFromAdditionalFiles)

Returns the content of a file in text format. The filename must be the same as in the Additional Files section in the HTML5 editor. As this is an asnychronous call a promise containing the file’s content is returned.

Arguments:

  • filenameFromAdditionalFiles (String) – Filename of the image that was declared in the Additional Files section of the HTML5 editor.

Returns:

Promise.<String> – A promise that contains a string with the content of the requested file.

CDSWebVisuAccess.getBinaryFile(filenameFromAdditionalFiles)

Returns the content of a file in binary format. The filename must be the same as in the Additional Files section in the HTML5 editor. As this is an asnychronous call a promise containing the file’s content is returned.

Arguments:

  • filenameFromAdditionalFiles (String) – Filename of the image that was declared in the Additional Files section of the HTML5 editor.

Returns:

Promise.<blob> – A promise that contains a blob object with the content of the requested file.

CDSWebVisuAccess.getImageById(imagePoolId)

Creates an HTML image element with the provided image name from an Image Pool as source that can be used in the html document of the element. The image source is created by calling the browser function createObjectURL() with the file’s binary content. It will stay in memory until the HTML5 element gets destroyed. As this is an asnychronous call a promise containing the Image is returned.

Arguments:

  • imagePoolId (String) – Path to the image pool and the image id, e.g. “ImagePool.img01”.

Returns:

Promise.<Image> – A promise that contains a HTML image element.

CDSWebVisuAccess.getImageByFilename(filenameFromAdditionalFiles)

Creates an HTML image element with the provided image filename as source that can be used in the html document of the element. The image source is created by calling the browser function createObjectURL() with the image file’s binary content. It will stay in memory until the HTML5 element gets destroyed. As this is an asnychronous call a promise containing the Image is returned.

Arguments:

  • filenameFromAdditionalFiles (String) – Filename of the image that was declared in the Additional Files section of the HTML5 editor.

Returns:

Promise.<Image> – A promise that contains a HTML image element.

CDSWebVisuAccess.getAdditionalFile(additionalFile)

Note

Deprecated: since Visualization 4.3.0.0. Use getTextFile() or getBinaryFile() instead.

Gets the actual filename of a additional file that can be referenced in the element. The original filenames are renamed after downloading the application in order to prevent name collisions with other elements.

Arguments:

  • additionalFile (String) – The original name of the file specified in the ‘Additional Files’ section in the Html5 Editor.

Returns:

Promise.<resultingAdditionalFileName> – A promise that contains the resulting file name.

CDSWebVisuAccess.getImagePoolFileName(imageId)

Note

Deprecated: since Visualization 4.3.0.0. Use getImageById() instead.

Gets the actual filename of a provided image file that can be referenced in the element. The original filenames are renamed after downloading the application in order to prevent name collisions with other elements.

Arguments:

  • imageId (String) – The original name of the file specified in the ‘Image’ section in the Html5 Editor.

Returns:

Promise.<resultingFileName> – A promise that contains the resulting file name.

CDSWebVisuAccess.sendResizeRequest(width, height)

Notifies the WebVisu that the size of the iframe containing the element should be updated. This is useful, for example, when implementing components such as drop-down combo boxes. If this function is used, the HTML5 control is responsible for storing the original size so it can be restored later.

Arguments:

  • width (Number) – The new width of the iframe

  • height (Number) – The new height of the iframe

CDSWebVisuAccess.sendChangeForegroundStateRequest(foregroundState)
Arguments:

  • foregroundState (boolean) – Informs the WebVisu that the foreground state of the HTML5 element should be updated. This is useful, for example, when implementing components such as drop‑down combo boxes that may need to overlap other visual elements. This flag controls the ElementZIndex of the embedded iframe that contains the html5-element: - false (default): Uses Default - true: Uses AboveEverything