01. Apresentação

Este documento tem por objetivo apresentar os passos necessários para disponibilizar no DataServer da linha RM a integração com o Totvs Assinatura Eletrônica. 

02. Configuração

Para configurar o RM x Totvs Assinatura Eletrônica é necessário informar nos parâmetros globais o caminho das API's do Totvs Assinatura Eletrônica.

03. Habilitar Meu DataServer

Para habilitar a utilização do Totvs Assinatura Eletrônica basta informar a propriedade "AllowTotvsSign" com o valor "True" na Action equivalente ao dataServer desejado.
Sendo assim, será disponibilizado a opção do Totvs Assinatura Eletrônica em sua funcionalidade.

using RM.Imb.Parametros;
using RM.Imb.Recursos;
using RM.Lib.Client;
using RM.Lib.WinForms;
 
partial class ImbContratoLocAction
  {
    /// <summary>
    /// Inicialização da action de contrato de locação    
    /// </summary>
    private void InitializeComponent()
    {
      components = new System.ComponentModel.Container();
      DataServerName = "ImbContratoLocData";     
      FormName = "ImbContratoLocForm";     
      AllowTotvsSign = true; 
     }
  }

Resultado:

04. Vinculo Processos

Após habilitar a utilização do Totvs Assinatura Eletrônica, é possível condicionar a execução de processo de acordo com o status do documento anexado a entidade principal.

Exemplo: 

Imagine que temos um contrato de locação de imóvel em elaboração e o usuário do sistema, enviou o "documento / contrato" para o locatário assinar via Totvs Assinatura eletrônica. 
E o usuário do RM, pode efetivar o contrato no RM antes mesmo do locatário assinar o documento.

Demanda:

Como devo codificar, para condicionar o sucesso do processo de "Efetivação do Contrato" com a assinatura do documento. Ou seja,  preciso que seja a apresentando mensagem de erro tratado para o usuário do RM caso ele tente efetivar o contrato para o documento não assinado.


04.1 Disponibilização dos processos

Para disponibilizar os processo para o usuário possa vincular com o documento, basta preencher a propriedade "ProcessValidationTotvsSignActions"

using RM.Imb.Parametros;
using RM.Imb.Recursos;
using RM.Lib.Client;
using RM.Lib.WinForms;

namespace RM.Imb.Aluguel.ContratoLoc
{
  partial class ImbContratoLocAction
  {
    /// <summary>
    /// Inicialização da action de contrato de locação    
    /// </summary>
    private void InitializeComponent()
    {
      components = new System.ComponentModel.Container();

      DataServerName = "ImbContratoLocData";
      FormName = "ImbContratoLocForm";
      // Libera o Totvs Assinatura eletrônica para o dataServer
      AllowTotvsSign = true;

      // Processo de efetivar contrato de locação
      ProcessActions.Add("ImbEfetivarContLocAction", true);


      //Disponibilização de processo na tela de envio de documento do Totvs Assinatura
      ProcessValidationTotvsSignActions.Add(new RMSProcessTotvsSignInfo()
      {
        ActionName = nameof(ImbEfetivarContLocAction),
        LabelProcess = Properties.Resources.SImbCaptinEfetivacaoContratoTotvsSign
      });

      ProcessValidationTotvsSignActions.Add(new RMSProcessTotvsSignInfo()
      {
        ActionName = nameof(ImbContratoLocEscalonamentoAction),
        LabelProcess = Properties.Resources.SImbCaptinEfetivacaoEscalonamentoTovsSign
      });

      ProcessValidationTotvsSignActions.Add(new RMSProcessTotvsSignInfo()
      {
        ActionName = nameof(ImbEfetivarAditivoContLocBaseAction),
        LabelProcess = Properties.Resources.SImbCaptinEfetivacaoAditivoTovsSign
      });

      ProcessValidationTotvsSignActions.Add(new RMSProcessTotvsSignInfo()
      {
        ActionName = nameof(ImbEncerrarContLocAction),
        LabelProcess = Properties.Resources.SImbCaptinEfetivacaoEncerramentoTovsSign
      });
    }

Resultado:

Os processo que foram preenchidos na action na lista ProcessValidationTotvsSignActions são apresentando no cadastro do documento.

Observação:

Caso a "action" não possua processos definidos não será exibido a página de seleção, os processos marcados para validar assinatura eletrônica serão gravados na tabela GINTEGRACAOTOTVSSIGNRESTRICAO


04.2 Validação dos processos

Após a exposição dos processo, os mesmo são exibidos para o usuário RM na aba de validações . Mas ainda não é suficiente, pois você tem apenas quais os processo foram marcados pelo usuário para "Validar" na tela do documento. Precisamos dessa informação em camada server para que o analista codifique sua validação. 

Foi disponibilizado método na framework  cujo sua responsabilidade e retornar informações referente documento anexado ao seu "DataServer" Principal. Sendo assim, você pode consumir esse método e implementar sua validação. Você deverá adicionar em seu Facade, uma chamada para o método "RetornarDadosArquivo(actionName, serverName, pkValues)" disponível na interface IGlbTotvsSignMod. E agora e utilizar o seu metodo que criou em seu facade.


using RM.Glb.TotvsSign;
using RM.Glb.TotvsSign.IService;
using RM.Lib.Server;
using System.Collections.Generic;

namespace RM.Imb.Aluguel.Facade
{
  public class ImbAluguelTotvsSignFacade : RMSFacade
  {
    /// <summary>
    /// 
    /// </summary>
    /// <param name="actionName">Action que deseja localizar</param>
    /// <param name="serverName">Nome do dataserver que foi o anexo do documento: Exemplo: ImbContratoLocData</param>
    /// <param name="pkValues">Pk da entidade Principal. Exemplo:1;45 Coligada =1 e CodContrato=45</param>
    /// <returns></returns>
    public List<ImbDocumentSignItem> RetornarDocumentoTotvsSign(string actionName, string serverName, List<string> pkValues)
    {
      List<ImbDocumentSignItem> retorno = new List<ImbDocumentSignItem>();
      using (var totvsSign = CreateModule<IGlbTotvsSignMod>("GlbTotvsSignMod"))
        if (totvsSign.IsConfiguracaoIntegracaoTotvsSign())
        {
          totvsSign.RetornarDadosArquivo(actionName, serverName, pkValues)
            ?.ForEach(doc => retorno.Add(doc));
        }
      return retorno;
    }
  }