PPLSBTAT - Novo botão na Rotina de atendimento no Portal PLS

Descrição

Ponto de Entrada para criar um novo botão na rotina de atendimento no Portal PLS, possibilitando criar uma nova funcionalidade.

Observação 1

Veja no exemplo que a função do Ponto de Entrada apenas serve para configurar o botão que é criado e não contém nenhuma customização. Toda customização deve ser desenvolvida em uma Web Function separada, que recebe o conteúdo campo de Número da Autorização via "httpget" e deve retornar um código HTML válido que é interpretado e exibido na janela pop-up.
É importante lembrar que durante a execução dessa Web Function não há ambiente do Protheus aberto, ou seja, não há empresa selecionada, usuário logado, data base selecionado etc. Sendo assim para acessar as tabelas de dados do Protheus ou executar rotinas que necessitam de ambiente aberto, é necessário criar e utilizar um Web Service que é responsável por esse tipo de execução, assim como trabalha todo o Portal PLS.

Observação 2

O terceiro parâmetro que deve ser retornado pelo PE, que aqui foi chamado de cWinParam apenas é repassado como "specs" para a função window.open(URL,name,specs,replace) do JavaScript.
Uma lista completa de atributos pode ser facilmente encontrada na Internet apenas buscando por window.open. Segue alguns exemplos: "fullscreen=yes|no", "menubar=yes|no", "toolbar=yes|no", "titlebar=yes|no", "height=pixels".

Exemplos

User function PPLSBTAT
Local aRet := {"customizado","W_MEUBOTAO.APW","width=600,height=400"}
Return aRet
 
Web Function MEUBOTAO
LOCAL cHTML := "<H3>Página criada através do PE PPLSBTAT.</H3>" cHTML += "<BR><H5>Número da Autorização: " + httpget->cNumAut + "</H5>"
Return cHTML

Idioma

Português(Brasil)

Versões

11

Sistemas Operacionais Suportados

Todos

Compatível com as Bases de Dados

Todas

Retorno

aRet -> {cCaption,cFunc,cWinParam} O Retorno da função deve ser um Array de 3 posições contendo:
[1] cCaption -> Texto que é exibido no botão. Exemplo: "customizado"
[2] cFunc -> Chamada de uma Web Function sem passagem de parâmetro. Exemplo: "W_MEUBOTAO.APW" *Veja Obs.1
[3] cWinParam -> String contendo parâmetros separados por virgula, referentes à abertura de uma janela pop-up. Exemplo: "width=600,height=400" *Veja Obs.2

Programa Fonte

PPLSSADT.APH