Skip to main content
Els microserveis són components independents que s’executen per prevenir o solucionar problemes freqüents als dispositius, millorar-ne el rendiment o agilitzar tasques que podrien requerir molt temps fer-les manualment. Els microserveis es poden executar de forma autònoma o com a part d’una funcionalitat més àmplia dins d’un sistema. Microserveis permet crear, habilitar i publicar microserveis perquè es puguin executar a nivell d’organització, com a mecanisme de prevenció o autoremediació —a través de fluxos o alertes—, o directament per l’usuari final. marketplace-1
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.
Els microserveis estaran visibles a la secció Workspaces quan prèviament s’hagin configurat per executar-se en el context Sistema, i a la secció Sessions quan en la seva configuració s’hagi seleccionat el context Sessió. microservice_exec La gestió de l’àmbit de l’execució del microservei i dels permisos es pot realitzar des de la secció Dissenyador. S’ha de tenir en compte que la potestat d’executar determinats microserveis dependrà del rol que tingui l’usuari a la plataforma.

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. flow2

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.
  1. Accedir a Monitor → Configuració d’alertes.
  2. A la taula, seleccionar un nom d’alerta per accedir a la seva informació detallada.
  3. Al menú lateral esquerre, fer clic a la pestanya Microserveis.
  4. Fer clic a Vincular.
  5. 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).
  6. Al formulari, fer clic a Vincular.
Per obtenir més informació sobre com vincular una alerta a un microservei, si us plau consulta la documentació de Configuració d’alertes.

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:
  1. Accedir a Microserveis → Habilitat.
  2. Seleccionar un microservei del llistat.
  3. A la pestanya Destinataris dirigir-se a l’apartat Execució per l’usuari final.
  4. Fer clic a Editar i activar Execució per l’usuari final. target_microservice
A continuació, de forma opcional, es pot configurar la recepció de notificacions.

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.
ms-notifications Les notificacions apareixeran a la barra de notificacions de Windows. notif-bar

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.
  1. Accedir a Configuració → Organització.
  2. Al menú lateral esquerre, fer clic a la pestanya Microserveis → Editar la configuració de microserveis.
  3. Canviar el nom de la carpeta.
  4. Fer clic a Desar.
El nom triat ha de tenir entre 3 i 50 caràcters, i només pot contenir lletres, números, guions i guions baixos. ms_inicio Si el dispositiu té Windows 11 com a sistema operatiu i només s’habilita un microservei per a un usuari final, la carpeta no es mostrarà; en el seu lloc, al menú d’inici, només es veurà la icona del microservei. ms-w11search

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. ms-oper Per consultar les operacions:
  1. Accedir a Operacions.
  2. Seleccionar l’operació corresponent. El menú lateral permet accedir a diferents àmbits de l’execució: Detalls, Workspaces i Esdeveniments. ms-oper-detail

Detalls

Aquesta pestanya mostra targetes resum amb els principals indicadors de l’operació: ms-carddetail
  • 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: ms-overview
  • 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. ms-wksdetail Cada registre inclou la informació següent:
  • 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. ms-eventsdetail La informació de cada esdeveniment inclou:
  • 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.
operations-msdetail1