FAQ Add-ons

Perguntas Frequentes e Respostas

  1. O que é a app key, e para quê ela serve?

A app key é uma chave utilizada para identificar os Add-ons, bem como a sua autoria. Todas os Add-ons protegidos (.exts) precisam obrigatoriamente de uma app key, pois ela é necessária para sua geração, bem como necessária no momento de instalação de Add-ons protegidos.

  1. Preciso de uma app key para meu Add-on, o que preciso fazer?

Para gerar uma app key, basta acessar este link, preencher os dados e enviar o formulário. A app key será gerada e enviada para o e-mail informado no formulário em até 72 horas úteis.

  1. Posso utilizar a mesma app key para todas os meus Add-ons?

Não. A app key é única por Add-on, cada Add-on deve ter a sua.

  1. Os Add-ons comuns (.ext) continuarão podendo ser instaladas para todos os clientes?

Não, Os Add-ons comuns podem ser instaladas somente para clientes com data início de contrato até fevereiro de 2023. Clientes com contratos a partir de março de 2023 poderão instalar em seus EIP’s somente os Add-ons protegidos (.exts).

  1. Ao tentar realizar a instalação de um Add-on a mensagem “Erro! O Add-on [nome do arquivo do Add-on] não foi instalado. A appkey da solução não existe, está incorreta ou inativa. Entre em contato com o autor do Add-on e solicite que o mesmo regularize a appkey para que você consiga realizar a instalação.”. O que devo fazer?

Neste caso, o sistema detectou que o Add-on em questão não está com a sua app key informada corretamente. Para corrigir esta situação, é necessário:

  • A app key do Add-on seja criado via formulário de solicitação (caso ainda não tenha sido).
  • Uma vez com a app key em mãos, é necessário realizar a geração do Add-on novamente, informando desta vez a app key corretamente.
  • Após gerar o Add-on com app key, é necessário realizar a publicação do Add-on na loja de soluções do Place.
  • Notificar ao cliente que realize o download do Add-on no Place novamente.
  • Tentar realizar a instalação do Add-on novamente.
  1. Ao tentar realizar a instalação de um Add-on, a mensagem “[VALIDA_ADD-ON] - O Add-on [nome do arquivo do Add-on] não foi instalado pois foi adquirido por outro parceiro. Para realizar a instalação é necessário fazer o download do mesmo através da loja de soluções do
    Sankhya Place.”. O que devo fazer?

Neste caso, o sistema detectou que o Add-on foi baixado na loja de soluções por um cliente, porém a tentativa de instalação foi realizada em uma base pertencente a outro cliente. Para conseguir instalar este Add-on é necessário que:

  • Algum dos usuários do cliente que deseja utilizar o Add-on em questão acesse o Sankhya Place e realize o donwload do mesmo através da loja de soluções.
  • Tente realizar a instalação do Add-on novamente.
  1. Ao tentar realizar a instalação de um Add-on., a mensagem “[VALIDA_ADD-ON] - O Add-on [nome do arquivo de Add-on] não foi instalado pois não foi adquirido pela Loja de Soluções. Para realizar a instalação é necessário fazer o download do mesmo através da loja de soluções do Sankhya Place. Caso necessário solicite que o autor publique o Add-on na loja de soluções e então faça a aquisição do mesmo.”. O que devo fazer?

Neste caso, o sistema detectou que o Add-on que está sendo instalado, não foi adquirido através do Sankhya Place. Para conseguir instalar este Add-on é necessário que:

  • Algum dos usuários do cliente que deseja utilizar o Add-on em questão acesse o Sankhya Place e realize o donwload do mesmo através da loja de soluções.
  • Caso ele não esteja publicado na loja de soluções, solicitar que o autor realize a publicação.
  • Tente realizar a instalação do Add-on novamente após adquiri-lo através da loja de soluções.
  1. Ao tentar realizar a instalação de uma Add-on a mensagem “Erro! O Add-on [nome do Add-on. não foi instalado. É permitido a instalação somente de Add-on protegidos no formato ".exts". Entre em contato com o autor do Add-on e solicite que o mesmo realize a publicação dele na Loja de Soluções do Place. Então adquira o mesmo através da loja e realize a instalação do novo arquivo de Add-on protegido”. O que devo fazer?

Neste caso, o sistema detectou que o Add-on que está sendo instalado é um Add-on comum (.ext) e a base do cliente permite somente a instalação de Add-ons protegidos (.exts). Para conseguir instalar este Add-on é necessário que:

  • Algum dos usuários do cliente que deseja utilizar o Add-on em questão acesse o Sankhya Place e realize o donwload do mesmo através da loja de soluções.
  • Caso ele não esteja publicado na loja de soluções, solicitar que o autor realize a publicação.
  • Tente realizar a instalação do Add-on novamente após adquiri-lo através da loja de soluções.
  1. Ao tentar realizar a instalação de um Add-on, o sistema apresentou mensagem de erro referente a problemas de conexão com a internet . O que devo fazer?

Para algumas validações durante o processo de instalação de Add-ons, é necessário que o servidor esteja conectado à internet. Neste caso:

  • Verifique e corrija problemas de conexão do servidor com a internet.
  • Tente realizar a instalação do Add-on novamente.
  1. As alterações a serem realizadas para adequar os Add-ons ao novo modelo afetam ou afetarão os módulos java?

Não. O funcionamento dos Add-ons permanece como é atualmente. Apenas foram acrescentados mecanismos de segurança, governança e identificação.

  1. A app key do Add-on é vinculada ao cliente, ao desenvolvedor ou ambos?

As app key do Add-on é vinculada ao parceiro desenvolvedor da mesma. Não há relação de app keys de Add-ons com clientes.

  1. Se o cliente obteve um Add-on pelo Place e por algum motivo a app key for inativada, o que acontece com o Add-on?

Na próxima atualização de versão do Sankhya OM, ou na próxima vez que a instalação de Add-ons for realizada, o Add-on que possuir app key inativa não será instalado.

  1. A app key está diretamente relacionada à app key que vai ser usada para fazer operações via API?

Não. As app keys de Add-ons são exclusivamente para identificar Add-ons. As app keys para operações via API também devem ser exclusivas para identificar API’s.

  1. A app key está diretamente relacionada à app key que vai ser usada para fazer operações via API?

Não. As app keys de Add-ons são exclusivamente para identificar Add-ons As app keys para operações via API também devem ser exclusivas para identificar API’s.