2.1. Objetivo
Permitir al usuario realizar upload/download de un documento a la central de documentos del FLUIG(GED), vinculando este a un registro en la base de datos de negocio. Esta funcionalidad se podrá utilizar en formularios metadatos del tipo CRUDFreeForm o FreeForm.
2.2. Guía de uso
Cuando en un formulario se presenta un registro seleccionado por el usuario, el componente de Acciones Relacionadas del mismo puede presentar un ítem para permitir asociar un documento cualquiera con el registro seleccionado. La Figura 1.2.a presenta un CRUD Metadatos con un registro seleccionado, cuando el usuario haga clic en Acciones Relacionadas se presentará el ítem Asociación de Documentos.
Gráfico 1.2:
En el caso de CRUDFreeForm, cuando el usuario selecciona un registro (sólo 1) en la red de búsqueda, automáticamente el elemento Asociación de documentos deberá estar disponible. En el caso de FreeForm se deberá utilizar un código ABLScript para habilitar el elemento.
Cuando el usuario hace clic en el elemento Documento asociación, se presentará la ventana del gráfico 1.2. b.
Gráfico 1.2.b
Después de confirmar la operación se presentará ante el usuario la ventana del Gráfico 1.2.c. Allí, podrá hacer clic en el botón Seleccionar para elegir un archivo en el equipo local.
Figura 1.2.c
El sistema cargará el archivo y lo enviará a una carpeta en el GED. Luego aparecerá la pantalla que se muestra en el gráfico 1.2.d.
Figura 1.2.d
Después de insertar un documento, el usuario podrá agregar opcionalmente otros archivos para asociar con el mismo registro, como se muestra en el gráfico 1.2.e.
Gráfico 1.2.e
En otras ocasiones el usuario podrá volver a seleccionar el mismo registro, abrir las Acciones Relacionadas y hacer clic nuevamente en Asociación de documentos (Gráfico 1.2.a). Desde este punto el usuario podrá descargar dos archivos asociados nuevamente a la máquina local o eliminar la asociación del documento con el registro, como se muestra en los gráficos 1.2.f y 1.2 g.
Gráfico 1.2.f
Gráfico 1.2.g
2.3. Guía de Programación
Para el componente de Acciones Relacionadas de un CRUDFreeForm pueda mostrar el elemento Asociación de Documentos, debe establecerse mediante ABLScript la propiedad enableDocRel, como se muestra en el ejemplo siguiente:
DEFINIRPROPIEDAD(relatedActions, "enableDocRel", true).
En caso de formularios FreeForm
el desarrollador deberá agregar el componente RelatedActionsOperation.
Cuando haya un registro seleccionado en el formulario, se debe
ejecutar un script similar al siguiente:
DEFINE VARIABLE relatedActions AS WIDGET-HANDLE. DEFINE VARIABLE data AS CHARACTER. DEFINE TEMP-TABLE ttFullRecId FIELD databaseName AS CHARACTER FIELD tableName AS CHARACTER FIELD recordKeys AS CHARACTER. DEFINE TEMP-TABLE ttRecId FIELD cdn_cliente AS INTEGER FIELD cod_empresa AS CHARACTER. CREATE ttRecId. ttRecId.cdn_cliente = 3455. ttRecId.cod_empresa = "1". data = JSON-ENCODE(ttRecId, true). CREATE ttFullRecId. ttFullRecId.databaseName = "emsuni". ttFullRecId.tableName = "cliente". ttFullRecId.recordKeys = data. data = JSON-ENCODE(ttFullRecId, true). SETPROPERTY(relatedActions, "enableDocRel", true). CALLFUNCTION(relatedActions, "setDocRecordId", data).
La información sobre las asociaciones entre registro y
documentos se almacenan en una tabla llamada docto_ged_relac_rec
en el banco EMSFND.