A adaptabilidade do software é uma das grandes vantagens da aplicação PHC CS Web, mas para isso os seus utilizadores necessitam criar o código que se adapte as suas necessidades.

De forma a ajudar o utilizador a criar código mais rapidamente, evitando consultas a manuais e artigos, foi desenvolvido o Editor de código.

Num campo, ao qual está associado o botão , pode aumentar o espaço de inserção de código clicando em . Ao clicar no botão anteriormente mencionado, o utilizador passa a ter ao seu alcance ao Editor de código que revela ser uma ferramenta importante na construção de código. O editor de código apresenta do lado esquerdo o número de cada linha de código introduzida, ao dar "enter" no código é incrementada essa linha.

Esta mais-valia pode ser utilizada por exemplo em: Eventos; Regras; entre outras funcionalidades.

Depois do utilizador expandir este campo, passa a ter disponível no lado direito do ecrã várias opções de ajuda à edição de código.

As opções disponíveis são:


Disponibiliza informação de ajuda sobre o editor de código.

Exemplo de instrução do campo Expressão do ecrã "Eventos":
Condição para ser avaliada se o evento deve correr. Se deixar em branco o evento corre sempre. Deve ser em código VB e retornar true, para correr ou false, para não correr.



Disponibiliza as principais funções disponíveis na framework phc, sendo apresentado um resumo da função com o seu nome em parenteses. Na tooltip tem uma descrição mais detalhada da função. São elas:

• Acrescenta espaços à direita (padr): Retorna uma string com espaços à direita;


• Alerta (Alerta): Mostra mensagem de alerta temporariamente no topo do ecrã;


• Converter um DataTable num texto em html (listtohtml): Converte um DataTable num texto com uma table de html, ou seja, um datatabletohtml;


• Converte um DataTable num texto formatado em html (listtohtmlformatado): Converte um DataTable num texto formatado com uma table de html ou seja um datatabletohtml;


• Data em formato longo em PT (clongdatep): Retorna a Data em português, num formato longo;


• Dia da semana (dow): Retorna um valor numérico que representa o dia da semana a partir de uma data;


• Dia da semana em PT (cdowp): Retorna o dia da semana em português de uma data;


• Enviar email (sendemail): Envia email;


• Enviar email a partir de ecrã (GenEmail): Redireciona para ecrã para enviar email;


• Exporta para Excel. (ExportToExcel): Exporta os dados de uma tabela para Microsoft Excel;


• Fazer o log de código para o ecrã (LogViewSource): Faz o log de código para o ecrã (pode ser usado pelo utilizador no seu código);


• Gera um stamp (u_stamp): Gera stamps aleatoriamente, retornando uma string que corresponde a um stamp único;


• Hora atual (time): Retorna uma string que corresponde à hora atual do sistema;


• Mês de uma data em PT (cmonthp): Retorna o nome do mês em português de uma determinada data;


• Mês em PT (cmesp): Retorna o nome do mês em português;


• Mostra uma mensagem (formmensagem): Mostra uma mensagem ao utilizador;


• Mostra uma mensagem temporária (waitwind): Mostra uma mensagem ao utilizador. A mensagem pode ser observada com view source;


• Multiplica um texto (replicate): Retorna um texto multiplicado pelo número de vezes indicado no segundo parâmetro;


• Primeira palavra (firstWord): Retorna a primeira palavra;


• Renderizar um datagrid para html (datagridToHtml): Renderiza um datagrid para html;


• Retorna um objeto datatable (getdatatable): Retorna um objeto do tipo datatable, ou seja, um objeto que representa um conjunto de linhas de uma ou mais tabelas definidas pela instrução tsql no 1º parâmetro;


• Retorna um valor texto da base de dados (getumvalorstring): Faz uma consulta à base de dados e devolve um valor de um campo em texto;


• Substitui um texto (substr): Retorna uma string, que corresponde à totalidade ou a uma parte de uma outra string (que foi enviada como parâmetro);


• Texto para html (strtohtml): Converte as quebras de linha para tags de html;


• Transforma um número numa string formatada (strzero): Retorna um número numa string com zeros à esquerda;


• Transforma um valor lógico em texto (logic): Avalia uma expressão lógica e retorna uma string em função do valor lógico. Pode retornar 'Sim' ou pode retornar 'Não';


• Transforma uma data em texto (dtoc): Transforma uma data numa string;


• Transforma uma data YYYYMMDD (dtos): Transforma uma data numa string formatada como YYYYMMDD;


• Transforma uma data para sql (dtosql): Transforma uma data numa string formatada para SQL Server;


• Transforma um texto em data (dtod): Transforma uma string numa data e retorna um valor do tipo date;


• Valor máximo (max): Retorna o maior nº de duas expressões numéricas que recebe como parâmetro;


• Valor mínimo (min): Retorna o menor nº de duas expressões numéricas que recebe como parâmetro;


• Verifica se está vazio (empty): Verifica se um determinado objeto se encontra vazio e retorna um valor lógico (True ou False);

Contém as principais variáveis disponíveis na framework phc em que é apresentado o nome da variável e na tooltip uma descrição mais pormenorizada. Terá ao seu dispor as variáveis:

• Código do utilizador: Retorna uma string com o nome de login do utilizador;


• Email do utilizador: Retorna uma string com o email do utilizador;


• Estabelecimento do utilizador: Retorna uma string com o nome do estabelecimento do utilizador;


• Iniciais do utilizador: Retorna as iniciais do utilizador;


• Nome do funcionário: Retorna uma string com o nome de funcionário do utilizador;


• Nome do cliente: Retorna uma string com o nome do cliente do utilizador;


• Nome do utilizador: Retorna uma string com o nome do utilizador;


• Número de funcionário: Retorna uma string com o número de funcionário do utilizador;


• Número de técnico: Retorna uma string com o número de técnico do utilizador;


• Número de vendedor: Retorna uma string com o número de vendedor do utilizador;


• Número do cliente: Retorna uma string com o número de cliente do utilizador;


• Número do utilizador: Retorna uma string com o número do utilizador;

Estão disponíveis alguns exemplos de código que podem ser utilizados e adaptados mediante as necessidades do utilizador. Os exemplos são:

• Captar variável do querystring: Capta a variável do querystring da página;


• Criar um datatable: Cria um datatable sem uma chamada ao servidor;


• Cria uma string longa com stringbuilder: Cria uma string longa com o stringbuilder;


• Evento ApósAssinatura: Código para evento Após Assinatura com envio de imagem de assinatura por email para o cliente;


• Mapear Mainform: Cria uma variável do tipo Mainform a partir de uma página;


• Mapear Normalform: Cria uma variável do tipo Normalform a partir de uma página;


• Mostra mensagem no Mainform: Mostra uma mensagem no Mainform;


• Obter dados da base de dados Sql Server: Obtém dados da base de dados do Sql Server de acordo com a query utilizada;

Permite executar consultas à base de dados, sem a necessidade de aceder ao Sql Server;

Nota: Todas as consultas feitas no simulador ficam guardadas na tabela nlog com o tipo "Framework.SimSQL" .



Possibilita a consulta dos campos das tabelas selecionadas.
Por exemplo, para selecionar uma tabela deve colocar o nome da tabela com o ponto antes (Ex: .cl) ou a descrição da tabela e depois clicar no botão adicionar tabela.
Nota: Se só existir uma tabela na procura, essa é logo selecionada não sendo necessário escolher.

À medida que as tabelas vão sendo selecionadas pelo utilizador, vão ficando disponíveis ao longo dessa sessão. Para que possa aceder às mesmas de forma imediata.


Formas de interação com as Funções; Variáveis e Exemplos

Para selecionar e adicionar uma função, variável, exemplo ou campo de tabela pode ser feito de duas maneiras:

• Arrastando a opção desejada para o local desejado;


• Posicionado o cursor no local desejado e depois clicar no item desejado.

Para facilitar a sua introdução de código tem outros dois botões: e .

• O primeiro botão permite tornar o código mais claro e fácil de identificar a hierarquia das linhas. Ao clicar, o código existente na caixa de texto é indentado automaticamente, sendo assim mais fácil a leitura do código escrito.
  Por exemplo, num código VB.Net:
  
  Exemplo de indentação do código VB.Net:
  
  Código Inicial:
  If val=1 then
  return false
  else
  return true
  end if
  
  Código após clicar no botão:
  If val=1 then
  return false
  else
  return true
  end if
  
  Nota: Esta nova funcionalidade apenas está disponível quando o código é em VB.NET puro, ou uma mistura de HTML/CSS/JavaScript, e onde tenha condições no próprio código.


• Sempre que o utilizador tenha necessidade de se situar prontamente na última linha de código, poderá fazê-lo com a ajuda do botão: . Assim que o utilizador termine o seu código, pode minimizar o campo do editor de código, clicando no botão e voltará ao registo onde se situava antes de aceder ao editor de código.

Framework Phc Cs Web