Configure o sistema SAP ERP

Esta página descreve como configurar o seu sistema SAP para usar um dos plug-ins SAP no Cloud Data Fusion.

Instale componentes do plug-in SAP no SAP através dos ficheiros de transporte SAP

Para usar os plug-ins SAP no Cloud Data Fusion, adicione módulos de funções remotas (RFMs) e funções de autorização no seu sistema SAP. Os RFMs fornecem as APIs de extração chamadas pelo plug-in no Cloud Data Fusion.

Transfira o ficheiro de transporte

Obtém o código SAP e as configurações necessárias através de ficheiros de transporte SAP, que são arquivados num ficheiro ZIP.

O ficheiro ZIP de transporte está disponível para transferência quando implementa plug-ins SAP no Cloud Data Fusion Hub.

O ficheiro ZIP de transporte contém dois ficheiros ZIP:

• O cofile, que tem a seguinte convenção de nomenclatura: KSIX_DIGITS.SID
• O ficheiro de dados, que tem a seguinte convenção de nomenclatura: RSIX_DIGITS.SID

Exemplo:

ODP

O exemplo seguinte mostra os ficheiros no ficheiro ZIP de transporte do SAP ODP:

Nome do ficheiro ZIP	ID do pedido de transporte	Cofile	Ficheiro de dados	Conteúdo
Google_CDF_connector_SAP_ODP.zip	SIDK123456	K123456.SID	R123456.SID	RFMs da SAP num espaço de nomes Google
Authorization_Role_SAP_ODP.zip	SIDK123456	K123456.SID	R123456.SID	Função de autorização

Tabela

O exemplo seguinte mostra os ficheiros no ficheiro ZIP de transporte de tabelas SAP:

Nome do ficheiro ZIP	ID do pedido de transporte	Cofile	Ficheiro de dados	Conteúdo
SAP_TABLE_READER_TR.zip	SIDK123456	K123456.SID	R123456.SID	RFMs da SAP num espaço de nomes Google

Importe os ficheiros de transporte do SAP

Para instalar os transportes SAP, siga estes passos:

1. Inicie sessão no sistema operativo da instância SAP.
2. Para obter o caminho da pasta DIR_TRANS, use o código de transação SAP AL11. Normalmente, o caminho é /usr/sap/trans/.
3. Copie o ficheiro de configuração para a pasta DIR_TRANS/cofiles.
4. Copie os ficheiros de dados para a pasta DIR_TRANS/data.
5. Defina o utilizador e o grupo das pastas e dos ficheiros de dados e de configuração como SIDadm e sapsys.

Um administrador do SAP pode importar os ficheiros de pedido de transporte através do sistema de gestão de transportes do SAP ou da linha de comandos do sistema operativo:

Gestão de transportes

1. Inicie sessão no sistema SAP como administrador do SAP.
2. Introduza o STMS da transação.
3. Clique em Vista geral > Importações.
4. Na coluna Fila, clique duas vezes no SID atual.
5. Clique em Extras > Outros pedidos > Adicionar.
6. Selecione o ID do pedido de transporte e clique em Continuar.
7. Selecione o pedido de transporte na fila de importação e clique em Pedido > Importar.
8. Introduza o número de cliente.
9. No separador Opções, selecione Substituir originais e Ignorar versão de componente inválida (se disponível).
10. Opcional: para planear atualizações do sistema SAP e restauros de cópias de segurança, pode optar por importar novamente os transportes mais tarde. Clique em Deixar pedidos de transportes na fila para importação posterior e Importar pedidos de transportes novamente.
11. Clique em Continuar.
12. Verifique se o módulo de função e as funções de autorização foram importados com êxito através de transações, como SE80 e PFCG.

CLI SAP

1. Inicie sessão no sistema SAP como administrador do SAP.

2. Adicione pedidos ao buffer de importação:

   tp addtobuffer TRANSPORT_REQUEST_ID SID
   

   Substitua o seguinte:

   • TRANSPORT_REQUEST_ID com o ID do pedido de transporte
   • SID com o ID do SAP

   Exemplo: tp addtobuffer IB1K903958 DD1

3. Importe os pedidos de transportes:

   tp import TRANSPORT_REQUEST_ID SID client=CLIENT_NUMBER U1238
   

   Substitua CLIENT_NUMBER pelo número do cliente.

   Exemplo: tp import IB1K903958 DD1 client=800 U1238

   Nota: U1238 indica que deve definir as opções descritas nos passos 9 a 10 no separador Gestão de transportes nesta página. Os números indicam o número de ordem da opção correspondente na interface do utilizador do SAP, que pode variar consoante o sistema. Os números têm de ser ajustados por um administrador do SAP.

4. Verifique se o módulo de função e as funções de autorização foram importados com êxito através de transações adequadas, como SE80 e PFCG.

Após a importação do transporte para o sistema SAP, são criados os seguintes objetos SAP:

Plugin ODP

• Módulos de funções com RFC:
  • /GOOG/ODP_DS_EXTRACT_DATA_V2
  • /GOOG/ODP_DS_FETCH_DATA_V2
  • /GOOG/ODP_DS_METADATA_V2
  • /GOOG/ODP_REPL_CLEANUP_V2
• Função de autorização: /GOOG/ODP_AUTH

Plugin de tabelas

• Módulos de funções com RFC:
  • /GOOG/RFC_READ_TABLE
  • /GOOG/RFC_READ_TABLE_SNAPSHOT
  • /GOOG/RFC_READ_TABLE_CLEANUP
  • /GOOG/RFC_READ_TABLE_JOBSTATUS
  • /GOOG/RFC_TABLE_STAGE_READ
  • /GOOG/RFC_GET_PACKAGE_SIZE
  • /GOOG/RFC_GET_TABLE_LIST

Configure as autorizações no SAP

Para configurar as autorizações de utilizadores no SAP, atribua a função de autorização do ODP incluída no ficheiro de transporte ou crie manualmente uma função de autorização.

Do Transport

Plugin SAP ODP

No SAP, atribua a função de autorização /GOOG/ODP_AUTH, que está incluída nos transportes do SAP que transfere quando implementa o plug-in SAP ODP.

Criar

Para criar a função de autorização manualmente, siga estes passos:

1. Na GUI do SAP, introduza o código de transação PFCG. É aberta a janela Manutenção de funções.
2. No campo Função, introduza um nome para a função, por exemplo, zcdf_role.
3. Clique em Função única. É apresentada a janela Criar funções.
4. No campo Descrição, introduza uma descrição, por exemplo, Authorizations for ODP plugin ou Authorizations for Table plugin.
5. Clique em Guardar.
6. Clique no separador Autorizações. O título da janela muda para Alterar funções.
7. Na secção Editar dados de autorização e gerar perfis, clique em Alterar dados de autorização. É aberta a janela Escolher modelo.
8. Clique em Não selecionar modelos. É aberta a janela Alterar função: autorizações.
9. Clique em Manualmente.
10. Faculte as autorizações apresentadas na seguinte tabela de autorizações da SAP.
11. Clique em Guardar.
12. Para ativar a função de autorização, clique no ícone Gerar.

As autorizações de SAP incluem o seguinte:

ODP

Nota: para impedir que um utilizador execute pipelines ODP com DataSources específicos, para o objeto de autorização S_RO_OSOA, forneça os nomes de DataSource necessários em OLTPSOURCE (por exemplo, 2LIS_02_ITM, 0MATERIAL_ATTR). Não use *.

As seguintes autorizações aplicam-se ao plug-in de ODP:

Classe de objeto	Texto da classe de objeto	Objeto de autorização	Texto do objeto de autorização	Autorização	Texto	Valor
AAAB	Cross-application Authorization Objects	S_RFC	Authorization Check for RFC Access	ACTVT	Activity	16
AAAB	Cross-application Authorization Objects	S_RFC	Authorization Check for RFC Access	RFC_NAME	Name of RFC object to which access is allowed	/GOOG/CDF_ODP_FG /GOOG/ODP_DS_EXTRACT_DATA /GOOG/ODP_DS_FETCH_DATA /GOOG/ODP_DS_METADATA DDIF_FIELDINFO_GET RFCPING RFC_GET_FUNCTION_INTERFACE RODPS_REPL_ODP_CLOSE RODPS_REPL_SOURCES_GET_LIST SAPTUNE_GET_SUMMARY_STATISTIC TH_WPINFO
AAAB	Cross-application Authorization Objects	S_RFC	Authorization Check for RFC Access	RFC_TYPE	Type of RFC object to which access is allowed	FUGR FUNC
AAAB	Cross-application Authorization Objects	S_TCODE	Transaction Code Check at Transaction Start	TCD	Transaction Code	SM50
BC_A	Basis: Administration	S_ADMI_FCD	System Authorizations	S_ADMI_FCD	System administration function	PADM ST0R
BC_A	Basis: Administration	S_BTCH_ADM	Background Processing: Background Administrator	BTCADMIN	Background Administrator ID	Y
BC_A	Basis: Administration	S_BTCH_JOB	Background Processing: Operations on Background Jobs	JOBACTION	Job operations	RELE
BC_A	Basis: Administration	S_BTCH_JOB	Background Processing: Operations on Background Jobs	JOBGROUP	Summary of jobs for a group	''
MM_E	Materials Management: Purchasing	M_BEST_BSA	Document Type in Purchase Order	ACTVT	Activity	03
MM_E	Materials Management: Purchasing	M_BEST_BSA	Document Type in Purchase Order	BSART	Purchasing Document Type	*
RO	Authorizations: BW Service API	S_RO_OSOA	SAP DataSource Authorizations	ACTVT	Activity	03
RO	Authorizations: BW Service API	S_RO_OSOA	SAP DataSource Authorizations	OLTPSOURCE	DataSource (OSOA/OSOD)	*
RO	Authorizations: BW Service API	S_RO_OSOA	SAP DataSource Authorizations	OSOAAPCO	Application Component of a DataSource (OSOA/OSOD)	*
RO	Authorizations: BW Service API	S_RO_OSOA	SAP DataSource Authorizations	OSOAPART	Subobject for DataSource	DATA

Tabela

As seguintes autorizações aplicam-se ao plug-in de tabela:

Classe de objeto	Texto da classe de objeto	Objeto de autorização	Texto do objeto de autorização	Autorização	Texto	Valor
AAAB	Cross-application Authorization Objects	S_RFC	Cross-application Authorization Objects	ACTVT	Activity	16
AAAB	Cross-application Authorization Objects	S_RFC	Authorization Check for RFC Access	RFC_NAME	Name of RFC object to which access is allowed	/GOOG/RFC_READ_TABLE DDIF_FIELDINFO_GET RFC_GET_FUNCTION_INTERFACE RFCPING SAPTUNE_GET_SUMMARY_STATISTIC TH_WPINFO
AAAB	Cross-application Authorization Objects	S_RFC	Cross-application Authorization Objects	RFC_TYPE	Type of RFC object to which access is allowed	FUNC
AAAB	Cross-application Authorization Objects	S_TCODE	Transaction Code Check at Transaction Start	TCD	Transaction Code	SM50
BC_A	Basis: Administration	S_ADMI_FCD	System Authorizations	S_ADMI_FCD	System administration function	ST0R
BC_A	Basis: Administration	S_TABU_NAM	Table Access by Generic Standard Tools	ACTVT	Activity	03
BC_A	Basis: Administration	S_TABU_NAM	Table Access by Generic Standard Tools	TABLE	Table Name	*

Configure o SAP Java Connector

Transfira os seguintes artefactos do SAP Java Connector (SAP JCo). A versão mínima suportada do JCo é 3.0.20.

• Uma independente da plataforma (sapjco3.jar)
• Um dependente da plataforma (libsapjco3.so no Unix)

Copie os ficheiros para o contentor do Cloud Storage.

Para a ODP: ative origens de dados para extração

Para extrair os dados, tem de ativar uma origem de dados no sistema SAP de origem. Para ativar uma origem de dados no SAP, siga estes passos:

1. Inicie sessão no sistema SAP.
2. Aceda ao código de transação RSA5.

3. Expanda a lista DataSources.

   1. Abra a vista CDS no editor CDS da SAP.

   2. Na vista CDS, procure as seguintes anotações:

      • @Analytics.dataCategory
      • @Analytics.dataExtraction.enabled

      Se a vista CDS tiver ambas as anotações, é exposta para a extração de dados do ODP. Sem eles, não é exposto.

4. Clique em Pesquisar.

5. Indique o nome da origem de dados e clique em Enter.

6. Se a pesquisa for bem-sucedida, a origem de dados é apresentada na lista de resultados.

   Selecione o nome da origem de dados e clique em Enter.

7. Selecione a origem de dados e clique em Ativar origens de dados.

8. Na caixa de diálogo Criar entrada de diretório de objetos, introduza o nome do pacote e clique em Guardar.

9. Na caixa de diálogo Pedido de bancada transportável, introduza o número de transporte no campo Pedido. Clique em Enter.

   A origem de dados selecionada está ativada no SAP.

Verifique se o DataSource está exposto para extração

1. Inicie sessão no sistema SAP.
2. Aceda ao código de transação SE16N.
3. Introduza o nome da tabela, ROOSATTR, e introduza o nome da origem de dados em OLTPSOURCE.
4. Clique em Executar ou prima F8.
5. Se o campo EXPOSE_EXTERNAL tiver um X, a origem de dados é exposta e está pronta para extração.

Se a origem de dados não aparecer na tabela ROOSATTR ou o campo EXPOSE_EXTERNAL estiver em branco, siga estes passos para expor a origem de dados para a extração de ODP:

1. Inicie sessão no sistema SAP.
2. Aceda ao código de transação SA38.
3. Introduza o nome do programa, RODPS_OS_EXPOSE, e clique em Executar.
4. Introduza o nome da origem de dados e clique em Libertar origem de dados.
5. Guarde as alterações no transporte.

O que se segue?

• Configure o plug-in SAP ODP no Cloud Data Fusion.