Configurer le système ERP SAP

Cette page explique comment configurer votre système SAP pour qu'il utilise l'un des plug-ins SAP dans Cloud Data Fusion.

Installer les composants du plug-in SAP dans SAP à l'aide des fichiers de transport SAP

Pour utiliser les plug-ins SAP dans Cloud Data Fusion, ajoutez des modules de fonction distante (RFM) et des rôles d'autorisation dans votre système SAP. Les RFM fournissent les API d'extraction appelées par le plug-in dans Cloud Data Fusion.

Télécharger le fichier de transport

Vous obtenez le code et les configurations SAP requis via des fichiers de transport SAP, qui sont archivés dans un fichier ZIP.

Le fichier ZIP de transport est disponible en téléchargement lorsque vous déployez des plug-ins SAP dans le hub Cloud Data Fusion.

Le fichier ZIP de transport contient deux fichiers ZIP:

  • Le cofile, qui suit la convention d'attribution de noms suivante : KSIX_DIGITS.SID
  • Le fichier de données, qui suit la convention d'attribution de noms suivante : RSIX_DIGITS.SID

Exemple :

ODP

L'exemple suivant montre les fichiers du fichier ZIP de transport SAP ODP:

Nom du fichier ZIP ID de la demande de transport Fichier cofile Fichier de données Contenu
Google_CDF_connector_SAP_ODP.zip SIDK123456 K123456.SID R123456.SID RFM SAP dans un espace de noms Google
Authorization_Role_SAP_ODP.zip SIDK123456 K123456.SID R123456.SID Rôle d'autorisation

Table

L'exemple suivant montre les fichiers du fichier ZIP de transport de la table SAP:

Nom du fichier ZIP ID de la demande de transport Fichier cofile Fichier de données Contenu
SAP_TABLE_READER_TR.zip SIDK123456 K123456.SID R123456.SID RFM SAP dans un espace de noms Google

Importer les fichiers de transport SAP

Pour installer les transports SAP, procédez comme suit:

  1. Connectez-vous au système d'exploitation de l'instance SAP.
  2. Pour obtenir le chemin d'accès du dossier DIR_TRANS, utilisez le code de transaction SAP AL11. Le chemin d'accès est généralement /usr/sap/trans/.
  3. Copiez le fichier cofile dans le dossier DIR_TRANS/cofiles.
  4. Copiez les fichiers de données dans le dossier DIR_TRANS/data.
  5. Définissez les dossiers et fichiers "User" (Utilisateur) et "Group of data and cofiles" (Groupe de données et cofiles) sur SIDadm et sapsys.

Un administrateur SAP peut importer les fichiers de requête de transport à l'aide du système de gestion des transports SAP ou de la ligne de commande du système d'exploitation:

Gestion des transports

  1. Connectez-vous au système SAP en tant qu'administrateur SAP.
  2. Saisissez la transaction STMS.
  3. Cliquez sur Présentation > Importations.
  4. Dans la colonne File d'attente, double-cliquez sur le SID actuel.
  5. Cliquez sur Extras > Autres requêtes > Ajouter.
  6. Sélectionnez l'ID de la requête de transport, puis cliquez sur Continuer.
  7. Sélectionnez la demande de transport dans la file d'attente d'importation, puis cliquez sur Demander > Importer.
  8. Saisissez le numéro client.
  9. Dans l'onglet Options, sélectionnez Écraser les versions d'origine et Ignorer la version de composant non valide (si disponible).
  10. Facultatif: Pour planifier les mises à niveau du système SAP et les restaurations de sauvegarde, vous pouvez choisir d'importer à nouveau les transports ultérieurement. Cliquez sur Laisser des requêtes de transport en file d'attente pour une importation ultérieure et Importer à nouveau les requêtes de transport.
  11. Cliquez sur Continuer.
  12. Vérifiez que le module de fonction et les rôles d'autorisation ont bien été importés à l'aide de transactions, telles que SE80 et PFCG.

CLI SAP

  1. Connectez-vous au système SAP en tant qu'administrateur SAP.

  2. Ajoutez des requêtes au tampon d'importation:

    tp addtobuffer TRANSPORT_REQUEST_ID SID

    Remplacez les éléments suivants :

    • TRANSPORT_REQUEST_ID avec l'ID de la requête de transport
    • SID par l'ID SAP

    Exemple : tp addtobuffer IB1K903958 DD1

  3. Importez les requêtes de transport:

    tp import TRANSPORT_REQUEST_ID SID client=CLIENT_NUMBER U1238

    Remplacez CLIENT_NUMBER par le numéro client.

    Exemple : tp import IB1K903958 DD1 client=800 U1238

  4. Vérifiez que le module de fonction et les rôles d'autorisation ont bien été importés à l'aide des transactions appropriées, telles que SE80 et PFCG.

Une fois le transport importé dans le système SAP, les objets SAP suivants sont créés:

Plug-in ODP

  • Modules de fonctions compatibles RFC :
    • /GOOG/ODP_DS_EXTRACT_DATA
    • /GOOG/ODP_DS_FETCH_DATA
    • /GOOG/ODP_DS_METADATA
    • /GOOG/ODP_REPL_CLEANUP
  • Rôle d'autorisation: /GOOG/ODP_AUTH

Plug-in Tableau

  • Modules de fonctions compatibles 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

Configurer les autorisations dans SAP

Pour configurer les autorisations des utilisateurs dans SAP, attribuez le rôle d'autorisation ODP inclus dans le fichier de transport ou créez manuellement un rôle d'autorisation.

Depuis Transport

Plug-in SAP ODP

Dans SAP, attribuez le rôle d'autorisation /GOOG/ODP_AUTH, qui est inclus dans les transports SAP que vous téléchargez lorsque vous déployez le plug-in SAP ODP.

Créer

Pour créer manuellement le rôle d'autorisation, procédez comme suit :

  1. Dans l'interface utilisateur graphique de SAP, saisissez le code de transaction PFCG. La fenêtre Role Maintenance (Maintenance des rôles) s'ouvre.
  2. Dans le champ Role (Rôle), saisissez un nom pour le rôle (par exemple, zcdf_role).
  3. Cliquez sur Rôle unique. La fenêtre Créer des rôles s'ouvre.
  4. Dans le champ Description, saisissez une description (par exemple, Authorizations for ODP plugin ou Authorizations for Table plugin).
  5. Cliquez sur Enregistrer.
  6. Cliquez sur l'onglet Autorisations. Le titre de la fenêtre passe à Modifier les rôles.
  7. Dans la section Modifier les données d'autorisation et générer des profils, cliquez sur Modifier les données d'autorisation. La fenêtre Choisir un modèle s'ouvre.
  8. Cliquez sur Ne pas sélectionner de modèles. La fenêtre Modifier le rôle: Autorisations s'ouvre.
  9. Cliquez sur Manuellement.
  10. Fournissez les autorisations indiquées dans le tableau suivant.
  11. Cliquez sur Enregistrer.
  12. Pour activer le rôle d'autorisation, cliquez sur l'icône Générer.

Les autorisations SAP incluent les suivantes:

ODP

Les autorisations suivantes s'appliquent au plug-in ODP:

Classe d'objet Texte de la classe d'objet Objet d'autorisation Texte de l'objet d'autorisation Autorisation Texte Valeur
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

Table

Les autorisations suivantes s'appliquent au plug-in Table:

Classe d'objet Texte de la classe d'objet Objet d'autorisation Texte de l'objet d'autorisation Autorisation Texte Valeur
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 *

Configurer le connecteur Java SAP

Téléchargez les artefacts SAP Java Connector (SAP JCo) suivants. La version minimale de JCo compatible est 3.0.20.

  • Une plate-forme indépendante (sapjco3.jar)
  • Une plate-forme dépendante (libsapjco3.so sur Unix)

Copiez les fichiers dans le bucket Cloud Storage.

Pour ODP: Activer les sources de données pour l'extraction

Pour que vous puissiez extraire les données, une source de données doit être activée dans le système SAP source. Pour activer une source de données dans SAP, procédez comme suit:

  1. Connectez-vous au système SAP.
  2. Accédez au code de transaction RSA5.

  3. Développez la liste DataSources (Sources de données).

    1. Ouvrez la vue CDS dans l'éditeur SAP CDS.

    2. Dans la vue CDS, recherchez les annotations suivantes:

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

      Si la vue CDS comporte ces deux annotations, elle est exposée pour l'extraction de données ODP. Sans elles, il n'est pas exposé.

  4. Cliquez sur Rechercher.

  5. Saisissez le nom de la source de données, puis cliquez sur Entrée.

  6. Si la recherche aboutit, la source de données apparaît dans la liste des résultats.

    Sélectionnez le nom de la source de données, puis cliquez sur Entrée.

  7. Sélectionnez la source de données, puis cliquez sur Activate DataSources (Activer les sources de données).

  8. Dans la boîte de dialogue Create Object Directory Entry (Créer une entrée de répertoire d'objet), saisissez le nom du package, puis cliquez sur Enregistrer.

  9. Dans la boîte de dialogue Invite pour une requête de poste de travail transportable, saisissez le numéro de transport dans le champ Requête. Appuyez sur Entrée.

    La source de données sélectionnée est activée dans SAP.

Vérifier que DataSource est exposé pour l'extraction

  1. Connectez-vous au système SAP.
  2. Accédez au code t SE16N.
  3. Saisissez le nom de la table, ROOSATTR, puis le nom de la source de données dans OLTPSOURCE.
  4. Cliquez sur Exécuter ou appuyez sur F8.
  5. Si le champ EXPOSE_EXTERNAL contient un X, la source de données est exposée et prête à être extraite.

Si la source de données n'apparaît pas dans le tableau ROOSATTR ou si le champ EXPOSE_EXTERNAL est vide, procédez comme suit pour exposer la source de données pour l'extraction ODP:

  1. Connectez-vous au système SAP.
  2. Accédez au code t SA38.
  3. Saisissez le nom du programme, RODPS_OS_EXPOSE, puis cliquez sur Exécuter.
  4. Saisissez le nom de la source de données, puis cliquez sur Release DataSource (Libérer la source de données).
  5. Enregistrez les modifications dans le transport.

Étape suivante