Pular para o conteúdo principal
Versão: 25.4

Designer

Através da seção Designer é possível acessar todas as informações dos microsserviços existentes, como o autor, o script, datas de execução, problema que resolve ou tipo de licença; mas, acima de tudo, permite criar novos microsserviços.

Criação de microsserviços

Os microsserviços são criados em quatro fases:

Fase 1

  1. Acessar Portal -> Microsserviços -> Designer.
  2. Clicar em Novo.
  3. O assistente será aberto e pedirá para inserir as seguintes informações:

ms_creation

  • Nome. Nome do microsserviço.
  • Cor. Cor do ícone do microsserviço.
  • Ícone. Tipo de ícone do microsserviço.
  • Descrição. Breve texto que explica o que o microsserviço faz.
  • Linguagem. Linguagem de programação com a qual foi desenvolvido.
  • Versão. Número de versão do microsserviço.
  • Âmbito. Âmbito de execução. Pode-se selecionar Workspace (contexto Sistema ou Sessão) ou Plataforma.
  • Sistema operacional. Sistema operacional para o qual foi projetado.
  • Categoria. Diretório ou grupo de microsserviços acessíveis a partir de Workspaces em que este microsserviço será hospedado.
  • Eficiência. Quantidade de minutos que o microsserviço economiza a cada execução.
  1. Clique em Avançar.
informação

Se o microsserviço for utilizado como microsserviço de usuário final, o nome do microsserviço não deve conter caracteres especiais (como \ / : * ? " < > e outros caracteres específicos de idiomas para certas distribuições de teclado).

Fase 2 - Licença

  1. Escolher entre as opções suspensas o tipo de licença que o microsserviço terá.
  2. Clique em Avançar.

ms_license

Fase 3 - README

  1. Inserir uma descrição do microsserviço em formato Markdown
  2. Clique em Avançar.
informação

Para colocar um título com Markdown simplesmente deve-se iniciar a linha com # Título. A seguir, alguns exemplos de sua sintaxe:

ElementoSintaxe MarkdownPré-visualização
Negrito**negrito**negrito
Itálico*itálico*itálico
Lista- Elemento da lista- Elemento da lista
Link[texto](url)texto
Imagem![alt](url)alt
Códigocódigocódigo
:::

Fase 4 - Script

  1. Inserir o script.
  2. Clique em Avançar.

O microsserviço criado aparecerá na tabela principal da seção.

Código

Embora os microsserviços permitam a execução de qualquer comando CMD ou PowerShell em dispositivos Windows, os comandos enviados serão executados a partir do administrador local ou da sessão do usuário, dependendo do âmbito que lhes foi atribuído. Isso pode significar que alguns cmdlets não tenham o output esperado em relação à execução realizada. Por esse motivo, se estiver desenvolvendo um script em PowerShell deve-se levar em consideração uma série de considerações:

  • É recomendado que a versão do PowerShell instalada nos dispositivos seja a mesma que a utilizada para desenvolver os microsserviços.

  • A execução dos microsserviços pode ser feita com a identidade da sessão do usuário ou pelo administrador local.

    • Execução a partir do administrador local: em Âmbito é possível configurar Workspaces ou Plataforma, o que facilita muito a interação com os processos, serviços e agir com permissões administrativas no dispositivo, mas pode dificultar o acesso a informações específicas do usuário ou da sua sessão.

    • Execução a partir da sessão do usuário: em Âmbito é possível configurar Sessões, o que é muito útil para acessar informações do usuário como o registro, informações contidas no perfil, etc. Deve-se ter em mente que o script será executado com o nível de permissões que o usuário tiver, então, se o usuário não for administrador local, ele terá certas limitações ao atuar em nível de sistema.

  • Quando se desejar mostrar alguma mensagem na saída do microsserviço, recomenda-se usar o cmdlet "Write-Output" em vez de "Write-Host".

  • A saída da execução pode ser consultada nos detalhes do trabalho gerado na execução.