Mudanças entre as páginas "Scripts" e "TPHExcel"

(Diferenças entre páginas)
(Objetos)
 
 
Linha 1: Linha 1:
===Desenvolvimento===
+
A classe TPHExcel serve para realizar a importação de arquivos do excel com a extensão xlsx. A classe TPHExcel suporta execução no cliente e no servidor e o ambiente escolhido requer a aplicação do Excel do office instalada. Para execução no servidor deve-se realizar implementação em um script especifico, e a chamada do script no cliente deverá ocorrer através do classe [[TPHProcScript|TPHProcScript]].
A implementação dos scripts, ocorre na tela disponível pelo botão [[Arquivo:Botao_Script.png|link=|40px]]. A tela de script está disponível para usuários desenvolvedores em telas de cadastros, formulários, relatórios e cadastro de scripts. Os script também podem ser utilizados para geração de textos de documentos fiscais.
 
  
====Objetos====
+
===Propriedades===
::[[TPHArquivoTexto|TPHArquivoTexto]]
+
{| class="wikitable" style="width: 100%"
::[[TPHConexaoREST|TPHConexaoREST]]
+
! Nome
::[[TPHEmail|TPHEmail]]
+
!Tipo
::[[TPHExcel|TPHExcel]]
+
!Descrição
::[[TPHFormulario|TPHFormulario]]
+
|-
::[[TPHJson|TPHJson]]
+
|QtdLinhas
::[[TPHProcesso|TPHProcesso]]
+
|Integer
::[[TPHProcScript|TPHProcScript]]
+
|Quantidade de linhas do arquivo.
::[[TPHRelatorio]]
+
|QtdColunas
::[[TPHServerClass]]
+
|Integer
::[[TPHXML|TPHXML]]
+
|Quantidade de colunas do arquivo.
::[[TStringList|TStringList]]
+
|}
  
====Funções====
+
===Criação do Objeto===
::[[Criar_cadastro|Criar Cadastro]]
+
* '''NewPHExcel''': Cria o objeto, espera como parâmetro o nome do cadastro.
::[[Exibe_processo|Exibir processo]]
 
  
====Utilização====
+
===Procedimentos===
::[[Chamar_script|Chamar Scripts]]
+
* '''Importar(pArquivoExcel:String)''': Realizar importação do arquivo com extensão xlsx informado no parâmetro do pArquivoExcel do procedimento;
::[[Script_no_Recebimento_de_Mensagem|Script no Recebimento de Mensagens]]
+
* '''RetornaCSV''': Após a importação do arquivo xlsx, é possível retornar o texto correspondente no formado CSV (Seperado por ponto e virgura);
  
====Outros Exemplos====
+
===Exemplo Conversão para CSV===
::[[Scripts de Tela]]
+
 
::[[PHWhatsApp|Integração WhatsApp]]
+
{ Retornar CSV da planilha }                                                                   
 +
function RetornarCSV:String;
 +
var
 +
  Excel:TPHExcel;                                         
 +
begin
 +
  Excel := NewPHExcel;
 +
  try
 +
    Excel.Importar('C:\teste.xlsx');                                 
 +
    Result := Excel.RetornaCSV;   
 +
  finally
 +
    Excel.Free;                       
 +
  end;           
 +
end;         
 +
begin
 +
  Informacao(RetornarCSV);                     
 +
end.

Edição das 18h29min de 20 de agosto de 2023

A classe TPHExcel serve para realizar a importação de arquivos do excel com a extensão xlsx. A classe TPHExcel suporta execução no cliente e no servidor e o ambiente escolhido requer a aplicação do Excel do office instalada. Para execução no servidor deve-se realizar implementação em um script especifico, e a chamada do script no cliente deverá ocorrer através do classe TPHProcScript.

Propriedades

Nome Tipo Descrição
QtdLinhas Integer Quantidade de linhas do arquivo. QtdColunas Integer Quantidade de colunas do arquivo.

Criação do Objeto

  • NewPHExcel: Cria o objeto, espera como parâmetro o nome do cadastro.

Procedimentos

  • Importar(pArquivoExcel:String): Realizar importação do arquivo com extensão xlsx informado no parâmetro do pArquivoExcel do procedimento;
  • RetornaCSV: Após a importação do arquivo xlsx, é possível retornar o texto correspondente no formado CSV (Seperado por ponto e virgura);

Exemplo Conversão para CSV

{ Retornar CSV da planilha }                                                                    
function RetornarCSV:String;
var
  Excel:TPHExcel;                                           
begin
  Excel := NewPHExcel;
  try
    Excel.Importar('C:\teste.xlsx');                                  
    Result := Excel.RetornaCSV;    
  finally
    Excel.Free;                        
  end;            
end;          
begin
  Informacao(RetornarCSV);                       
end.