Base de Conocimientos

SCALE (Simple Cross-Platform Agent Language for Extensibility), es el lenguaje simple de agente multiplataforma para extensibilidad de TeamViewer para la gestión de puntos finales (endpoints) y las operaciones de dispositivos. Proporciona una forma coherente de ejecutar tareas de diagnóstico, corrección y administración en dispositivos Windows, macOS y Linux. Al combinar capacidades integradas del agente, control de flujo, salidas estructuradas e integraciones con el sistema operativo, SCALE ayuda a las organizaciones a automatizar actividades de endpoints de forma controlada y predecible. SCALE se utiliza en todos los flujos de trabajo de automatización de TeamViewer, incluidas las herramientas aprobadas disponibles a través de las experiencias de Resolución de problemas de Tia.

Este artículo se aplica a todos los titulares de licencias TeamViewer ONE (Standard, Advanced y Enterprise), Premium, Corporate y Tensor.

¿Qué es SCALE?

SCALE es un lenguaje de automatización creado específicamente para la gestión de puntos finales. Permite a las organizaciones ejecutar flujos de trabajo de diagnóstico, corrección, recopilación de información y operaciones directamente en dispositivos gestionados.

SCALE proporciona:

• Ejecución multiplataforma en Windows, macOS y Linux
• Acceso coherente a los datos de los puntos finales y a las capacidades del dispositivo
• Salidas estructuradas que pueden ser utilizadas por flujos de trabajo de automatización
• Ejecución controlada mediante lógica predefinida y mecanismos de gobernanza

Dentro de TeamViewer, SCALE impulsa las automatizaciones de puntos finales, incluidas muchas de las herramientas de diagnóstico y corrección mostradas a través de Tia y otros flujos de trabajo gestionados.

Información general

SCALE fue desarrollado originalmente por 1E, donde impulsa las automatizaciones de puntos finales de Digital Employee Experience (DEX). Tras la adquisición de 1E por parte de TeamViewer, SCALE pasó a formar parte de TeamViewer y continúa siendo la base de las capacidades de automatización de dichos puntos finales en toda la plataforma.

Cómo funciona SCALE

SCALE es intencionadamente compacto e incluye solo las capacidades necesarias para realizar automatización de puntos finales de forma segura y predecible. Su superficie de lenguaje limitada y bien definida ayuda a reducir la complejidad innecesaria y favorece una ejecución controlada. Al basarse en herramientas aprobadas y acciones predefinidas, SCALE permite flujos de trabajo de automatización predecibles y gobernados.

El lenguaje se basa en cuatro áreas principales.

Control de flujo

SCALE admite la toma de decisiones y la iteración mediante construcciones como:

IF / ELSE / ENDIF
FOREACH

Estas construcciones permiten que una herramienta evalúe condiciones y procese varios elementos cuando sea necesario.

Finalización limpia

Una herramienta puede finalizar la ejecución explícitamente utilizando comandos como:

EVALUATE
RETURN
NOCONTENT
ERROR
NOTIMPLEMENTED

Estos comandos ayudan a garantizar que cada ejecución finalice en un estado claro y bien definido.

Puente con el shell

Algunas tareas de automatización requieren capacidades del sistema operativo disponibles solo mediante comandos específicos de la plataforma. En estos casos, las herramientas aprobadas pueden aprovechar capacidades como PowerShell en Windows o comandos de shell en Linux y macOS.

Estos comandos se ejecutan como parte de una lógica de herramienta predefinida, manteniendo al mismo tiempo la gobernanza, los controles de ejecución y el manejo estructurado de resultados que proporciona SCALE.

Métodos del agente

SCALE incluye una biblioteca de métodos integrados del agente multiplataforma que pueden leer información del dispositivo y realizar acciones de forma coherente en los sistemas operativos compatibles.

Ejemplo de instrucción SCALE

La siguiente instrucción de diagnóstico recupera información de configuración de red de un 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;

En este ejemplo:

1. Un comando de PowerShell recupera datos de configuración de red.
2. El resultado se almacena en una variable.
3. La herramienta valida que se hayan devuelto datos.
4. La salida estructurada se devuelve al solicitante.

Resultados estructurados

SCALE combina patrones de scripting familiares con capacidades de procesamiento de datos similares a SQL. Esto permite filtrar y dar forma a los datos en el punto final antes de devolverlos.

Como resultado, las herramientas devuelven información estructurada en lugar de una salida de comandos sin procesar. Debido a que cada herramienta devuelve datos de acuerdo con un esquema de retorno definido, Tia puede interpretar de forma coherente los resultados de las herramientas, reducir la ambigüedad y respaldar flujos de trabajo de resolución de problemas fiables.

Integración con comandos del sistema operativo

Cuando es necesario, una herramienta SCALE puede ejecutar internamente comandos específicos del sistema operativo.

Los ejemplos incluyen:

Comandos de PowerShell en Windows

Comandos de shell en Linux

Comandos de shell en macOS

Aunque los comandos subyacentes pueden diferir entre sistemas operativos, SCALE garantiza que los resultados se devuelvan en un formato coherente definido por el esquema de retorno de la herramienta.

SCALE y el Catálogo de herramientas

El artículo sobre las capacidades de resolución de problemas de Tia contiene las herramientas de diagnóstico y corrección aprobadas disponibles para Tia. Las definiciones de las herramientas, las entradas esperadas, las salidas y el comportamiento de ejecución se predefinen y gobiernan antes de estar disponibles. Esto ayuda a garantizar coherencia, trazabilidad y control operativo. 

SCALE proporciona el lenguaje de ejecución que impulsa esas herramientas. Juntos, SCALE y el Catálogo de herramientas permiten flujos de trabajo de resolución de problemas controlados y coherentes.
 

Gobernanza y control

SCALE proporciona el lenguaje de ejecución utilizado por las herramientas aprobadas, pero no determina qué herramientas están disponibles. Las herramientas disponibles se rigen mediante el proceso de aprobación del Catálogo de herramientas y se ejecutan de acuerdo con sus definiciones predefinidas.

Esta separación entre la gobernanza de herramientas y la ejecución de herramientas respalda:

• Supervisión operativa
• Ejecución coherente
• Trazabilidad
• Automatización controlada

Al utilizar herramientas aprobadas y salidas predefinidas, las organizaciones pueden mantener una mayor visibilidad y control sobre las actividades de automatización de puntos finales.

Documentación oficial

Para obtener información técnica de referencia sobre SCALE, consulta el siguiente enlace documentación oficial de SCALE.