Base de Conhecimento

SCALE (Simple Cross-Platform Agent Language for Extensibility) é a linguagem de automação multiplataforma da TeamViewer para a gestão de endpoints e operações de dispositivos. Proporciona uma forma consistente de executar tarefas de diagnóstico, remediação e administração em dispositivos Windows, macOS e Linux. Ao combinar capacidades incorporadas do agente, controlo de fluxo, saídas estruturadas e integrações com o sistema operativo, o SCALE ajuda as organizações a automatizar atividades de endpoint de forma controlada e previsível. O SCALE é utilizado em todos os fluxos de trabalho de automação da TeamViewer, incluindo as ferramentas aprovadas disponíveis através das experiências de resolução de problemas do Tia.

Este artigo aplica-se a todos os clientes com licença do TeamViewer ONE (Standard, Advanced e Enterprise), e do TeamViewer Remote Premium, Corporate e Tensor.

O que é o SCALE?

O SCALE é uma linguagem de automação criada especificamente para a gestão de endpoints. Permite às organizações executar fluxos de trabalho de diagnóstico, remediação, recolha de informações e operações diretamente em dispositivos geridos.

O SCALE oferece:

• Execução multiplataforma em Windows, macOS e Linux
• Acesso consistente a dados de endpoint e capacidades do dispositivo
• Saídas estruturadas que podem ser consumidas por fluxos de trabalho de automação
• Execução controlada através de lógica predefinida e mecanismos de governação

Na TeamViewer, o SCALE alimenta automações de endpoint, incluindo muitas das ferramentas de diagnóstico e remediação apresentadas através do Tia e de outros fluxos de trabalho geridos.

Contexto

O SCALE foi originalmente desenvolvido pela 1E, onde alimenta automações de endpoint de Digital Employee Experience (DEX). Após a aquisição da 1E pela TeamViewer, o SCALE passou a fazer parte da TeamViewer e continua a servir de base para as capacidades de automação de endpoint em toda a plataforma.

Como o SCALE funciona

O SCALE é intencionalmente compacto e inclui apenas as capacidades necessárias para realizar a automação de endpoint de forma segura e previsível. A sua superfície linguística limitada e bem definida ajuda a reduzir a complexidade desnecessária e apoia uma execução controlada. Ao recorrer a ferramentas aprovadas e ações predefinidas, o SCALE permite fluxos de trabalho de automação previsíveis e governados.

A linguagem está estruturada em torno de quatro áreas principais.

Controlo de fluxo

O SCALE suporta a tomada de decisões e a iteração através de construções como:

IF / ELSE / ENDIF
FOREACH

Estas construções permitem que uma ferramenta avalie condições e processe vários itens quando necessário.

Terminação limpa

Uma ferramenta pode terminar a execução explicitamente utilizando comandos como:

EVALUATE
RETURN
NOCONTENT
ERROR
NOTIMPLEMENTED

Estes comandos ajudam a garantir que cada execução termina num estado claro e bem definido.

Ponte para shell

Algumas tarefas de automação exigem capacidades do sistema operativo disponíveis apenas através de comandos específicos da plataforma. Nestes casos, as ferramentas aprovadas podem tirar partido de capacidades como o PowerShell no Windows ou comandos de shell no Linux e no macOS.

Estes comandos são executados como parte da lógica predefinida da ferramenta, mantendo ao mesmo tempo a governação, os controlos de execução e o tratamento estruturado de resultados fornecidos pelo SCALE.

Métodos do agente

O SCALE inclui uma biblioteca de métodos incorporados do agente, multiplataforma, que podem ler informações do dispositivo e executar ações de forma consistente nos sistemas operativos suportados.

Exemplo de instrução SCALE

A instrução de diagnóstico seguinte recupera informações de configuração de rede de um dispositivo Windows:

// Diagnostic instruction — read-only by design
@result = Scripting.RunText(
   Language: "PowerShell",
   Text: "Get-NetIPConfiguration | ConvertTo-Json"
);
EVALUATE @result;   // stop early if nothing returned
RETURN @result;

Neste exemplo:

1. Um comando PowerShell recupera dados de configuração de rede.
2. O resultado é armazenado numa variável.
3. A ferramenta valida que foram devolvidos dados.
4. A saída estruturada é devolvida ao chamador.

Resultados estruturados

O SCALE combina padrões de scripting familiares com capacidades de processamento de dados semelhantes a SQL. Isto permite que os dados sejam filtrados e moldados no endpoint antes de serem devolvidos.

Como resultado, as ferramentas devolvem informações estruturadas em vez de saídas brutas de comandos. Uma vez que cada ferramenta devolve dados de acordo com um esquema de retorno definido, o Tia consegue interpretar consistentemente os resultados das ferramentas, reduzir a ambiguidade e suportar fluxos de trabalho fiáveis de resolução de problemas.

Integração com comandos do sistema operativo

Quando necessário, uma ferramenta SCALE pode executar internamente comandos específicos do sistema operativo.

Os exemplos incluem:

• Comandos PowerShell no Windows
• Comandos de shell no Linux
• Comandos de shell no macOS

Embora os comandos subjacentes possam diferir entre sistemas operativos, o SCALE garante que os resultados são devolvidos num formato consistente definido pelo esquema de retorno da ferramenta.

SCALE e o Catálogo de Ferramentas

O artigo Capacidades de resolução de problemas do Tia contém as ferramentas aprovadas de diagnóstico e remediação disponíveis para o Tia. As definições das ferramentas, entradas esperadas, saídas e comportamento de execução são predefinidos e governados antes de ficarem disponíveis. Isto ajuda a garantir consistência, rastreabilidade e controlo operacional. 

O SCALE fornece a linguagem de execução que alimenta essas ferramentas. Em conjunto, o SCALE e o Catálogo de Ferramentas permitem fluxos de trabalho de resolução de problemas controlados e consistentes.
 

Governação e controle

O SCALE fornece a linguagem de execução utilizada por ferramentas aprovadas, mas não determina quais as ferramentas disponíveis. As ferramentas disponíveis são governadas através do processo de aprovação do Catálogo de Ferramentas e executam-se de acordo com as suas definições predefinidas.

Esta separação entre governação de ferramentas e execução de ferramentas suporta:

• Supervisão operacional
• Execução consistente
• Rastreabilidade
• Automação controlada

Ao utilizar ferramentas aprovadas e saídas predefinidas, as organizações podem manter maior visibilidade e controlo sobre as atividades de automação de endpoint.

Documentação oficial

Para obter informações técnicas de referência sobre o SCALE, consulte a documentação oficial do SCALE.