Variáveis de provisionamento
Referência das variáveis padrão e customizadas usadas em scripts de provisionamento de ONU.
Variáveis de provisionamento
Página de referência das variáveis disponíveis para uso em scripts de provisionamento. As variáveis são preenchidas automaticamente no momento da autorização, usando a sintaxe #nome_da_variavel# dentro do script.
Variáveis padrão do sistema
São 17 variáveis sempre disponíveis, preenchidas automaticamente a partir do contexto (interface PON, ONU, OLT) ou do formulário de autorização:
| Variável | O que representa | De onde vem |
|---|---|---|
frame | Número do frame da interface | Extraído da interface (frame/slot/port) |
slot | Número do slot | Extraído da interface |
pon | Número da porta PON | Extraído da interface |
ont_id | ID atribuído à ONU na PON | Calculado automaticamente (próximo livre) |
service_port | ID do service port | Calculado automaticamente |
serial_number | Serial da ONU | Detectado pelo OLT |
line_profile | Line profile do fabricante | Valor padrão configurado na interface |
service_profile | Service profile do fabricante | Valor padrão configurado na interface |
profile_id | ID do perfil de provisionamento | Valor padrão configurado na interface |
name | Nome amigável da ONU | Informado na autorização |
vlan | VLAN de dados | Valor padrão configurado na interface |
vlan_pppoe | VLAN para PPPoE | Valor padrão configurado na interface |
vlan_voip | VLAN para VoIP | Valor padrão configurado na interface |
vlan_tr069 | VLAN para TR-069 | Valor padrão configurado na interface |
gemport | Identificador do GEM port | Valor padrão configurado na interface |
username | Usuário PPPoE | Informado na autorização |
password | Senha PPPoE | Informada na autorização (armazenada de forma segura) |
Variáveis customizadas
Cada script pode definir variáveis extras que serão exibidas como campos no formulário de autorização. Para cada variável customizada, defina:
| Campo | Descrição |
|---|---|
| Nome | Identificador usado no script (sem espaços) |
| Rótulo | Texto exibido no formulário de autorização |
Use a variável no comando com #nome# — ela será substituída pelo valor informado pelo operador no momento da autorização.
Ordem de preenchimento
Quando o operador clica em Autorizar, o sistema preenche cada variável seguindo esta ordem de prioridade:
- Valor digitado pelo operador no formulário de autorização (prioridade máxima)
- Valor padrão da interface PON (pré-preenche o formulário)
- Valor padrão do script (se houver)
Variáveis derivadas do contexto (como frame, slot, pon, serial_number) não são editáveis no formulário — vêm fixas da interface e da ONU selecionadas.
Valores padrão por interface
Em Interfaces GPON → (editar interface), você pode definir valores padrão específicos para aquela porta PON (VLAN, profiles, gemport, etc.). Esses valores pré-populam o formulário de autorização toda vez que uma ONU é autorizada naquela interface, agilizando o trabalho do operador e reduzindo erros.
Se uma variável usada no script não tiver valor preenchido (nem no formulário, nem nos padrões da interface, nem no script), o sistema enviará o texto literal #nome# para o equipamento — o que muito provavelmente causará erro. Confira a lista de variáveis antes de salvar o script.