¿Cómo configurar funciones del usuario?

Crear una función de usuario Query SQL

1. Acceder a Extensibilidad | Funciones en el área de configuraciones del ERP (backstage);
2. Hacer clic en Nueva;
3. En la pestaña General, definir el nombre de la función;
4. Definir el tipo de función, seleccionando la función Query SQL;
5. Indicar una descripción de la función (opcional);
6. En la pestaña Definición ,indicar la Query SQL a utilizar en la ejecución;
7. Por fin, Confirmar.

Al definir las funciones del usuario tipo Query SQL, podrás utilizar parámetros en la especificación de la Query. De este modo, se potencializa la adaptabilidad a escenarios que utilicen componentes de naturaleza variable.

También deberás definir el resultado de la función, una vez que la manera como la datatable resultante de la Query SQL será interpretada por el motor de ejecución depende del tipo de resultado seleccionado:

• Ningún: la Query SQL no devuelve ningún resultado;
• Texto, Entero, Numérico, Fecha, Booleano: la Query SQL devuelve una datatablecon solo un registro y una sola columna, que se debe interpretar según el tipo de datos seleccionado;
• Lista de Registros: la Query SQL devuelve una datatable con diversos registros y diversas columnas.

Crear una función de usuario Email

1. Acceder a la opción Extensibilidad | Funciones en el área de configuraciones del ERP (backstage);
2. Hacer clic en Nueva;
3. En la pestaña General, definir el nombre de la función;
4. Definir el tipo de función, hacer clic en la opción Email;
5. Indicar una descripción de la función (opcional);
6. En la pestaña Definición, definir el destinatario, seleccionando la opción Para e indicar la dirección de email del destinatario;
7. Definir el asunto, indicando el tópico del asunto del mensaje;
8. Definir el mensaje e introducir el contenido del mensaje;
9. Indicar los adjuntos, seleccionando los archivos a adjuntar al mensaje (opcional);
10. Por fin, Confirmar.

Al definir las funciones de usuario del tipo Email, se sugiere el uso de parámetros en la configuración del mensaje de email. Así, puede reforzarse el envío del mensaje, independientemente de los destinatarios y de otras particularidades meramente adaptables en el contexto del mensaje.

Nota: Las funciones del tipo Email no permiten la definición de los respectivos resultados.

Crear una función de usuario Formulario de Usuario

1. Acceder a Extensibilidad | Funciones en el área de configuraciones del ERP (backstage);
2. Hacer clic en Nueva;
3. En la pestaña General, definir el nombre de la función;
4. Definir el tipo de función, hacer clic en la opción Formulario de Usuario;
5. Indicar una descripción de la función (opcional);
6. En la pestaña Definición, seleccionar el formulario de usuario a utilizar en la ejecución;
   Nota: Los formularios personalizados deben ser previamente implementados en PEX (Extensibility) y las extensiones deben ser asociadas a la empresa;
7. Por fin, Confirmar.

Las funciones do tipo Formulario de Usuario no permiten la definición de parámetros ni de resultados.

Crear una función de usuario Aplicación Externa

1. Acceder a Extensibilidad | Funciones en el área de configuraciones del ERP (backstage);
2. Hacer clic en Nueva;
3. En la pestaña General, definir el nombre de la función;
4. Definir el tipo de función, hacer clic en la opción Aplicación Externa;
5. Indicar una descripción de la función (opcional);
6. En la pestaña Definición, definir el comando, identificando la ubicación de la aplicación/documento externo;
7. Definir los parámetros, enumerando los parámetros adicionales a aplicar en la ejecución (opcional);
8. Definir el directorio inicial, identificando la respectiva ubicación física (opcional);
9. Definir el tipo de ventana a utilizar en la ejecución;
10. Por fin, Confirmar.

Al definir las funciones de usuario del tipo Aplicación Externa, se sugiere el uso de parámetros en la configuración del mensaje de email. De este modo, la ejecución de una determinada aplicación o documento se potencializa con base en criterios dinámicos.

La ejecución de aplicaciones externas permite definir que tratamiento aplicar al resultado, permitiendo especificar dos tipos de resultados:

• Ningún: el motor de ejecución no gestionará el resultado de la ejecución;
• Entero: la aplicación ejecutada producirá un exit code que el motor gestionará al final de la ejecución.

Crear una función de usuario Informe de Usuario

1. Acceder a Herramientas | Funciones del Usuario;
2. Hacer clic en Nueva;
3. En la pestaña General, definir el nombre de la función;
4. Definir el tipo de función, hacer clic en la opción Informe de Usuario;
5. Indicar una descripción de la función (opcional);
6. En la pestaña Definición, definir el informe a ser ejecutado;
7. Seleccionar el formato del informe;
8. Definir el envío por email, si se desea enviar el resultado de la ejecución del informe por email (opcional);
9. Definir la ubicación física, si se desea guardar el resultado de la ejecución del informe en archivo (opcional);
10. Por fin, Confirmar.

Al definir las funciones del tipo Informes de Usuario se sugiere la utilización de parámetros en la configuración del informe, de forma a facilitar la adaptación al proceso de exportación. Si el informe de usuario tiene parámetros definidos en el Crystal Reports, estos serán automáticamente detectados y añadidos a la lista de parámetros de la función.

El resultado de este tipo de función es fijo y corresponde siempre a la ubicación física del informe de usuario después de exportado en el formato seleccionado.

No será ofrecido el resultado de la ejecución si la configuración de la función de usuario no incluye el envío del informe por email y/o la exportación para un directorio en el disco.

Crear una función macro de extensibilidad

Las macros de extensibilidad deben ser creadas en extensiones PEX y cargadas en la configuración de extensibilidad antes de que sea posible crear funciones con base en las macros de estas extensiones.

Podrás consultar las extensiones en Extensibilidad | Extensiones en el área de configuraciones del ERP.

Para crear una función macro de extensibilidad, deben seguirse los siguientes pasos:

1. Acceder a Extensibilidad | Funciones en el área de configuraciones del ERP (backstage);
2. Hacer clic en Nueva;
3. Seleccionar la pestaña General;
4. Definir el nombre de la función;
5. Seleccionar la opción Macro Extensibilidad en el tipo de función;
6. Indicar una descripción de la función (opcional);
7. Seleccionar la pestaña Definición;
8. Definir el proyecto en el cual está definida la macro;
9. Seleccionar la macro definida en el proyecto Extensibilidad;
10. Por fin, clicar em Confirmar.

Nota: Los parámetros de la función de usuario serán los parámetros que corresponden a la función que implementa la macro. El resultado de la función de usuario también será determinado por la definición de la macro, como el tipo de retorno de la función que implementa la macro.

Crear una función de usuario Stored Procedure

1. Acceder a Extensibilidad | Funciones en el área de configuraciones del ERP (backstage);
2. Hacer clic en Nueva;
3. En la pestaña General, definir el nombre de la función;
4. Definir el tipo de función, seleccionando la función Stored Procedure;
5. Indicar una descripción de la función (opcional);
6. En la pestaña Definición, seleccionar la Stored Procedure a utilizar en la ejecución;
7. Por fin, Confirmar.

Los parámetros de la función de usuario serán determinados por la propia definición de la Stored Procedure en la base de datos.

Deberá definirse el resultado de la función. A pesar de que normalmente una stored procedure no produzca resultados, el SQL Server permite que la respectiva definición incluya queries en la base de datos.

Si definidas correctamente, estas queries permiten simular un resultado en forma de un recordset. La forma como el motor de ejecución interpreta el recordset depende del tipo de resultado seleccionado:

• Ningún: la Stored Procedure no devuelve ningún resultado;
• Texto, Entero, Numérico, Fecha, Booleano: la Stored Procedure devuelve un recordset con solo un registro y una sola columna, que se debe interpretar según el tipo de datos seleccionado;
• Lista de registros: la Stored Procedure devuelve un recordset con diversos registros y diversas columnas.

Crear una función de usuario User Defined Function

1. Acceder a Extensibilidad | Funciones en el área de configuraciones del ERP (backstage);
2. Hacer clic en Nueva;
3. En la pestaña General, definir el nombre de la función;
4. Definir el tipo de función, seleccionando la función User Defined Function;
5. Indicar una descripción de la función (opcional);
6. En la pestaña Definición, seleccionar la User Defined Function a utilizar en la ejecución;
7. Por fin, Confirmar.

Nota: Los parámetros y resultados de la función de usuario serán determinados por la propia definición User Defined Function en la base de datos.