insertTextRandom Transaction Format

About insertTextRandom Transaction Format

insertTextRandom transaction format inserts a note for the specified object or class.

Syntax

insertTextRandom {
objectPtr {
class = class-name fd
(field1) = "str1" fd
(field2) = "str2" fd
...
(fieldN) = "strN" fd
[objectPtr pointer-name {
class = class-name fd
(field1) = "str1" fd
(field2) = "str2" fd
...
(fieldN) = "strN" fd
}]
...
}
[permGrantGroups{
(add|remove)="group-name" | all fd
}]
[permGrantUsers{
(add|remove)="user-name" fd
.......
}]
S_TXD_NAME = "str" fd
S_TXD_TEXT = "str" fd
S_TXD_LANGUAGE_CODE = "str" fd
objectPtr S_TXD_ITY_ID {
class = S_ITY_CLASS fd
S_ITY_NAME = "str" fd
}}

Explanation

insertTextRandom {
objectPtr{
class=class-name fd
(field1| field1@unit) = "str1" fd
(field2| field1@unit) = "str2" fd
...
(fieldN) = "strN" fd
}
}

You can use the first objectPtr statement to identify the object to which the note you are inserting is associated. For class-name, provide the class in which the object is located. For the fields that remain, provide the primary keys.

[objectPtr pointer-name {
class = class-name fd
(field1| field1@unit) = "str1" fd
(field2| field2@unit) = "str2" fd
...
(fieldN| fieldN@unit) = "strN" fd}]
...
}

Use one or more additional objectPtr statements if the associated objects primary keys include pointers.

[permGrantGroups{
(add|remove)="group-name" | all fd
}]

Use the permGrantGroups statement to grant or revoke write permission to/from one or more user groups for the note you are interesting. To grant to or revoke from all groups, set the add or remove statement to all.

[permGrantUsers{
(add|remove)="user-name" fd
.......
}]
........

Note: When you are using the permGrantGroups or permGrantUsers permissions with the remove option, ensure that the data has user/group permissions are set.

Use the permGrantUsers statement to change the permissions on the note you are updating.

S_TXD_NAME = "str" fd
S_TXD_TEXT = "str" fd
S_TXD_LANGUAGE_CODE = "str" fd
objectPtr S_TXD_ITY_ID {
class = S_ITY_CLASS fd
S_ITY_NAME = "str" fd
}

Use the remaining fields to supply or change values for the selected note.

Example

This example, inserts a note associated with an existing object. The objectPtr statement specifies the object that the note is associated with. The actual text of this note follows the text keyword.

insertTextRandom {
objectPtr {
class = s_usr_class;
s_usr_name = "John";
}
S_TXD_NAME = "test";
S_TXD_TEXT = "This is testing.";
S_TXD_LANGUAGE_CODE = "US";
objectPtr S_TXD_ITY_ID {
class = S_ITY_CLASS;
S_ITY_NAME = "Alert";
}
}