A biblioteca de Scripts é onde você mantém os scripts que executa em seus dispositivos. Faça o upload de um .sh, .py ou .ps1 uma vez e execute-o em qualquer dispositivo compatível.

Visão Geral

Tipos de scripts suportados:

Cada script tem um limite de 1 MiB.

Como usar

Abra a biblioteca de Scripts

1. Na console de TI Factorial, abra Gerenciamento de Dispositivos.
2. Selecione a aba Scripts.
3. Selecione a sub-aba Biblioteca de Scripts. Cada linha mostra o nome, tipo e ações de um script.

Adicionar um script

1. Clique em Adicionar um script.
2. Forneça o script de uma das duas maneiras:
   • Arraste e solte um arquivo .sh, .py ou .ps1 na área de upload. O nome, plataforma e conteúdo são preenchidos para você.
   • Preencha os campos manualmente: escolha uma plataforma, digite um nome que termine com a extensão correta e cole o script no editor.
3. Clique em Salvar.

O seletor de Plataforma controla a extensão. Alterar a plataforma reescreve a extensão no nome. Digitar um nome que termine com uma extensão correspondente altera a plataforma. Ambos os campos podem ser editados livremente; eles permanecem vinculados apenas quando o outro não deixa dúvidas.

Editar um script

1. Na linha do script, abra o menu de ações e selecione Editar.
2. Altere o script no editor.
3. Clique em Salvar. O botão permanece desabilitado até que você mude algo.

Apenas o conteúdo pode ser editado. O nome e a plataforma estão bloqueados, pois renomear mudaria o tipo do script. Para renomear um script ou mudar seu tipo, exclua-o e crie um novo.

Baixar um script

Na linha do script, abra o menu de ações e selecione Baixar. O arquivo mantém seu nome e extensão originais.

Excluir um script

1. Na linha do script, abra o menu de ações e selecione Excluir.
2. Confirme no diálogo.

Execuções anteriores permanecem no histórico de scripts de cada dispositivo, pois a Factorial TI mantém o nome e o conteúdo usados na época. Execuções que ainda não terminaram são marcadas como canceladas.

Regras de Validação

Antes de salvar, a Factorial TI verifica se:

• O nome termina em .sh, .py ou .ps1.
• O conteúdo é de 1 MiB ou menos.
• Um script .py começa com um shebang python, por exemplo:

  #!/usr/bin/env python3
  print("Olá do Factorial TI")

• Um script .sh que declara um shebang usa um interpretador suportado, como #!/bin/bash ou #!/usr/bin/env bash.

Se uma verificação falhar, Salvar permanece desabilitado e o campo com problema explica o porquê.

Permissões

Sem a permissão correta, a ação ainda é exibida, mas desabilitada, e uma dica informa o motivo.

Solução de Problemas e FAQ

Solução de Problemas

Salvar está desabilitado ao adicionar um script. Uma regra de validação falhou. Leia a mensagem abaixo do campo: geralmente uma extensão errada, um shebang python ausente, um shell não suportado ou um arquivo acima de 1 MiB.

Salvar está desabilitado ao editar um script. Você ainda não alterou o conteúdo.

Não consigo renomear um script. Nome e plataforma estão bloqueados. Exclua o script e adicione-o novamente com o novo nome.

Uma ação está desabilitada. Você está sem MDM_READ ou MDM_WRITE. Passe o mouse sobre ela para ver qual.

FAQ

1. Quais plataformas podem executar scripts da biblioteca?
   macOS e Linux com .sh e .py, e Windows com .ps1.
    
2. O que acontece com execuções passadas quando eu excluo um script?
   Elas permanecem no histórico de scripts de cada dispositivo com o nome e conteúdo usados na época. Execuções que não terminaram são canceladas.
    
3. Qual é o tamanho máximo de um script?
   Até 1 MiB.
    
4. Posso mudar a plataforma de um script após salvá-lo?
   Não. Exclua-o e crie um novo.