Como estender interfaces de Utilizador?

Este documento descreve os passos necessários para criar interfaces de Utilizador em Eye Peak.

O Eye Peak permite criar novas interfaces ou estender as interfaces de sistema, tanto para o Frontend como para o terminal.

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, na árvore expandir a linguagem pretendida (“C#” ou “VB”).
3. Abaixo da linguagem, selecionar Windows Desktop.
4. Selecionar o tipo de projeto “Windows Forms App (.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 que é apresentada, Carregar 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:
   1. Para o Frontend: "GlobalSist.Common.dll", "GlobalSist.DataAccess.dll", "GlobalSist.Entities.WMS.dll", "GlobalSist.FrontEnd.Functionalities.dll", "GlobalSist.Library.dll", "GlobalSist.Logic.dll".
   2. Para o Terminal: "GlobalSist.Common.dll" "GlobalSist.DataAccess.dll" "GlobalSist.Entities.WMS.dll" "GlobalSist.Terminal.Functionalities.dll" "GlobalSist.Library.dll" "GlobalSist.Logic.dll".
5. Carregar no botão “Add” e de seguida no botão “OK”

Passo 3 – Criar Class Module

1. No nó do projeto carregar com o botão direito do rato, e escolher Add > New Item…
2. Na janela apresentada, na árvore expandir 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…”.

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 MyApplicationModule 
{
    public class MyApplicationModule : AppModule
    {
    }
}

Implementar um construtor sem argumentos:

///

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

public MyApplicationModule() : base("Nome do Módulo")
{
}

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 – Estender um formulário de Eye Peak

1. No nó do projeto carregar 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 Windows Forms.
4. Selecionar o tipo “Windows Form”.
5. Nomear o novo formulário e carregar no botão “Add…”.
6. Abrir o Editor de código do Formulário e na definição da classe do Formulário alterar a herança de “Form” para o Formulário do Eye Peak.

using GlobalSist.FrontEnd.Functionalities.Core;
public partial class Form1 : FormSKU
{
     public Form1()
     {
           this.InitializeComponent();
     }      
}

Estender um ou vários eventos do formulário base:

protected override void EditData()
{
    base.EditData();
    ///Implementação de código personalizado
}

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.