Manuais
PHC GO Como criar um novo Ecrã e entidade
 
Nome da entidade: Nome da entidade à qual será associado o novo ecrã.

Tabela da entidade: Campo informativo que apresenta o nome interno da tabela de entidade. O valor deste campo é atualizado após o preenchimento do Nome da entidade.

Título do ecrã: Título do ecrã a ser criado.

Designação do registo: Texto que representa o registo do novo ecrã. Esta informação será utilizada no botão  
Introduza
 do novo ecrã (por exemplo,  
Introduza artigo
 ).




Descrição: Campo opcional a ser preenchido com a descrição do ecrã.


Neste separador, é possível adicionar campos ou elementos às várias secções do ecrã, secções estas que passamos a explicar em detalhe:

Campos internos (sem visualização): Os campos internos são campos que não serão renderizados no ecrã, servindo para alojar informação sem que esta esteja visível para o utilizador. Para adicionar um novo campo e/ou elemento a esta secção, deve carregar no botão exibido na tabela abaixo, e de seguida selecionar o tipo de campo/elemento a ser adicionado à secção. Consoante a seleção anterior é exibido o ecrã de propriedades onde serão efetuadas as configurações do elemento/campo.

add
text_fields  Texto
pin  Inteiro
pin  Decimal
check_box  Lógico
today  Data
calendar_view_month  Grelha de edição


Cabeçalho: Secção principal do ecrã. Para adicionar um novo campo e/ou elemento a esta secção, deve carregar no botão exibido na tabela abaixo, e de seguida selecionar o tipo de campo/elemento a ser adicionado à secção. Consoante a seleção anterior é exibido o ecrã de propriedades onde serão efetuadas as configurações do elemento/campo.

add
drive_file_rename_outline  Textbox
edit_note  Textarea
text_format   Rich text editor
today   Datepicker
manage_search   Autocomplete
read_more   Itens de lista dinâmica
check_box   Checkbox
image   Imagem
calendar_view_month   Grelha de edição
table_rows   Tabela de consulta
title   Texto
highlight_alt   Em branco

sticky_note_2Notas

È possível, em todos estes campos, definir se o mesmo é disponibilizado em modo de lista, através do campo checkbox È apresentado em modo de lista.


Caso este campo esteja ativo, irá ser apresentado no modo de lista do ecrã. Caso não tenha nenhum campo marcado neste ecrã, a aplicação irá automaticamente definir que todos os campos presentes no cabeçalho irão ser apresentados no modo de lista do ecrã.

É também possível uma ordenação , através dos seguintes campos:

  • Tipo de ordenação: Campo onde se define se a ordenação vai ser Ascendente, Descendente ou Nenhuma.

  • Ordem: Campo onde definimos, numéricamente, a ordem de prioridades da ordenação dos campos eligiveis para serem disponibilizados em modo de lista.

No separador Ações, é possível adicionar novas ações para o ecrã, e novas ações para os registos do ecrã.

Por defeito, não existe nenhuma ação parametrizada. Para adicionar uma nova ação ao seu ecrã, carregue em  
Adicione ação
 .

Após a ação anterior, é aberta uma nova janela com o assistente de configuração de ações. Nesta é possível parametrizar as ações do ecrã à sua medida, utilizando para tal os seguintes campos:

Título: Nome a atribuir à ação

check_box  Ação sugerida: Ao ativar este campo, a ação terá prioridade sobre as restantes ações de registo, surgindo em primeiro aquando consultadas as ações de registo do respetivo ecrã.
sticky_note_2Notas

O PHC GO permite um máximo de 2 ações sugeridas por ecrã.




check_box  Ação de ecrã:
Ao ativar este campo, a ação criada estará disponível no modo ecrã e automaticamente, escondida do modo registo.

Ao nível da interação com o utilizador, o campo apresenta ainda as seguintes características:

  • Ao ter o campo ativado, a ação "Ação sugerida" fica inativa.
  • O campo "Ecrã de destino" fica apenas de leitura.
  • A descrição dos campos destinados ao código "function runAction" e "function isActionAvailable" oculta o parâmetro "currentRecord" porque nenhum "itemVO" será usado na operação da ação.
  • O campo "Identificador da regra de negócio" disponibilizará apenas as opções das regras de negócio do tipo "A pedido modo ecrã".

    Ecrã de destino: Ecrã associado a ação de registo. Ao clicar no botão de ações de registo do novo ecrã ( playlist_play ), a ação será apresentada no separador colapsável do ecrã selecionado nesta opção. Por exemplo, no ecrã de clientes, a ação Emita fatura tem como ecrã de destino o ecrã Faturação.

    Executa regra de negócio: Ao ativar este campo, está a indicar que a ação executará o código de uma regra de negócio A Pedido do novo ecrã.
    Se esta opção estivar ativa, o editor de código da função runAction ficará desabilitado, enquanto que o campo Identificador da regra de negócio estará disponível para edição.

    Identificador da regra de negócio: Caso tenha selecionado a opção Executa regra de negócio, este campo passa estar disponível para edição por parte do utilizador, devendo ser preenchido com a regra de negócio A Pedido do novo ecrã que será executada ao clicar na ação.

    function runAction: Código que será executado ao clicar na ação caso o campo Executa regra de negócio estiver desmarcado. Neste editor de código, deverá implementar código na linguagem  
    Typescript
      e poderá utilizar as funções disponíveis na biblioteca SDK do Frontend.

    Exemplo:
    sdk.publishMessage("Custom message", AlertTypes.WARNING)

    sticky_note_2Notas

    Para mais informações relacionadas com funções da biblioteca SDK do Frontend, carregue aqui .

    function isActionAvaiable: Permite mostrar a ação consoante uma determinada condição. Neste editor de código, deverá implementar código na linguagem  
    Typescript
     .

    1. Caso defina:
      return true;
      A ação é sempre exibida no registo.

    2. Por outro lado, caso defina:
      return currentRecord.meucampologico;
      A ação apenas é apresentada nos registos que tenham o campo meucampologico igual a 1.
    3. sticky_note_2Notas

      Nos editores de código de linguagem  
      Typescript
       , poderá utilizar o comando console.log para debugar o código implementado.

      Uma vez que a linguagem  
      Typescript
       é derivada do Javascript , as funções do Javascript também poderão ser utilizadas pelo developer.

     



  • No separador Assinaturas físicas, é possível adicionar um novo tabulador aos ecrãs do PHC GO, para poder associar assinaturas físicas aos registos desse ecrã, ou seja, uma versão eletrónica de uma assinatura manuscrita.
    infoInformações

    O componente Assinaturas físicas está disponível a partir do plano Advanced..

    Por defeito, não existe nenhuma assinatura parametrizada. Para adicionar uma nova assinatura ao seu ecrã, carregue em  
    Adicione assinatura
     .

    Após a ação anterior, é aberta uma nova janela com o assistente de configuração da assinatura. Nesta é possível parametrizar algumas opções da assinatura à sua medida, utilizando para tal os seguintes campos:

    Título: Nome a atribuir à área da assinatura a disponibilizar no ecrã.

    Identificador: Permite atribuir um identificador único interno para esta assinatura. Não serão aceites caracteres especiais na construção deste identificador

    Tooltip: Defina uma mensagem explicativa sobre a área da assinatura, para que, ao passar com o rato por cima da área, o utilizador possa compreender o objetivo desse campo.

    function isSignatureAvailable: Código que será executado para condicionar a exibição desta área ou alguma regra de negócio específica.
    Neste editor de código, deverá implementar código na linguagem  
    Typescript
      e poderá utilizar as funções disponíveis na biblioteca SDK do Frontend.

    sticky_note_2Notas

    Para mais informações relacionadas com funções da biblioteca SDK do Frontend, carregue aqui .


     

    No separador comportamento, está disponível um editor de código, o qual poderá utilizar para escrever ou importar código  
    Typescript
      .


    Neste separador, é possível configurar comportamentos específicos para as ações core do PHC GO através de código Typescript, sendo estas:

    • Edite
    • Duplique
    • Apague
    • Imprima
    • Descarregue
    • Envie
    • Introduza

    Para adicionar um novo comportamento, comece por carregar em  
    Adicione comportamento
     .
    De seguida, é exibida a janela Ação, através da qual é possível configurar o comportamento desejado:

    • check_box Comportamento para modo de lista: Ao ativar este campo, o comportamento a ser configurado, será executado para a ação selecionada, aquando no modo lista da respetiva entidade.
      sticky_note_2Notas

      Para comportamentos do modo lista, é necessário certificar que os objetos a serem invocados pelo código  
      Typescript
       , tenham a opção check_box É apresentado no modo de lista do ecrã ativa.
    • Tipo de ação: É neste campo onde é definida qual a ação a ser configurada, tendo como opções disponíveis as ações referidas anteriormente.
      sticky_note_2Notas

      A ação do tipo Introduza só está disponível para o modo de lista.

      Tendo isto em conta, é necessário que o campo check_box Comportamento para modo de lista esteja ativo para que a opção Introduza seja exibida na lista do campo Tipo de ação.

      Para mais informações sobre os parâmetros de objetos do PHC GO, carregue aqui.
    • Código: Para configurar o comportamento desejado, está disponível um campo para edição de código  
      Typescript
       . Para expandir este campo, carregue em open_in_full.

    Uma vez introduzidos comportamentos, estes serão exibidos no modo de consulta do ecrã/entidade, estando agrupadas em duas categorias:

    • Ações de lista
    • Ações de registo

    Ao carregar no botão more_vert , são exibidas as operações disponíveis para comportamentos:

    • create Edite: Permite editar as configurações do comportamento.

    • delete Apague: Elimina o comportamento do ecrã/entidade.

     

    No separador traduções, é possível definir para os vários idiomas do PHC GO, os diferentes textos que cada campo deve exibir, Por defeito, ao ser adicionado um novo campo no separador Desenho, será criada automaticamente uma entrada para esse campo neste secção.

    Em alternativa, poderá 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 4 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
    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.