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

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    .

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ã.



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.
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 comportamento, está disponível um editor de código, o qual poderá utilizar para escrever ou importar código    .

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    .
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.

 

check_box  Não mostra no menu da aplicação: Ao ativar este campo, o ecrã não será exibido no   menu  Menu do PHC GO.


check_box  Ecrã de definições: Ao ativar este campo, o ecrã será considerado como um novo ecrã das   settings  Definições do PHC GO.

check_box  Mostra em pasta da aplicação: Ao ativar este campo, permite escolher em qual entidade deverá inserir o ecrã através do campo Pasta da aplicação.

Pasta da aplicação: Caso tenha selecionado a opção check_box Mostra em pasta da aplicação, este campo passa estar disponível para edição por parte do utilizador, devendo ser preenchido com o agrupador de 1º nível do menu Menu do PHC GO no qual se deverá inserir o ecrã.
 

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   , 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