Configurações

Guia para Emissão e Configuração de Certificado SSL no DOX Portal

Objetivo

Este documento orienta clientes da Ema Sistemas na emissão e configuração de certificados SSL para uso em domínios próprios no DOX Portal.

A utilização do HTTPS (HTTP sobre SSL/TLS) garante uma camada adicional de segurança na comunicação entre o navegador e o servidor, protegendo os dados transmitidos por meio de criptografia.

✅ Etapas para Emissão e Configuração do Certificado SSL

1. Registrar um Domínio Próprio

💡 Importante: A Ema não realiza o registro para os clientes, mas pode instruir como fazer. O registro de domínio é um serviço pago.

2. Hospedar o Domínio

💰 A hospedagem do domínio também é um serviço pago.

3. Criar o Subdomínio e Emitir o Certificado SSL

Com o domínio hospedado:

  1. Crie o subdomínio que será utilizado no acesso ao DOX Portal (ex: dox.suaempresa.com.br)
  2. Solicite no serviço de hospedagem a emissão do certificado SSL para este subdomínio, garantindo que o formato gerado seja compatível com o sistema da Ema: .PEM ou .CRT
  3. Alternativa: Caso a hospedagem não ofereça emissão de certificado SSL, será necessário buscar uma certificadora terceirizada especializada. Esta alternativa exige atenção redobrada, pois envolve um processo mais técnico e pode demandar etapas adicionais de validação e configuração.

⏱️ A emissão pode levar até 1 dia útil, dependendo do provedor de hospedagem.

4. Configurar o Certificado no Ema Configurador

Com o certificado em mãos, siga os passos abaixo com apoio do Suporte da Ema:

  1. Abra o Ema Configurador e edite o registro da conexão
  2. Defina a porta principal como 443 (HTTPS padrão). Portas alternativas também são permitidas, desde que especificadas corretamente no endereço de conexão
  3. Marque a opção "Utiliza HTTPS"
  4. Nos campos "Certificado" e "Arq. Senha" procure e informe o certificado no formato .PEM ou .CRT
  5. Caso o cliente esteja executando o sistema anteriormente com conexão HTTP, altere o caminho de conexão no seguinte arquivo, substituindo o protocolo de http para https e ajustando a porta.:
    C:\Ema Software\Contas ERP\Ema_Conexao_Servidor.ini
5. Testar a Inicialização do Sistema com SSL

Caso os microserviços do sistema não iniciem, execute o seguinte teste manual:

  1. Abra o terminal do Windows (Prompt de Comando)
  2. Execute:
    C:\Ema Software\Contas ERP\fabio.exe" -cfg fabio.properties
  3. Este comando tenta inicializar o serviço com o certificado SSL configurado e mostrará mensagens de erro úteis para diagnóstico

🔧 Se o sistema estiver online, pare os serviços pelo Ema_Start antes de testar.

ℹ️ Informações Importantes

🌐 Clientes Cloud Server da Ema

🆓 Opção Gratuita com Let's Encrypt

🔗 Documentação Relacionada

Para mais informações sobre configuração de acesso externo, consulte também: Liberando o Acesso Externo ao DOX Portal


Integração do Active Directory com Aplicações Ema

O que é Active Directory?

O Active Directory é uma implementação de serviço de diretório no protocolo LDAP que armazena informações sobre objetos em rede de computadores e disponibiliza essas informações a usuários e administradores desta rede.

Como Integrar com as Aplicações da Ema?

Primeiramente o ambiente do cliente precisar estar devidamente configurado com o AD DS (Active Directory Domain Service). Caso não esteja, não será possível utilizar o recurso. Caso queira configurar, deve entrar em contato com sua Equipe de TI para que seja realizada a configuração.

Habilitando o uso do AD nas aplicações

Para que o ERP/APS/DOX funcionem junto com o AD, precisamos habilitar o micro serviço Ema_AD, sem ele não será possível.

Vamos em C:\Ema Software\Contas ERP\ -> aqui procuramos pelo Ema_Configurador -> vamos na aba serviços -> habilitamos o micro serviço Ema_AD -> clicamos na opção salvar -> e depois reiniciamos o serviço Ema start.

Após subir os serviços, devemos abrir o DOX estúdio, pois a configuração atualmente é feita única e exclusivamente pela aplicação.

configurações -> parâmetros gerais -> aba Active Directory, habilitar as seguintes opções:

Liberando o Acesso Externo ao DOX Portal

Quer acessar o DOX Portal de qualquer lugar, com um endereço personalizado e seguro? Veja como liberar o acesso externo de forma simples e eficiente:

🛠️ O que você vai precisar

1️⃣ Crie o subdomínio para o DOX Portal

2️⃣ Libere a porta de comunicação no seu firewall/gateway

3️⃣ Acesse o DOX Portal de fora da empresa

Agora você já pode acessar de qualquer lugar, usando:

💡 Dicas extras

Pacote de funções - PostgreSQL

Criando o SCHEMA PKG_EMA 

CREATE SCHEMA pkg_ema AUTHORIZATION postgres;

RETORNA COLUNA GRADE

-- DROP FUNCTION pkg_ema.retorna_coluna_grade(int4, int4, int4, int4, int4);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_coluna_grade(xidprocesso integer, xidatividade integer, xidformulario integer, xidgrade integer, xidvalor integer)
 RETURNS character varying
 LANGUAGE plpgsql
AS $function$
  declare
   leitura varchar(4000);
  begin
   select
    resposta into leitura
   from public.crm_processo_grade_valor
   where idprocesso = xidprocesso
    and idformulario = xidformulario
    and idatividade = xidatividade
    and idgrade  = xidgrade
    and idvalor  = xidvalor
    and idrepeticao = (select max(idrepeticao)
          from crm_processo_grade_valor xx
          where xx.idatividade = crm_processo_grade_valor.idatividade
          and xx.idprocesso = crm_processo_grade_valor.idprocesso
          and xx.idformulario = crm_processo_grade_valor.idformulario);
  return(trim(leitura));
  end;
 $function$
;

RETORNA COLUNA GRADE GLOB 

-- DROP FUNCTION pkg_ema.retorna_coluna_grade_clob(int4, int4, int4, int4, int4);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_coluna_grade_clob(xidprocesso integer, xidatividade integer, xidformulario integer, xidgrade integer, xidvalor integer)
 RETURNS text
 LANGUAGE plpgsql
AS $function$
  declare
   leitura text;
  begin
   select
    resposta into leitura
   from public.crm_processo_grade_valor
   where idprocesso = xidprocesso
    and idformulario = xidformulario
    and idatividade = xidatividade
    and idgrade  = xidgrade
    and idvalor  = xidvalor
    and idrepeticao = (select max(idrepeticao)
          from crm_processo_grade_valor xx
          where xx.idatividade = crm_processo_grade_valor.idatividade
          and xx.idprocesso = crm_processo_grade_valor.idprocesso
          and xx.idformulario = crm_processo_grade_valor.idformulario);
  return(trim(leitura));
  end;
 $function$
;

RETORNA COLUNA GRADE DATA

-- DROP FUNCTION pkg_ema.retorna_coluna_grade_data(int4, int4, int4, int4, int4);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_coluna_grade_data(xidprocesso integer, xidatividade integer, xidformulario integer, xidgrade integer, xidvalor integer)
 RETURNS date
 LANGUAGE plpgsql
AS $function$
  declare
   leitura date;
  begin
   select respostadatahora into leitura
   from public.crm_processo_grade_valor
   where idprocesso = xidprocesso
    and idformulario= xidformulario
    and idatividade = xidatividade
    and idgrade  = xidgrade
    and idvalor  = xidvalor
    and idrepeticao = (select max(idrepeticao)
          from crm_processo_grade_valor xx
          where xx.idatividade = crm_processo_grade_valor.idatividade
          and xx.idprocesso = crm_processo_grade_valor.idprocesso
          and xx.idformulario = crm_processo_grade_valor.idformulario);
  return(leitura); --fazer o trim depois
  
  end;
 $function$
;

RETORNA COLUNA GRADE DATAHORA 

-- DROP FUNCTION pkg_ema.retorna_coluna_grade_datahr(int4, int4, int4, int4, int4);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_coluna_grade_datahr(xidprocesso integer, xidatividade integer, xidformulario integer, xidgrade integer, xidvalor integer)
 RETURNS timestamp without time zone
 LANGUAGE plpgsql
AS $function$
  declare
   leitura timestamp;
  begin
   select respostadatahora into leitura
   from public.crm_processo_grade_valor
   where idprocesso = xidprocesso
    and idformulario= xidformulario
    and idatividade = xidatividade
    and idgrade  = xidgrade
    and idvalor  = xidvalor
    and idrepeticao = (select max(idrepeticao)
          from crm_processo_grade_valor xx
          where xx.idatividade = crm_processo_grade_valor.idatividade
          and xx.idprocesso = crm_processo_grade_valor.idprocesso
          and xx.idformulario = crm_processo_grade_valor.idformulario);
  return(leitura);
  
  end;
 $function$
;

RETORNA COLUNA GRADE INTEIRO 

-- DROP FUNCTION pkg_ema.retorna_coluna_grade_int(int4, int4, int4, int4, int4);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_coluna_grade_int(xidprocesso integer, xidatividade integer, xidformulario integer, xidgrade integer, xidvalor integer)
 RETURNS integer
 LANGUAGE plpgsql
AS $function$
 declare
  leitura int4;
 
  begin 
  /*leitura := 0 ;
  select (select to_number(decode(respostainteiro,'.',0,respostainteiro)) from dual)*/
 
  select respostainteiro into leitura
  from public.crm_processo_grade_valor
  where idprocesso = xidprocesso
  and idformulario = xidformulario
  and idatividade = xidatividade
  and idgrade = xidgrade
  and idvalor = xidvalor
  and idrepeticao = (select max(idrepeticao)
       from crm_processo_grade_valor xx
       where xx.idatividade = crm_processo_grade_valor.idatividade
       and xx.idprocesso = crm_processo_grade_valor.idprocesso);
 
  return(leitura);
 
  end;
 $function$
;

RETORNA COLUNA GRADE TEXTO

-- DROP FUNCTION pkg_ema.retorna_coluna_grade_texto(int4, int4, int4, int4, int4);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_coluna_grade_texto(xidprocesso integer, xidatividade integer, xidformulario integer, xidgrade integer, xidvalor integer)
 RETURNS character varying
 LANGUAGE plpgsql
AS $function$
  declare
   leitura varchar(4000);
  begin
   select
    resposta into leitura
   from public.crm_processo_grade_valor
   where idprocesso = xidprocesso
    and idformulario = xidformulario
    and idatividade = xidatividade
    and idgrade  = xidgrade
    and idvalor  = xidvalor
    and idrepeticao = (select max(idrepeticao)
          from crm_processo_grade_valor xx
          where xx.idatividade = crm_processo_grade_valor.idatividade
          and xx.idprocesso = crm_processo_grade_valor.idprocesso
          and xx.idformulario = crm_processo_grade_valor.idformulario);
  return(trim(leitura));
  end;
 $function$
;

RETORNA COLUNA GRADE VALOR

-- DROP FUNCTION pkg_ema.retorna_coluna_grade_valor(int4, int4, int4, int4, int4);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_coluna_grade_valor(xidprocesso integer, xidatividade integer, xidformulario integer, xidgrade integer, xidvalor integer)
 RETURNS numeric
 LANGUAGE plpgsql
AS $function$
  declare
   leitura numeric(15,2);
  begin  
   select respostavalor into leitura
   from public.crm_processo_grade_valor
   where idprocesso  = xidprocesso
    and idformulario  = xidformulario
    and idatividade  = xidatividade
    and idgrade   = xidgrade
    and idvalor   = xidvalor
    and idrepeticao  = (select max(idrepeticao)
           from crm_processo_grade_valor xx
           where xx.idatividade = crm_processo_grade_valor.idatividade
            and xx.idprocesso  = crm_processo_grade_valor.idprocesso);
   return(leitura);
  end;
 $function$
;

RETORNA LISTA 

-- DROP FUNCTION pkg_ema.retorna_lista(text, bpchar);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_lista(in_lista text, delimitador character)
 RETURNS TABLE(out_id integer, out_str text)
 LANGUAGE plpgsql
AS $function$
declare
  dados record;
begin
IN_LISTA = REPLACE(REPLACE(IN_LISTA,'(',''),')','');
   
   IF DELIMITADOR = '' OR DELIMITADOR IS NULL THEN DELIMITADOR = ','; END IF;
  IF IN_LISTA <> '.' and IN_LISTA is not null and IN_LISTA <> '' and (IN_LISTA not like '/%' and IN_LISTA not like '%/')  THEN   
  for dados in (select unnest(string_to_array(IN_LISTA, DELIMITADOR)) LISTA) 
  LOOP
  BEGIN
  OUT_ID  = cast(dados.lista as integer);
     OUT_STR = dados.lista;
  RETURN NEXT;
 
   EXCEPTION
WHEN OTHERS then
   OUT_ID = 0;
OUT_STR = dados.lista; 
    RETURN NEXT;
  END;
  END LOOP; 
  ELSE 
OUT_ID  = 0;
  OUT_STR = '0';
  RETURN NEXT;
END IF;
    
end;
$function$
;

RETORNA VALOR VARIAVEL 

-- DROP FUNCTION pkg_ema.retorna_valor_variavel(int4, int4);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_valor_variavel(xidprocesso integer, xidvariavel integer)
 RETURNS character varying
 LANGUAGE plpgsql
AS $function$
  declare
  valor varchar(5000);
  begin
  select valoratual into valor
  from public.crm_processo_variavel
  where crm_processo_variavel.idprocesso = xidprocesso
  and crm_processo_variavel.idvariavel = xidvariavel ;
  return valor;
  end;
$function$
;

RETORNA VALOR VARIAVEL BLOB

-- DROP FUNCTION pkg_ema.retorna_valor_variavel_blob(int4, int4);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_valor_variavel_blob(xidprocesso integer, xidvariavel integer)
 RETURNS text
 LANGUAGE plpgsql
AS $function$
  declare
  valor text;
  begin
  select valorblob into valor
  from public.crm_processo_variavel
  where crm_processo_variavel.idprocesso = xidprocesso
  and crm_processo_variavel.idvariavel = xidvariavel ;
  return trim(valor);
  end;
$function$
;

RETORNA VALOR VARIAVEL CLOB

-- DROP FUNCTION pkg_ema.retorna_valor_variavel_clob(int4, int4);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_valor_variavel_clob(xidprocesso integer, xidvariavel integer)
 RETURNS text
 LANGUAGE plpgsql
AS $function$
  declare
  valor text;
  begin
  select valoratual into valor
  from public.crm_processo_variavel
  where crm_processo_variavel.idprocesso = xidprocesso
  and crm_processo_variavel.idvariavel = xidvariavel ;
  return trim(valor);
  end;
$function$
;

RETORNA VALOR VARIAVEL DATA 

-- DROP FUNCTION pkg_ema.retorna_valor_variavel_data(int4, int4);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_valor_variavel_data(xidprocesso integer, xidvariavel integer)
 RETURNS date
 LANGUAGE plpgsql
AS $function$
  declare
   valor date;
  begin
  if (xidprocesso > 0 and xidvariavel > 0) then
  begin
  select case when valoratual <> '.' then to_date(valoratual,'dd/mm/yyyy HH24:MI')
   else to_date('01-01-1900','dd/mm/yyyy HH24:MI') end into valor
  from public.crm_processo_variavel
  where crm_processo_variavel.idprocesso = xidprocesso
  and crm_processo_variavel.idvariavel = xidvariavel ;
  end;
  else
  valor := to_date('01/01/1900','dd/mm/yyyy HH24:MI');
  end if;
  return valor;
  end;
$function$
;

RETORNA VALOR VARIAVEL DATAHORA

-- DROP FUNCTION pkg_ema.retorna_valor_variavel_datahr(int4, int4);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_valor_variavel_datahr(xidprocesso integer, xidvariavel integer)
 RETURNS timestamp without time zone
 LANGUAGE plpgsql
AS $function$
  declare
   valor timestamp;
  begin
  if (xidprocesso > 0 and xidvariavel > 0) then
  begin
  select case when valoratual <> '.' then to_timestamp(valoratual,'dd/mm/yyyy HH24:MI')
   else to_timestamp('01-01-1900','dd/mm/yyyy HH24:MI') end into valor
  from public.crm_processo_variavel
  where crm_processo_variavel.idprocesso = xidprocesso
  and crm_processo_variavel.idvariavel = xidvariavel ;
  end;
  else
  valor := to_timestamp('01/01/1900','dd/mm/yyyy HH24:MI');
  end if;
  return valor;
  end;
$function$
;

RETORNA VALOR VARIAVEL INTEIRO 

-- DROP FUNCTION pkg_ema.retorna_valor_variavel_int(int4, int4);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_valor_variavel_int(xidprocesso integer, xidvariavel integer)
 RETURNS integer
 LANGUAGE plpgsql
AS $function$
declare
 valor int4;
  begin
  select cast(case when valoratual = '.' then '0' else valoratual end as int4)
  into valor
  from public.crm_processo_variavel
  where crm_processo_variavel.idprocesso = xidprocesso
  and crm_processo_variavel.idvariavel = xidvariavel ;
  return valor;
  end;
$function$
;

RETORNA VALOR VARIAVEL TEXTO

-- DROP FUNCTION pkg_ema.retorna_valor_variavel_texto(int4, int4);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_valor_variavel_texto(xidprocesso integer, xidvariavel integer)
 RETURNS character varying
 LANGUAGE plpgsql
AS $function$
  declare
  valor varchar(5000);
  begin
  select valoratual into valor
  from public.crm_processo_variavel
  where crm_processo_variavel.idprocesso = xidprocesso
  and crm_processo_variavel.idvariavel = xidvariavel ;
  return valor;
  end;
$function$
;

RETORNA VALOR VARIAVEL VALOR 

-- DROP FUNCTION pkg_ema.retorna_valor_variavel_valor(int4, int4);

CREATE OR REPLACE FUNCTION pkg_ema.retorna_valor_variavel_valor(xidprocesso integer, xidvariavel integer)
 RETURNS numeric
 LANGUAGE plpgsql
AS $function$
  declare
   valor decimal(15,2) ;
  begin
  select replace(replace(case when valoratual = '.' then '0' else valoratual end, '.', ''), ',', '.')
  into valor
  from public.crm_processo_variavel
  where crm_processo_variavel.idprocesso = xidprocesso
  and crm_processo_variavel.idvariavel = xidvariavel ;
  return valor;
  end;
$function$
;

EXEMPLO RETORNO DE GRADE

SELECT PKG_EMA.RETORNA_COLUNA_GRADE_INT(X.IDPROCESSO, X.IDATIVIDADE, X.IDFORMULARIO, 1, X.IDVALOR) AS NOMECAMPO1,
       PKG_EMA.RETORNA_COLUNA_GRADE_INT(X.IDPROCESSO, X.IDATIVIDADE, X.IDFORMULARIO, 2, X.IDVALOR) AS NOMECAMPO2,
       PKG_EMA.RETORNA_COLUNA_GRADE_INT(X.IDPROCESSO, X.IDATIVIDADE, X.IDFORMULARIO, 3, X.IDVALOR) AS NOMECAMPO3,
       PKG_EMA.RETORNA_COLUNA_GRADE_VALOR(X.IDPROCESSO, X.IDATIVIDADE, X.IDFORMULARIO, 4, X.IDVALOR) AS NOMECAMPO4,
       0/*IDPROCESSO*/ AS IDPROCESSO
  FROM CRM_PROCESSO_GRADE_VALOR X
 WHERE IDPROCESSO = 0/*IDPROCESSO*/
   AND IDATIVIDADE = 3/*IDATIVIDAE*/
   AND IDFORMULARIO = 34/*IDFORMULARIO*/
   AND IDREPETICAO = (SELECT MAX(IDREPETICAO)
                        FROM CRM_PROCESSO_GRADE_VALOR
                       WHERE IDPROCESSO = X.IDPROCESSO
                         AND IDATIVIDADE = X.IDATIVIDADE)  
   AND IDGRADE = 1