feat(core/reports): functions for formatting tables' data as html

Author: robzan8

projects/core/models/src/utils/expression-utils.md

@@ -20,6 +20,32 @@ Reads from report_data the result of the AI prompt with the specified name.
 `CHART_TO_DATA(labels, values)`
 Converts chart arrays into a JSON string.
 
+`FORMAT_TABLE_ROWS(rows)`
+Formats the given table rows as an HTML table string.
+Example: `FORMAT_TABLE_ROWS(['name', 'age'], ['Pippo', 10], ['Pluto', 5])`
+Outputs:
+```
+<table>
+  <tr>
+    <td>name</td><td>age</td>
+  </tr>
+  <tr>
+    <td>Pippo</td><td>10</td>
+  </tr>
+  <tr>
+    <td>Pluto</td><td>5</td>
+  </tr>
+</table>
+```
+
+`FORMAT_TABLE_COLS(columns)`
+Formats the given table columns as an HTML table string.
+Example: `FORMAT_TABLE_COLS(['name', 'Pippo', 'Pluto'], ['age', 10, 5])`
+
+`FORMAT_TABLE_FIELDS(forms, fields)`
+Extracts the fields' data from the specified forms and formats them as an HTML table string.
+Example: `FORMAT_TABLE_FIELDS(dataset, ['name', 'age'])`
+
 ## Forms manipulation functions
 
 `BUILD_DATASET(forms, schema?)`  

projects/core/models/src/utils/expression-utils.ts

@@ -176,6 +176,9 @@ export class AjfExpressionUtils {
     SUM: {fn: SUM},
     TODAY: {fn: TODAY},
     CHART_TO_DATA: {fn: CHART_TO_DATA},
+    FORMAT_TABLE_ROWS: {fn: FORMAT_TABLE_ROWS},
+    FORMAT_TABLE_COLS: {fn: FORMAT_TABLE_COLS},
+    FORMAT_TABLE_FIELDS: {fn: FORMAT_TABLE_FIELDS},
   };
 }
 
@@ -2133,3 +2136,52 @@ export function CHART_TO_DATA(labels: string[], values: any[]): string {
   labels.forEach((lab: string, i: number) => (jsonObj[lab] = values[i]));
   return JSON.stringify(jsonObj);
 }
+
+/**
+ * Formats the given table rows as an HTML table string.
+ * @param rows
+ * @returns
+ */
+export function FORMAT_TABLE_ROWS(rows: any[][]): string {
+  let html = '\n<table>';
+  for (const row of rows) {
+    html += '\n  <tr>\n    ';
+    for (const cell of row) {
+      html += `<td>${cell}</td>`;
+    }
+    html += '\n  </tr>';
+  }
+  html += '\n</table>\n';
+  return html;
+}
+
+/**
+ * Formats the given table columns as an HTML table string.
+ * @param columns
+ * @returns
+ */
+export function FORMAT_TABLE_COLS(columns: any[][]): string {
+  const numRows = columns.length && columns[0].length;
+  const rows = Array(numRows).fill(1).map(_ => []) as any[][];
+  for (const col of columns) {
+    for (let i = 0; i < numRows; i++) {
+      rows[i].push(col[i]);
+    }
+  }
+  return FORMAT_TABLE_ROWS(rows);
+}
+
+/**
+ * Extracts the fields' data from the specified forms and formats them as an HTML table string.
+ * @param forms
+ * @param fields
+ * @returns
+ */
+export function FORMAT_TABLE_FIELDS(forms: MainForm[], fields: string[]): string {
+  forms = forms.filter(f => f != null);
+  const rows = [fields] as any[][];
+  for (const form of forms) {
+    rows.push(fields.map(field => form[field]));
+  }
+  return FORMAT_TABLE_ROWS(rows);
+}

projects/core/reports/src/xls-report/hindikit-parser.ts

@@ -429,4 +429,7 @@ const functionArgs: {[name: string]: string[]} = {
   SUM: ["arg", "field", "func(form)?"],
   TODAY: [],
   CHART_TO_DATA: ["arg", "arg"],
+  FORMAT_TABLE_ROWS: ["arg"],
+  FORMAT_TABLE_COLS: ["arg"],
+  FORMAT_TABLE_FIELDS: ["arg", "arg"],
 };