Como subscrever eventos de Documentos?

Este documento descreve os passos necessários para criar eventos de extensibilidade de Documentos para o Eye Peak.

Esta implementação faz-se através da criação de uma dll de extensibilidade que terá de cumprir com as configurações descritas nos passos seguintes.

Pré-Requisitos

• Primavera Eye Peak;
• Visual Studio 2013 ou superior;
• Net Framework 4.

Passo 1 – Criar uma solução

1. Abrir o Visual Studio e selecionar File > New > Project;
2. Na janela apresentada, expandir a linguagem pretendida (“C#” ou “VB”) na árvore e selecionar Windows Desktop;
3. Selecionar o tipo de projeto “Class Library (.NET Framewok)";
4. Atribuir um nome ao projeto, escolher a localização do projeto e atribuir um nome à solução;
5. Validar que a versão da Framework selecionada por baixo do nome da solução é a Framework 4.

Passo 2 – Adicionar Referências

1. Aceder ao Solution Explorer do Visual Studio e selecionar o nó References;
2. Carregar com o botão direito do rato e escolher “Add References…”;
3. Na janela apresentada, carregar em “Browse…” e navegar até à pasta de instalação do Eye Peak.
   A pasta predefinida de instalação é:
   “C:Program Files (x86)PRIMAVERAWMS510Eye Peak WMS”.
4. Selecionar os ficheiros: "GlobalSist.Common.dll", "GlobalSist.DataAccess.dll", "GlobalSist.Library.dll", "GlobalSist.Facades.dll" e "GlobalSist.ServiceProvider.dll".
5. Carregar no botão “Add” e depois em “OK”

Passo 3 – Criar Class Module

1. Carregar com o botão direito do rato no nó do projeto e escolher Add > New Item…;
2. Na janela apresentada, expandir a linguagem pretendida (“C#” ou “VB”) na árvore e selecionar Code.
3. Selecionar o tipo “Class”;
4. Atribuir um nome à nova classe e carregar em “Add…”;
5. Introduzir as seguintes configurações:

Definir a classe herdando a definição de AppModule:

using GlobalSist.Common;
public class DocModule : AppModule.
{
}

Implementar um construtor sem argumentos:

public DocModule ()
: base(“Nome do Módulo”)
{ 
}

Se necessário, criar um override do método Init():

public override void Init()
{
    ///Inicialização dos componentes necessários
    ///Registo de extensões extra, etc
    ServiceProvider.ServiceManager.AddRegister();
}

Passo 4 – Criar classe para evento de Documento de Eye Peak

1. Carregar com o botão direito do rato no nó do projeto e escolher Add > New Item…;
2. Na janela apresentada, expandir a linguagem pretendida (“C#” ou “VB”) na árvore e selecionar Code;
3. Selecionar o tipo “Class”;
4. Atribuir um nome à nova classe e carregar em “Add…”;
5. Introduzir as seguintes configurações:

Abrir o Editor de código da classe e acrescentar a herança para IDoc:

using GlobalSist.Facades.Base; 
using GlobalSist.Facades.DocLogic; 
using System;
using System.Collections.Generic;

namespace DocExtention
{
    Public class DocExt : IDoc
    {
    }
}

Adicionar as interfaces do IDoc pretendidas:

public void OnDocClosed(object doc)
{
     throw new NotImplementedException();
}

Passo 5 – Compilar a dll e instalar o módulo

Por último, é necessário compilar a dll para a pasta de instalação, aceder ao frontend e instalar o módulo, tal como descrito no artigo Como instalar Componentes de Extensibilidade?.

Pode consultar um exemplo de extensibilidade com a tecnologia Eye Peak no GitHub.