Differences

This shows you the differences between two versions of the page.

--- 711:scripting_advanced [2025/04/04 11:40] – [Advanced Scripting] Weinlein, Thomas
+++ 711:scripting_advanced [2025/04/04 11:58] (current) – [Advanced Scripting] Weinlein, Thomas
@@ Line 3: / Line 3: @@
 ====== Advanced Scripting ======
-Some advanced reports might need to use additional Java library API to provide the requested functionality. As this might pose security risks, explicit whitelisting of such API is necessary. This can be done by providing a comma separated list of class names in the following configuration properties depending on the use case:
+Some advanced reports and admin jobs might need to use additional Java library API to provide the requested functionality. As this might pose security risks, explicit whitelisting of such API is necessary. This can be done by providing a comma separated list of class names in the following configuration properties depending on the use case:
 Admin Jobs: ''adminjob.script.class.whitelist''
@@ Line 14: / Line 14: @@
 <property name="metrics.script.class.whitelist" value="java.text.SimpleDateFormat,java.time" />
 </code>
+Stages will prevent access to all other Java API and will log an error message indicating the unavailable class that needs whitelisting.
 File system access also needs explicit permission via configuration.
@@ Line 47: / Line 49: @@
 files.newInputStream(relativeFileName);
 files.newOutputStream(relativeFileName);
+</code>
+Please ensure the returned streams are **closed after usage**.
+e.g.
+<code javascript>
+var reader = new java.io.BufferedReader(new java.io.InputStreamReader(Files.newInputStream("report-data.csv")));
+try {
+    while ((rline = reader.readLine()) != null) {
+        log.info(rline);
+    }
+} finally {
+    reader.close();
+}
 </code>