Como criar um Job?

Este documento descreve os passos necessários para criar extensibilidade no serviço Eye Peak sob forma de Jobs a ocorrer em intervalos de tempo regulares. Esta implementação pressupõe a criação de uma dll de extensibilidade que terá de cumprir com as regras descritas nos seguintes passos. Pré-Requisitos

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

---

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”) e, abaixo da linguagem, 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. Atenção: Deve ter em atenção que o nome dado à solução tem seguir as seguintes regras: - Tem de começar por “GlobalSist.” (verificar letras maiúsculas e minúsculas); - De seguida, escrever o nome pretendido e um ponto; - Por fim, terminar com “Job”; Exemplo: GlobalSist.JobExtension.Job

Nota: Verificar se a versão 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, clicar com o botão direito do rato, e escolher “Add References…”.
2. Na janela que é apresentada, 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”.
3. Selecionar os ficheiros: "GlobalSist.Common.dll", "GlobalSist.DataAccess.dll", "GlobalSist.Library.dll", "GlobalSist.Server.Jobs.dll".
4. Carregar no botão “Add” e de seguida no botão “OK”.

---

Passo 3 – Criar classe de Implementação do Job

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

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

using GlobalSist.Common;
using GlobalSist.Server.Jobs;
using System;

namespace GlobalSist.JobExtension.Job
{
    public class JobExample : BaseJob
    {
    }
}

Implementar um construtor sem argumentos:

public JobExample() 
{
      this.Interval = 60; /// Elapsed time between runs in miliseconds
      this.jobName = JOB_NAME; /// The Job Name
}

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

protected override bool Run()
{
    ///Implementar acções pretendidas que serão executadas em intervalos de tempo constantes e regulares, durante a execução do serviço de Eye Peak
}

---

Passo 4 – Compilar a dll e instalar

Por último, é necessário compilar a dll, devendo de seguida parar a execução do serviço, copiar a dll para a pasta de instalação e iniciar o serviço. Veja um exemplo sobre a tecnologia do Eye Peak no GitHub.