
En aquest document es descriu en línies generals què són els microserveis i les maneres d’executar-los. Els articles següents aporten informació més precisa sobre el seu comportament i configuració:
- Habilitat. Descriu com activar un microservei per a la seva execució per part d’un usuari final.
- Marketplace. Mostra el catàleg de microserveis disponibles.
- Dissenyador. Explica com crear microserveis nous i configurar els existents.
- Crear amb IA. Explica pas a pas com generar microserveis utilitzant llenguatge natural.
Característiques
Microserveis ofereix una sèrie d’avantatges clau. A continuació, es descriuen els més rellevants:Accés a un catàleg centralitzat
Els microserveis disponibles es troben organitzats a la secció Marketplace, on els usuaris poden explorar el catàleg, seleccionar i habilitar microserveis específics segons les necessitats de la seva organització o casos d’ús particulars.Creació de microserveis personalitzats
Es poden crear microserveis de manera senzilla a través de la secció Dissenyador. Aquesta eina guia l’usuari, sempre que compti amb els permisos adequats, a través de totes les fases necessàries per construir i configurar el seu propi microservei.Configuració de l’àmbit d’execució
Cada microservei es pot definir perquè s’executi en un dels contextos següents, configurables des de la secció Dissenyador.Execució des de l’administrador local
Permet interactuar directament amb serveis del sistema operatiu, processos i altres recursos que requereixen privilegis elevats. És ideal per a operacions que s’han d’executar amb permisos d’administrador, però pot limitar l’accés a informació específica de l’usuari o la seva sessió.Execució des de sessió d’usuari
Útil per accedir a informació de l’usuari com el registre o informació continguda al perfil. L’script s’executarà amb el nivell de permisos que tingui l’usuari, per la qual cosa, si no compta amb privilegis d’administrador local, no podrà realitzar accions que requereixin accés al sistema.Formes de consumir els microserveis
Els microserveis es poden crear i habilitar perquè siguin executats per l’usuari final, posats en marxa a través d’un flux o amb accions automatitzades.Execució a demanda des de Workspaces
Qualsevol microservei que hagi estat habilitat prèviament en Portal pot executar-se des de Workspaces.- Accedir al mòdul Workspaces → secció Workspaces o Sessions.
- Seleccionar els dispositius o sessions en els quals vols aplicar el microservei.
- Al menú superior fer clic sobre la icona de microserveis (
>_). - Seleccionar el microservei que es desitja executar.

Execució programada a través de Fluxos
Fluxos és una funcionalitat que permet definir seqüències d’automatització per executar accions programades sobre els dispositius segons l’avaluació de condicions lògiques preestablertes. La seva principal característica és que simplifica les accions de diagnòstic i soluciona els problemes ràpidament a través de l’execució d’un microservei.
Execució programada a través de Configuració d’alertes
A través de Configuració d’alertes és possible vincular esdeveniments (event logs) a un o més microserveis, per prevenir inconvenients amb el dispositiu o resoldre problemes amb immediatesa.- Accedir a Monitor → Configuració d’alertes.
- A la taula, seleccionar un nom d’alerta per accedir a la seva informació detallada.
- Al menú lateral esquerre, fer clic a la pestanya Microserveis.
- Fer clic a Vincular.
- Al formulari, triar el microservei que es vol vincular a l’alerta i l’ordre d’execució (útil quan es vol vincular més d’un microservei).
- Al formulari, fer clic a Vincular.
Execució per l’usuari final
En crear un microservei, aquest no queda habilitat automàticament per a la seva execució per part de l’usuari final. Per habilitar-lo, cal completar la configuració següent:- Accedir a Microserveis → Habilitat.
- Seleccionar un microservei del llistat.
- A la pestanya Destinataris dirigir-se a l’apartat Execució per l’usuari final.
-
Fer clic a Editar i activar Execució per l’usuari final.

Notificacions
Aquesta opció permet definir si es notificarà a l’usuari quan el microservei comenci a executar-se i quan acabi, ja sigui de forma satisfactòria o amb errors. Per fer-ho, s’ha d’activar Notificació d’usuari i completar els camps següents:- Text inicial. Missatge que es mostrarà en començar l’execució del microservei.
- Text d’èxit. Missatge que es mostrarà quan l’execució finalitzi correctament.
- Text d’error. Missatge que es mostrarà quan l’execució finalitzi amb errors.


Canviar el nom de la carpeta de microserveis
Quan els microserveis estan habilitats per a la seva execució per l’usuari final, s’afegeixen automàticament a una carpeta del dispositiu anomenada Flexxible; no obstant això, aquest nom es pot modificar.- Accedir a Configuració → Organització.
- Al menú lateral esquerre, fer clic a la pestanya Microserveis → Editar la configuració de microserveis.
- Canviar el nom de la carpeta.
- Fer clic a Desar.


Seguiment de l’execució d’un microservei
Per facilitar l’anàlisi i la resolució d’incidències, la plataforma permet consultar l’estat, la durada i el resultat de l’execució dels microserveis a través de la secció Operacions.
- Accedir a Operacions.
-
Seleccionar l’operació corresponent.
El menú lateral permet accedir a diferents àmbits de l’execució: Detalls, Workspaces i Esdeveniments.

Detalls
Aquesta pestanya mostra targetes resum amb els principals indicadors de l’operació:
- Estat. Situació actual de l’operació.
- Resum. Indicador visual del resultat global de l’operació.
- Durada. Temps total que va durar l’execució de l’operació.
- Workspaces. Quantitat de dispositius en els quals es va executar l’operació.
- Microservei. Nom del microservei executat. En fer clic s’accedeix a la seva vista de detall.
Visió general
Aquest apartat presenta una taula amb la informació següent:
- Descripció. Breu explicació de l’operació realitzada.
- Tipus d’operació. Operació executada.
- Estat. Situació actual de l’execució: Pendent, En curs, Error, Timeout o Finalitzat.
- Creat el. Data i hora de creació del registre de l’operació.
- Iniciat el. Data i hora d’inici de l’execució.
- Finalitzat el. Data i hora de finalització de l’execució.
- Data programada. Data i hora a partir de la qual s’executarà el microservei.
- Data programada màxima. Data i hora límit per a l’execució del microservei.
Workspaces
Aquesta pestanya mostra una taula amb el llistat dels dispositius sobre els quals es va executar el microservei.
- Nom. Identificació del dispositiu. En fer clic s’obre la seva vista de detall.
- Grup d’informe. Grup d’informe al qual pertany el dispositiu.
- Estat. Estat de l’execució de l’operació en aquest dispositiu.
- Iniciat el. Data i hora d’inici de l’execució.
- Finalitzat el. Data i hora de finalització.
- Accions. Permet accedir al detall del microservei executat.
Esdeveniments
Aquesta secció mostra l’històric d’esdeveniments generats pel sistema durant l’execució del microservei, cosa que permet diagnosticar errors o verificar-ne el progrés.
- Data. Data i hora en què es va registrar l’esdeveniment.
- Tipus. Nivell de l’esdeveniment: Informació, Error o Crític.
- Origen. Component del sistema que va generar l’esdeveniment.
- Missatge. Descripció detallada de l’esdeveniment.
Estats d’una operació
- Pendent. L’operació està registrada, però encara no ha començat a executar-se.
- En curs. L’operació es troba actualment en execució.
- Error. L’operació va finalitzar amb errors.
- Timeout. L’operació no va finalitzar dins del temps màxim permès. Als microserveis aquest temps és d’aproximadament quatre hores.
- Finalitzat. L’operació va acabar correctament.
Consideracions
- Si un microservei s’executa sobre un dispositiu apagat, l’operació finalitzarà amb error.
- Si en el moment d’executar un microservei el dispositiu està apagat o no està reportant, l’execució fallarà i no s’executarà automàticament quan el dispositiu s’encengui.
- Quan un microservei es llança sobre un grup molt gran de dispositius, les operacions es processen en cua (estat Pendent). En aquest cas, pot passar que, quan s’inicia l’operació des de la consola, l’ordre encara no hagi estat enviada al dispositiu. Si durant aquest temps el dispositiu s’encén, l’operació sí que es podrà executar.
- L’execució d’un microservei també es pot programar per començar a partir d’una hora determinada. En aquest cas, l’operació queda programada i no començarà fins a l’hora indicada. Durant aquest temps, l’estat dels dispositius pot canviar.
- El temps màxim d’execució d’un microservei és d’aproximadament 4 hores. Si durant l’execució el dispositiu es reinicia, l’operació romandrà activa a la consola fins a arribar a aquest límit. Transcorregut aquest temps, finalitzarà amb estat Timeout.
Detall del microservei executat
La vista de detall de l’execució del microservei inclou la informació següent:- Iniciat el. Data i hora d’inici de l’execució.
- Finalitzat el. Data i hora de finalització.
- Durada. Temps total transcorregut entre l’inici i la finalització.
- Microservei executat. Codi identificador del microservei.
- Output. Informació generada com a resultat de l’execució, útil per validar el resultat i analitzar possibles incidències.
