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:

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

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

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:

Elemento	Sintaxe Markdown	Pré-visualização
Negrito	**negrito**	negrito
Itálico	*itálico*	itálico
Lista	- Elemento da lista	- Elemento da lista
Link	[texto](url)	texto
Imagem	
Código	código	có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.