Como estender eventos da Onda de Picking?

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

Pré-Requisitos

• PRIMAVERA Eye Peak;
• Visual Studio 2013 ou superior;
• NET Framework 4.0.

Passo 1 – Criar uma solução

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

Passo 2 – Adicionar Referências

1. No Solution Explorer do Visual Studio, selecionar o nó References.
2. Clicar com o botão direito do rato e escolher “Add References…”.
3. Na janela clicar no botão “Browse…” e navegar até à pasta de instalação do Eye Peak.
   Numa instalação por defeito a pasta será:
   “C:Program Files (x86)PRIMAVERAWMS510Eye Peak WMS”.
4. Selecionar os ficheiros: "GlobalSist.Common.dll", "GlobalSist.DataAccess.dll", "GlobalSist.Entities.WMS.dll", "GlobalSist.Logic.dll".
5. Clicar no botão “Add” e de seguida no botão “OK”

Passo 3 – Criar Class Module

1. No nó do projeto clicar, com o botão direito do rato, e escolher Add > New Item…
2. Na janela apresentada,  expandir na árvore a linguagem pretendida (“C#” ou “VB”).
3. Abaixo da linguagem, selecionar Code.
4. Selecionar o tipo “Class”.
5. Nomear a nova classe e clicar no botão “Add…”.

Na definição da classe, herdar a mesma de AppModule:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using GlobalSist.Common;

namespace PickingWaveModule
{
    public class PickingWaveModule : AppModule
    {
    }
}

Implementar um construtor sem argumentos:

///

/// Initializes a new instance of the class.
///

public PickingWaveModule() : base("Picking wave module")
{
this.IsLogic = true;
this.IsTerminal = false;
}

Caso seja necessário criar um override do método Init():

///

/// Initializes this instance.
///

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

Passo 4 – Criar classe para evento de Onda de Picking de Eye Peak

1. No nó do projeto clicar, com o botão direito do rato, e escolher Add > New Item…
2. Na janela apresentada, expandir na árvore a linguagem pretendida (“C#” ou “VB”).
3. Abaixo da linguagem, selecionar Code.
4. Selecionar o tipo “Class”.
5. Nomear a nova classe e carregar no botão “Add…”.

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

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

namespace PickingWaveExtention
{
    Public class PickingWaveExt : IWave
    {
    }
}

Adicionar evento para estender Onda de Picking em Eye Peak:

public Report OnAutomaticWaveLaunched(object instance, bool useTestMethod)
{
    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?.

Veja um exemplo sobre a tecnologia Eye Peak no GitHub.