Conceito
Para permitir a busca em outras fontes de pesquisa, será disponibilizado uma aba da Central de Ajuda que realizará a consulta em uma fonte customizada. É possível configurar a URL de uma fonte própria como fonte de consulta, que receberá os parâmetros conforme dados do ambiente (linha de produto, segmento, versão, módulo, rotina). Será permitida a configuração de 1 (uma) fonte de dados customizada. A chamada será feita via REST com requisições do tipo GET, o retorno deverá ser no formato JSON.
Não será suportado nenhum tipo de autenticação.
Os parâmetros da chamada GET deverão estar entre chaves duplas {{}} e o conteúdo opcional entre colchetes duplos [[]]. O conteúdo opcional são os parâmetros que podem não ser passados pela aplicação de acordo com o contexto. Os parâmetros suportados são:
- {{linhaproduto}}
- {{segmento}}
- {{versao}}
- {{modulo}}
- {{rotina}}
- {{texto}}
- {{idioma}}
No arquivo logixprofile.pro incluir as seguintes propriedades:
- logix.help.baseurl - URL base para ser concatenada ao identificador da pagina e montar o link que será exibido na tela da central;
- logix.help.initialur - URL da busca inicial, a busca que será realizada assim que a Central de Ajuda for acessada;
- logix.help.advancedurl - URL da busca avançada, quando é utilizado o campo de pesquisa na central de ajuda;
- logix.help.seemoreurl - URL que será utilizada para a construção do link 'veja mais'
- logix.help.urlfield - Indica o campo do JSON de retorno que contém o identificador da pagina destino. Esta informação será concatenada à URL base para formar o link.
- logix.help.titlefield - Indica o campo do JSON de retorno que contém o titulo a ser exibido para o link no corpo da aba customizada.
- logix.help.titlelimit - Indica a quantidade de caracteres que o titulo do link terá
- logix.help.pagetitle - Indica o titulo da aba customizada
- logix.help.arrayname - Indica o nome do array que possui a lista de itens retornados no JSON.
No exemplo a seguir, realizamos uma configuração para acessar o conteúdo do youtube:
logix.help.baseurl=http://www.youtube.com.br/watch?v= logix.help.initialurl=https://www.googleapis.com/youtube/v3/search?part=id%2C+snippet&q={{linhaproduto}}&channelid=UChsYWCL7MFkDM4OsK7de8dw&type=video&maxResults=10&key=AIzaSyA-tg4sqTbd5ArqndIyb6jcpa1uEX8PBxo logix.help.advancedurl=https://www.googleapis.com/youtube/v3/search?part=id%2C+snippet&q={{linhaproduto}}+{{text}}&channelid=UChsYWCL7MFkDM4OsK7de8dw&type=video&maxResults=10&key=AIzaSyA-tg4sqTbd5ArqndIyb6jcpa1uEX8PBxo logix.help.seemoreurl=https://www.youtube.com/results?search_query={{linhaproduto}} logix.help.urlfield=id.videoId logix.help.titlefield=snippet.title logix.help.titlelimit=180 logix.help.pagetitle=teste customizado logix.help.arrayname=items
Resultado: