Parâmetros do App

Parâmetros tornam apps configuráveis sem exigir modificações de código. Os instaladores de apps podem definir parâmetros por dispositivo ou por grupo, e seu código de borda lê esses valores na inicialização.

Definindo Parâmetros

Defina parâmetros em App Settings → Parameters. Para cada parâmetro:

Campo	Descrição
Key	Identificador programático (usado no código)
Label	Nome de exibição amigável mostrado para instaladores
Type	Tipo de dado (text, number, boolean, select)
Default Value	Valor de fallback quando nenhum parâmetro está definido
Description	Texto de ajuda para instaladores
Required	Se o instalador deve fornecer este parâmetro

Tipos de Parâmetro

Tipo	Casos de Uso
text	URLs de API, identificadores, mensagens
number	Intervalos de amostragem, limites, contagens
boolean	Alternar recursos, modo de debug
select	Escolha de um conjunto de valores predefinidos
password	Credenciais (armazenadas criptografadas, nunca exibidas)

Lendo Parâmetros no Código de Borda

O agente IronFlock escreve parâmetros em um arquivo JSON montado no seu container:


import json
 
with open("/app/params/parameters.json") as f:
    params = json.load(f)
 
sampling_interval = params.get("sampling_interval", 5)
api_endpoint = params.get("api_endpoint", "https://default.example.com")

Parâmetros do Nível de Grupo

Ao definir parâmetros em um grupo de dispositivos, os valores se propagam para todos os dispositivos do grupo. Dispositivos individuais podem sobrescrever esses valores com configurações específicas do dispositivo.

Isso permite padronizar configuração em uma frota enquanto ainda permite exceções quando necessário.