Histórico da Página

Para que a integração com excel seja possível é necessário que algumas propriedades do internet explore sejam alteradas:

Acessar no menu ferramentas/opções da internet no folder segurança escolher o tópico intranet e clicar no botão nível personalizado, irá abrir a janela configurações de segurança procurar a opção Plugins e controles ActiveX, Na flag Inicializar e executar scripts de controle ActiveX não marcados como seguros escolher a opção confirmar, para que o mesmo pergunte ao usuário se o mesmo quer executar o ActiveX.

• O Desenvolvedor deve definir no programa uma variável do tipo handle com o nome de h-excel.

Ex.:

Define var h-excel as handle no-undo.

• Na procedure generateHeaderSon do programa filho deve ser definido um botão utilizando a técnica de botões customizados para que o mesmo execute a função geraexcel criada pela API.

Ex.:

def var auxFunction as char no-undo.
assign auxFunction = "geraexcel()".
{web/winclude/wi-sonbut.i "Excel" "btn_excel" auxFunction}

• Na procedure process-web-request deve-se rodar a API de modo persistent utilizando a include{utp/utapi029.i2} passando como parâmetro a variável handle definida.

Ex.:

{utp/utapi029.i2 h-excel}

• Deve-se informar a API a versão da bo que será utilizada.

Obs: Se for bo 1.1 deve-se passar o parâmetro como branco.

Ex.:

RUN setboversion IN h-excel("2.0").

• Deve se usar a include “method/dbotterr.i” no programa que chama a api.

• Passar o handle da bo utilizada para API.

Ex.:

RUN sethandle IN h-excel({&hDBOSon}).

• Informar a API sobre a configuração do arquivo que será gerado pela mesma.

Ex.:

RUN configuraarquivo IN h-excel(1,"anderson.xls",2,NO,YES,NO,1).

• Informar a API sobre a configuração da planilha.

Ex.:

RUN configuraplanilha IN h-excel(1,1,"ordens do repres",NO,12.5,YES).

• Setar a célula inicial da planilha para indicar em qual ponto serão inseridos os dados gerados pela API.

Ex.:

RUN setfaixaini IN h-excel(1,3). /*(coluna/linha)*/

• Informar a API quais os campos da tabela que serão utilizados para geração da planilha.

Ex.:

• serão utilizados para geração da planilha.

Ex.:

RUN setcampo IN h-excel (1,1,"order-num","order-num","I",3,"Times New Roman",12,NO,NO,57,"","").
RUN setcampo IN h-excel (1,1,"cust-num","cust-num","I",3,"Times New Roman",12,NO,NO,57,"","").
RUN setcampo IN h-excel (1,1,"data-ordem","order-date","D",3,"Times New Roman",12,NO,NO,57,"","").
RUN setcampo IN h-excel (1,1,"repres","sales-rep","C",3,"Times New Roman",12,NO,NO,57,"","").

• Após informar os campos que serão utilizados pela API deve-se executar a procedure incluivalores para que a mesma efetive os dados que serão lançados na planilha.

Ex.:

RUN incluivalores IN h-excel.

• Para gerar o gráfico da planilha criada deverá ser executado o método configuragrafico após executar o método incluivalores, e em seguida o método geraintegração.

Ex.:

RUN configuragrafico IN h-excel(1,2,"Grafico cliente","Limite do cliente",2,2,YES,NO,NO,NO).

OBS.: Para verificar os parâmetros o desenvolvedor deve consultar o tópico métodos internos na procedure configuragrafico.

• Após executar a procedure configuragrafico deverá ser gerado o código javascript para fazer a integração com o Excel. Neste método é verificado se existem erros nas informações passadas pelo desenvolvedor. Este método recebe dois parâmetros:

Como input-output table a tabela rowErrors;

Como input um valor char para verificar se a mesma gerará código javascript a cada execução ou se será gerado o código javascript somente quando se clicar no botão.

Se for passado como parâmetro "botao" a API gerará código javascript a cada execução.

Ex.:

RUN geraintegracao IN h-excel(INPUT-OUTPUT TABLE RowErrors, INPUT "botao").

Se for passado como parâmetro “ ” a API irá gerará o código javascript somente quando o botão for acionado.

Ex.:

RUN geraintegracao IN h-excel(INPUT-OUTPUT TABLE RowErrors, INPUT "").

• Após rodar a procedure geraintegracao deve-se fazer a chamada da include utapi029.i3 passando para a mesma a variável handle definida pelo desenvolvedor, que é responsável pela verificação de erros durante a geração do código javascript e pela consistência dos dados passados a API, se houver erros a mesma não gerará o código para criar a planilha e apresentará os possíveis erros através da include wi-erapi.i. Este metódo também é responsável por deletar o handle da api.

Ex.:

{ utp/utapi029.i3 h-excel}

• O Desenvolvedor deve definir no programa uma variável do tipo handle com o nome de h-excel.

Ex.:

Define var h-excel as handle no-undo.

• Na procedure generateHeaderSon do programa filho deve ser definido um botão utilizando a técnica de botões customizados para que o mesmo execute a função geraexcel criada pela API.

Ex.:

def var auxFunction as char no-undo .
assign auxFunction = "geraexcel()".{web/winclude/wi-sonbut.i "Excel" "btn_excel" auxFunction}

• Na procedure outputHeader inserir o seguinte código:

Este código fará com que a página seja atualizada passando na url o parâmetro excel=yes para que seja gerado o código javascript.

Ex.:

IF get-value("param") <> "" THEN DO:
   {&out}
    '<script language="javascript">' SKIP   SKIP
    'function geraexcel()~{' SKIP   SKIP
    'location = location + "&excel=yes"~;' SKIP   SKIP
    '~}' SKIP
 SKIP      '</script>'.
END.
ELSE DO:
     {&out}
     '<script language="javascript">' SKIP    SKIP
     'function geraexcel()~{' SKIP    SKIP
     'location = location + "?excel=yes"~;' SKIP    SKIP
     '~}' SKIP    SKIP
     '</script>'.
END.

• Na procedure process-web-request deve-se executar a API de modo persistente utilizando a variável h-excel, testando o parâmetro excel, se o mesmo for =yes deve-se rodar a API e seus métodos internos para se gerar o código javascript.