¿Cómo se puede configurar un botón para ejecutar operaciones sobre la lista de documentos relacionados en Athento?
Athento permite añadir botones personalizados en la lista de documentos relacionados, facilitando la ejecución de operaciones masivas o específicas sobre estos documentos. Esta funcionalidad se implementa mediante la configuración de la propiedad CUSTOM_RELATED_DOCUMENTS_BUTTONS en el archivo de configuración avanzada de la plataforma.
¿Dónde y cómo se configura?
La configuración se realiza en el archivo athentose/settings_custom/local_settings.py, donde se define la propiedad CUSTOM_RELATED_DOCUMENTS_BUTTONS. Esta propiedad acepta una lista que puede incluir tanto botones estándar (como ‘copy’, ‘excel’, ‘selectAll’, ‘selectNone’) como botones personalizados definidos en formato JSON.
Ejemplo de configuración
CUSTOM_RELATED_DOCUMENTS_BUTTONS = "['copy', 'excel', 'selectAll', 'selectNone', \
{ text: 'Validar documento', action: function (e, dt, node, config) { run_operations_on_related_documents([[192,'Validando documento'], [193,'Cambiando estado']]); } }]"
Explicación de la configuración
-
Botones estándar:
'copy', 'excel', 'selectAll', 'selectNone'son los botones habituales que puedes incluir. - Botón personalizado: Se define como un objeto JSON dentro de la lista, con los siguientes parámetros:
- text: Texto que aparecerá en el botón (por ejemplo, «Validar documento»).
-
action: Función JavaScript que se ejecuta al pulsar el botón. En el ejemplo, se llama a
run_operations_on_related_documents, que recibe una lista de tuplas.- Cada tupla contiene:
- El identificador de la operación a ejecutar (por ejemplo, 192).
- Un mensaje que se muestra al usuario durante la ejecución de la operación (por ejemplo, «Validando documento»).
De este modo, puedes añadir uno o varios botones personalizados, cada uno ejecutando una o varias operaciones sobre los documentos relacionados y mostrando mensajes informativos al usuario.
¿Qué debes personalizar?
- El texto del botón (
text). - El listado de operaciones y mensajes a ejecutar en la función
run_operations_on_related_documents.