Suscríbete a DeepL Pro para poder editar este documento.

Entra en www.DeepL.com/pro para más información.

Si desea acceder a los datos almacenados en Oracle Field Service y construir integraciones con
otros sistemas, va a ejecutar algunas solicitudes de API. Estos sistemas a los que me refiero
podrían ser otras aplicaciones u ofertas de Oracle Cloud, o podrían ser sistemas externos en
una red de clientes. OFS tiene varias APIs disponibles para hacer fluir los datos adecuados. Y la
que podría decirse que es la más potente es la Core REST API.
Esta es la API principal que se utiliza para dar soporte a una variedad de casos de uso
relacionados con los datos de las principales entidades de OFS: actividades, recursos, usuarios
e inventario, entre otros. A alto nivel, estas son las entidades que soporta la API principal. Esta
es una captura de pantalla de una aplicación registrada y configurada. Y puede ver que tiene la
capacidad de establecer permisos para la autenticación de la API para cada una de las
entidades según sea necesario.
Lectura-escritura es la opción si quiere ser capaz de recuperar y crear o actualizar a través de la
API, sólo lectura si quiere ser capaz de recuperar los datos, u oculto para cualquier entidad para
la que no quiera o necesite el soporte de la API-- Explicaré brevemente algunas de las
capacidades que la API REST Core ofrece con respecto a cada una de estas entidades, sólo lo
suficiente para darle un poco de alimento para el pensamiento. Pero para la lista completa de
capacidades y detalles, por favor consulte la documentación de la API para OFS, así como las
lecciones en la suscripción de aprendizaje.
¿Preparado? BIEN. Hay una serie de métodos que le permiten establecer, obtener o eliminar
actividades individuales o enlaces asociados, así como cualquier necesidad de inventario
requerida e incluso preferencias de recursos. Y si hay algún archivo correspondiente asociado a
las actividades, también se puede gestionar a través de esta API. Si utiliza actividades
segmentables, puede ejecutar una solicitud para devolver todos los segmentos de una actividad.
Y, por supuesto, puedes añadir o actualizar actividades de forma individual o en bloque.
Si necesita consultar una actividad, también hay funciones de búsqueda. Esto permite que sus
clientes puedan consultar el estado de sus citas por sí mismos, entre otros casos de uso. Y si
utiliza OFS para gestionar el uso del inventario sobre el terreno, la Core API ofrece la posibilidad
de especificar qué inventario se encuentra ya en las instalaciones de un cliente. También puede
obtener detalles de lo que se ha instalado o desinstalado. Y, por supuesto, también puede
gestionar el inventario de los técnicos, pero esos métodos entran en la categoría de recursos.
Por último, también se admiten las actualizaciones de estado previstas para las actividades.
Esto es lo más necesario cuando los recursos de campo utilizan aplicaciones móviles de
terceros o propias en lugar de la aplicación OFS Core. Muchos clientes realizan un seguimiento
del uso y consumo de inventario como parte de su negocio de servicios de campo.
Entonces, ¿qué proporciona la API principal para apoyar ese seguimiento? Para empezar, hay
algunos comandos que se pueden utilizar para gestionar lo que hay en los grupos de inventario.
Esto incluye la capacidad de crear, actualizar y eliminar el inventario asociado a las actividades
o a los recursos, incluso de forma masiva, cuando sea necesario. Y al igual que con otras
entidades, el inventario también puede tener archivos en su lugar. Por lo tanto, los métodos para
tratarlos también están disponibles.
Si está utilizando su propia aplicación móvil, probablemente necesitará métodos para que sus
recursos realicen acciones sobre el inventario en el campo, así que cosas como instalar o
desinstalar, básicamente el seguimiento del consumo, pueden ser necesarias. Y también un
método para recuperar detalles sobre una pieza específica del inventario.
¿Gestiona usted la información de los recursos dentro de otro sistema, como en el SIRH, y
luego la pasa a OFS? Hay varios métodos disponibles dentro de la API principal para ayudarle a
hacerlo. Tanto si necesita rellenar o modificar su jerarquía organizativa dentro de OFS como
mantener actualizadas las habilidades laborales, las zonas de trabajo, los calendarios y las
ubicaciones de sus recursos, hay comandos de la API disponibles para hacerlo.
En cuanto a los registros de recursos propiamente dichos, hay algunas cosas que puedes hacer
con ellos. La más obvia será la capacidad de crear y modificar los registros y, una vez más,
asociar archivos con ellos, como fotos de sus técnicos, por ejemplo. La capacidad de encontrar
recursos que tengan las habilidades, la accesibilidad y la disponibilidad para realizar el trabajo
es otro poderoso método disponible dentro del Core API. Esta solicitud de búsqueda de recursos
coincidentes es sólo una opción a la hora de reservar directamente ciertas actividades a los
recursos de campo.
También hay un método que puede encontrar recursos cercanos para un trabajo urgente y dar
estimaciones sobre el tiempo que se tardará en llegar al lugar de trabajo. Hay algunos métodos
que pueden ayudarte a preparar los recursos para el enrutamiento. Puedes crear ubicaciones en
el nivel de recursos en el que pueden ser utilizados o compartidos y luego obtener una lista de
ellos para obtener sus ID de ubicación. Con eso, puede entonces establecer esas ubicaciones
para los recursos en función de los días de la semana, ya sea para las ubicaciones de inicio o
finalización o para la referencia del centro de la zona de origen. Incluso las ubicaciones
temporales se pueden gestionar a través de la API.
También puede obtener, establecer y eliminar las habilidades de trabajo, las zonas de trabajo y
las configuraciones de calendario que se asignan a varios recursos. Esto es útil si está
gestionando las habilidades, certificaciones o formación de los recursos desde un sistema fuente
como un HRIS, y quiere mantener OFS actualizado cuando esas habilidades cambian. Como
mencioné anteriormente, también tiene métodos para establecer y recuperar el inventario que
debe ser parte del grupo de recursos o de técnicos, es decir, especificar quién tiene qué
inventario en su inventario.
En cuanto a las rutas, además de poder activar o desactivar rutas, también puede recuperar una
ruta. Se trata de una solicitud bastante común en la que se puede obtener una lista actualizada
de las actividades asignadas a una determinada ruta, incluyendo sus respectivos datos y
estados. Cuando se gestionan los registros de los usuarios en OFS, se controla quién tiene
acceso a qué partes del sistema.
Entonces, ¿qué puede hacer específicamente con los registros de usuarios a través de la Core
API? Puede obtener detalles de los usuarios. Puede añadir, actualizar o eliminar cuentas de
usuario. Y también puedes establecer y recuperar cualquier archivo que esté asociado a ellos. Si
utiliza la colaboración, hay métodos que puede utilizar para controlar a qué grupos de
colaboración se asigna un usuario.
Las posiciones son en realidad un subconjunto de la información sobre los recursos, ya que se
refieren a sus geocoordenadas. Así, por ejemplo, si utiliza un proveedor de GPS o LBS de
terceros para rastrear las ubicaciones de los recursos, la Core API proporciona un método para
enviar esas coordenadas a OFS.
Ahora bien, ¿qué ocurre con la obtención de información del sistema a medida que se producen
actualizaciones sobre el terreno? Este es un caso de uso con el que se enfrentan casi todos los
clientes de OFS. La API principal admite la recuperación de datos mediante métodos de
eventos, y se puede construir una lógica adicional para admitir cualquier número de casos de
uso, flujos de trabajo o flujos de datos en relación con la forma en que deben manejarse esos
datos. Digamos que un CRM o un sistema de tickets necesita actualizarse cuando se completan
las actividades, o una base de datos de gestión de inventario necesita actualizarse cuando se
instalan o intercambian piezas o artículos con número de serie.
Las suscripciones a eventos pueden incluso incluir los resultados de las ejecuciones de
enrutamiento, lo que puede ayudar a los integradores a construir flujos de trabajo que se basen
en las distintas etapas de ejecución del enrutamiento. La idea aquí es que se pueden crear
suscripciones que se componen de varios tipos de datos. Los eventos de negocio son los
asociados a las entidades principales. Y los eventos de colaboración proporcionan detalles
sobre los mensajes de colaboración, las transmisiones o las videollamadas que se inician.
Otra característica extremadamente útil de los eventos es la capacidad de recuperar información
de cualquier variedad de formularios que hayan sido enviados. El punto aquí es que sus
suscripciones a eventos deben ser creadas en base a cómo y cuándo sus sistemas requieren
ser actualizados. Continuando, los extractos diarios se utilizan para informar sobre las
principales entidades de Oracle Field Service, como las actividades, el inventario y los mensajes
para su almacenamiento y posterior análisis.
Los datos extraídos se almacenan en la base de datos de extractos diarios como un paquete de
archivos XML. Y la API REST del núcleo es lo que usted utilizaría para extraer esos archivos.
Tenga en cuenta que los archivos sólo permanecen disponibles durante el número de días que
haya especificado como periodo de retención en la sección de reglas de negocio de OFS,
siendo 90 días el máximo.
Y por último, las solicitudes de servicio representan una funcionalidad única y muy flexible que
puede, en muchos casos, automatizar ciertos procesos. A menudo se utilizan para
desencadenar notificaciones manuales o mensajes de vuelta a los sistemas de origen para los
destinatarios clave y pueden encontrarse dentro de los contextos de las actividades, el
inventario o los recursos. También hay que señalar que el procesamiento de las solicitudes de
servicio también puede gestionarse a través de formularios en la capacidad de suscripción a
eventos de la Core API. Bien, hemos terminado por ahora. Esperemos que este tema le haya
ayudado a entender mejor las vastas capacidades que ofrece el Core API.