O presente documento tem como objetivo orientar o usuário sobre as implementações realizadas para a sua empresa. Todas as funcionalidades descritas neste manual têm como base do que está descrito nos documentos:

Especificação Anexo I - FS008422(AAAZIZ) Tabela Referencial de Cursos – Solução Integradora


Esse manual tem a função de detalhar, de forma operacional, como será realizado o cadastro da Tabela Referencial de Cursos, vinculo da Tabela Referencial criada ao Curso, Importação da Tabela Referencial e o Processo de Criação de cursos com base na tabela Referencial.

Processos


Pré-Requisitos / Parametrizações


No TOTVS Serviços Globais, por meio do menu Customização | Controle de customizações ativas, verificar se a customização Lib CNI e Solução Integradora está ativada.



Pré-requisitos


  Customização instalada e todos os scripts gerados com sucesso. 


Detalhamento do Processo


Para realizar o cadastro da Tabela Referencial de Cursos, será necessário acessar: TOTVS Educacional | Sistema Indústria | Tabela Referencial de Cursos.



Não será permitido realizar a exclusão/edição da Tabela Referencial de Curso, caso o mesmo já tenha sido vinculado em algum curso.
Campo Cbo SI: Seu preenchimento não será obrigatório.

CheckBox Importado, apenas leitura, será utilizado para informar se o registro foi criado manualmente ou importado via processo de importação, quando importado será apresentado marcado.

Campo Cód. Curso Catálogo, deverá ter o seu tamanho até 7 caracteres.

Pré-requisitos


Realizar os cadastros de Tabela Referencial de Cursos em uma planilha do Excel (.xls ou .xlsx) como o modelo a seguir:


É necessário manter as colunas com os respectivos valores. Ex.: A - Código Curso Catálogo, B - Descrição Catálogo, etc.

Detalhamento do Processo


O processo de Importação, está disponível em: TOTVS Educacional | Sistema Indústria | Tabela Referencial de Cursos | Processos | Importação em Lote - Tabela Referencial de Curso.


Ao clicar no processo, é necessário informar apenas o caminho da planilha para importação.  


O Processo irá verificar os seguintes requisitos para realizar a importação:

  • O Código do Produto (Modalidade) está cadastrado no TOTVS Educacional.
  • O Código da Área está cadastrada no TOTVS Educacional.
  • O Código CBO está cadastrado no TOTVS Educacional e possui a quantidade de 5 ou 6 dígitos para ser importado, caso possuir menos que 5 dígitos, a importação será realizada mas não levará o CBO ao cadastro. 
  • O Código do Eixo Tecnológico está cadastrado no TOTVS Educacional.
  • O Código Curso Catálogo não existe no TOTVS Educacional.
  • O Nome do Curso e a Descrição do Catálogo foram informados na planilha.


Não é possível excluir ou alterar os registros importados pelo processo Importação em Lote - Tabela Referencial de Curso.


Nas máquinas com acesso ao RM.exe onde será realizada a importação da Tabela Referencial via XLS (a ser realizada uma única vez como processo inicial) torna-se necessário que exista o MS-Office/Ms-Excel instalado, para que seja possível à customização abrir o arquivo e executar a leitura do mesmo durante a importação de planilhas do Excel.
Detalhes sobre necessidade do MS-Excel:
Para que este método funcione é necessário ter instalado, no computador onde o processo será iniciado (client), os objetos de transferência de dados entre aplicações do office (Microsoft Access Database Engine Redistributable – AccessDatabaseEngine.exe). Normalmente, em computadores que possuem o office instalado, isto já está presente.

O Excel avalia o conteúdo das primeiras linhas para determinar o tipo de dado (http://dougbert.com/blog/post/Importing-from-Excel-IMEX-and-mixed-data-types.aspx  http://support.microsoft.com/kb/194124/EN-US) então é importante que as colunas das planilhas e seus dados estejam com a tipagem de acordo com os definidos nos layouts abaixo.


Observação: não é necessário a instalação do MS-Excel em servidores de Job/Aplicação, apenas nas máquinas onde o usuário acessa o RM (client).


Pré-requisitos


Realizar os cadastros de Tabela Referencial de Cursos. 


Detalhamento do Processo


O vinculo do Curso a Tabela Referencial de Cursos, está disponível em: TOTVS Educacional | Currículo e Oferta | Cursos | Anexos | Cadastro Referencial de Cursos.



Será apresentado a tela de Cadastro Referencial de Cursos, o qual será utilizado para realizar o vinculo do curso a Tabela Referencial de Cursos já cadastrada.




 O vínculo será realizado apenas se os campos cadastrados na Tabela Referencial for idêntico ao cadastrado no curso:  Nome do Curso, Código do Curso, Área e Eixo Tecnológico .

 Sendo divergente será apresentado uma mensagem informando quais campos estão divergentes para que o usuário possa ajustá-los.

 Após realizar o vinculo da Tabela Referencial ao curso, não será possível alterar no curso:  Código do Curso, Nome, Modalidade, Código da Área e Código do Eixo Tecnológico, para que seja realizado qualquer alteração no curso, o vinculo deverá ser desfeito.

Pré-requisitos


Realizar os cadastros de Tabela Referencial de Cursos. 


Detalhamento do Processo


A criação do curso com base na Tabela Referencial de Cursos, está disponível em: TOTVS Educacional | Currículo e Oferta | Cursos | Processos | Criação de Cursos com base na Tabela Referencial.



Para que seja possível executar o processo, será necessário informar  qual o cadastro referencial de curso será utilizado, 



Após o término do processo, o curso será criado e o código do curso compartilhará o código curso catálogo informado no processo. 



O Código do Curso será gerado com base no Código Curso Catálogo e utilizará um sequencial, separado por ponto. Exemplo 

Não será possível executar o processo sem informar qual o cadastro tabela referencial que será usado.

O processo de Criação de Cursos com Base na Tabela Referencial, irá criar apenas um curso com base no cadastro referencial escolhido.

Ao analisar o monitor de log, é importante verificar a mensagem de erro para identificar a causa. Aguns erros, causas e soluções estão listadas abaixo:


ERRO: [Customização]

         [Solução Integradora]

         Could not load type 'RM.Cst.Lib.CstParamsLeitorExcel' from assembly 'RM.Cst.Lib, Version=12.1.27.1, Culture=neutral, PublicKeyToken=null'.


1) Verifique se a Lib DN encontra-se atualizada em todos os servidores.

2) Verifique se a DLL RM.Cst.Lib está duplicada em seu ambiente, ela deve existir apenas dentro da pasta Custom. 


ERRO: [Customização]
         [Solução Integradora]

         Retrieving the COM class factory for component with CLSID {00024500-0000-0000-C000-000000000046} failed due to the following error: 80040154 Class not registered (Exception from HRESULT: 0x80040154 (REGDB_E_CLASSNOTREG)).


Nas máquinas com acesso ao RM.exe onde será realizada a importação da Tabela Referencial via XLS (a ser realizada uma única vez como processo inicial) torna-se necessário que exista o MS-Office/Ms-Excel instalado, para que seja possível à customização abrir o arquivo e executar a leitura do mesmo durante a importação de planilhas do Excel. Ver Menu Importação em Lote - Tabela Referencial de Cursos


Observação: não é necessário a instalação do MS-Excel em servidores de Job/Aplicação, apenas nas máquinas onde o usuário acessa o RM (client).


ERRO: [Customização]

         [Solução Integradora]

         Microsoft Office Excel cannot access the file 'xxxx'. There are several possible reasons:

          • The file name or path does not exist.
          • The file is being used by another program.
          • The workbook you are trying to save has the same name as a currently open workbook.


Geralmente esse erro em Windows 64 bits. Para corrigir o mesmo, além das verificações de acesso ao caminho pelo usuário de serviço de rede (NETWORK_SERVICE), pode ser necessário criar as pastas descritas abaixo, pois como o interop é objeto DCOM, o sistema cria cópia do arquivo em uma pasta Desktop no caminho de perfil default do sistema, pois para segurança ele acessa o mesmo como um usuário de sistema.

Passo a passo: 


Acesse o caminho: 


C:\Windows\SysWOW64\config\systemprofile (para win 64)   C:\Windows\System32\config\systemprofile  (para win 32)

Crie uma pasta com nome  "Desktop"e nas opções de segurança certifique-se de o usuário do serviço terá acesso.

C:\Windows\SysWOW64\config\systemprofile/Desktop (para win 64)  
C:\Windows\System32\config\systemprofile/Desktop  (para win 32)  


Outra validação que pode ser feita e que possa ser necessário algum ajuste de acesso ao componente Excel é através dos serviços de componente:
Execute o comando no Executar do Windows (Win + R) => dcomcnfg


Será aberto o serviço de componente


Na treeview de configurações de DCOM (Config DCOM) localize a opção do Excel.


Acesse as propriedades:


Por padrão é usado o usuário que inicia, mas pode ser necessário usar um usuário específico (não recomendado) ou usuário interativo.


Para mais informações: 

https://superuser.com/questions/598601/what-is-system32-config-systemprofile
https://social.msdn.microsoft.com/Forums/vstudio/en-US/01ef550d-22e8-4d34-804f-b998bbb0a585/microsoft-excel-cannot-access-the-file-822082308221-there-are-several-possible-reasons?forum=winserver2008appcompatabilityandcertification