Categoria Aparência

• Esquerda / Topo
São propriedades de posicionamento eixo X / Y as zonas e as linhas do PHC GO definem a posição no eixo do Y.

As colunas de cada linha de uma determinada zona definem a posição no eixo do X, é possível adicionar um componente especial (em branco) que permite criar espaçamentos nas colunas, alinhando assim os restantes componentes no eixo do X dessa linha à esquerda ou à direita.

Cada componente dentro de uma linha pode ser configurado para ocupar, uma, duas, três ou a totalidade das colunas disponíveis que são quatro.


• Alinhamento
No PHC GO o alinhamento interno do componente é aplicado de forma automática, consoante o valor escolhido na opção Componente - Tipo de dados.


• Comprimento
Apesar de ser possível definir o comprimento do componente no PHC GO já o mesmo não é possível para a propriedade Altura do PHC CS.


• Estilo de Contorno
É definido pela aplicação do PHC GO consoante o campo esteja ou não na Área de desenho do Cabeçalho.


• Visível
Esta propriedade no PHC GO é programada, não no componente, mas sim na área Dados Gerais – Comportamento, explicada mais à frente.

Categoria Dados

• Campo obrigatório
Permite criar uma regra de negócio automática, que obriga o campo a ser de preenchimento obrigatório, no PHC GO deve-se utilizar a opção Estado – Obrigatório.


• Formatação / Máscara
No PHC GO estas propriedades são aplicadas de forma automática, consoante o valor escolhido na opção Componente - Tipo de dados.


• Nome
No PHC CS é possível que o componente tenha um nome diferente no ecrã do que o nome do campo definido na propriedade Variável do Objeto, no caso do PHC GO o nome do componente é sempre igual ao nome do campo na base de dados, essa configuração é feita na opção Geral - Nome.


• Só de Leitura
Permite criar uma regra de negócio automática, que não permite a alteração do seu valor, no PHC GO deve-se utilizar a opção Estado – Readonly.


• Variável do Objeto
Esta propriedade faz o mapeamento do componente com um determinado campo da entidade na base de dados, no PHC GO esta configuração é feita na opção Geral - Nome.


• Expressão TSQL / Expressão XBASE
Estas propriedades no PHC CS servem para se conseguir criar campos virtuais no ecrã, que não usam a propriedade Variável do Objeto definindo a expressão para obter esses dados da base de dados no próprio componente.

Não existe à data da criação deste artigo a possibilidade de campos virtuais de utilizador para serem.

Categoria Eventos

Categoria Outras

Categoria Tipo letra

Mapeamento dos componentes

• Texto
  No PHC GO o componente equivalente é o Texto.
  
  No PHC CS, o principal uso deste componente é fornecer um título aos componentes inseridos no desenho do ecrã, por exemplo o componente Campos de Tabelas, para que o utilizador possa compreender mais facilmente o significado de determinado valor visível no ecrã.
  
  No PHC GO, o título faz parte do próprio componente usado para mostrar determinado campo da entidade, esse valor pode ser definido na configuração do componente na opção Componente – Título.
  
  Desta forma, no PHC GO, a necessidade de utilização do componente Texto é reduzida, uma vez que, além de os componentes terem o seu próprio título, existe também a opção de agrupar componentes por painéis, cada um com o seu próprio título, ajudando assim a organizar o ecrã.


• Campos de tabelas
  No PHC GO o componente equivalente é o Textbox.
  
  Este componente é utilizado para mostrar campos da tabela, normalmente de preenchimento livre, por exemplo, o campo nome do álbum.
  
  Consoante o tipo de campo usado no PHC CS, na configuração do componente no PHC GO na opção Componente - Tipo de dados devemos escolher o tipo que mais de adequa ás nossas necessidades.
  
  
  • FC, C
    Indica a presença de um campo de texto String na base de dados, para texto simples, como o nome de um álbum de música ou uma característica, pode-se selecionar o tipo Texto. Caso o campo tenha uma função específica, pode-se optar por URL ou E-mail.
    
    Se desejarmos armazenar um valor de hora, podemos escolher entre Hora incluindo segundos (formato hh:mm:ss) ou Hora (sem segundos, no formato hh:mm). Independentemente do formato, o campo de hora na base de dados terá sempre o tamanho de 8, sem permitir ajuste de tamanho.
    
    Se o tipo escolhido na opção Tipo de Dados permitir definir um valor no campo Comprimento e esta opção for deixada em branco, o valor assumido será zero, e o campo será criado na base de dados como VarChar(Max).
    
    Quando o componente é TextBox e o comprimento é VarChar(Max) o valor será armazenado numa única linha, sem quebras.
  
  
  • FN e N
    Indica a presença de um campo numérico na base de dados, para valores numéricos, estão disponíveis os tipos Inteiro e Decimal. Para valores monetários, independentemente de corresponderem à moeda definida na ficha da empresa ou a moeda estrangeira, deve-se escolher o tipo Moeda.
    
    Também há tipos numéricos específicos, como Percentagem e Quantidade (que segue o valor de decimais para quantidade definido nos parâmetros gerais da aplicação). Outros tipos disponíveis incluem Volume e Medidas.
  
  
  • D
    Indica a presença de um campo de data de calendário na base de dados, no PHC GO deve ser escolhido o componente Datepicker.
    
    De notar que á semelhança do PHC CS embora o campo seja criado na base de dados como um DateTime que suporta a gravação de uma data e horas, o valor guardado será apenas a parte da data sem as horas.
    
    O componente usado nos ecrãs para este caso é um calendário que apenas atribui o valor da data, significa que a gravação feita na base de dados só vai incluir essa parte e as horas ficam sempre a zero.
    
    Este tipo de campo é sempre criado na base de dados com o tamanho 10 não permitindo definir o seu tamanho.


• Campo de ligação
  No PHC GO o componente equivalente é o Autocomplete.
  
  Na entidade álbum temos o campo singername que representa o nome da banda ou cantor, este valor vem de uma lista que tem origem na entidade de bandas u0000_singerVO (Bandas / Cantores).
  
  Para construir a lista, na configuração do componente, preenchemos a opção runSearch com o código da pesquisa a ser efetuada, e os campos a retornar da base de dados:
  
  

  ' Código PHC GO – VB.NET
  
  
  
  Public Function runSearch(currentRecord As GenericVO) As QueryVO
  
   Dim query As QueryVO = New QueryVO()
  
  
  
   query.entityName = "u0000_singer"
  
   query.SelectItems.add("nome")
  
   query.SelectItems.add("u0000_singerstamp")
  
   
  
   Return query
  
  End Function
  
  

  
  Esta função corre sempre que o utilizador clica para abrir a lista completa do componente, ou quando digita valores no campo, sendo que a lista apresentada será filtrada automaticamente pelos valores que o utilizador digitou.
  
  A função recebe do frontend o registo atual na variável currentRecord que o utilizador está a criar ou a alterar no momento em que interage com o componente, e pode ser útil para condicionar a maneira como queremos que a procura seja efetuada na base de dados.
  
  Retornamos dois campos da entidade u0000_singerVO, o campo nome usado para mostrar a lista ao utilizador e que indicamos também na opção Campo para descrição, e o identificador único do registo, o campo u0000_singerstamp cujo valor vamos utilizar para guardar na base de dados, cujo valor vamos indicar também na opção Campo para valor.
  
  O mapeamento para os respetivos campos na entidade u0000_albumVO é feito da seguinte forma, o valor indicado na opção Campo para valor corresponde ao valor indicado na opção Geral – Nome, que será o campo singerstamp.
  
  O valor da opção Campo para descrição corresponde á opção Campo para desnormalização que será o campo singername.


• Campos lógicos
  No PHC GO o componente equivalente é o Lógico.
  
  Indica a presença de um campo booleano de valor verdadeiro ou falso, correspondente a 1 ou 0 na base de dados, o tipo usado no PHC CS é o L.


• Campos com tabelas de utilizador (tabprg)
  No PHC GO o componente equivalente é o Itens de lista dinâmica.
  
  Indica a presença de um campo de texto, de preenchimento simples, semelhante ao componente do PHC CS Campos de tabelas, mas com uma nuance de ser criada uma lista de valores possíveis, para permitir escrever na primeira vez e nas seguintes selecionar o valor já existente.
  
  No PHC CS na propriedade Dados da tabela auxiliar, escrevemos o nome único do grupo para a lista, no PHC GO devemos utilizar a opção GO Studio - Toolbox – Itens de Lista Dinâmica, para criar a lista onde na opção ID Tabela definimos o seu nome.
  
  Após isso, o valor que definimos para o nome da lista deve ser colocado neste componente na opção Componente - Tabela de itens de lista dinâmica.
  
  Um exemplo de uso deste componente é o campo que classifica o álbum em termos de género musical genre, pretende-se que o utilizador não tenha de escrever essa informação todas as vezes, se já existir na lista só tem de selecionar o item pretendido, Rock, Pop, etc.


• Filtros para grelhas
  Este componente do PHC CS não existe na framework de add-ons do PHC GO.


• Campos com tabelas
  No PHC GO o componente equivalente é o Autocomplete.
  
  Indica a presença de um campo de texto, de preenchimento simples através da escolha de um item de uma lista fixa de valores.
  
  Esta lista é obtida através de registos existentes em outra entidade da base de dados, devemos utilizar a explicação dada para o componente do PHC CS Campo de ligação.


• Campos com listas
  No PHC GO o componente equivalente é o Autocomplete.
  
  Este componente apresenta um campo de texto simples que permite o preenchimento por meio da escolha de um item de uma lista fixa de valores, definida na configuração do próprio componente.
  
  Por exemplo, o campo state, que classifica o estado de um álbum, pode ter vários valores: Ativo, que indica que o álbum está disponível na coleção; Abatido, que significa que o álbum já não faz parte da coleção porque foi vendido ou oferecido; e Perdido, que indica que o álbum já não está disponível, embora a causa para esse estado seja desconhecida.
  
  Deve-se ativar a opção: Utiliza opções fixas, e na opção, Lista de títulos, indicar os três estados separados por vírgula. Estes serão os valores a mostrar ao utilizador.
  
  Em relação aos valores guardados na base de dados, podemos optar por escrever os mesmos que indicamos para os estados, ou optar por guardar um código correspondente a cada estado, em ambas as situações devemos preencher a opção Lista de valores também separada por vírgula.
  
  No nosso exemplo, optamos por guardar na base de dados um código, vamos utilizar respetivamente os códigos 01, 02 e 03, independente da estratégia adotada, o campo criado na entidade que vai guardar uma das opções da Lista de valores será sempre do tipo String.


• Campos memos
  No PHC GO o componente equivalente é o Textarea ou Rich text editor.
  
  Indica a presença de um campo de texto na base de dados com a particularidade de aceitar quebra de linha, ou seja, formatar o texto em várias linhas.
  
  O componente Rich text editor suporta um editor de formatação/html.
  
  Este tipo de campo é sempre criado na base de dados como VarChar(Max) não sendo permitindo definir o seu tamanho.


• Campos de escolha seletiva
  Este componente do PHC CS não existe na framework de add-ons do PHC GO.


• Botão
  No PHC GO os botões são substituídos por ações do ecrã, que podem ser configuradas na área Dados Gerais – Ações.


• Imagem
  No PHC GO o componente equivalente é o Imagem.
  
  As imagens no PHC GO são guardadas na tabela IFL que é partilhada por todas as outras entidades existentes na aplicação.
  
  As entidades que têm imagens, têm um campo, com o nome definido na opção Geral - Nome que guarda o identificador único do registo da imagem guardado no campo iflstamp da tabela de imagens.
  
  No nosso exemplo a entidade de álbuns tem dois campos para guardar as imagens capa frontal e traseira do álbum, nos campos imgfront e imgback respetivamente.


• Figura geométrica
  Este componente do PHC CS não existe na framework de add-ons do PHC GO.


• Grelha
  No PHC GO o componente equivalente é Grelha de Edição ou Tabela de consulta.
  
  A Grelha de Edição, cria uma nova entidade na base de dados, o componente é usado para quando existe uma entidade filha da entidade principal do ecrã, conforme exemplo dado das músicas de um álbum.
  
  A Tabela de consulta, é apenas de leitura e permite visualizar dados de outra entidade que possa estar ou não relacionada com a entidade principal do ecrã, podemos até construir uma expressão que retorna informação não de apenas uma entidade, mas sim de várias entidades existentes na base de dados


• Análise Multi-Dimensional, Gráfico, Campo em árvore, Análise avançada (HTML)
  
  
  
  Estes componentes do PHC CS não existem na framework de add-ons do PHC GO.

Dados Gerais – Ações

Dados Gerais – Comportamento

' Código PHC GO – Typescrip



function updateConfig(currentRecord: GenericVO): void

' Código PHC GO – Typescrip



function updateConfig(currentRecord: GenericVO): void {



 sdk.setReadonly('rarity', !sdk.User.esa);

}

Dados Gerais - Comportamento das ações core

• Modo de lista e colocar invisível o componente:
  
  

  ' Código PHC GO – Typescript
  
  
  
  Function isActionHidden(selectionStatus: DataTableSelectionStatus, currentSeries?:
  
  GenericVO):Boolean
  
  

  
  
• Modo de consulta e colocar invisível o componente:
  
  

  ' Código PHC GO – Typescript
  
  
  
  Function isActionHidden(currentRecord: GenericVO, currentSeries?: GenericVO):Boolean
  
  

  
  
• Modo de lista e colocar desabilitado o componente:
  
  

  ' Código PHC GO – Typescript
  
  
  
  Function isActionDisabled(selectionStatus: DataTableSelectionStatus, currentSeries?:
  
  GenericVO):Boolean
  
  

  
  
• Modo de consulta e colocar desabilitado o componente:
  
  

  ' Código PHC GO – Typescript
  
  
  
  Function isActionDisabled(currentRecord: GenericVO, currentSeries?: GenericVO):Boolean
  
  

  
  

 Código PHC GO – Typescript



export interface DataTableSelectionStatus {

 selected: any[];

 selectedChildren: any[];

 anySelectedInPage: boolean;

 allSelectedInPage: boolean;

 allSelected: boolean;

 anySelected: boolean;

 singleSelected: boolean;

 countSelected: number;

}

' Código PHC GO – Typescript



Function isActionDisabled(selectionStatus: DataTableSelectionStatus, currentSeries?:

GenericVO):Boolean {



 If (!sdk.User.esa)

 {

 return selectionStatus.selected.some(value => value.rarity === true);

 }

 

 return false;

}

' Código PHC GO – Typescript



Function isActionDisabled(currentRecord: GenericVO, currentSeries?: GenericVO):Boolean {



 If (!sdk.User.esa)

 {

 return currentRecord[‘rarity’]

 }

 

 return false;

}

' Código PHC GO – VB.NET



Public Function OnDelete(itemVO As U0000_AlbumVO, runWarningRules As Boolean) As List(Of

MessageVO)

 Dim listMsg As List(Of MessageVO) = New List(Of MessageVO)



 If itemVO.rarity

 If not SDK.User.getCurrentInfo.esa

 listMsg.Add(new MsgError("Only administrators have access to delete rare albums."))

 End If



 End If

 

 Return listMsg

End Function

Dados Gerais - Menu

• Não mostra no menu da aplicação
  Quando ativa indica que não será criada uma opção no menu da aplicação para aceder ao ecrã, no entanto a sua rota estará disponível para ser chamada no frontend.
  
  Essa chamada pode ser através de SDK de frontend, o que vai causar que o ecrã apareça visível ao utilizador, e via API do backend que controla a entidade associada ao ecrã.
  
  Isto que dizer que a API desta entidade, apesar de o ecrã não aparecer no frontend, pode ser chamada pelo frontend ou via Engine, permitindo assim gerir toda a operação relacionada com essa entidade, como criar registos, gravar alterações, apagar registos, etc


• Ecrã de definições
  É semelhante ao comportamento descrito no inicio, só que a entrada de menu em vez de ser criada na raiz é criada abaixo da entrada de sistema já existente com o nome Definições.


• Mostra em pasta da aplicação
  É semelhante ao comportamento descrito na opção ecrã de definições só que permite escolher qual o nome da entrada de menu de sistema já existente, onde desejamos criar em segundo nível a nossa entrada.

Dados Gerais – Traduções

• ENTITYDATAFIELD.U0000_ALBUM.SINGERNAME
• ENTITYDATAFIELD.U0000_ALBUM.SINGERNAME.TOOLTIP