Saltar al contenido principal
Version: 25.4

Diseñador

A través de la sección Diseñador se puede acceder a toda la información de los microservicios existentes, como el autor, el script, fechas de ejecución, problema que soluciona o tipo de licencia; pero, sobre todo, permite crear microservicios nuevos.

Creación de microservicios

Los microservicios se crean en cuatro fases:

Fase 1

  1. Acceder a Portal -> Microservicios -> Diseñador.
  2. Hacer clic en Nuevo.
  3. Se abrirá el asistente que pedirá introducir la siguiente información:

ms_creation

  • Nombre. Nombre del microservicio.
  • Color. Color del icono del microservicio.
  • Icono. Tipo de icono del microservicio.
  • Descripción. Breve texto que explica qué hace el microservicio.
  • Lenguaje. Lenguaje de programación con el que está desarrollado.
  • Versión. Número de versión del microservicio.
  • Ámbito. Ámbito de ejecución. Se puede seleccionar Workspace (contexto Sistema o Sesión) o Plataforma.
  • Sistema operativo. Sistema operativo para el que está diseñado.
  • Categoría. Directorio o grupo de microservicios accesibles desde Workspaces en el que se alojará este microservicio.
  • Eficiencia. Cantidad de minutos que ahorra el microservicio con cada ejecución.
  1. Hacer clic en Siguiente.
info

Si el microservicio será utilizado como microservicio de usuario final, el nombre del microservicio no debería contener caracteres especiales (como \ / : * ? " < > y otros caracteres específicos de idiomas para ciertas distribuciones de teclado).

Fase 2 - Licencia

  1. Elegir entre las opciones desplegables el tipo de licencia que tendrá el microservicio.
  2. Hacer clic en Siguiente.

ms_license

Fase 3 - README

  1. Insertar una descripción del microservicio en formato Markdown
  2. Hacer clic en Siguiente.
info

Para poner un título con Markdown simplemente se debe iniciar la línea con # Título. A continuación, algunos ejemplos de su sintaxis:

ElementoSintaxis MarkdownPrevisualización
Negrita**negrita**negrita
Cursiva*cursiva*cursiva
Lista- Elemento de lista- Elemento de lista
Enlace[texto](url)texto
Imagen![alt](url)alt
Código`código`código

Fase 4 - Script

  1. Introducir el script.
  2. Hacer clic en Siguiente.

El microservicio creado aparecerá en la tabla principal de la sección.

Código

Si bien los microservicios permiten la ejecución de cualquier comando CMD o PowerShell en dispositivos Windows, los comandos enviados serán ejecutados desde el administrador local o desde la sesión de usuario, dependiendo del ámbito que se les asigne. Esto puede significar que algunos cmdlets no tengan el output esperado con relación a la ejecución realizada. Por ese motivo, si se está realizando un script en PowerShell se debe tener en cuenta una serie de consideraciones:

  • Se recomienda que la versión de PowerShell instalada en los dispositivos sea la misma que la que se utilice para desarrollar los microservicios.

  • La ejecución de los microservicios puede realizarse bajo la identidad de sesión de usuario o desde el administrador local.

    • Ejecución desde el administrador local: en Ámbito se puede configurar Workspaces o Plataforma, lo cual facilita mucho interactuar con los procesos, servicios y actuar con permisos administrativos en el dispositivo, pero puede complicar acceder a información específica del usuario o su sesión.

    • Ejecución desde sesión de usuario: en Ámbito se puede configurar Sesiones, lo cual es muy útil para acceder a información del usuario como el registro, información contenida en el perfil, etc. Se debe tener en cuenta que el script se ejecutará con el nivel de permisos que tenga el usuario, por lo que si el usuario no es administrador local tendrá ciertas limitaciones cuando desee actuar a nivel de sistema.

  • Cuando se desee mostrar algún mensaje en el output del microservicio, se recomienda utilizar el cmdlet "Write-Output" en lugar de "Write-Host".

  • El output de la ejecución puede consultarse en los detalles del trabajo generado en la ejecución.