Manual de Utilização Central de Ajuda Datasul

Introdução

A Central de Ajuda substitui o antigo Help OnLine do Datasul. Trazendo, além do conteúdo do Help, documentos de mais 4 fontes de pesquisa: TDN, YouTube, Blog TOTVS e Fluig

 O conteúdo será exibido com uma ou mais colunas para cada fonte de pesquisa contendo links para os resultados das buscas, conforme exemplo em imagem abaixo:

Central de Ajuda - 

Na caixa de texto da central de ajuda o usuário poderá refinar a sua busca, conforme definição de cada fonte de pesquisa (descritas mais adiante neste manual).
As consultas serão feitas de forma on line, trazendo sempre resultados atualizados em todas as fontes de pesquisa. Por conta disso, é necessário que o cliente possua conexão com a internet.
A busca em cada fonte é feita de forma assíncrona, ou seja, cada fonte de pesquisa é consultada de forma independente das outras (sem travar a utilização da central) e o usuário pode acessar o conteúdo mesmo antes que a central seja carregada completamente (com o retorno de todas as fontes). Por conta disso, caso alguma fonte de pesquisa fique indisponível, somente a coluna relacionada exibirá uma mensagem de indisponibilidade (as outas colunas continuarão trazendo os resultados disponíveis).

Em linhas gerais, ao acessar a central de ajuda no sistema, o usuário será direcionado para a Central de Ajuda com acesso aos seguintes conteúdos:

• Links para vídeos no YouTube

Conteúdo do canal Tutoriais e Demonstrações da TOTVS ({+}https://www.youtube.com/channel/UChsYWCL7MFkDM4OsK7de8dw) que conta com vídeos e playlists para auxiliar a operação de diversas rotinas dos produtos TOTVS.

• Notícias do blog TOTVS

Serão exibidas as últimas novidades do segmento publicadas no blog TOTVS ({+}http://blog.totvs.com/)

• Posts do Fluig TOTVS ({+}http://fluig.totvs.com/)

Serão exibidas as últimas publicações em comunidades do Fluig (filtrando sempre por comunidades relevantes ao contexto em que a central foi aberta)

• Documento de referencia do produto (https://www.totvs.com/mktfiles/tdiportais/helponlinedatasul/portal/index.html)

 Será exibido o conteúdo de help da rotina que originou o acesso à central.

•  Documentos publicados no TDN http://tdn.totvs.com.br/

Links do TDN trazendo documentações das rotinas, pontos de entrada, soluções de chamados e diversas outros conteúdos do TDN. Como a consulta é on line, o usuário tem acesso a informação sempre atualizada.

Além disso será possível configurar uma aba da central de ajuda com uma fonte customizada, para exibir conteúdos de uma fonte própria de conteúdos.
Essa fonte customizada pode ser qualquer fonte de dados do próprio cliente, que siga as definições técnicas descritas no tópico Configuração para fonte customizada. Por exemplo: um canal próprio no YouTube, um sistema de gestão de conteúdos para customizações criadas pelo cliente, etc.

Cada fonte de dados irá trazer 6 links com as últimas novidades da fonte, respeitando os filtros aplicados. Caso o usuário deseje ver mais conteúdos relacionados, poderá utilizar o link "Veja Mais" disponibilizado no final de cada coluna para ser redirecionado à página da fonte de pesquisa já com os filtros aplicados pela central de ajuda.
 

Conceito das buscas

A Central de Ajuda possui dois conceitos de busca:

• Busca Inicial – executada na abertura da central
• Busca Adicional – executada quando o usuário deseja refinar a busca utilizando a caixa de texto para pesquisa .

Cada fonte de pesquisa irá realizar a Busca Inicial e a Busca Adicional considerando diferentes filtros e especificações, conforme descritas mais adiante nos tópicos de cada fonte.
Em ambas as buscas, o sistema irá aplicar filtros considerando diferentes elementos (segmento, módulo, rotina e versão), de acordo com o tipo de busca e a fonte consultada.

Definição das áreas

Na aba "Você precisa Saber", são exibidas 3 colunas as seguintes fontes: 

• Blog da TOTVS
• Fluig - Comunidade #Segmento (de acordo com o segmento utilizado)
• Fluig - Comunidade @Consultoria Tributária

Na aba "Últimos Publicados", são exibidas as seguintes fontes

• TDN
• Youtube 
• Fluig - Comunidades de acordo com o módulo que abriu a central (caso haja mais de uma comunidade para o mesmo módulo, os resultados serão divididos e o link veja mais será montado com base na comunidade de maior relevância)

Quando houver uma fonte de dados customizada, os links relacionados serão exibidos na aba chamada "Customizações".
 

Busca no TDN 

Busca inicial – TDN

A busca inicial do TDN é ser feita dentro do space do Datasul filtrando os labels de documentos com a seguinte regra:

Quando a central for chamada a partir de uma rotina, será filtrado no TDN a rotina e a versão do sistema.
Quando a central for chamada de dentro de um módulo, sem nenhuma rotina aberta, será filtrado no TDN o módulo e a versão do sistema.
Quando a central for chamada antes da seleção do módulo (na tela de login do sistema, por exemplo), será filtrado no TDN o segmento e a versão do sistema.

Busca adicional – TDN

A busca adicional permite que o usuário refine a pesquisa dentro do mesmo contexto. Desta forma, será mantido o filtro já aplicado da busca inicial (filtro feito em labels) e adicionado filtro pelo texto digitado no campo de pesquisa.
OBS: Os filtros padrões (rotina, versão do sistema e/ou segmento) são feitos nos labels de documentos. Já o filtro do campo de texto é feito nos títulos e conteúdos de documentos do TDN

Link "Veja Mais" – TDN

Ao clicar no link Veja Mais o usuário será redirecionado para uma página do TDN com filtro da Space Datasul e com filtro dos labels que estiverem aplicados na central (rotina, versão do sistema e/ou segmento), conforme regra descrita anteriormente.
Nesta página serão exibidos mais documentos do TDN que estejam relacionados com o contexto filtrado e o usuário poderá manipular os filtros de label adicionando mais filtros ou removendo.

Idioma - TDN

No Datasul será observado o idioma configurado para o usuário para realizar a tradução da tela da central de ajuda.
Quando o idioma do sistema for diferente de português, ao clicar em um link da coluna do TDN ou ao clicar no link "Veja Mais", o TDN será aberto com o plugin de tradução já selecionado no idioma correspondente. Dessa forma a página será carregada no TDN traduzida. Nesse caso os links serão exibidos em português e a tradução será feita somente depois que o usuário abrir o link, direto na página do TDN.

Busca no Youtube

Busca inicial – You Tube

A busca inicial do YouTube irá trazer os últimos vídeos da playlist do segmento do ambiente que abriu a central. Neste ponto não é considerado a linha de produto, nem a rotina ou módulo que abriu a central.

Busca adicional – You Tube

A busca adicional do YouTube irá pesquisar vídeos dentro do canal da TOTVS Tutoriais e Demonstrações aplicando os filtros por segmento, versão do sistema, módulo, rotina e texto digitado na caixa de pesquisa.

Link "Veja Mais" – You Tube

Ao clicar no link "Veja Mais", o usuário será direcionado para a página do YouTube com a playlist do segmento carregada.

Internacionalização - YouTube

Não será feita nenhuma alteração na central quanto a internacionalização da fonte YouTube. As descrições dos links serão exibidas sempre em português, porém, ao acessar um vídeo, o YouTube permite ativar a legenda do áudio em diversos idiomas.  

Busca no Blog TOTVS

Busca inicial – Blog

A busca inicial do blog será feita com base apenas no segmento do sistema que abriu a central. Serão carregadas as últimas notícias publicadas no blog para o segmento específico.

Busca adicional – Blog

A busca adicional não será feita no blog TOTVS.

Link "Veja Mais" – Blog

Ao clicar no link "Veja Mais", o usuário será direcionado para a página do blog referente ao segmento do ambiente que abriu a central.

Internacionalização - Blog

Quando o idioma do ambiente que originou a chamada for espanhol, os links de notícias do blog serão exibidos em espanhol e o link veja mais irá carregar a página do blog em espanhol.
Para outros idiomas será carregado o conteúdo em português, pois atualmente o blog TOTVS só possui o conteúdo dos segmentos no idioma português e espanhol.

Busca no Fluig

Busca inicial – Fluig

O Fluig é exibido em 3 diferentes colunas com as seguintes comunidades:

• #Segmento
  • São exibidos os últimos 6 posts da comunidade associada ao segmento utilizado
  • Esta coluna é exibida na aba "Você Precisa Saber"
• @módulo
  • São exibidos 6 posts das comunidades associadas ao módulo acessado. No caso de existir mais de uma comunidade para o mesmo módulo, os resultados exibidos são divididos entre as comunidades e o link Veja Mais é montado baseado na comunidade de maior relevância.
  • Esta coluna é exibida na aba "Últimos Publicados"
• @Consultoria Tributária
  • São ser exibidos 6 posts das comunidades de Consultoria Tributária de Segmentos TOTVS, P@ E-Social e P@ Fiscal, dividindo os resultados e montar o link Veja Mais com a comunidade Consultoria Tributária de Segmentos TOTVS.

Busca adicional – Fluig

A busca adicional não será feita no Fluig.

Internacionalização Fluig

Não será feito tratamento de internacionalização para as buscas no Fluig.