Como extender o Assistente Echo (v10.10)?

O Assistente Echo é uma ferramenta que gera de mensagens de interesse para o utilizador e que permite executar algumas tarefas disponíveis nas versões 9 e 10 do ERP.

Este assistente tem uma forte componente de extensibilidade, permitindo aos parceiros integradores criar tópicos de interesse para os seus clientes. É possível produzir tópicos para o ECHO para atingir dois objetivos diferentes:

1. Executar código fora do processo, ou seja, executar tarefas de forma diferida, sem bloquear o funcionamento do ERP;
2. Exibir uma mensagem que expõe situações de interesse para o utilizador de determinada funcionalidade, através de pesquisas na base de dados.

A API de integração do ECHO no ERP também permite criar uma conversação durante a utilização do produto para auxiliar o utilizador a realizar determinadas tarefas ou seguir passos, uma vez que pode introduzir nas mensagens ligações para recursos externos ou até operações de drill down no ERP.

Criar e instalar tópicos

A partir da Service Release 1 da v10.10, é possível criar e instalar um tópico para o ECHO através do Visual Studio.

Nota: A v10 tem suporte até à versão 2019.

Para criar e instalar tópicos, siga os seguintes passos:

1. Instalar a extensão "Primavera.Bot.TemplateSR1.vsix", disponível na pasta "ManuaisSDKERPBotTopics" e no repositório do GitHub da PRIMAVERA;
2. Criar um novo projeto do tipo "Primavera.Bot.TemplateTopic";
3. Depois de criar o projeto, siga os passos no ficheiro "Readme.md" criado com o projeto;
4. Para configurar as tarefas, a sua natureza e o agendamento, rever os ficheiros SQL "DevelopersNetworkTopicSQL.sql" e "TemplateTopicBaseSQL.sql" presentes no projeto. O ficheiro está documentado para o ajudar a personalizar as definições. Serão também dadas explicações mais detalhadas das configurações deste ficheiro em artigos seguintes;
5. Compilar em ambiente de "debug" para a pasta APLHurPluginsBot;
6. Garantir que os registos nas tabelas "Bot.BotTopics" e "Bot.BotTasks" estão criados na base de dados PRIEMPRE;
7. Em produtivo, basta colocar nesta pasta a DLL do tópico e todas as dependências do cliente que não estejam já na pasta APLHUR;
   Nota: Utilizar versões diferentes das mesmas DLLs poderá provocar problemas ao executar os restantes tópicos.