Índice:

Índice

exclude	.*ndice:

Objetivo

Explicar como uma action deve ser configurada para que a Desconexão Automática ou o Bloqueio Automático sejam ignoradas.

Obs.: Configurações validas somente para o uso do sistema através da MDI.

Requisitos

Apresentar como utilizar o serviço RestProcess.

Requisitos

Nota

title	Versão

Disponível à partir da versão 12.1.21 da linha RM.

Linha de Software	Versão	Data de Liberação	Observação
RM	12.011.19 21 e/ou posteriores	JaneiroJunho/2018	Para os requisitos de software deve-se consultar a Portabilidade RM

Informações

icon	false

Expandir

title

Desconexão automática configurada

É necessário que a Desconexão Automática (Tempo para desconexão automática (min)) ou o Bloqueio Automático (Tempo para (min) p/ lock (necessário logoff)) estejam configurados.

Para mais informações favor acessar o documento : Bloqueio do Sistema X Desconexão Automática

Como Configurar a Action

Informações

icon	false

No exemplo iremos utilizar a action de Coligada.

No construtor da action é necessário assinar o evento BeforeSystemLock.

Image Removed

Após assinar o evento basta implementá-lo.

Image Removed

Informações

title	Boas Práticas

É necessário remover o evento no Dispose da action, para evitar vazamento de memória.

Image Removed

Informações

title	Chamada da Action

A funcionalidade somente irá executar se a action for executada pelo método ExecuteAction da classe RMSMDIUtils:

Image Removed

Alias Default

Acesse a máquina ou servidor que está executando o serviço. 
Vá ao diretório C:\totvs\CorporeRM\RM.Net e edite o arquivo RM.Host.Service.exe.config.

Inclua a tag <add key="DefaultDB" value="CorporeRM" /> dentro da limitação appSettings.
O valor a ser atribuído a tag DefaultDB deve ser idêntico ao nome do alias que aponta para a base de dados utilizada. No exemplo que citamos atribuímos o valor "CorporeRM" ao alias e respectivamente ao DefaultDB.

Bloco de código

language	xml
title	RM.Host.Service.exe.Config

<?xml version="1.0" encoding="utf-8"?>
<configuration>
	<appSettings>
		<add key="JobServer3Camadas" value="false" />
		<add key="Port" value="8050" />
		<add key="ServicesHostName" value="BHD0002773" />
		<add key="ActionsPath" value="C:\totvs\CorporeRM\RM.Net;C:\totvs\CorporeRM\Corpore.Net\Bin" />
		<add key="LibPath" value="C:\totvs\CorporeRM\RM.Net" />
		<add key="EnableDynamicLocalization" value="false" />
		<add key="EnableCompression" value="false" />
		<add key="LocalizationLanguage" value="pt-BR" />
        <add key="DefaultDB" value="CorporeRM" />
	</appSettings>
	<runtime>
		<gcServer enabled="true" />
	</runtime>
</configuration>

Informações

title	Atenção

Para que estas configurações entrem em vigor será necessário reiniciar o serviço do Host.

Métodos disponibilizados pelo serviço:

Método	URL	Nome	Descrição
GET	rest/restprocess/getschema/{processServerName}	GetSchema	Faz a leitura do Processo informado.
GET	rest/restprocess/getprocessstatus/{jobId}/{execId}	GetProcessStatus	Monitora o progresso da execução de um processo.
POST	rest/restprocess/executeprocess/{processServerName}	ExecuteProcess	Executa o processo informado
POST	rest/restprocess/executeprocessasync/{processServerName}	ExecuteProcessAsync	Executa o processo informado de forma assíncrona.

Exemplos de Utilização:

Informações

icon	false

Expandir

title	RestProcess»localhost:8051»GetSchema

Exemplo de Uso

Url: http://localhost:8051/rest/restprocess/getschema/GlbCopyPermisUsrProc

Resultado Esperado

Bloco de código

language	js

{
  "SourceUsuario": null,
  "RemoveOldPermissions": false,
  "CopyToAllApplications": false,
  "CodSistema": null,
  "NewUser": {
    "Usuario": null,
    "Nome": null,
    "Senha": null,
    "Email": null,
    "codAcesso": null
  },
  "PrimaryKeyList": [
    [
      "//O valor apresentado abaixo deve ser do tipo System.Int32.",
      0
    ],
    [
      "//O valor apresentado abaixo deve ser do tipo System.Double.",
      0.0
    ],
    [
      "//O valor apresentado abaixo deve ser do tipo System.String.",
      "TEXTO"
    ],
    [
      "//O valor apresentado abaixo deve ser do tipo System.DateTime.",
      "2018-06-29T00:00:00-03:00"
    ]
  ],
  "PrimaryKeyNames": [
    "COLUNAPK"
  ],
  "Context": {
    "$id": "1",
    "_params": {
      "$EXERCICIOFISCAL": 2,
      "$CODLOCPRT": 12,
      "$CODTIPOCURSO": 1,
      "$EDUTIPOUSR": "",
      "$CODUNIDADEBIB": 1,
      "$CODCOLIGADA": 1,
      "$RHTIPOUSR": "-1",
      "$CODIGOEXTERNO": "-1",
      "$CODSISTEMA": "G",
      "$CODUSUARIOSERVICO": "",
      "$IDPRJ": -1,
      "$CHAPAFUNCIONARIO": "-1",
      "$CODFILIAL": 1
    },
    "Environment": 4
  }
}

Exemplo prático no postman

Image Added

Informações

icon	false

Expandir

title	RestProcess»localhost:8051»ExecuteProcess

Exemplo de Uso

Url: http://localhost:8051/rest/restprocess/executeprocess/GlbCopyPermisUsrProc

Body:

Bloco de código

language	js

{
  "ActionModule": "G",
  "ActionName": "GlbActionProcCopyPermisUsr",
  "CodUsuario": "mestre",
  "SourceUsuario": "mestre",
  "RemoveOldPermissions": false,
  "CopyToAllApplications": false,
  "CodSistema": "G",
  "NewUser": {
    "Usuario": null,
    "Nome": null,
    "Senha": null,
    "Email": null,
    "codAcesso": null
  },
  "PrimaryKeyList": [
    [
      "rest"
    ]
  ],
  "PrimaryKeyNames": [
    "CODUSUARIO"
  ],
  "Context": {
    "$id": "1",
    "_params": {
      "$EXERCICIOFISCAL": 2,
      "$CODLOCPRT": 12,
      "$CODTIPOCURSO": 1,
      "$EDUTIPOUSR": "",
      "$CODUNIDADEBIB": 1,
      "$CODCOLIGADA": 1,
      "$RHTIPOUSR": "-1",
      "$CODIGOEXTERNO": "-1",
      "$CODSISTEMA": "G",
      "$CODUSUARIOSERVICO": "",
      "$IDPRJ": -1,
      "$CHAPAFUNCIONARIO": "-1",
      "$CODFILIAL": 1
    },
    "Environment": 4
  }
}

Exemplo prático no Postman

Image Added

Informações

icon	false

Expandir

title	RestProcess»localhost:8051»ExecuteProcessAsync

Exemplo de Uso

Url: http://localhost:8051/rest/restprocess/executeprocessasync/GlbCopyPermisUsrProc

Body:

Bloco de código

language	js

{
  "ActionModule": "G",
  "ActionName": "GlbActionProcCopyPermisUsr",
  "CodUsuario": "mestre",
  "SourceUsuario": "mestre",
  "RemoveOldPermissions": false,
  "CopyToAllApplications": false,
  "CodSistema": "G",
  "NewUser": {
    "Usuario": null,
    "Nome": null,
    "Senha": null,
    "Email": null,
    "codAcesso": null
  },
  "PrimaryKeyList": [
    [
      "rest"
    ]
  ],
  "PrimaryKeyNames": [
    "CODUSUARIO"
  ],
  "Context": {
    "$id": "1",
    "_params": {
      "$EXERCICIOFISCAL": 2,
      "$CODLOCPRT": 12,
      "$CODTIPOCURSO": 1,
      "$EDUTIPOUSR": "",
      "$CODUNIDADEBIB": 1,
      "$CODCOLIGADA": 1,
      "$RHTIPOUSR": "-1",
      "$CODIGOEXTERNO": "-1",
      "$CODSISTEMA": "G",
      "$CODUSUARIOSERVICO": "",
      "$IDPRJ": -1,
      "$CHAPAFUNCIONARIO": "-1",
      "$CODFILIAL": 1
    },
    "Environment": 4
  }
}

Exemplo prático no Postman

Image Added

Informações

icon	false

Expandir

title	RestProcess»localhost:8051»GetProcessStatus

Exemplo de Uso

Url: http://localhost:8051/rest/restprocess/getprocessstatus/103157/1

Bloco de código

language	js

Resultado (Erro no Processo):
{
 "Message": "Ocorreram erros ao realizar a cópia de permissões entre usuários!\r\nFavor verificar o log de execução do processo.",
 "ProcessID": {
 "ExecID": 1,
 "JobID": 103157
 },
 "Progress": 100,
 "Status": "Error"
}

Exemplo prático postman:

Image Added

Exemplo prático no Postman

Image Added

Usabilidade:

Informações

icon	false

Quando uma action que assinar o evento BeforeSystemLock estiver aberta a tela de desconexão de usuário não será exibida até que a action seja encerrada pelo usuário.

Informações

icon	false
title	Para maiores informações:

Canais de Atendimento:

Chamado: Através do Portal Totvs www.suporte.totvs.com.br

Telefônico: 4003-0015 Escolhendo as opções 2 – (Software), 2 – (Suporte Técnico), 3 – (RM), 9 – (Demais Áreas), 4 – (BI) e 3 – (Gerador de Relatórios e Planilha).

Informações

icon	false

Informações

icon	false

Produto: Framework

Informações

icon	false

Versão: 12.01.191.21 (superiores)

Informações

icon	false

Processo: Segurança Integração

Informações

icon	false

SubProcesso: Desconexão Automática RestProcess

Informações

icon	false

Informações

icon	false

Status: Finalizado

Informações

icon	false

Data: 0412/1206/20172018

Informações

icon	false

Autores:

Diogo Damiani Ferreira

Fábio Augusto Amaral Melo Nunes

Carlos Roberto Pereira Garcia

Stella Gleyse Macedo Vilaca

Carlos Philippe de Farias Marques

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

Índice:

Objetivo

Requisitos

Requisitos

Como Configurar a Action

Métodos disponibilizados pelo serviço:

Exemplos de Utilização:

Exemplo de Uso

Exemplo de Uso

Exemplo de Uso

Exemplo de Uso

Usabilidade:

Atalhos

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

Índice:

Objetivo

Requisitos

Requisitos

Como Configurar a Action

Métodos disponibilizados pelo serviço:

Exemplos de Utilização:

Exemplo de Uso

Exemplo de Uso

Exemplo de Uso

Exemplo de Uso

Usabilidade: