Introdução

O conector do CR.IA Business é o componente responsável por estabelecer a comunicação entre a plataforma e o ambiente de dados da empresa.

O conector deve ser instalado em um servidor que tenha acesso aos bancos de dados que serão utilizados pelo CR.IA Business.

A instalação é realizada diretamente pela tela de Instalação da plataforma e consiste em baixar o instalador, informar as credenciais de instalação, executar o processo no servidor e validar a instalação.

O conector opera dentro do ambiente da empresa, permitindo que os dados corporativos sejam acessados de forma segura pela plataforma.

Importante: o conector deve ser instalado no servidor que tenha acesso ao ambiente onde estão os dados que serão utilizados pelo CR.IA Business.

---

Acessar a instalação do conector

Após realizar o primeiro acesso à plataforma, o usuário será direcionado para a tela de Instalação.

Na tela inicial, localize a etapa:

Instalar o conector

Essa é a primeira etapa obrigatória para preparar o ambiente do CR.IA Business.

Clique em Instalar o conector para acessar a tela de instalação.

Na tela seguinte serão apresentados os passos necessários para realizar a instalação do conector.

---

Baixar o instalador

Na tela Conecte o CR.IA Business ao seu ambiente, será apresentada a primeira etapa da instalação:

1. Baixe o Instalador

O instalador está disponível no formato .zip.

Para realizar o download:

1. Clique no botão Baixar o Arquivo.
2. Aguarde a conclusão do download.
3. Localize o arquivo baixado no computador.
4. Transfira o arquivo para o servidor onde o conector será instalado, caso o download tenha sido realizado em outro computador.

O arquivo do instalador é disponibilizado com o nome:

cria-connector-installer.zip

Importante: a instalação deve ser realizada no servidor onde o conector terá acesso ao ambiente de dados da empresa.

Antes de iniciar a instalação, verifique também os requisitos necessários para o servidor. Para isso, utilize o link Ver requisitos do sistema disponível na própria tela.

---

Informar a chave da instalação

Após baixar o instalador, será necessário informar as credenciais utilizadas para vincular o conector ao ambiente do CR.IA Business.

Na tela de instalação, localize a etapa:

2. Informe a chave da instalação

Serão apresentados dois campos:

• Locatário
• Segredo

Essas informações devem ser utilizadas durante a execução do instalador.

Locatário

O campo Locatário identifica o ambiente da empresa no CR.IA Business.

Copie o valor apresentado na tela de instalação para utilizá-lo quando o instalador solicitar essa informação.

Segredo

O campo Segredo é utilizado em conjunto com o Locatário para autenticar a instalação do conector.

Caso seja necessário gerar um novo segredo, utilize o botão:

Gerar o Segredo

Após gerar um novo segredo, utilize o valor apresentado no instalador.

Importante: mantenha o Segredo protegido e não o compartilhe publicamente. Ele é utilizado para autenticar a instalação do conector no ambiente do CR.IA Business.

---

Executar o instalador

Após baixar o arquivo cria-connector-installer.zip, localize o arquivo no servidor onde será realizada a instalação.

Extraia o conteúdo do arquivo .zip para uma pasta de sua preferência.

Em seguida:

1. Abra a pasta onde os arquivos foram extraídos.
2. Localize o instalador.
3. Execute o instalador como administrador.
4. Quando solicitado, informe os dados de Locatário e Segredo apresentados na plataforma.
5. Siga as orientações apresentadas pelo instalador.

Importante: a execução como administrador é necessária para que o instalador tenha permissão para configurar os serviços necessários do Windows.

---

Realizar a instalação

Após informar os dados solicitados, o instalador realizará a configuração do conector no servidor.

O processo configura automaticamente os componentes necessários para o funcionamento do CR.IA Business.

Durante a instalação, aguarde a conclusão do processo antes de fechar o instalador.

Ao final do processo, o conector estará instalado no servidor e será executado automaticamente como serviços do Windows.

---

Verificar os serviços do Windows

Após concluir a instalação, recomenda-se verificar se os serviços do CR.IA Business foram criados e estão em execução.

Para realizar essa verificação:

1. Abra o Serviços do Windows no servidor.
2. Localize os serviços instalados pelo CR.IA Business.
3. Verifique se os serviços estão presentes e em execução.

Os principais serviços são:

• CR.IA Business+
• Data Gateway Client
• Task Scheduler

Se os serviços estiverem presentes e em execução, a instalação do conector foi realizada corretamente.

---

Verificar a instalação no portal

Após concluir a instalação no servidor, retorne à tela de instalação do CR.IA Business.

Na etapa Instalar o conector, clique em:

Verificar a instalação

A plataforma realizará a validação do conector.

Após a validação, o status da instalação será atualizado.

Quando a instalação for identificada corretamente, a etapa será apresentada como concluída.

Com a instalação concluída, a próxima etapa da configuração será liberada:

Configurar conexão

Próximo passo: Configuração da conexão com os dados da empresa.

---

Segurança do conector

O conector foi desenvolvido para operar dentro do ambiente da empresa e realizar a comunicação necessária entre a plataforma e os sistemas corporativos.

A instalação é realizada no servidor que possui acesso aos dados, permitindo que o ambiente corporativo permaneça protegido.

A própria tela de instalação informa que:

O conector é seguro e opera exclusivamente dentro da rede interna da sua empresa, garantindo que dados sensíveis não sejam expostos à internet.

---

Pré-requisitos técnicos

Antes de realizar a instalação, confirme se o servidor atende aos requisitos mínimos necessários para execução do conector.

Item	Recomendação mínima
Sistema Operacional	Windows 10 ou superior
Processador	2 CPUs
Memória RAM	4 GB
Espaço em disco	1 GB disponível
.NET Runtime	9.0 ou superior
Conexão com internet	Acesso estável

Observação: os requisitos podem ser atualizados conforme a evolução do conector. Consulte sempre a opção Ver requisitos do sistema disponível na tela de instalação antes de realizar uma nova instalação.

---

Solução de problemas

Durante a instalação do conector, algumas situações podem impedir a conclusão correta do processo. Abaixo estão os problemas mais comuns.

O instalador não inicia

Possível causa

O instalador pode não ter sido executado com privilégios administrativos.

Como resolver

1. Localize o instalador.
2. Clique com o botão direito do mouse.
3. Selecione Executar como administrador.
4. Execute novamente o processo de instalação.

---

Os serviços do CR.IA Business não aparecem no Windows

Possível causa

A instalação pode não ter sido concluída corretamente ou algum erro pode ter ocorrido durante a criação dos serviços.

Como resolver

1. Abra o Serviços do Windows.
2. Verifique se existem os seguintes serviços:
   • CR.IA Business+
   • Data Gateway Client
   • Task Scheduler
3. Caso os serviços não estejam presentes, execute novamente o instalador como administrador.
4. Repita o processo de instalação.

---

Erro relacionado ao .NET Runtime

Possível causa

O servidor não possui a versão necessária do .NET Runtime instalada.

Como resolver

1. Verifique se o servidor possui o .NET Runtime 9.0 ou superior.
2. Caso não esteja instalado, instale a versão necessária.
3. Execute novamente o instalador do CR.IA Business.

---

A instalação não aparece como concluída no portal

Possível causa

O conector pode não ter iniciado corretamente ou pode não ter conseguido se comunicar com o portal.

Como resolver

1. Verifique se os serviços do CR.IA Business estão em execução no Windows.
2. Confirme se o servidor possui acesso à internet.
3. Retorne ao portal do CR.IA Business.
4. Aguarde alguns segundos.
5. Atualize a página.
6. Clique novamente em Verificar a instalação.

Caso o problema persista, reinicie os serviços do CR.IA Business e realize uma nova verificação.

---

Conclusão

Após a instalação ser validada pelo portal, a etapa Instalar o conector será marcada como concluída.

O ambiente estará então preparado para a próxima etapa da configuração inicial:

Configurar conexão

Nessa etapa serão informados os dados do sistema e do banco de dados que serão utilizados pelo CR.IA Business.

Próximo passo: Configuração da conexão com os dados.