Function EN Version 1.90

@UpdateNote

Note

Syntax

@UpdateNote(NOTEHANDLE1;MODE2);
@UpdateNote(NOTEHANDLE1;MODE2;MODE3);

Description

Updates the document identified by NOTEHANDLE NOTEHANDLE1 and returns the NOTEHANDLE. FN MODE2 can be used to specify more detailed behavior.

MODE2:
0 = Do not save changes.
1 = Save changes.
2 = Save changes without changing $Revisions.
3 = Save changes without changing replication flags.
4   = Save changes without changing the EngineScript update-list field.
6 = Save changes without changing the EngineScript update-list field and without changing $Revisions.
7 = Save changes without changing the EngineScript update-list field and without changing replication flags.
257= Save changes, but only if the SUMMARY field flags can be set.
258= Option 257 and option 2 combined.
259= Option 257 and option 3 combined.

MODE3:
0 = Save only if no conflicts are created.
1 = Force save

Example: @UpdateNote(NOTEHANDLE1;MODE2);

DBHANDLE:=@OpenDB("TEST.NSF");
VIEWHANDLE:=@OpenView(DBHANDLE;"TEST VIEW");
VIEWPOSITION:=1:1:1:0:0:0:0:0:0:0;
NOTEHANDLE1:=@OpenNoteByPosition(DBHANDLE;VIEWHANDLE;VIEWPOSITION;NOTEHANDLE1);
IF(Category[NOTEHANDLE1]!="NEU")
{
Category[NOTEHANDLE1]:="NEU";
NOTEHANDLE1:=@UpdateNote(NOTEHANDLE1;1);
}
NOTEHANDLE1:=@CloseNote(NOTEHANDLE1;0);
VIEWHANDLE:=@CloseView(VIEWHANDLE);
DBHANDLE:=@CloseDB(DBHANDLE);

A database is opened, a document is searched for and opened, and its field "Category" may be changed. If this was the case, the document is saved; otherwise it is only closed. Finally, the database is closed again.

Example: @UpdateNote(NOTEHANDLE1;MODE2;MODE3);

DBHANDLE:=@OpenDB("TEST.NSF");
VIEWHANDLE:=@OpenView(DBHANDLE;"TEST VIEW");
VIEWPOSITION:=1:1:1:0:0:0:0:0:0:0;
NOTEHANDLE1:=@OpenNoteByPosition(DBHANDLE;VIEWHANDLE;VIEWPOSITION;NOTEHANDLE1);
IF(Category[NOTEHANDLE1]!="NEU")
{
Category[NOTEHANDLE1]:="NEU";
RET:=@UpdateNote(NOTEHANDLE1;1;0);
}
NOTEHANDLE1:=@CloseNote(NOTEHANDLE1;0);
VIEWHANDLE:=@CloseView(VIEWHANDLE);
DBHANDLE:=@CloseDB(DBHANDLE);

A database is opened, a document is searched for and opened, and its field "Category" may be changed. If this was the case, the document is saved; otherwise it is only closed. Finally, the database is closed again.

Note : This text was machine-translated and may contain inaccuracies.