Guia de Iniciação Rápida do L2L Connect para o Ignition

Last updated: June 19, 2026

O L2L Connect para Ignition é um módulo de gateway que fornece funcionalidades de scripting em Python para muitas das APIs padrão do CloudDISPATCH. O L2L Connect padronizou a sua conectividade L2L para todos os seus projetos Ignition. Oferece gestão centralizada de credenciais e capacidades de registo aprimoradas. Esta é a melhor solução para uma abordagem empresarial padronizada à integração do L2L CloudDISPATCH.

Para descarregar o L2L Connect para Ignition, por favor clique aqui.

Detalhes do L2L Connect para Ignition:

  • Suporta Ignition 8.1+ (Embora versões anteriores, embora não testadas, possam funcionar.)
  • Vem num ficheiro .modl que é carregado através da tela de configuração de módulos do Gateway.
  • Fornece funções de scripting fáceis de usar para os casos de uso comuns da API L2L / Ignition através do namespace system.L2L.
    • Obter Sites, Áreas, Linhas, Máquinas do L2L
    • Definir / Incrementar Contagens de Ciclo de Máquinas no L2L
    • Registar valores reais de produção / sucata no L2L
    • Abrir Dispatches no L2L
  • Fornece aos utilizadores uma forma mais fácil de implementar e padronizar a funcionalidade L2L em todo o servidor Ignition com credenciais centralizadas.

Índice

Integração com Ignition

Para mais informações sobre os casos de uso e melhores práticas para integração com Ignition, consulte os seguintes artigos de suporte:

Detalhes das Versões Suportadas

Suportamos todas as versões do Ignition 8.1 e superiores. A versão atual é 8.1.11. Versões anteriores do Ignition podem funcionar com vários dos métodos descritos abaixo, mas recomendamos atualizar para a versão mais recente para aproveitar as últimas funcionalidades, melhorias de segurança e benefícios de desempenho.

Instalação

A documentação de instalação a seguir foi adaptada da documentação oficial do Ignition. Para as informações mais recentes sobre a instalação de módulos Ignition, consulte:

Descarregar

Para descarregar o módulo L2L Connect para Ignition, por favor clique aqui.

Configuração do Módulo

A configuração do módulo é feita a partir da página web do Gateway na secção Config > Módulos. Aqui pode adicionar, remover e reiniciar módulos. Os módulos integram as suas definições no menu de configuração do Gateway na esquerda da tela.

Instalar ou Atualizar um Módulo

  • Na Página Web do Gateway, selecione Configuração > Módulos para abrir a página de Configuração do Módulo.

    • Desloque-se até ao final da lista, encontre a seta azul e clique no link Instalar ou Atualizar um Módulo.

    Clique em Escolher Ficheiro, selecione um ficheiro .modl que tenha descarregado anteriormente.
    Não tem o módulo L2L Connect para Ignition já descarregado? Faça o download aqui.

  • Durante a Beta, este módulo pode ser autoassinado. Basta clicar na caixa de seleção que indica que compreende o risco e deseja instalar este módulo. Depois clique no botão "Adicionar Certificado e Instalar Módulo" (ou clique no botão Instalar se disponível). Quando a página recarregar, poderá ver o módulo que instalou na lista de módulos.)
    • mceclip0.png

    Desinstalar um Módulo

    1. Na página web do Gateway, selecione Config > Módulos para abrir a página de Configuração do Módulo.
    2. Desloque-se até ao módulo que deseja desinstalar.
    3. À direita do nome do módulo, clique no Mais botão e selecione desinstalar. Aparece uma mensagem de confirmação.
    4. Clique em Confirmar. O módulo já não está instalado e é removido da lista.

    Os módulos são intercambiáveis a quente, o que significa que estas ações podem ser realizadas enquanto o sistema está a funcionar. A natureza isolada dos módulos garante que a realização de uma destas ações afeta apenas esse módulo em particular e quaisquer módulos que dele dependam. Por exemplo, desinstalar o módulo L2L Connect para Ignition não afetará quaisquer clientes de módulos Vision em execução.

    Reiniciar um Módulo

    Devido à natureza isolada dos módulos, os outros módulos não são afetados pelo reinício (a menos que dependam desse módulo em particular).

  • Na página web do Gateway, selecione Config > Módulos para abrir a página de Configuração do Módulo.
  • Desloque-se até ao módulo que deseja reiniciar.
    • À direita do nome do módulo, clique no botão reiniciar.
  • Clique em Confirmar na mensagem de confirmação.

    • A ignição irá fornecer-lhe uma mensagem de confirmação quando o módulo tiver sido reiniciado.

    Estado do Módulo

    A lista de módulos instalados na Configuração do Módulo também fornece algumas informações básicas sobre o Estado do módulo. As colunas Versão, Licença e Estado estão todas exibidas na lista. A licença do módulo é realizada centralmente em Sistema > Licenciamento, portanto, os valores aqui são apenas para fins informativos.

    O Estado do módulo pode ser Executando ou Carregado:

    • Executando indica que os programas do módulo estão realizando tarefas ativamente, por exemplo, o módulo de Notificação de Alarmes aparece como Executando porque está verificando continuamente por alterações de condição que precisam ativar ou desativar o alarme.
    • Carregado indica que o programa ou recursos do módulo estão disponíveis, mas nada está em execução, por exemplo, o módulo Symbol Factory disponibiliza todas as imagens de símbolos para uso.

    Configuração

    Depois de instalar o módulo L2L Connect para Ignition, será necessário configurá-lo adicionando suas credenciais. Na interface web do Gateway, vá para Configuração, depois Configurações do L2L Connect.

    mceclip1.png

    Será necessário adicionar o Nome do Servidor, Número do Site, Chave de Autenticação API, e fornecer o nome de utilizador associado à Chave de Autenticação API. Depois clique em Guardar Alterações.

    Licenciamento e Ativação

    Como Funciona o Licenciamento do L2L Connect para Ignition

    O L2L Connect para Ignition é um serviço por subscrição que é cobrado por site. Para obter um orçamento, por favor contacte o seu representante de vendas ou suporte. Podemos fornecer a possibilidade de experimentar este serviço, por favor contacte o seu representante de suporte para ativar este serviço para o seu site.

    Período de Teste do Ignition

    Novato no Ignition? O Ignition é licenciado pelo servidor, não pelo cliente. Precisa de apenas uma licença para o seu servidor; quaisquer clientes são incluídos automaticamente. Se desejar testar o módulo L2L Connect para Ignition, não precisa fazer nada extra devido ao modo de Teste integrado. Todos os módulos não licenciados podem ser reiniciados em modo de teste de 2 horas. Se não tiver um servidor Ignition licenciado que possa descarregar na sua página web, instalá-lo e começar a usar por 2 horas de cada vez. Ao final do período de 2 horas, os módulos pararão de funcionar, mas não se preocupe, pode reiniciar o temporizador para mais 2 horas. Pode reiniciar o temporizador quantas vezes quiser, por isso, vá em frente! A página web do Gateway e o Designer não são afetados por este teste, assim pode desenvolver pelo tempo que desejar sem interrupções. Se tiver uma licença, quaisquer módulos não licenciados funcionarão neste modo de Teste, mas os módulos licenciados nunca expiram.

    Pode reiniciar o período de Teste fazendo login no Gateway e clicando em Reiniciar Teste para ativar mais 2 horas de execução. O temporizador de teste pode ser reiniciado várias vezes.

    No Gateway, o banner do Tempo de Teste é exibido perto do topo da tela. Para reiniciar o temporizador de teste, clique no botão Reiniciar Teste:


    Para mais informações sobre a licença da sua Instalação Ignition, por favor consulte;

    Resolução de Problemas / Depuração

    Erro de API não licenciada

    Se estiver a usar uma versão de avaliação do Ignition que expirou, poderá receber uma resposta do módulo L2L Connect para Ignition com sucesso definido como falso e uma mensagem de erro de "L2L Connect para Ignition não está licenciado". Por favor, reinicie a sua avaliação através da interface web do gateway Ignition.

    Erro de desativado para este site

    Poderá receber uma resposta do módulo L2L Connect para Ignition com sucesso definido como falso e uma mensagem de erro de "L2L Connect para Ignition está desativado para este site." A funcionalidade L2L Connect para Ignition deve estar ativada para cada site. Por favor, contacte o representante de suporte para detalhes sobre a ativação como avaliação, ou contacte o seu representante de vendas para um orçamento para adicionar esta funcionalidade à sua assinatura.

    Erro de falha na conexão

    Poderá receber uma resposta do módulo L2L Connect para Ignition com sucesso definido como falso e uma mensagem de erro de "Falha na conexão do L2L Connect para Ignition." Neste caso, aceda à interface web do gateway, selecione configuração, depois Configurações do L2L Connect para verificar as suas credenciais.

    Diagnósticos - Registos do Gateway

    Uma das ferramentas mais importantes de resolução de problemas do Página Web do Gateway é a página de Registos. Este console mostra erros causados por Eventos do Gateway incluindo coisas como conexões de Base de Dados ou Dispositivo, perfis de autenticação, Registos de Alarmes e Pipelines, e qualquer outra coisa que seja scoped ao Gateway. Pode encontrar registos na aba de Estado do Página Web do Gateway sob Diagnósticos > Registos.

    • Pode filtrar os registos para mostrar apenas mensagens L2L para ajudar a restringir o que procura.
    • Pode também achar útil alterar o campo Nível Mínimo para depurar, para mostrar mais informações.

    Adicione um filtro de registo para L2L Connect clicando em "Adicionar Filtro de Contexto de Diagnóstico Mapeado":

    Configure o filtro com uma chave chamada "module-name" e um valor chamado "L2L Connect for Ignition". Ele aparecerá na lista suspensa para a caixa de entrada de valor. Clique em "Adicionar Filtro".

    Para mais informações, consulte a documentação do Ignition:

    Depuração via o Script do Designer e Consola de Saída

    A Consola de Scripts é um terminal Python ao vivo que só pode ser acessado no Designer. É uma ótima maneira de testar rapidamente um script, pois não depende de um evento de script ou componente específico. A Consola de Scripts pode ser aberta através do menu Ferramentas > Consola de Scripts. Consiste em duas partes: um Buffer Multilinha, e um Intérprete Interativo. O código pode ser digitado em ambos os lados.

    A Consola de Scripts pode chamar os scripts L2L Connect para Ignition, Projeto e Compartilhados. Se um script de Projeto ou Compartilhado foi adicionado recentemente, então a consola precisará ser redefinida antes de poder ser chamada. Isso pode ser feito clicando na Redefinir
     ícone no canto superior direito.

    Interpretador Interativo

    O Interpretador Interativo está localizado no lado direito da Consola de Scripts, e permite executar uma única linha de código de cada vez. O código é executado a partir do Interpretador Interativo pressionando a tecla Enter. As declarações Print de ambos os lados da Consola de Scripts aparecerão no Interpretador Interativo.

    A janela de Autocompletar, disponível no Interpretador Interativo, tem acesso ao ambiente de trabalho atual, portanto itens como Scripts de Projeto e Compartilhados aparecerão automaticamente. Também podem ser digitados manualmente. O atalho de teclado Ctrl + Espaço exibirá a janela de Autocompletar se alguma função puder ser inferida do que foi digitado.

    Para mais informações, consulte a documentação do Ignition:

    Consola de Saída

    A Consola de Saída é a melhor amiga do programador de scripts. É um painel acoplável, e pode ser aberto através do menu Ferramentas > Consola ou do atalho de teclado Ctrl-Shift-C.

    A Consola é um painel acoplável que pode abrir através do menu Ferramentas ou do atalho de teclado Ctrl-Shift-C. A Consola imprime mensagens do sistema provenientes do Designer. Estas podem variar desde mensagens de informação simples, que indicam quando as coisas são carregadas, até mensagens de erro quando algo corre mal. A Consola também é frequentemente usada para testar e depurar scripts Python, pois as instruções de impressão em componentes executados no designer são exibidas aqui.

    Por exemplo, ao usar a função print no seu script, pode observar o funcionamento interno do seu script enquanto ele é executado. Se executar o seguinte script:

    # Um script Python que demonstra a instrução print
      
    print "Imprime-me primeiro"
    x=10
    z=2
    print x, y, x / y
      
    #O resultado é assim:
    #Imprime-me primeiro
    #10 2 5

    As informações com escopo de Gateway não aparecerão nem na Output Console nem em Script Console. Em vez disso, a saída será enviada para o arquivo wrapper.log. Alternativamente, system.util.getLogger() enviará mensagens para o Gateway Console, sendo um método preferido para resolução de problemas de scripts com escopo de Gateway.

    A Consola de Saída é mais frequentemente usada para testar e depurar scripts Python em componentes no Ignition. Ao usar a palavra-chave print  no seu script, pode observar o funcionamento interno do seu script à medida que ele é executado. Por exemplo, se executou o seguinte script:

    Python - Usando a Consola de Saída para Testar e Depurar Scripts Python
    # Uma função que intercepta escritas de tags, imprimindo primeiro o valor anterior
    def writeToTag(caminho, valor):
       valorAnterior = system.tag.getTagValue(caminho)
       print "A escrever valor '%s' em %s, anteriormente era '%s'" % (valor, caminho, valorAnterior)
       system.tag.writeToTag(caminho, valor)
     
    writeToTag("Compressor/HOA", 2)

    Imprimiria o seguinte na consola:

    Escrevendo valor '2' em Compressor/HOA, anteriormente era '0'

    A Consola de Saída também está disponível no Cliente Vision em Ajuda > Diagnósticos e selecionando a aba Consola.

    Para mais informações, consulte a documentação do Ignition: