Servicios Útiles y Servicios de Negocio

En la siguiente sección, se realzan algunos de los servicios de negocio y los servicios provistos por el producto que pueden ser útiles para las implementaciones.

Servicio de Explorador de Datos

El sistema proporciona un mecanismo para realizar una sentencia Select de SQL para usar en el scripting, en los conectores Java o mediante llamadas de solicitud de servicio web. Esto se realiza creando una zona mediante uno de los tipos de zona de explorador de datos en los que se define SQL. A continuación, cree un servicio de negocio con el servicio de Explorador de Datos (FWLZDEXP).

Nota: Se proporcionan varios servicios de negocio con el producto base que hacen referencia a este servicio, que se puede usar como plantilla.

En los siguientes puntos, se realza cómo crear su propio servicio de negocio para este servicio. Tenga en cuenta que normalmente existe un servicio de negocio separado para cada zona.

  • Ingrese un código de Servicio de Negocio y una Descripción. Se recomienda definir el código del servicio de negocio para que se asocie con el código de zona de manera que sea más fácil administrar qué servicio de negocio invoca qué zona.
  • Seleccione el Nombre de Servicio FWLZDEXP.
  • En el separador Esquema, en el nodo <schema> , ingrese el mapeo de los campos que requiere el servicio de Explorador de Datos:
    • La Zona se debe mapear al campo de servicio ZONE_​CD . Defina el código de zona como valor por defecto.
    • Para cada filtro de usuario definido en la zona, cree un mapeo de esquema en el campo de servicio Fx_​VALUE , donde "x" es el número de filtro (de los parámetros de zona).
    • Para cada filtro oculto definido en la zona, cree un mapeo en el campo de servicio Hx_​VALUE , donde "x" es el número de filtro (de los parámetros de zona).
    • El servicio de explorador de datos devuelve los resultados de búsqueda en forma de lista. Cada valor de columna aparece en el campo de servicio COL_​VALUE con un número de secuencia adecuado ( SEQNO ). Los resultados se pueden nivelar en función del número de secuencia, lo que permite que se defina un nombre de elemento lógico.
    • Otro campo útil es ROW_​CNT , que proporciona el número de filas que se recuperan con la búsqueda.

El siguiente es un ejemplo del esquema para un Servicio de Negocio que recibe un código de objeto de negocio y devuelve una lista de valores de estado y sus descripciones, que permiten definir los motivos de estado.


<schema>
     <zone mapField="ZONE_CD" default="F1-BOSTSLST"/>
     <bo mapField="H1_VALUE" />>
     <rowCount mapField="ROW_CNT"/>>
     <results type="list" mapList="DE">>
          <status dataType="string" mapField="COL_VALUE">
               <row mapList="DE_VAL">>
                    <SEQNO is="1" />>
               </row>>
          </status>>
          <description dataType="string" mapField="COL_VALUE">
               <row mapList="DE_VAL">>
                    <SEQNO is="2" />>
               </row>>
          </description>>
      </results>>
</schema>

Servicio de Registro de Objeto de Mantenimiento

Muchos objetos de mantenimiento soportan una tabla de registro que sigue un patrón de comportamiento y de nombres de columnas. El sistema proporciona un servicio llamado Servicio de Registro de Objeto de Mantenimiento Genérico (F1MOLOGP) que se puede usar para realizar funciones comunes relacionadas con registros de entrada:

  • Leer registros de entrada. Si transmite un Objeto de Mantenimiento, una clave primaria y un número de secuencia de registro determinados, el servicio devolverá los detalles de ese registro de entrada. El producto proporciona un servicio de negocio genérico que se puede usar para este fin: Objeto de Mantenimiento Genérico: Recuperar Detalles de Registro (F1–ReadMOLog). De manera alternativa, es posible crear un servicio de negocio para un Objeto de Mantenimiento determinado en el que el código del Objeto de Mantenimiento se asigne al elemento del Objeto de Mantenimiento por medio de la sintaxis por defecto. Esto permite que la funcionalidad de negocio específica de ese objeto de mantenimiento use el Servicio de Negocio específico.

  • Agregar registro. Se puede usar el servicio para agregar un registro de entrada. Si se agrega un registro de usuario, los comentarios del usuario se completan en la descripción detallada. Los registros de entrada generados por el sistema normalmente proporcionan la categoría o el número del mensaje junto con otra información, como el estado, un tipo de registro específico y, de manera opcional, una referencia de objeto relacionado (por medio de una característica). El producto proporciona un servicio de negocio genérico que se puede usar para este fin: Agregar Registro de Objeto de Mantenimiento Genérico (F1–AddMOLog). De manera alternativa, es posible crear un servicio de negocio para un Objeto de Mantenimiento determinado en el que el código del Objeto de Mantenimiento se asigne al elemento del Objeto de Mantenimiento por medio de la sintaxis por defecto. Esto permite que la funcionalidad de negocio específica de ese objeto de mantenimiento use el Servicio de Negocio específico.

Servicios de Negocio Base

En la siguiente tabla, se realzan algunos servicios de negocio proporcionados por el producto que pueden ser útiles para la lógica personalizada de una implementación.

PRECAUCIÓN: Esta tabla no pretende ser una referencia completa de los Servicios de Negocio. Consulte la página de servicios de negocio para buscar todos los servicios de negocio soportados.

Servicios Relacionados con Objetos de Negocio

Nombre de Servicio de Negocio Descripción
F1-AutoTransitionBO Ejecuta algoritmos de monitoreo asociados con el estado actual de una instancia de objeto de negocio determinada (que puede tener como resultado la transición al siguiente estado).
F1-CompareBusinessObjectData Compara dos versiones de una instancia de objeto de negocio específica.
F1-DetermineBo Determina el objeto de negocio de una instancia específica de un objeto de mantenimiento ejecutando la lógica Determinar Objeto de Negocio del Objeto de Mantenimiento.
F1-GetRequiredFieldsForBOState Devuelve los campos requeridos para un estado de objeto de negocio determinado.
F1-RetrieveBOOption Devuelve los valores de opción de Objeto de Negocio de un Objeto de Negocio determinado y el tipo de opción.
F1-RetrieveBOStatusOption Devuelve los valores de opción de Objeto de Negocio de un Objeto de Negocio determinado, el estado y el tipo de opción.
F1-RetrieveBOStatusOption Recupera una lista de Objetos de Negocio de un Objeto de Mantenimiento determinado a los que puede acceder el usuario actual.
F1-RetrieveBoStatusDescription Devuelve la descripción de un estado de Objeto de Negocio determinado.
F1-RetrieveBusinessObjectLabel Devuelve la etiqueta adecuada para una ruta determinada (por ejemplo, de elemento) dentro de un esquema de Objeto de Negocio.
F1-RetrieveNextStates Devuelve una lista de los próximos estados posibles en función de la entrada de un Objeto de Mantenimiento y su clave primaria, o un Objeto de Negocio y uno de sus estados.

Servicios Relacionados con el Correo Electrónico

Nombre de Servicio de Negocio Descripción
F1-EmailService Envía un mensaje de correo electrónico en tiempo real.
F1-RetrieveEmailAddress Recupera las direcciones de correo electrónico de los usuarios que pertenecen a un Rol de Tarea.
F1-RetrieveEnvironmentURL Recupera la información del URL de entorno actual para la instalación.

Herramientas para Mapeo y Scripting

Nombre de Servicio de Negocio Descripción
F1-AddWarning Este servicio de negocio puede utilizarse para registrar una advertencia y especificar los detalles del mensaje. El sistema recopila todas las advertencias y las despliega juntas al usuario.
F1-CheckOnlineConnection Verificar si la Conexión es En Línea o de Lote.
F1-CheckWarning Se utiliza para controlar si se acumularon advertencias. Si se acumularon advertencias, no se debe ejecutar ninguna lógica que no se pueda revertir (cuando se muestran las advertencias).
F1–DateMath Realiza distintos cálculos matemáticos para la fecha y la hora. Consulte la descripción del Servicio de Negocio para obtener más detalles.
F1-DateTimeFormattingService Formatea una fecha/hora determinada en función de la configuración de perfil de despliegue del usuario.
F1-ExecuteScriptInNewSession Ejecuta un Script de Servicio en una nueva transacción/sesión de procesamiento.
F1-GetFieldLabel Recupera la etiqueta para un campo determinado.
F1-GetForeignKeyReference Devuelve información de referencia de clave foránea para una Referencia de Clave Foránea y una clave primaria determinadas, que incluye la descripción de la información, la opción de navegación y el menú contextual.
F1-GetFKReferenceDetails Devuelve información de referencia de clave foránea para un Objeto de Mantenimiento y una clave primaria determinados, que incluye el código de referencia de Clave Foránea, la descripción de la información, la opción de navegación, la zona de búsqueda y el menú contextual.
F1-GetLookupDescription Devuelve la descripción de consulta para un valor de campo de consulta en función del nombre de campo de consulta.
F1-GetExtLookUpVal Devuelve la lista de valores para un Objeto de Negocio de consulta extensible determinado.
F1-GetMonthInYearAbbreviation Devuelve una abreviatura de mes de tres caracteres para una fecha de entrada en el formato del sistema.
F1-NumberAmountFormatter Formatea un importe o un número determinado en función de la configuración de perfil de despliegue del usuario. También puede recibir una entrada para ajustar la escala y, de manera opcional, aplicar la configuración de divisa.
F1-OutmsgDispatcher Despacha un mensaje en tiempo real y da al usuario la opción de mantener el mensaje en la base de datos y de capturar los errores que se produzcan durante la llamada. Consulte Mensajes en Tiempo Real para obtener más información.
F1-OutmsgMediator Alternativa a F1-OutmsgDispatcher y puede ser una mejor opción si el emisor no requiere que se inicialice un registro de mensaje de salida. Consulte Mensajes en Tiempo Real para obtener más información.
F1-RethrowError Emite un error de aplicación usando los parámetros, el número o la categoría de mensaje de entrada.
F1-RetrieveMODescription Recupera la descripción de un objeto de mantenimiento.
F1-ReturnMessage Recupera el mensaje ampliado en función de la categoría, el número, los parámetros y los tipos de parámetro del mensaje.
F1-SavePointDispatcher Permite que un script de servicio se ejecute cuando se capturan excepciones y se revierte la transacción a un punto de grabado definido antes de la ejecución del script de servicio.

Servicios Relacionados con el Usuario

Nombre de Servicio de Negocio Comentarios
F1-CheckApplicationSecurity Controla la seguridad de un usuario para un modo de acceso/servicio de aplicación determinado.
F1-CheckUserAuthorization Determina si un usuario específico tiene acceso autorizado en función del servicio de aplicación, el código de seguridad y el nivel de autorización de entrada.
F1-DetermineIfUserCanApproveTD Determina si el usuario actual puede aprobar una Tarea determinada.