Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

Service Management2017.11

Develop > Programming Guide > JavaScript and Service Manager reference > List: JavaScript global methods > JavaScript global method: insertDatum

JavaScript global method: insertDatum

Inserts data into an array datum directly.

Syntax

insertDatum( array[, position[, number[, value[, denull]]]])

Arguments

The following parameters are valid for this function.

Parameter	Data type	Description
array	Array datum	The array parameter is the array into which an element is inserted.
position	Number	The position parameter is the position of the first inserted element. If the value is zero (0), the element is inserted at the end of the array. This is an optional parameter. The default value is zero (0).
number	Number	The number parameter is the number of elements to insert. This is an optional parameter. The default value is one (1). If the value is zero (0), this function will return without changing the array.
value	Any data type supported by RAD	The value parameter is a value to insert into the new elements. This is an optional parameter. The default value is NULL.
denull	Boolean	The denull parameter is a logical value that determines whether or not the array should be denulled before inserting elements. This is an optional parameter. The default value is true.

Return values

The array is returned with the new data inserted.

Throws

None

Description

This method insert data directly into an existing array datum.

Examples

Action desired	Example and result
Insert an element at the beginning of an array datum	`vars.$a=["a", "b", "c", "d"]; insertDatum(vars.$a, 1, 1, "z");` Returns: `vars.$a = {"z", "a", "b", "c", "d"}`
Insert an element in the middle of an array datum	`vars.$a=["a", "b", "c", "d"]; insertDatum(vars.$a, 3, 1, "z")` Returns: `vars.$a = {"a", "b", "z", "c", "d"}`
Insert an element at the end of an array datum	`vars.$a=["a", "b", "c", "d"]; insertDatum(vars.$a, 0, 1, "z");` Returns: `vars.$a = {"a", "b", "c", "d", "z"}`
To denull the array datum	`vars.$a=["a", "b", null, null, "e", "f", null, null, null, null]; insertDatum(vars.$a, 0, 1, "z");` Returns: `vars.$a = {"a", "b", , , "e", "f", "z"}`
To avoid denulling the array datum	`vars.$a=["a", "b", null, null, "e", "f", null, null, null, null]; insertDatum(vars.$a, 0, 1, "z", 0);` Returns: `vars.$a = {"a", "b", , , "e", "f", , , , ,"z"}`
To denull the array datum again	vars.$a=["a", "b", null, null, "e", "f", null, null, null, null]; insertDatum(vars.$a, 2, 1, "z"); Returns: `vars.$a = {"a", "z", "b", , , "e", "f"}`