Saltar al contenido
Verificada

JavaScript

Código fuente JS real, compilado al guardar, para la lógica que un programa declarativo no puede expresar.

Un programa JavaScript contiene código fuente real en scriptData.value, la salida de emergencia para la lógica que un Get Data, Set Data o Batch declarativo no puede expresar. Se compila al guardar (save_prog ejecuta la misma compilación que Studio y devuelve data.compile, { ok: true, dependencies } o { ok: false, error }), y se ejecuta con una API real para campos, tablas y eventos, no solo un elemento DOM.

Propiedades

El contrato de ejecución

El código fuente es un cuerpo asíncrono simple, sin export, sin envoltorio, ejecutado como:

js
async function (params, xu, SESSION_ID, SESSION_OBJ, jobNoP, $container, func, glb, APP_OBJ, evt) {
  /* your source */
}

params son los parámetros de quien llama, ya evaluados. xu es la API del entorno de ejecución: campos, filas de la base de datos, eventos, HTTP. await funciona libremente porque el envoltorio es asíncrono. Aquí las comillas no dan problema, a diferencia de un valor de atributo xu-script.

Leer y escribir una tabla

js
const raw = await xu.get_field_value(`rows_json_v`);
const rows = typeof raw === `string` ? JSON.parse(raw || `[]`) : raw || [];
for (const row of rows) {
  await xu.dbs_create(`392_tbl_…`, { CNT_Name: row.name || `` });
}
// dbs_read resolves to an ARRAY of { id, value } rows, the row id on .id, fields under .value.
const all = await xu.dbs_read(`392_tbl_…`, {}, [], null, 999);
await xu.set_field_value(`saved_rows_v`, all.map((r) => ({ row_id: r.id, name: r.value?.CNT_Name || `` })));

Los métodos dbs_* reciben el _id de la tabla, nunca su nombre. La proyección fields de dbs_read es opcional: [], el valor por defecto, devuelve todos los campos, y una lista de ids de campo devuelve solo esos.

Pasar datos: campos, no parámetros

call_native_javascript no evalúa los envoltorios de parámetros {value, fx}; un script llamado así recibe los objetos literales {value: "", fx: "@field"}, no valores resueltos. El patrón fiable: quien llama pone primero la carga útil en un campo (un paso update o un campo de entrada xu-bind), llama al script con parameters: {} vacío, y el script lee con xu.get_field_value e informa con xu.set_field_value. Llamar desde otro script es distinto: los parámetros de xu.call_javascript(prog_id, {...}) sí llegan tal como se pasan.

Invocar un programa JavaScript

Ejemplo práctico

Declara los parámetros

Las entradas de progFields se convierten en los nombres de los argumentos de la función envoltorio, en el orden de la llamada.

Escribe el cuerpo

Un cuerpo de función asíncrona simple; haz return de un valor si call_evaluate_javascript lo va a leer.

Llámalo y lee compile.ok

Después de save_prog, comprueba data.compile.ok: una compilación fallida igualmente guarda el documento con un build_error adjunto.

Crea un nodo JavaScript en Programas, escribe el código en el editor de código y añade parámetros en la cuadrícula de Campos. Al guardar se recompila automáticamente; los errores aparecen en el editor.

xml
<meta lang="json5">
{
  id: "normalize_student_name",
  menuTitle: "Normalize Student Name"
}
</meta>

<params lang="json5">
{
  in: { raw_name_in: "string" },
  out: { normalized_name_out: "string" }
}
</params>

<code>
return (@raw_name_in || "")
  .trim()
  .split(/\s+/)
  .filter(Boolean)
  .map(part => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase())
  .join(" ");
</code>
json
{
  "properties": { "menuType": "javascript", "menuName": "Slugify Name", "fileExtension": "js" },
  "scriptData": { "value": "return name.toLowerCase().replace(/[^a-z0-9]+/g, '-');", "dependencies": [] },
  "progFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "name", "type": "virtual" }, "props": { "fieldType": "string" } }
  ]
}