Várias tarefas de configuração devem ser feitas antes que você possa usar o Conector do ACL para SAP para importar dados SAP.
No sistema SAP:
-
Instale o suplemento do conector do SAP para o sistema SAP
-
Configure autorizações SAP para usuários do conector SAP
-
Configure as portas em um ou mais servidores SAP
No computador local ou no servidor de rede em que você pretende usar o Conector do ACL para SAP:
-
Instalar o SAP GUI for Windows
-
Configurar informações e credenciais da conexão com o SAP
Você poderá usar o conector do SAP com o aplicativo Robôs no HighBond, mas somente se a sua organização usar um Agente do Robôs local. Não é possível configurar o conector do SAP para uso com um Agente do Robôs na nuvem.
Nota
A configuração do conector do SAP e, se aplicável, do SNC (Secure Network Communications) e SSO (Login único), requer pessoal com o nível apropriado de conhecimento técnico.
O conector do SAP exige um direito de assinatura adicional, além da assinatura básica do Analytics. Se você não tiver o direito de assinatura necessário, não poderá se conectar ao SAP.
Entre em contato com o representante de contas para obter mais informações sobre uma assinatura de conector do SAP.
Sistemas SAP compatíveis
O conector do ACL para SAP pode ser usado com os seguintes sistemas SAP:
- S/4HANA
- todos os níveis de aprimoramento dos sistemas a seguir, executados em todas as plataformas de banco de dados compatíveis, incluindo SAP HANA:
- SAP ERP 6.0 (ECC 6.0)
- SAP CRM 7.0
- SAP SRM 7.0
- SAP SCM 7.0
- SAP EWM 7.0
Versão compatível do SAP SPAM/SAINT
Para instalar o suplemento do SAP para o sistema SAP, é necessária a versão SAP SPAM/SAINT 0053 ou mais recente.
O SAP SPAM é o Support Package Manager. O SAP SAINT é o Add-On Installation Tool.
Instale o suplemento do conector do SAP para o sistema do SAP
O administrador do SAP Basis deve instalar o suplemento do conector do SAP no sistema do SAP. O suplemento é necessário para a comunicação entre o conector do SAP e o sistema do SAP. Usuários com uma assinatura do conector do SAP podem fazer download do arquivo de suplemento no Launchpad (www.highbond.com).
Use o SAP Front End para instalar o suplemento do conector do SAP. A versão compatível do SAP Basis para instalar o suplemento do SAP é 700 ou mais recente.
- Efetue login no HighBond (www.highbond.com).
- No Launchpad, em Recursos, clique em Downloads.
-
Na guia superior do ACL para Windows, em Conector de dados SAP ERP, clique em Fazer download da versão 1.4.
O arquivo .zip baixado contém os seguintes arquivos .sar:
- dabexp-sapconn-aoi-140.sar: arquivo do instalador para instalação do suplemento do conector do SAP.
- dabexp-sapconn-aou-140.sar: arquivo de atualização para atualizar o suplemento do conector do SAP versão 1.0 ou 1.1 existente.
- No sistema SAP, use a transação SAINT para acessar o Add-On Installation Tool.
- Use o Add-On Installation Tool para instalar ou atualizar o SAP Add-on Installation Package.
Autorizações do SAP
Nota
As autorizações do SAP devem ser atribuídas pelo administrador de segurança do SAP.
Os usuários do conector do SAP precisam do acesso e das autorizações do SAP a seguir para conectar-se ao sistema SAP e extrair dados:
- Um ID e uma senha de usuário do SAP que permite a conexão ao sistema SAP
- Autorizações e objetos de autorização específicos do SAP, incluindo autorizações para tabelas do SAP
Objetos de autorização do SAP
Os usuários do conector do SAP precisam das autorizações do SAP específicas mostradas a seguir.
Nota
Consulte a documentação de segurança do SAP para obter informações detalhadas sobre a atribuição de autorizações do SAP a usuários.
Classe de autorização | Objeto de autorização | Campo | Valores | Detalhes |
---|---|---|---|---|
AAAB Objetos de autorização entre aplicativos |
S_RFC Verificação de autorização para acesso via RFC |
ACTVT | 16 (autoriza execução) | Controla a capacidade do usuário de executar módulos de funções no sistema SAP em um local remoto, como um computador desktop. |
RFC_NAME |
/SDF/RI_CRM CMON RFC1 SYST /DABEXP/DAB_FUGR |
|||
RFC_TYPE | FUGR (grupo de funções) | |||
Como alternativa, a partir do SAP NW 7.0 EHP 2 (SAP Basis 702), o RFC_TYPE pode ser definido como FUNC (módulo de funções). Com FUNC, os módulos de função devem ser autorizados diretamente e não por meio do grupo de funções. |
||||
ACTVT |
16 (autoriza execução) |
|||
RFC_NAME |
/SDF/CMO_GET_INSTNO CMO_GET_INSTNO RFC_GET_FUNCTION_INTERFACE RFC_GET_NAMETAB RFCPING /DABEXP/RFC_SAPCONNECTOR |
|||
RFC_TYPE | FUNC (módulo de funções) | |||
BC_A Basis: Administração
|
S_TABU_DIS | ACTVT | 03 (exibição) | Controla o acesso de um usuário a grupos específicos de tabelas do SAP. |
DICBERCLS (grupo de autorização) | * | |||
S_TABU_NAM | ACTVT | 03 (exibição) | Controla o acesso de um usuário a tabelas do SAP individuais. | |
TABLE (nome de tabela) | * | |||
Nota Os usuários do conector do SAP devem receber autorizações para as tabelas do SAP que precisam acessar para executar suas análises. Por exemplo, um usuário que executa uma auditoria de livro razão precisa de autorizações para as tabelas do livro razão. Os processos de negócios da sua empresa determinam quais usuários precisam de autorizações de tabelas e quais autorizações são necessárias. Trabalhe com o administrador de segurança do SAP para determinar o nível de acesso adequado necessário para os usuários. |
Configuração de portas do SAP
Em cada servidor do SAP que você conectará usando o conector do SAP, você precisa abrir as seguintes portas TCP/IP para comunicação de entrada e de saída:
Nome da porta | Número de porta | Comentário |
---|---|---|
Dispatcher | 32<NN> | Usada pelo SAP GUI |
Gateway | 33<NN> | Usada para comunicação RFC |
Servidor de mensagens | 36<NN> | |
Nota <NN> é o número da instância do sistema SAP. Portanto, se o número do sistema SAP for 10, as portas 3210, 3310 e 3610 precisarão ser abertas. |
Instalar o SAP GUI for Windows
O SAP GUI for Windows, versão 7.60 ou mais recente deve ser instalado no computador local ou servidor de rede onde você pretende usar o conector do ACL para SAP. O SAP GUI permite que o conector do SAP acesse remotamente o sistema do SAP.
Usuários do Analytics | O SAP GUI deve estar instalado no mesmo computador que o Analytics. |
Usuários do Robôs | O SAP GUI deve estar instalado no servidor que hospeda o Agente do Robôs local. |
sapnwrfc.dll é obrigatório
Após instalar o SAP GUI para Windows, verifique se um arquivo DLL associado, sapnwrfc.dll, está instalado neste local:
C:\Windows\SysWOW64\sapnwrfc.dll
O conector do SAP não funcionará se o arquivo DLL não estiver nesse local.
Se sapnwrfc.dll não estiver na pasta SysWOW64, localize o DLL no diretório de extração do SAP GUI e copie-o para C:\Windows\SysWOW64.
Informações e credenciais da conexão com o SAP
Normalmente, um administrador do SAP Basis mantém as informações de conexão para um sistema do SAP. Solicite ao administrador do SAP Basis que forneça as informações de conexão necessárias ou que configure as configure na janela SAP Logon.
Se o administrador não conseguir ajudá-lo, você ou o administrador deve entrar em contato com o suporte do SAP.
Para conectar-se ao SAP, você ou o administrador deve obter:
- o tipo de servidor correto (Normal ou Load Balanced)
- o número de instância (para tipo de servidor Normal)
- o grupo de logon e o ID do sistema (para tipo de servidor Load Balanced)
- o nome do host ou o endereço IP do sistema do SAP
- o nome de usuário e a senha do SAP
- o número do cliente
- acesso de leitura às tabelas no sistema do SAP
Sistemas SAP com Secure Network Communications (SNC)
O sistema SAP da sua organização pode ter o Secure Network Communication (SNC) ativado, que permite comunicação criptografada entre os diferentes componentes de um sistema SAP e autenticação do usuário com login único.
SNC é uma camada de software no sistema SAP que permite estender a segurança básica do SAP integrando com um produto de segurança externa.
Configurações adicionais são necessárias no ACL Connector for SAP se você estiver usando SNC, com ou sem Login Único. Para obter mais informações, consulte Configurações de conexão.
Erros de conexão do SAP
Número do erro | Código de erro | Descrição |
---|---|---|
0 | Desconhecido | Não foi possível concluir a conexão ao SAP ou a importação dos dados. Ocorreu um erro desconhecido. |
1 | SapDriverInitializationError | Não é possível conectar ao SAP. É possível que os arquivos de configuração de driver necessários não tenham sido encontrados. |
2 | SapDriverLicenseInvalidError | Não é possível conectar ao SAP. Há um problema com a licença do driver. |
3 | ConnectionPropertiesParserValueMustNotBeNullOrWhitespaceError | Não é possível conectar ao SAP. Um parâmetro de conexão necessário não foi encontrado. |
4 | ConnectionPropertiesParserLibraryTypeOutOfRangeError | O valor do parâmetro de conexão de biblioteca é inválido. Os valores válidos são: ClassicRfc, NetweaverRfc |
5 | ConnectionPropertiesParserRfcFunctionTypeOutOfRangeError | O valor do parâmetro de conexão de função de RFC é inválido. Os valores válidos são: Standard, Extended, Three |
6 | ConnectionPropertiesParserServerDetailInfoAmbiguousError | Não é possível conectar ao SAP. Os valores especificados para uma ou mais das seguintes propriedades estão incorretos: InstanceNumber, LogonGroup, SID. |
7 | ConnectionPropertiesParserVariableStringLengthNotAnIntegerError | O comprimento da cadeia variável do parâmetro de conexão deve ser um número inteiro. |
8 | SapConnectionInfoValidationClientIsNullOrWhitespaceError | O valor do parâmetro de conexão de cliente não foi encontrado. |
9 | SapConnectionInfoValidationClientLongerThanThreeCharactersError | O valor do parâmetro de conexão de cliente não pode exceder 3 caracteres. |
10 | SapConnectionInfoValidationLanguageIsNullOrWhitespaceError | O valor do parâmetro de conexão de idioma não foi encontrado. |
11 | SapConnectionInfoValidationLanguageIsLongerThanTwoCharactersError | O valor do parâmetro de conexão de idioma não pode exceder 2 caracteres. |
12 | SapConnectionInfoValidationUsernameIsNullOrWhitespaceError | O valor do parâmetro de conexão de nome de usuário não foi encontrado. |
13 | SapConnectionInfoValidationPasswordIsNullOrWhitespaceError | O valor do parâmetro de conexão de senha não foi encontrado. |
14 | SapConnectionInfoValidationTestDownloadTableIsNullOrWhitespaceError | O valor do parâmetro de conexão de tabela de download de teste não foi encontrado. |
15 | SapConnectionInfoValidationRfcFunctionModuleIsNullOrWhitespaceError | O valor do parâmetro de conexão de módulo de função de RFC não foi encontrado. |
16 | SapConnectionInfoValidationSapConnectionServerInfoIsNullError | Não é possível conectar ao SAP. As propriedades de servidor do SAP não foram encontradas (erro interno do driver). |
17 | SapConnectionInfoValidationVariableStringLengthMustBeGreaterZeroError | Não é possível conectar ao SAP. O comprimento da cadeia variável deve ser maior que 0 (erro interno do driver). |
18 | SapConnectionInfoValidationServerIsNullError | O valor do parâmetro de conexão de servidor não foi encontrado. |
19 | SapConnectionInfoValidationServerDetailsIsNullError | Não é possível conectar ao SAP. As propriedades detalhadas de servidor do SAP não foram encontradas (erro interno do driver). |
20 | SapConnectionInfoValidationInstanceNumberNullOrWhitespaceError | O valor do parâmetro de conexão de número da instância a não foi encontrado. |
21 | SapConnectionInfoValidationInstanceNumberMustHaveTwoDigitsError | O valor do parâmetro de conexão de número da instância deve ter dois dígitos. |
22 | SapConnectionInfoValidationLogonGroupNullOrWhitespaceError | O valor do parâmetro de conexão de grupo de logon não foi encontrado. |
23 | SapConnectionInfoValidationSidNullOrWhitespaceError | O valor do parâmetro de conexão de SID não foi encontrado. |
24 | SapConnectionInfoValidationSidLongerThanThreeCharactersError | O valor do parâmetro de conexão de SID não pode exceder 3 caracteres. |
25 | SapDriverErpError | A conexão ao servidor SAP foi perdida. Ocorreu um erro desconhecido. |
26 | SapDriverTableNotFoundError | Não foi possível encontrar a tabela. |
27 | SapDriverTableStructureNotExportableError | Não foi possível importar a tabela porque ela não contém dados. |
28 | SapDriverAppendStructureNotExportableError | Não foi possível importar a tabela porque ela não contém dados. |
29 | SapDriverGetTablesDownloadError | Não foi possível concluir o download de tabelas do SAP. |
30 | SapDriverSqlParsingError | Não foi possível executar a importação de dados. Provavelmente, a sintaxe do SQL está inválida. Não foi possível determinar uma causa específica para o erro. |
31 | SapDriverSqlParsingNoSqlScriptFragmentError | É necessário especificar instruções SQL. |
32 | SapDriverSqlParsingExactlyOneBatchAllowedError | Somente 1 lote de SQL é permitido. |
33 | SapDriverSqlParsingExactlyOneSelectStatementAllowedError | Somente uma instrução SELECT é permitida. |
34 | SapDriverSqlParsingFragmentNotAllowedError | Uma parte da sintaxe do SQL não é permitida ou não é permitida na posição atual. Por exemplo, instruções UPDATE ou DELETE não são permitidas. |
36 | SapDriverSqlParsingJoinTypeNotAllowedError | O tipo de JOIN especificado não é permitido. Especifique um INNER JOIN ou um LEFT JOIN. |
37 | SapDriverSqlParsingFirstJoinValueNotATableError | O primeiro valor especificado pelo JOIN não é uma tabela. |
38 | SapDriverSqlParsingOnlyOneJoinAllowedError | Somente um JOIN é permitido. |
39 | SapDriverSqlParsingSecondJoinValueNotATableError | O segundo valor especificado pelo JOIN não é uma tabela. |
40 | SapDriverSqlParsingNoJoinConditionError | A condição de JOIN não pode ficar vazia. |
41 | SapDriverSqlParsingJoinConditionOringNotAllowedError | Não é permitido usar OR com condições de JOIN. |
42 | SapDriverSqlParsingJoinConditionNotAllowedError | O tipo de condição de JOIN especificada não é permitido. |
43 | SapDriverSqlParsingJoinOperatorMustBeEqualsOnlyError | O operador de JOIN somente pode ser Equals. |
44 | SapDriverSqlParsingJoinSameFieldError | Não é possível executar um JOIN de campo com ele mesmo. |
45 | SapDriverSqlParsingOnlyExplicitJoinsAllowedError | Somente são permitidos JOINS explícitos. |
46 | SapDriverSqlParsingHasNoSelectStatementError | É necessário especificar uma instrução SELECT. |
47 | SapDriverSqlParsingHasNoQuerySpecificationError | Provavelmente, a sintaxe do SQL está inválida. Uma especificação de consulta pode ser necessária. |
48 | SapDriverSqlParsingSqlFieldMustBeQualifiedWithTableError | O campo deve ser qualificado com um nome ou alias de tabela. |
49 | SapDriverSqlParsingSqlSelectStarFieldMustOnlyBeQualifiedWithTableNameError | SELECT * deve ser qualificado com um nome ou alias de tabela. |
50 | SapDriverSqlParsingSqlFieldMustOnlyBeQualifiedWithTableNameError | O campo somente pode ser qualificado com um nome ou alias de tabela. |
51 | SapDriverSqlParsingSqlTableMustHaveExactlyOneIdentifierError | O nome de tabela não deve ser qualificado. |
52 | SapDriverSqlParsingSqlQueryeMustHaveAtLeastOneFieldError | A instrução SELECT deve conter pelo menos um campo. |
53 | SapDriverSqlParsingSqlQueryeMustHaveAtLeastOneTableError | A instrução SELECT deve conter pelo menos uma tabela. |
54 | SapDriverSqlParsingSqlEnhancedQuerySqlTableNotMatchingAnySapTableError | A tabela que qualifica um campo não corresponde a nenhuma tabela recebida do sistema do SAP. |
55 | SapDriverSqlParsingSqlFieldQualifierNotMatchingAnyTableError | A tabela que qualifica um campo não corresponde a nenhuma tabela especificada na instrução SELECT. |
56 | SapDriverSqlParsingSqlSelectStarFieldQualifierNotMatchingAnyTableError | A tabela que qualifica um campo * não corresponde a nenhuma tabela especificada na instrução SELECT. |
57 | SapDriverSqlParsingSqlFieldNotInSapTableError | O campo especificado na instrução SELECT não existe nos dados do SAP. |
58 | SapDriverSqlParsingSqlFieldNotExportableError | O campo especificado na instrução SELECT não pode ser importado do sistema do SAP. |
59 | SapDriverSqlParsingSqlFieldNotFilterableError | O campo especificado na cláusula WHERE não pode ser filtrado no sistema do SAP. |
60 | SapDriverSqlParsingTopRowFilterMustHaveAbsolutValueError | A instrução SELECT TOP deve especificar um valor absoluto. |
61 | SapDriverSqlParsingTopRowFilterWithTiesNotAllowedError | A instrução SELECT TOP deve ser usada sem vínculos. |
63 | SapDriverSqlParsingTopRowFilterMustHaveIntegerValueError | A instrução SELECT TOP deve especificar um valor inteiro. |
64 | SapDriverSqlParsingTopRowFilterIntegerValueMustBeGreaterZeroError | A instrução SELECT TOP deve especificar um valor maior que zero (0). |
68 | SapDriverSqlParsingTopRowFilterFromClauseMustHaveInnerQuerySpecificationError | A cláusula FROM na instrução SELECT TOP deve conter uma especificação de consulta. |
69 | SapDriverSqlParsingOringFilterValuesOnlyForSameFieldAndClauseError | Campos diferentes não podem ser especificados em uma condição OR. O mesmo campo deve ser usado em toda a condição OR e o mesmo operador de campo deve ser usado. |
70 | SapDriverSqlParsingFilterExpressionNotAllowedError | A expressão especificada na cláusula WHERE para filtragem do campo não é permitida. |
71 | SapDriverSqlParsingFilterValueLiteralNotAllowedError | A literal especificada na cláusula WHERE para filtragem do campo não é permitida. |
72 | SapDriverSqlParsingFilterComparisonTypeNotAllowedError | O operador de comparação especificado na cláusula WHERE para filtragem do campo não é permitido. |
73 | SapDriverPackageCreationFilterTypeNotSupportedError | O tipo de filtro não é permitido. |
74 | SapDriverTableCreationMaximumRecordLimitReachedError | O número de campos selecionados excede o máximo permitido pela RFC do SAP (chamada de função remota do SAP). |
75 | SapDriverExecuteDownloadError | Ocorreu um erro desconhecido na importação de dados da tabela do SAP. |
76 | SapDriverSearchTablesDownloadError | Ocorreu um erro desconhecido na pesquisa de tabelas do SAP. |
77 | SapDriverSqlParsingNoFromClauseError | A instrução SELECT deve conter uma cláusula FROM. |
78 | SapDriverSqlParsingNoTableReferenceInFromClauseError | A cláusula FROM na instrução SELECT deve conter uma tabela. |
79 | SapDriverSqlParsingExpectedTopRowForPreviewError | A instrução de SELECT externo deve ter uma cláusula TOP. |
80 | SapDriverSqlParsingPreviewStatmentMustNotHaveWhereClauseError | A instrução de SELECT externo não deve ter uma cláusula WHERE. |
81 | SapDriverSqlParsingPreviewStatmentMustHaveUnqualifiedStarQualifierOnlyError | A instrução de SELECT externo deve ter apenas um qualificador *. |
82 | SapDriverProjectPathNotFoundError | O diretório de trabalho temporário especificado não existe. |