This API returns the UTF-8 representation of data in the RawBytes. Returns null if the RawBytes object represents a binary data.

Syntax

<RawBytes object>.text

Input Parameters

None

Example

var mainLoc = kony.io.FileSystem.getDataDirectoryPath();
var myFileLoc = mainLoc + constants.FILE_PATH_SEPARATOR + "myFile.txt";
var rawBytesObj = new kony.io.File(myFileLoc).read();
if (rawBytesObj === null) {
    kony.print("rawBytes object is null");
} else {
    kony.print(rawBytesObj.text);
}

Return Value

String

Read/ Write

Read only

Platform Availability

• Android

This API clears the content that is held by the RawBytes object.

NOTE: If the RawBytes object contains sensitive text that is generated when data is retrieved from the TextBox or TextArea widgets with the isSensitiveText property enabled, Temenos recommends that you clear the content of the object from the app memory using the clear API after the usage of object is done, or the object is no longer needed.

Syntax

RawBytesObject.clear();

Input Parameters

None

Example

//Example to clear the sensitive text content on Android devices
var basicConfig = {
    id: "textBox1",
    …,
    isSensitiveText: true
};
var layoutConfig = {…},
var pspConfig = {…};
//Creating the Textbox.
var textBox1 = new kony.ui.TextBox2(basicConfig, layoutConfig, pspConfig);
< FormId >.add(textBox1);
// Getting user entered text from TextBox
var textRawBytes = < FormId > .textBox1.text; 
if (kony.type(textRawBytes) == "kony.types.RawBytes") { 
/* As this api is android specific , this check is needed else calling this api without this check will throw method not found error */
    textRawBytes.clear();
}
textRawBytes = null;

Return Value

None

Exceptions

None

Platform Availability

• Android

This API creates and returns a new JavaScript RawBytes Object that is cloned from the specified RawBytes Object.

You can only create a clone for RawBytes of types kony.types.RawBytes.CONTENT_TYPE_BYTE_ARRAY and kony.types.RawBytes.CONTENT_TYPE_CHAR_ARRAY.

To avoid security issues, the sensitive text held by the Rawbytes Objects (retrieved from a TextBox or TextArea widget present within a Segment widget)is cleared during Form navigation or when the widget is destroyed. If a user wants to hold and use the sensitive text from the RawBytes Object, they can create a copy of the RawBytes Object by using this API.

NOTE: If the RawBytes object contains sensitive text that is generated when data is retrieved from the TextBox or TextArea widgets with the isSensitiveText property enabled, Temenos recommends that you clear the content of the object from the app memory using the clear API after the usage of object is done, or the object is no longer needed.

Syntax

RawBytesObject.clone();

Input Parameters

None

Example

//Example to clone an existing RawBytes Object on Android devices
var rowItems = Form1.segmentOne.selectedRowItems;
var mytext = rowItems[0]["txtSegOne"]["text"];
if (kony.type(mytext) == "kony.types.RawBytes") {
/* As this api is android specific , this check is needed else calling this api without this check will throw a method not found error */
var clonedRawBytes = mytext.clone();
}

Return Value

Returns a new JS RawBytes object cloned from the existing RawBytes object.

Exceptions

None

Platform Availability

• Android

This API retrieves the Content Type of the RawBytes object.

Syntax

RawBytesObject.getContentType();

Input Parameters

None

Example

/*The RawBytesObject can be obtained from sources such as TextArea or 
TextBox widgets with the isSensitiveText property enabled or through FFIs.*/
var konyrawbytes = rawbytesObject.getContentType();

Return Value

The content type of the RawBytes Object.

Depending on the content type of the RawBytes Object, this API returns one of the following JavaScript constants:

Exceptions

None

Platform Availability

• Android

This API returns the location of rawbytes which can be Android content URI or a file path.

Syntax

RawBytesObject.getResourcePath();

Input Parameters

None

Example

var mainLoc = kony.io.FileSystem.getDataDirectoryPath();
var myFileLoc = mainLoc + constants.FILE_PATH_SEPARATOR + "myFile.txt";
var rawBytesObj = new kony.io.File(myFileLoc).read();
if (rawBytesObj === null) {
    kony.print("The resource path is not available");
} else {
    kony.print("The resource path for file is" + rawBytesObj.getResourcePath());
}

Return Value

Exceptions

None

Platform Availability

• Android
• iOS

This API returns the path where the source files of all RawBytes are stored.

Syntax

RawBytesObject.getTempPath();

Input Parameters

None

Example

var tempPath = kony.types.RawBytes.getTempPath();

Return Value

The path of source files of all RawBytes.

Exceptions

None

Platform Availability

• iOS

This API returns the data as text represented by the RawBytes object. It returns null if the RawBytes object represents binary data.

Syntax

RawBytesObject.readAsText();

Input Parameters

None

Example

 
var mainLoc = kony.io.FileSystem.getDataDirectoryPath();
var myFileLoc = mainLoc + constants.FILE_PATH_SEPARATOR + "myFile.txt";
var rawBytesObj = new kony.io.File(myFileLoc).read();
if (rawBytesObj === null) {
    kony.print("rawBytes object is null");
} else {
    kony.print(rawBytesObj.readAsText());
}

Return Value

String - text available in this rawbytes.

Exceptions

None

Platform Availability

• Android
• iOS