Manuais
PHC GO Como criar painéis
 
Os Painéis são uma nova peça da Toolbox da framework do PHC GO que permitem criar livremente painéis com diversos objetos (widgets) e posteriormente incluí-lo num Add-on.

1. Criação do registo de painel

Para criar um registo de um painel proceda da seguinte forma:

1. Aceda ao ( Menu > GO Studio > Toolbox ) e clique sobre a peça picture_in_picture Painéis.

2. Clique em Introduza painel.

3. Preencha os seguintes campos:

  • Nome: Campo para o nome do painel. Deverá preencher o nome que facilmente identifique a peça (painel) de outros painéis que possam a existir.

  • Identificador interno: Identificação do objeto (nome da class em VB que o painel irá ter). Será o nome utilizado para a criação do respetivo objeto no painel, pelo que não deverá conter carateres especiais, acentuação, nem espaços. É preenchido automaticamente em função do valor preenchido no campo anterior do Nome.

  • Título do painel: Título do painel a ser exibido no topo do painel.

  • Descrição: Campo de registo facultativo. Permite preencher uma breve descrição do âmbito do painel.

  • Categoria: Campo de preenchimento obrigatório. Serve para associar o painel a um agrupador que será refletido posteriormente no monitor de painéis localizado no Menu > Análises e Listagens > Painéis).

Após ser gravado o registo, é disponibilizada uma ação no painel lateral das ações do registo, designadamente a ação Desenho o painel.
Ao ser acedida é aberto um painel em branco (canvas) e é onde o developer pode iniciar o desenho do próprio painel.

2. Desenho do painel

A ação de Desenho do Painel uma vez acedida irá exibir um ecrã, no qual a parte esquerda do mesmo exibe todos os elementos (widgets) que são possíveis de incluir no painel.
infoInformações

Para mais informações sobre cada um dos widgets disponíveis na configuração de um painel, clique no widget respetivo:


No topo da configuração, temos disponível o botão de Grave que permite guardar eventuais alterações feitas ao desenho do painel.

Ainda na mesma localização tem disponível o botão de Altere definições que ao ser acedido pode configurar o seguinte:

    Título do painel: Campo para definir o título do painel (é o mesmo campo referido anteriormente no ponto 3. da Criação do registo do painel).

    Identificador interno: Campo identificativo do objeto (nome da class em VB que o painel irá ter). Será o nome utilizado para a criação do respetivo objeto no painel, pelo que não deverá conter carateres especiais, acentuação, nem espaços (é o mesmo campo referido anteriormente no ponto 3. da Criação do registo do painel).


    Detalhes

    Abrir/Fechar

    Colunas viewport: Campo para configura o nº de colunas que pretende que o painel venha a suportar no ecrã. Atualmente no PHC GO todos os ecrãs dispõem de 4 colunas de viewport, no entanto, a nível dos painéis, o developer poderá optar por aumentar esse viewport para o tamanho que quiser, podendo colocar mais campos lado a lado.


    Comportamento

    Abrir/Fechar

    Ao atualizar painel: Neste editor de código, deverá implementar código na linguagem
    Typescript
    e é onde poderá atribuir comportamentos aos widgets no momento de execução de um Painel.

    Exemplos:
      - Colocar um widget disabled visto que outro se encontra por preencher, tudo através de funções sdk de frontend:
        sdk.setWidgetDisabled(widgetId: string, value: boolean, isField?: boolean)
        sdk.setWidgetReadonly(widgetId: string, value: boolean, isField?: boolean)
        sdk.setButtonHidden(buttonId: string, value: boolean)

      - Desabilitar 1 botão se a textbox estiver vazia:
        sdk.setWidgetDisabled(´button_1´, currentPanel.textbox_1 === ´´, false);


    Traduções

    Abrir/Fechar

    No separador traduções, é possível definir para os vários idiomas do PHC GO, os diferentes textos que cada campo deve exibir.
    sticky_note_2Notas
     
    Por defeito, nas peças dos painéis, ao ser adicionado um novo objeto (widget) no Desenho do painel, será criada automaticamente uma entrada para esse campo nesta secção.

    Deve carregar em  
    Adicione tradução
    , para adicionar um nova linha na tabela de traduções para o ecrã.

    A tabela de traduções é composta por 5 colunas, sendo estas:
     
    • Chave: Identificativo único do campo
    • Português: Texto do campo para o idioma português
    • Español: Texto do campo para o idioma espanhol
    • English: Texto do campo para o idioma inglês
    • Angola: Texto do campo para o idioma português de angola
    tips_and_updatesDicas

  • Para adicionar uma nova entrada na tabela de traduções do ecrã, basta carregar em Adicionar ( add ).
  • Para remover uma entrada da tabela de traduções do ecrã, basta carregar no balde do lixo ( delete ) respetivo à linha que deseja remover.
    • manage_searchTópico Relacionado

    Como definir acessos para o seu painel de informação

PHC GO