Admin Module - Revision history

CG: /* admin:write-log */

2023-09-18T12:58:54Z

admin:write-log

2023-03-09T15:04:24Z

admin:logs

2023-03-09T13:09:49Z

2023-03-09T13:02:10Z

Text replacement - "'''Signatures'''" to "'''Signature'''"

2023-03-09T11:02:34Z

2022-07-25T13:39:59Z

2022-07-20T12:07:58Z

2022-07-20T12:06:06Z

Text replacement - "|-" to "|- style="vertical-align:top;""

2022-07-18T18:20:44Z

2022-07-18T17:55:26Z

@@ Line 35: / Line 35: @@
 | width='120' | '''Signature'''
 |<pre>admin:write-log(
-   $text  as xs:string,
+   $message  as xs:string,
-   $type  as xs:string  := ()
+   $type     as xs:string  := ()
 ) as empty-sequence()</pre>
 |- valign="top"
 | '''Summary'''
-|Writes a string to the database logs, along with current user data (timestamp, username). An optional log {{Code|$type}} can be specified. If omitted, the log type is {{Code|INFO}}.<br/>If the function is called from a database client, the IP will be logged. Otherwise, the string {{Code|SERVER}} will be logged.
+|Writes a log {{Code|$message}} to the database logs, along with current user data (timestamp, username). An optional log {{Code|$type}} can be specified. If omitted, the log type is {{Code|INFO}}.<br/>If the function is called from a database client, the IP will be logged. Otherwise, the string {{Code|SERVER}} will be logged.
 |- valign="top"
 | '''Errors'''

@@ Line 13: / Line 13: @@
 | width='120' | '''Signature'''
 |<pre>admin:logs(
-   $date   as xs:string   := (),
+   $date   as xs:string    := (),
-   $merge  as xs:boolean  := ()
+   $merge  as xs:boolean?  := false()
 ) as element()*</pre>
 |- valign="top"
@@ Line 21: / Line 21: @@
 * If no argument is specified, a list of all log files will be returned, including the file size and date.
 * If a {{Code|$date}} is specified, the contents of a single log file will be returned.
-* If {{Code|$merge}} is set to true, related log entries will be merged. Please note that the merge might not be 100% successful, as log entries may be ambiguous.
+* If {{Code|$merge}} is set to true, related log entries will be merged. The merged representation may not be 100% correct, as log entries can be ambiguous.
 |- valign="top"
 | '''Examples'''

@@ Line 13: / Line 13: @@
 | width='120' | '''Signature'''
 |<pre>admin:logs(
-   $date   as xs:string   := ()
+   $date   as xs:string   := (),
    $merge  as xs:boolean  := ()
 ) as element()*</pre>
@@ Line 35: / Line 35: @@
 | width='120' | '''Signature'''
 |<pre>admin:write-log(
-   $text  as xs:string
+   $text  as xs:string,
    $type  as xs:string  := ()
 ) as empty-sequence()</pre>

@@ Line 11: / Line 11: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>admin:logs(
    $date   as xs:string   := ()
@@ Line 33: / Line 33: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>admin:write-log(
    $text  as xs:string
@@ Line 50: / Line 50: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>admin:delete-logs(
    $date  as xs:string
@@ Line 68: / Line 68: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>admin:sessions() as element(session)*</pre>
 |- valign="top"

@@ Line 12: / Line 12: @@
 |- valign="top"
 | width='120' | '''Signatures'''
-|{{Func|admin:logs||element(file)*}}<br/>{{Func|admin:logs|$date as xs:string|element(entry)*}}<br/>{{Func|admin:logs|$date as xs:string, $merge as xs:boolean|element(entry)*}}<br/>
+|<pre>admin:logs(
 |- valign="top"
 | '''Summary'''
@@ Line 31: / Line 34: @@
 |- valign="top"
 | width='120' | '''Signatures'''
-|{{Func|admin:write-log|$text as xs:string|empty-sequence()}}<br/>{{Func|admin:write-log|$text as xs:string, $type as xs:string|empty-sequence()}}
+|<pre>admin:write-log(
 |- valign="top"
 | '''Summary'''
@@ Line 45: / Line 51: @@
 |- valign="top"
 | width='120' | '''Signatures'''
-|{{Func|admin:delete-logs|$date as xs:string|empty-sequence()}}
+|<pre>admin:delete-logs(
 |- valign="top"
 | '''Summary'''
@@ Line 61: / Line 69: @@
 |- valign="top"
 | width='120' | '''Signatures'''
-|{{Func|admin:sessions||element(session)*}}
+|<pre>admin:sessions() as element(session)*</pre>
 |- valign="top"
 | '''Summary'''

@@ Line 108: / Line 108: @@
 * Added: {{Function||admin:write-log}}
-* Deleted: admin:users (renamed to [[User Module#user:list-details|user:list-details]])
+* Deleted: admin:users (renamed to {{Function|User|user:list-details}}).
 ;Version 7.8.2

@@ Line 91: / Line 91: @@
 ;Version 9.2
-* Updated: {{Function|Admin|admin:write-log}}: type string may contain more characters
+* Updated: {{Function||admin:write-log}}: type string may contain more characters
 ;Version 9.0
@@ Line 99: / Line 99: @@
 ;Version 8.3
-* Updated: {{Function|Admin|admin:write-log}}: optional log type added
+* Updated: {{Function||admin:write-log}}: optional log type added
 ;Version 8.2
-* Added: {{Function|Admin|admin:delete-logs}}
+* Added: {{Function||admin:delete-logs}}
 ;Version 8.0
-* Added: {{Function|Admin|admin:write-log}}
+* Added: {{Function||admin:write-log}}
 * Deleted: admin:users (renamed to [[User Module#user:list-details|user:list-details]])
 ;Version 7.8.2
-* Updated: {{Function|Admin|admin:users}}: md5-encoded password added to output.
+* Updated: {{Function||admin:users}}: md5-encoded password added to output.
-* Updated: {{Function|Admin|admin:logs}}: represent name of log files as string value; {{Code|$merge}} argument added.
+* Updated: {{Function||admin:logs}}: represent name of log files as string value; {{Code|$merge}} argument added.
 The Module was introduced with Version 7.5.