Cómo hacer una operación que añada filas a un campo de tipo tabla a partir de un campo de selección de documentos

Objetivo

Permitir que un usuario seleccione documentos en un campo Choice (subtipo Document) y, al ejecutar una operación, se creen automáticamente filas en un campo de tipo tabla en el documento actual.

Este patrón es útil en procesos como:

• Ofertas económicas (añadir productos o servicios).

• Licitaciones (añadir proveedores seleccionados).

• Pedidos o compras (añadir ítems seleccionados).

Requisitos previos

1. Un campo Choice configurado con subtipo Document 

2. Un campo tabla donde se crearán las filas.

3. Una operación Python personalizada o automatismo que recupere los documentos seleccionados y genere las filas.

4. Un botón de ejecución configurado para lanzar la operación.

    

Código de la operación

import json

from file.models import File
from operations.classes.document_operation import DocumentOperation

class AddTableRowsFromDocumentChoiceOperation(DocumentOperation):
    version = '1.0'
    name = 'Añadir filas desde documentos seleccionados'
    documentation = 'https://athento.zendesk.com/knowledge/articles/360024905974/'
    description = """
        Crea filas en un ITable a partir de los documentos seleccionados en un campo Choice.
    """
    deprecated = False  # If it's true,the operations doesn't appear in the marketplace
    configuration_parameters = {
    }

    def execute(self, *args, **kwargs):
        document = self.document

        choice_field = 'metadata.mi_campo_documentos'  # Campo Choice o MultiChoice
        itable_field = 'metadata.mi_campo_tabla'  # Campo ITable

        choice_document_uuids = document.get_metadata_value(choice_field)
        if not choice_document_uuids:
            return {'msg_type': 'warning', 'msg': 'Seleccione uno o varios documentos.'}

        current_rows = document.get_metadata_value(itable_field)
        if isinstance(current_rows, str):
            try:
                current_rows = json.loads(current_rows)
            except Exception:
                current_rows = []

        if not isinstance(current_rows, list):
            current_rows = []

        if isinstance(choice_document_uuids, str):
            choice_document_uuids = [choice_document_uuids]

        for doc_uuid in choice_document_uuids:
            try:
                doc = File.objects.get(uuid=doc_uuid)
            except File.DoesNotExist:
                continue

            new_row = {
                's-descripcion-xxxxx': doc.get_metadata_value('metadata.producto_descripcion'),
                's-precio-xxxxx': doc.get_metadata_value('metadata.producto_precio'),
                's-cantidad-xxxxx': doc.get_metadata_value('metadata.producto_cantidad_minima') or 1,
                'product_uuid': doc_uuid,
                'DT_RowId': f'row-{doc_uuid}',
            }
            current_rows.append(new_row)

        document.set_metadata(itable_field, json.dumps(current_rows))
        return {'msg_type': 'success', 'msg': 'Filas añadidas correctamente desde documentos seleccionados.'}


VERSION = AddTableRowsFromDocumentChoiceOperation.version
NAME = AddTableRowsFromDocumentChoiceOperation.name
DESCRIPTION = AddTableRowsFromDocumentChoiceOperation.description
DOCUMENTATION = AddTableRowsFromDocumentChoiceOperation.documentation
DEPRECATED = AddTableRowsFromDocumentChoiceOperation.deprecated
ORDER = 100
CATEGORY = ""
POSTLOAD = True
POSTCHARACT = False
POSTCLASSIF = False
POSTEXTRACTION = False
CONFIGURATION_PARAMETERS = AddTableRowsFromDocumentChoiceOperation.configuration_parameters


def run(uuid=None, **params):
    return AddTableRowsFromDocumentChoiceOperation(uuid, **params).run()

Configurar el botón de ejecución

1. Añade un campo de tipo botón en el formulario.

2. En la configuración del campo, selecciona la operación creada en la opción "Apply this automation on update event "

3. Configura la etiqueta del botón, por ejemplo: “Añadir filas desde documentos seleccionados”.

4. Guarda los cambios.

    

🧪 Resultado

• El usuario selecciona documentos en el campo Choice.

• Pulsa el botón.

• La operación recupera esos documentos y crea una fila en el ITable por cada uno.

Cada ejecución añadirá nuevas filas correspondientes a los documentos seleccionados.

💡 Buenas prácticas

• Usa el campo product_uuid como identificador único en la tabla.

• Guarda el valor del ITable siempre en formato JSON (json.dumps).

• Si quieres evitar duplicados, haz la operación idempotente (ver receta “Evitar duplicados en ITable”).

• Añade logs con fil.set_feature() para registrar errores o depurar.

🧠 Tip: Este patrón puede aplicarse a cualquier tipo de relación entre documentos:
Expedientes ↔ Subdocumentos, Contratos ↔ Proveedores, Empleados ↔ Equipos asignados, etc.