Detalhando Arquivo ALIAS.DAT do TOTVS Portal RM

O arquivo Alias.dat é o responsável por estabelecer a conexão entre os aplicativos e suas respectivas Bases de Dados. Equivalente ao aplicativo BDE Administrator da Borland, o Alias.dat possibilita ao usuário criar configurações para acessar diversas Bases de Dados existentes no ambiente interno ou externo; uma espécie de “atalho” para que o aplicativo localize, identifique e acesse estas bases - desde que seus drivers de acesso estejam instalados na estação de trabalho.

O arquivo Alias.dat é necessário e utilizado tanto pelo TOTVS Portal RM quanto pelo TOTVS RM da nova MDI. Estas duas plataformas não utilizam mais o antigo BDE para acesso às Bases de Dados.

O arquivo Web.Config, localizado na pasta \CorporeRM\Corpore.Net, faz referência ao Alias.dat através da linha de comando <add key="ServiceAlias" value="CorporeRM_Exemplo" />. Mais detalhes no tópico Detalhando o Arquivo Web.config que será postado em breve.

A configuração do arquivo Alias.dat pode ser realizada manualmente, através da digitação de códigos em seu conteúdo ou  com o auxílio de um programa desenvolvido pela TOTVS denominado RM.AliasManager.exe, localizado na pasta \CorporeRM\RM.Net.

Vamos aprender agora como criar esse arquivo de duas formas:

1. Criação manual (digitação de códigos):

<?xml version="1.0" standalone="yes"?>
<RMSAliasData xmlns="http://tempuri.org/RMSAliasData.xsd">
  <DbConfig>
    <Alias>CorporeRM_Exemplo</Alias>
    <DbType>SqlServer</DbType>
    <DbProvider>SqlClient</DbProvider>
    <DbServer>Notebook</DbServer>
    <DbName>CorporeRM_Exemplo</DbName>
    <UserName>sysdba</UserName>
    <Password>masterkey</Password>
    <RunService>false</RunService>
    <JobServerEnabled>false</JobServerEnabled>
    <JobServerMaxThreads>3</JobServerMaxThreads>
    <JobServerLocalOnly>true</JobServerLocalOnly>
    <ChartAlertEnabled>false</ChartAlertEnabled>
    <ChartAlertPollingInterval>10</ChartAlertPollingInterval>
    <ChartHistoryEnabled>false</ChartHistoryEnabled>
    <ChartHistoryPollingInterval>30</ChartHistoryPollingInterval>
    <RSSReaderMailEnabled>false</RSSReaderMailEnabled>
    <RSSReaderMailPollingInterval>3</RSSReaderMailPollingInterval>
  </DbConfig>

  <DbConfig>
    <Alias>CorporeRM_Totvs</Alias>
    <DbType>SqlServer</DbType>
    <DbProvider>SqlClient</DbProvider>
    <DbServer>Notebook</DbServer>
    <DbName>CorporeRM_Totvs</DbName>
    <UserName>sysdba</UserName>
    <Password>masterkey</Password>
    <RunService>false</RunService>
    <JobServerEnabled>false</JobServerEnabled>
    <JobServerMaxThreads>3</JobServerMaxThreads>
    <JobServerLocalOnly>true</JobServerLocalOnly>
    <ChartAlertEnabled>false</ChartAlertEnabled>
    <ChartAlertPollingInterval>10</ChartAlertPollingInterval>
    <ChartHistoryEnabled>false</ChartHistoryEnabled>
    <ChartHistoryPollingInterval>30</ChartHistoryPollingInterval>
    <RSSReaderMailEnabled>false</RSSReaderMailEnabled>
    <RSSReaderMailPollingInterval>3</RSSReaderMailPollingInterval>
  </DbConfig>
</RMSAliasData>

Os itens destacados em vermelho são fundamentais para uma conexão bem sucedida entre o aplicativo e a base de dados.

Observe que cada alias para acesso às Bases de Dados é iniciado com as tags <DbConfig> e </DbConfig>. Dessa forma poderemos criar diversos alias para Bases distintas, assim como fazemos no antigo BDE Administrator.

2. Criação automática através do aplicativo RM.AliasManager:

• Através do Windows Explorer, abra a pasta \CorporeRM\RM.Net, localize e execute o arquivo RM.AliasManager.exe;
  
  

• Para criar um novo Alias, clique n o botãoe preencha os campos solicitados pelo assistente como mostra a imagem acima.
• Teste se a conexão foi bem sucedida clicando no botão Testar e se tudo der certo o assistente exibirá a segunte mensagem: Conexão testada com sucesso.

Pronto! Agora é só acessar o TOTVS Portal RM ou o TOTVS RM da nova MDI e desfrutar de todos os fantásticos recursos destas duas plataformas.

Abraço a todos e até o próximo post.