Manipulando o quadro de Gantt e Criando uma regra de sequenciamento Personalizada - Treinamento API Preactor

Uma regra de sequenciamento consiste em distribuir da melhor for possível as operações/ ordens de produção pelos recursos produtivos disponíveis.

O Preactor já faz isso muito bem, pois possui inúmeras regras de sequenciamento Padrão: Minimização de Setup, Sequencia Preferida, Regras APS para frente, para trás, por prioridade, por data de entrega. 

Mas alguns empresas possuem particularidades que não são atendidas por essas regras, por isso a necessidade de desenvolver um algorítimo que interaja com o Preactor sequenciando as ordens de forma a atender essas particularidades.

O intuito desse tutorial não é te tornar um expert em regras de sequenciamento, e sim abrir sua cabeça sobre o que pode ser feito e através das funções que conhecerá. Com esse conhecimento você poderá montar sua própria regra de sequenciamento dentro do Preactor.

Para essa parte do treinamento você irá precisar baixar o modelo workshop 03

Funções PlanningBoard Preactor

A biblioteca PlanningBoard do Preactor é um grupo de funções que permitem o programador interagir com o Gráfico de Gantt. Na PlanningBoard que estão contidas as funções de sequenciamento de ordens, manipulação de calendários, movimentar da linha de tempo do Preactor, além de outras.

Vamos aprender então alguns funções básicas do PlanningBoard:

Instanciando a classe:

 IPreactor preactor = PreactorFactory.CreatePreactorObject(preactorComObject);
 //criando uma instancia da classe
 IPlanningBoard planning = preactor.PlanningBoard;


Função para mover a linha do tempo do Preactor:
IPlanningBoard planning = preactor.PlanningBoard;
//POSICIONA A LINHA DO TEMPO EM 02/10/2014 14:30
planning.TerminatorTime = new DateTime(2014,10,02,14,30,0);


Sequenciando todas as Desprogramadas:
            //SEQUENCIAMENTO PARA FRENTE
            planning.SequenceAll(SequenceAllDirection.Forwards, SequencePriority.Default);

            //SEQUENCIAMENTO PARA FRENTE POR DATA DE ENTREGA
            planning.SequenceAll(SequenceAllDirection.Forwards, SequencePriority.DueDate);

            //SEQUENCIAMENTO PARA FRENTE POR ORDEM DE CRIAÇÃO DAS ORDENS
            planning.SequenceAll(SequenceAllDirection.Forwards, SequencePriority.FileOrder);

            //SEQUENCIAMENTO PARA FRENTE POR PRIORIDADE
            planning.SequenceAll(SequenceAllDirection.Forwards, SequencePriority.Priority);

            //SEQUENCIAMENTP PARA FRENTE POR PRIORIDADE REVERSA
            planning.SequenceAll(SequenceAllDirection.Forwards, SequencePriority.ReversePriority);

            //SEQUENCIAMENTO PARA FRENTE POR CARGA/PESO 
            planning.SequenceAll(SequenceAllDirection.Forwards, SequencePriority.Weight);

            //TODAS ESSES TIPOS DE SEQUENCIAMENTO TAMBÉM PODEM SER APLICADOS PARA
            //SEQUENCIAMENTO PARA TRÁS, BASTA ALTERAR O PARÂMETRO 1 DA FUNÇÃO
            planning.SequenceAll(SequenceAllDirection.Backwards, SequencePriority.Default);


Desprogramar, ou desalocar as ordens do Gantt:
            //TODAS ESSES TIPOS DE SEQUENCIAMENTO TAMBÉM PODEM SER APLICADOS PARA
            //SEQUENCIAMENTO PARA TRÁS, BASTA ALTERAR O PARÂMETRO 1 DA FUNÇÃO
            planning.SequenceAll(SequenceAllDirection.Backwards, SequencePriority.Default);

            //DESPROGRAMAR TODAS AS ORDENS QUE ESTÃO DENTRO DO INTERVALO DE 2 MESES APÓS O TERMINADOR
            planning.UnallocateAll(planning.TerminatorTime, planning.TerminatorTime.AddMonths(2), OperationReferencePoint.ChangeStart);

            //DESPROGRAMAR UMA ORDEM, E TODAS SUAS OPERAÇÕES
            planning.UnallocateOperation(10, OperationSelection.AllOperations);
            //DESPROGRAMAR APENAS A OPERAÇÃO COMPREENDIDA PELO REGISTRO 10
            planning.UnallocateOperation(10, OperationSelection.ThisOperation);


Sequenciar uma única operação ou Ordem:
            //SEQUENCIAR TODAS AS OPERAÇÕES DA ORDEM 10 PARA FRENTE EM 01/01/2000 14:30
            var data = new DateTime(2000, 01, 01, 14, 30, 0);
            planning.SequenceOperation(10, SequenceOperationSelection.AllForwards, data);

            //SEQUENCIAR APENAS A OPERAÇÃO 10 EM 01/01/2000 14:30
            planning.SequenceOperation(10, SequenceOperationSelection.ThisOperation, data);


WorkShop 03

Com base nas funções que você aprendeu até o momento utilize o modelo do Workshop 03 e crie uma regra de sequenciamento personalizada.

Sua regra de sequenciamento deve ler o campo "Atributo 2" de cada ordem e sequenciar as operações de acordo com a sequencia de cadastro da tabela "Atributo 2", que segue a seguinte ordem:Regra 01, Regra 02, Regra 03, regra 04;

Explicando melhor: leia o campo "Atributo 2" das ordens, e sequencie 
1º todas as ordens "Regra 01", 
2º todas as ordens "Regra 02", e assim por diante.

Mãos a obra e boa sorte.

dúvidas: besaleel@msn.com

WorkShop 01 - Preactor API

Resolução workshop 01:

Irei mostrar a resolução do workshop em tópicos, seguindo uma sequencia lógica de trabalho, ok?

1º - Dentro de meu projeto Olá Mundo, eu criei uma classe contendo exatamente as mesmas propriedades do arquivo CSV:
 public class Apontamento
    {
        private string _ordem;
        private string _recurso;
        private string _status;
        private DateTime _dataDeInicio;
        private DateTime _dataDeFim;

        public string Ordem
        {
            get { return _ordem; }
            set { _ordem = value; }
        }

        public string Recurso
        {
            get { return _recurso; }
            set { _recurso = value; }
        }

        public string Status
        {
            get { return _status; }
            set { _status = value; }
        }

        public DateTime DataDeInicio
        {
            get { return _dataDeInicio; }
            set { _dataDeInicio = value; }
        }

        public DateTime DataDeFim
        {
            get { return _dataDeFim; }
            set { _dataDeFim = value; }
        }

        public override bool Equals(object obj)
        {
            if (obj is DBNull) return false;
            if (obj == null) return false;
            var m = (Apontamento) obj;
            return m.Ordem == _ordem;
        }

        public override int GetHashCode()
        {
            return base.GetHashCode();
        }
    }
2º Criei uma função para ler os dados do arquivo CSV e passar os valores para uma lista de Apontamentos:
 private IList getApontamentosByFileCSV(string pathFile)
        {
            try
            {
                IList apos = new List();

                if (!File.Exists(pathFile))
                {
                    MessageBox.Show("O arquivo de Apontamento não foi encontrado.");
                    return new List();
                }
                StreamReader rd = new StreamReader(pathFile, Encoding.Default);
                try
                {
                    var count = 0;
                    while (!rd.EndOfStream)
                    {
                        count++;
                        var linha = rd.ReadLine();
                        if (count == 1) continue;
                        if (string.IsNullOrEmpty(linha)) continue;

                        var colunas = linha.Split(';');
                        Apontamento iten = new Apontamento();
                        iten.Ordem = colunas[0];
                        iten.Recurso = colunas[1];
                        iten.Status = colunas[2];
                        iten.DataDeInicio = parseDate(colunas[3]);
                        iten.DataDeFim = parseDate(colunas[4]);

                        apos.Add(iten);
                    }
                }
                catch (Exception)
                {
                    throw;
                }
                finally
                {
                  rd.Close();  
                }


                return apos;
            }
            catch (Exception ex)
            {
                throw new Exception("Falha ao recuperar os dados do arquivo CSV:" + Environment.NewLine + ex.Message);
            }
        }
3º Criei um método que faz a comunicação com o Preactor, recebe a lista de apontamentos baseado no arquivo CSV e grava na tabela do Preactor:
OBS: a diferença entre este novo método e o OláMundo (Run) é um novo parâmetro que foi adicionado a função, "ref string arquivo". Eu achei essa forma mais simples configurar o nome e local onde o arquivo csv se encontra, mas você poderia também ter deixa o caminho e nome do arquivo fixos em seu projeto, ok?


 public int ImportApontamento(ref PreactorObj preactorComObject, ref object pespComObject, ref string arquivo)
        {
            IPreactor preactor = PreactorFactory.CreatePreactorObject(preactorComObject);
            try
            {
                //RECUPERAR OS DADOS DO ARQUIVO CSV
                IList itens = getApontamentosByFileCSV(arquivo);
                if (itens.Count == 0) return 0;

                //LIMPAR TABELA DE APONTAMENTOS
                preactor.Clear("Apontamento");

                preactor.DisplayStatus("Apontamentos","Importando arquivos de apontamentos.");
                var count = itens.Count;
                var i = 0;
                preactor.UpdateStatus(i, count);
                //INSERIR O GRUPO DE REGISTROS
                foreach (var iten in itens)
                {
                    i++;
                    preactor.UpdateStatus(i, count);
                    //CRIAR UM NOVO REGISTRO NA TABELA DE APONTAMENTOS
                    int record = preactor.CreateRecord("Apontamento");

                    //ESCREVER NA TABELA APONTAMENTOS
                    preactor.WriteField("Apontamento", "Ordem", record, iten.Ordem);
                    if (!string.IsNullOrEmpty(iten.Recurso))
                        preactor.WriteField("Apontamento", "Recurso", record, iten.Recurso);
                    if (!string.IsNullOrEmpty(iten.Status))
                        preactor.WriteField("Apontamento", "Status", record, iten.Status);
                    if (iten.DataDeInicio != DateTime.MinValue)
                        preactor.WriteField("Apontamento", "Data de Início", record, iten.DataDeInicio);
                    if (iten.DataDeFim != DateTime.MinValue)
                        preactor.WriteField("Apontamento", "Data de Fim", record, iten.DataDeFim);
                }
                preactor.DestroyStatus();
                //VAMOS SALVAR OS DADOS NA TABELA DO PREACTOR
                preactor.Commit("Apontamento");
                MessageBox.Show("Seus dados foram importados com sucesso!");
            }
            catch (Exception ex)
            {
                preactor.DestroyStatus();
                MessageBox.Show("Falha ao importar os Apontamentos:" + Environment.NewLine + ex.Message);
            }

            return 0;

        }
4º Criei um botão no arquivo de configuração prmdf, já fizemos isso no olá mundo.

5º Cadastrei a ação dentro do Preactor conforme a ação Olá Mundo, acompanhe o passo a passo:

clique em Editar

Clique em "Novo Registro" em seguida "Adicionar->", digite o nome "arquivo" E clique Ok

Vá para o Menu Script de Eventos => Script de Eventos

Clique em "Parameters.."

Clique Sobre o nome "arquivo"

No campo "File Name", adicione o caminho e o nome do arquivo que iremos importar

6º Vamos Testar nossa ação, vá no Visual Studio e aparte a tecla de atalho "F5", e vamos debugar nosso código:

Com isso encerramos nosso primeiro WorkShop, não detalhei as ações pois elas são bem simples, igual uma receita de bolo, basta seguir o passo-a-passo que não tem erro.

Se houver algum dúvida sobre esse workshop me escreva besaleel@msn.com ou faça um comentário aqui no blog que responderei o mais breve possível.

Se preferir faça o download da solução completa do WorkShop 01.