Exibir origem

O contexto de biblioteca de classes .NET permite que seja utilizadas DLLs .NET para leitura dos dados para geração dos registros. Este contexto permite que praticamente qualquer informação seja utilizada para geração do Layout. Pode ser utilizada qualquer versão do Visual Studio ou outras ferramentas de desenvolvimento .NET para geração desta DLL.

1Nome do Assembly

Selecione a DLL .NET que será executada para retornar os dados do contexto.

2Classe

Selecione a classe da DLL que será usada para retornar os dados do contexto.

Algumas regras devem ser seguidas na criação das classes para utilização no contexto do gerador.

A classe a ser utilizada deverá ser pública e instânciável, ou seja não pode ser uma classe estática.
A classe deverá ter um construtor público, este construtor poderá receber uma classe de parâmetros, desde as propriedades da classe sejam de tipos de valores (string, int, datetime, etc), estes valores serão identificados e preenchidos pelo gerador.
A classe deverá ter pelo menos um método público que retorne um enumerado genérico IEnumerable<T>, de uma classe qualquer, esta lista será exposta como uma lista do contexto e poderá ser associada a uma ligação do registro. Todas as propriedades e campos de tipois básicos desta classe serão expostas como campos da lista e poderão ser associados aos campos dos registros. Caso alguma propriedade ou campo for um tipo complexo, o mesmo será exposto como um membro da lista ou uma lista filha caso a propriedades seja um enumerado genérico IEnumerable<T> de uma classe.
A DLL deverá ser uma DLL compilada para .NET Core 2 (netcoreapp2), no caso do gerador RM ela deverá ser uma DLL .NET Full utilizando a mesma versão da Framework utilizada pela versão do RM.
Para o RM, a classe deverá herdar de RM.Lib.Server.RMSModule e as propriedades disponibilizadas para o gerador deverão utilizar o atributo RM.Lib.ColumnAttribute.

A DLL core deverá estar localizada na mesma pasta do executor Core (onde está localizada a TNF.Gen.Exec.dll) assim como qualquer DLL que ela faça referência. A DLL do gerador RM deverá estar na pasta de instalação da Biblioteca (RM.NET).

Exemplo

O exemplo a seguir expõe os dados dos processos em execução no sistema para o gerador de saídas. Como parâmetro ele pode receber o nome da máquina que deseja listar os processos. O método ListaProcessos() irá ser executado pelo gerador e as propriedades das classes TestProcInfo e TestThreadInfo poderão ser utilizadas para gerar os registros do Layout.

using System;
using System.Collections.Generic;
using System.Diagnostics;
namespace RM.Gen.Test
{
&#160; /// <summary>
&#160; /// Classe de teste para uso no gerador de sa&#237;das
&#160; /// </summary>&#160; 
&#160; public class TestClass
&#160; {
&#160;&#160;&#160; private TestClassParam Parameters;
&#160;&#160;&#160; /// <summary>
&#160;&#160;&#160; /// Cria uma inst&#226;ncia da classe
&#160;&#160;&#160; /// </summary>
&#160;&#160;&#160; /// <param name="machineName">Nome da m&#225;quina para listagem dos processos</param>
&#160;&#160;&#160; public TestClass(TestClassParam parameters)
&#160;&#160;&#160; {
&#160;&#160;&#160;&#160;&#160; this.Parameters = parameters;
&#160;&#160;&#160; }
&#160;&#160;&#160; /// <summary>
&#160;&#160;&#160; /// Lista os processos em execu&#231;&#227;o na m&#225;quina
&#160;&#160;&#160; /// </summary>
&#160;&#160;&#160; /// <returns></returns>
&#160;&#160;&#160; public List<TestProcInfo> ListaProcessos()
&#160;&#160;&#160; {
&#160;&#160;&#160;&#160;&#160; List<TestProcInfo> lista = new List<TestProcInfo>();
&#160;&#160;&#160;&#160;&#160; // carrega os processo em execu&#231;&#227;o na m&#225;quina...
&#160;&#160;&#160;&#160;&#160; Process[] procs;
&#160;&#160;&#160;&#160;&#160; if (this.Parameters != null && !string.IsNullOrEmpty(this.Parameters.MachineName))
&#160;&#160;&#160;&#160;&#160;&#160;&#160; procs = Process.GetProcesses(this.Parameters.MachineName);
&#160;&#160;&#160;&#160;&#160; else
&#160;&#160;&#160;&#160;&#160;&#160;&#160; procs = Process.GetProcesses();
&#160;&#160;&#160;&#160;&#160; // carrega as classes de resultado...
&#160;&#160;&#160;&#160;&#160; foreach (Process proc in procs)
&#160;&#160;&#160;&#160;&#160;&#160;&#160; lista.Add(new TestProcInfo(proc));
&#160;&#160;&#160;&#160;&#160; return lista;
&#160;&#160;&#160; }
&#160; }
&#160; /// <summary>
&#160; /// Par&#226;metros informados pelo gerador
&#160; /// </summary>
&#160; public class TestClassParam
&#160; {
&#160;&#160;&#160; public string MachineName { get; set; }
&#160; }
&#160; /// <summary>
&#160; /// Dados do processo do sistema
&#160; /// </summary>
&#160; public class TestProcInfo
&#160; {
&#160;&#160;&#160; public TestProcInfo(Process proc)
&#160;&#160;&#160; {
&#160;&#160;&#160;&#160;&#160; this.Id = proc.Id;
&#160;&#160;&#160;&#160;&#160; this.Titulo = proc.MainWindowTitle;
&#160;&#160;&#160;&#160;&#160; this.MemoriaMax = proc.PeakWorkingSet64;
&#160;&#160;&#160;&#160;&#160; this.MemoriaEmUso = proc.WorkingSet64;
&#160;&#160;&#160;&#160;&#160; try
&#160;&#160;&#160;&#160;&#160; {
&#160;&#160;&#160;&#160;&#160;&#160;&#160; this.HoraInicio = proc.StartTime;
&#160;&#160;&#160;&#160;&#160; }
&#160;&#160;&#160;&#160;&#160; catch
&#160;&#160;&#160;&#160;&#160; {
&#160;&#160;&#160;&#160;&#160; }
&#160;&#160;&#160;&#160;&#160; // carrega a lista de threads...
&#160;&#160;&#160;&#160;&#160; this.Threads = new List<TestThreadInfo>();
&#160;&#160;&#160;&#160;&#160; foreach (ProcessThread procThread in proc.Threads)
&#160;&#160;&#160;&#160;&#160;&#160;&#160; this.Threads.Add(new TestThreadInfo(procThread));
&#160;&#160;&#160; }
&#160;&#160;&#160; public int Id { get; private set; }
&#160;&#160;&#160; public string Titulo { get; private set; }
&#160;&#160;&#160; public long MemoriaMax { get; private set; }
&#160;&#160;&#160; public long MemoriaEmUso { get; private set; }
&#160;&#160;&#160; public DateTime HoraInicio { get; private set; }
&#160;&#160;&#160; public List<TestThreadInfo> Threads { get; private set; }
&#160; }
&#160; /// <summary>
&#160; /// Dados da Thread do Processo
&#160; /// </summary>
&#160; public class TestThreadInfo
&#160; {
&#160;&#160;&#160; public TestThreadInfo(ProcessThread procThread)
&#160;&#160;&#160; {
&#160;&#160;&#160;&#160;&#160; this.Id = procThread.Id;
&#160;&#160;&#160;&#160;&#160; if (procThread.ThreadState == ThreadState.Running)
&#160;&#160;&#160;&#160;&#160; {
&#160;&#160;&#160;&#160;&#160;&#160;&#160; try
&#160;&#160;&#160;&#160;&#160;&#160;&#160; {
&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; this.Processamento = procThread.UserProcessorTime;
&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; this.HoraInicio = procThread.StartTime;
&#160;&#160;&#160;&#160;&#160;&#160;&#160; }
&#160;&#160;&#160;&#160;&#160;&#160;&#160; catch
&#160;&#160;&#160;&#160;&#160;&#160;&#160; {
&#160;&#160;&#160;&#160;&#160;&#160;&#160; }
&#160;&#160;&#160;&#160;&#160; }
&#160;&#160;&#160; }
&#160;&#160;&#160; public int Id { get; private set; }
&#160;&#160;&#160; public DateTime HoraInicio { get; private set; }
&#160;&#160;&#160; public TimeSpan Processamento { get; private set; }
&#160; }
}