Servicios útiles y servicios de negocio

En la siguiente sección se resaltan algunos servicios de negocio y servicios proporcionados por el producto que pueden resultar útiles para las implantaciones.

Servicio de explorador de datos

El sistema proporciona un mecanismo para ejecutar una sentencia select de SQL que se usará en los scripts, los plug-ins de Java o mediante una llamada de servicio web. Esto se realiza creando una zona con uno de los tipos de zona del explorador de datos en la que está definida la sentencia SQL. A continuación, cree un servicio de negocio mediante el servicio Explorador de datos (FWLZDEXP).

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

Los puntos siguientes resaltan cómo crear su propio servicio de negocio para este servicio. Tenga en cuenta que, normalmente, hay un servicio de negocio independiente para cada zona.

  • Introduzca un código Servicio de negocio y una Descripción. Se recomienda definir el código de servicio de negocio para que coincida con el código de zona, lo que facilita gestionar qué servicio de negocio llama a qué zona.
  • Seleccione el Nombre de servicio FWLZDEXP.
  • En la pestaña Esquema, en el nodo <schema> , introduzca la asignación de los campos que son necesarios para el servicio Explorador de datos:
    • La Zona debe asignarse en el 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 una asignación 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 una asignación de esquema en el campo de servicio Hx_​VALUE , donde "x" es el número de filtro (de los parámetros de zona).
    • El servicio del explorador de datos devuelve los resultados de la búsqueda como una lista. Cada valor de las columnas está en el campo de servicio COL_​VALUE con un número de secuencia adecuado ( SEQNO ). Los resultados se pueden acoplar en función del número de secuencia, lo que permite definir un nombre de elemento lógico.
    • Otro campo útil es ROW_​CNT , que proporciona el número de filas recuperadas por su búsqueda.

A continuación se proporciona un ejemplo del esquema para un servicio de negocio que recibe un código de objeto de negocio y devuelve una lista de los valores de estado y sus descripciones en la que se pueden definir los motivos del 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 log de objeto de mantenimiento

Muchos objetos de mantenimiento soportan una tabla de log que sigue un patrón de nombres de columna y comportamiento. El sistema proporciona un servicio denominado Servicio de log de objeto de mantenimiento genérico (F1MOLOGP) que puede usarse para realizar funciones comunes relacionadas con las entradas de log:

  • Leer entradas de log. Si transfiere un determinado objeto de mantenimiento, clave primaria y número de secuencia de log, el servicio devolverá los detalles de esa entrada de log. El producto proporciona un servicio de negocio genérico que puede usarse con este fin: Objeto mantenimiento genérico - Recuperar detalles de log (F1–ReadMOLog). También es posible crear un servicio de negocio para un determinado objeto de mantenimiento, en el que el código de dicho objeto se asigna a su elemento usando la sintaxis por defecto. Esto permite que la funcionalidad de negocio específica de ese objeto de mantenimiento utilice el servicio de negocio específico.

  • Añadir log. El servicio se puede usar para añadir una entrada de log. Si se añade un log de usuario, los comentarios de dicho usuario se rellenan en la descripción detallada. Normalmente, las entradas de log generadas por el sistema suministran la categoría y el número del mensaje, junto con otra información, como el estado, un tipo de log específico y, de forma opcional, una referencia de objeto relacionada (mediante una característica). El producto proporciona un servicio de negocio genérico que puede usarse con este fin: Añadir log de objeto de mantenimiento genérico (F1–AddMOLog). También es posible crear un servicio de negocio para un determinado objeto de mantenimiento, en el que el código de dicho objeto se asigna a su elemento usando la sintaxis por defecto. Esto permite que la funcionalidad de negocio específica de ese objeto de mantenimiento utilice el servicio de negocio específico.

Servicio de negocio base

En la siguiente tabla se resaltan algunos servicios de negocio proporcionados por el producto que pueden resultar útiles para la lógica personalizada de una implantación.

PRECAUCIÓN: no está diseñada para ser una guía de referencia completa de los servicios de negocio. Consulte la página del servicio de negocio para ver todos los servicios de negocio soportados.

Servicios relacionados con objetos de negocio

Nombre de servicio de negocio Descripción
F1-AutoTransitionBO Realiza algoritmos de supervisión asociados al estado actual de una determinada instancia de objeto de negocio (lo que puede una transición de estado posterior).
F1-CompareBusinessObjectData Compara dos versiones de una determinada instancia de objeto de negocio.
F1-DetermineBo Determina el objeto de negocio de una determinada instancia de un objeto de mantenimiento al ejecutar la lógica 'El objeto de mantenimiento determina el objeto de negocio'.
F1-GetRequiredFieldsForBOState Devuelve los campos obligatorios para un determinado estado de objeto de negocio.
F1-RetrieveBOOption Devuelve los valores de las opciones de un objeto de negocio para un determinado tipo de objeto de negocio y opción.
F1-RetrieveBOStatusOption Devuelve los valores de las opciones de un objeto de negocio para un determinado objeto de negocio, estado y opción.
F1-RetrieveBOStatusOption Recupera una lista de objetos de negocio para un determinado objeto de mantenimiento al que tenga acceso el usuario actual.
F1-RetrieveBoStatusDescription Devuelve la descripción de un determinado estado de objeto de negocio.
F1-RetrieveBusinessObjectLabel Devuelve la etiqueta adecuada para una determinada ruta (por ejemplo, element) en un esquema de objeto de negocio.
F1-RetrieveNextStates Devuelve una lista de los siguientes 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 de la URL del entorno actual para la instalación.

Herramientas para mapas y scripts

Nombre de servicio de negocio Descripción
F1-AddWarning Este servicio de negocio se puede utilizar para registrar un aviso indicando los detalles de mensaje. El sistema recopila todos los avisos y los muestra al mismo tiempo al usuario.
F1-CheckOnlineConnection Comprueba si la conexión es en línea o por lotes.
F1-CheckWarning Se utiliza para comprobar si se han acumulado avisos. En caso afirmativo, no se podrá realizar ninguna lógica que no se pueda retroceder (cuando se muestran avisos).
F1-DateMath Realiza diversos cálculos matemáticos de fecha y hora. Consulte la descripción del servicio de negocio para obtener más detalles.
F1-DateTimeFormattingService Asigna formato a una determinada fecha y hora en función de la configuración del perfil de visualización del usuario.
F1-ExecuteScriptInNewSession Ejecuta un script de servicio en una nueva transacción o sección de procesamiento.
F1-GetFieldLabel Recupera la etiqueta de un determinado campo.
F1-GetForeignKeyReference Devuelve la información de referencia de clave externa para una determinada clave primaria, incluidos la descripción de la información, la opción de navegación, la zona de búsqueda y el menú contextual.
F1-GetFKReferenceDetails Devuelve la información de referencia de clave externa para un determinado objeto de mantenimiento y clave primaria, incluidos el código de referencia de clave externa, 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 del valor de un campo de lista de valores cuando se proporciona su nombre.
F1-GetExtLookUpVal Devuelve la lista de valores de un objeto de negocio de búsqueda ampliable.
F1-GetMonthInYearAbbreviation Devuelve una abreviatura de mes con tres caracteres para una fecha de entrada en el formato del sistema.
F1-NumberAmountFormatter Asigna formato a una determinada cantidad o número en función de la configuración del perfil de visualización del usuario. También puede recibir una entrada para ajustar la escala y, de forma opcional, aplicar la configuración de divisa.
F1-OutmsgDispatcher Emite un mensaje en tiempo real que proporciona al usuario la opción de mantener el mensaje en la base datos, así como detectar errores que puedan tener lugar durante la llamada. Para obtener más información, consulte Mensajes en tiempo real.
F1-OutmsgMediator Se trata de una alternativa a F1-OutmsgDispatcher y puede ser una mejor opción en caso de que el remitente no necesite crear una instancia del registro del mensaje saliente. Para obtener más información, consulte Mensajes en tiempo real.
F1-RethrowError Emite un error de aplicación con los parámetros, el número y la categoría del mensaje.
F1-RetrieveMODescription Recupera descripción de un objeto de mantenimiento.
F1-ReturnMessage Devuelve el mensaje ampliada, según la categoría del mensaje, el número, los parámetros y el tipo de parámetro.
F1-SavePointDispatcher Permite la ejecución de un script de servicio en el que las excepciones se detectan y la transacción se revierte a un punto guardado establecido antes de la ejecución del script.

Servicios relacionados con el usuario

Nombre de servicio de negocio Comentarios
F1-CheckApplicationSecurity Comprueba la seguridad de un usuario para un determinado servicio de aplicación o modo de acceso
F1-CheckUserAuthorization Determina si un determinado usuario está autorizado para acceder en función del servicio de la aplicación de entrada, el código de seguridad y el nivel de autorización.
F1-DetermineIfUserCanApproveTD Determina si el usuario actual puede aprobar una determinada tarea.