IDOC Intermediate DOCument Intermediate DOCument Page 1 A

  • Slides: 87
Download presentation
I-DOC Intermediate DOCument Intermediate DOCument Page : 1

I-DOC Intermediate DOCument Intermediate DOCument Page : 1

A qui s ’adresse ce cours ? Quels objectifs ? F Participants : ü

A qui s ’adresse ce cours ? Quels objectifs ? F Participants : ü Ingénieurs ü Consultants techniques (la première journée) F Objectifs du cours : A la fin du cours, vous serez en mesure de : ü configurer l ’interface Idoc ü suivre le traitement des Idocs dans le système ü créer et modifier un Idoc spécifique Intermediate DOCument Page : 2

Sommaire 1 F Chapitre 1 : présentation générale des Idocs F Chapitre 2 :

Sommaire 1 F Chapitre 1 : présentation générale des Idocs F Chapitre 2 : les définitions des IDOC F Chapitre 3 : les processus d ’envoie / réception F Chapitre 4 : l ’environnement de développement F Chapitre 5 : le Workflow et la configuration minimale pour la gestion des erreurs F Chapitre 6 : les tests des traitements F Chapitre 7 : l ’administration Intermediate DOCument Page : 3

Sommaire 2 F Feuille Word dans directory Intermediate DOCument Page : 4

Sommaire 2 F Feuille Word dans directory Intermediate DOCument Page : 4

Présentation générale des Idocs F Qu ’est qu ’un Idoc ? ü Intermediate DOCument

Présentation générale des Idocs F Qu ’est qu ’un Idoc ? ü Intermediate DOCument ü un ensemble d ’enregistrements dans la base de données qui comprennent les données applicatives d ’un document de gestion (ex. facture) ainsi que des données de gestion (ex. un statut évoluant lors de son traitement) ü L ’IDOC est utilisé pour mettre un processus transactionnel (tel qu’une commande) dans une forme électronique. Intermediate DOCument Page : 5

Présentation générale des Idocs F Les utilisations des Idoc sont cross- applications : ü

Présentation générale des Idocs F Les utilisations des Idoc sont cross- applications : ü ü ü ü Workflow Système R/3 ou R/2 ALE EDI Système R/2 Internet/ Intranet. . . Intermediate DOCument Page : 6

Présentation générale des Idocs F Quand les utiliser ? ü EDI : échange de

Présentation générale des Idocs F Quand les utiliser ? ü EDI : échange de données informatisé entre différentes sociétés ex. entre un client et un fournisseur ü ALE : échange de données informatisé entre différentes applications réparties sur plusieurs systèmes au sein d ’une même société. ex. entre deux systèmes R/3 ou R/2, entre R/3 et un système de traçabilité, entre R/3 et un système d ’acquisition… Les données sont des données de base telles que fiches articles, comptes généraux, …. ou des documents applicatifs tels que documents comptables, contrats cadres. . . Intermediate DOCument Page : 7

Présentation générale des Idocs FALE : Application Link Enabling FEDI : Electronic Data Interchange

Présentation générale des Idocs FALE : Application Link Enabling FEDI : Electronic Data Interchange Document Système SAP R/3 R/2 Idoc sortant Sous système EDI ALE Idoc EDI Système SAP R/3 R/2 Idoc entrant Sous système EDI Message Intermediate DOCument Page : 8

Quelques caractéristiques de l ’interface Idoc FInterface «standard» ü Structure des messages standards /

Quelques caractéristiques de l ’interface Idoc FInterface «standard» ü Structure des messages standards / Montée de version ü Gestion des erreurs • Avertissement des utilisateurs responsables • Consultation du message d ’erreur et de l ’IDOC • Recyclage de l ’IDOC (manuel ou automatique) FMonitorage des IDOCs ü suivi des IDOCs, liste des erreurs, statistiques, audit. . FUtilisable pour une interface périodique ou permanente entre applications. Intermediate DOCument Page : 9

L ’architecture EDI et ALE SOMMAIRE F EDI : Sous système EDI, module SAP

L ’architecture EDI et ALE SOMMAIRE F EDI : Sous système EDI, module SAP F ALE : système de gestion externe F Les composantes impactées dans SAP Intermediate DOCument Page : 10

EDI : sous système, module SAP Intermediate DOCument Page : 11

EDI : sous système, module SAP Intermediate DOCument Page : 11

ALE : Idocs de communication Module SAP Système SAP 1 Batch input création commande

ALE : Idocs de communication Module SAP Système SAP 1 Batch input création commande Correspondance Accusé de réception Interface IDOC Plate-forme Evénement «Fichier à intégrer» Evénement «Fichier à traduire» SAP 2 Interface IDOC Batch input création commande Correspondance Accusé de réception Module SAP Intermediate DOCument Page : 12

Les composantes impactées dans SAP Système 1 Gestion des messages Business Workflow 2 3

Les composantes impactées dans SAP Système 1 Gestion des messages Business Workflow 2 3 externe Interface Idoc / Service ALE 4 Intermediate DOCument Page : 13

Les définitions des IDOC SOMMAIRE F Type d ’enregistrements : contrôle, données et statut

Les définitions des IDOC SOMMAIRE F Type d ’enregistrements : contrôle, données et statut ü ü les trois types d ’enregistrements d ’un IDOC l ’enregistrement de contrôle les enregistrements de données les enregistrements de statuts F Type d ’IDOC ü définition du contenant (structure du message) F Type de message ü définition du contenu (commande, facture, article…) Intermediate DOCument Page : 14

Les définitions des IDOC A la fin de ce chapitre vous devez pouvoir répondre

Les définitions des IDOC A la fin de ce chapitre vous devez pouvoir répondre aux questions : FQu ’est ce qu ’un type d ’Idoc par rapport à un Idoc ? FComment est structuré un Idoc ? Intermediate DOCument Page : 15

Types d ’enregistrement Idoc FChaque Idoc de la base de données R/3 est composée

Types d ’enregistrement Idoc FChaque Idoc de la base de données R/3 est composée de : Enregistrement de contrôle Enregistrements de données Enregistrements de statuts Intermediate DOCument Page : 16

L ’enregistrement de contrôle F Il contient les données générales de communication : ü

L ’enregistrement de contrôle F Il contient les données générales de communication : ü l ’ID de l ’Idoc ü trois données « partenaire » ü le type d ’Idoc et le message logique ü la structure externe (nom du sous système EDI par exemple) ü le « port d ’entrée ou de sortie » de SAP F Son rôle est de permettre la communication entre systèmes et en accord avec le paramétrage des systèmes. Page : 17 Intermediate DOCument

Les enregistrements de donnée F Il contient : Enregistrement de donnée Données applicatives En

Les enregistrements de donnée F Il contient : Enregistrement de donnée Données applicatives En tête Zone 1 Zone 2 F L ’entête contient le nom du segment. F Le segment est une structure du DDIC Intermediate DOCument Page : 18

Les enregistrements de statut F Il contient : ID de l ’Idoc + information

Les enregistrements de statut F Il contient : ID de l ’Idoc + information sur le statut F Au cours du traitement, les informations de statut évoluent et servent de base pour la gestion des exceptions Intermediate DOCument Page : 19

Types d ’Idoc FC ’est un ensemble de segments (le contenant), ordonnés et hiérarchisés.

Types d ’Idoc FC ’est un ensemble de segments (le contenant), ordonnés et hiérarchisés. Un type d ’Idoc est très lié à une application ou à un processus de gestion (ex. une commande). FLorsqu ’ils contiennent des données applicatives, les segments constituent un Idoc. FL ’Idoc est une instance du type d ’Idoc. Intermediate DOCument Page : 20

Résumé F Dans SAP, un Idoc est constitué d ’un enregistrement de contrôle, d

Résumé F Dans SAP, un Idoc est constitué d ’un enregistrement de contrôle, d ’enregistrements de données et d ’enregistrements de statuts Ces derniers ne sont pas transmis au système externe. F C ’est le type d ’Idoc qui spécifie les différents segments et leurs hiérarchies. Intermediate DOCument Page : 21

Les définitions des communications en entrées et sorties SOMMAIRE Port / type de port

Les définitions des communications en entrées et sorties SOMMAIRE Port / type de port ü Fichier ü RFC ü Internet ü CPI-C ü PI Intermediate DOCument Page : 22

Les définitions des communications en entrées et sorties A la fin de ce chapitre

Les définitions des communications en entrées et sorties A la fin de ce chapitre vous devez pouvoir répondre aux questions : FQu ’est ce qu ’un port, un accord d ’interchange ? FComment sont utilisées ces définitions ? Intermediate DOCument Page : 23

Types de port : définition FCinq techniques de communication différentes : Interface Idoc Fichier

Types de port : définition FCinq techniques de communication différentes : Interface Idoc Fichier /RFC t. RFC Système externe Internet CPI-C R/2 PI Autre. . . Intermediate DOCument Page : 24

Types de port fichier FDéfinition La définition d ’un port fichier comprend : •

Types de port fichier FDéfinition La définition d ’un port fichier comprend : • le nom du fichier de sortie, • le nom et le répertoire du fichier de commande devant être appelé par le programme rfcexec et qui lance le système externe, • une destination RFC; celle-ci doit être définie dans la transaction SM 59 (connexion TCP/IP). Intermediate DOCument Page : 25

Types de port fichier Interface Idoc 1 Fichier Idoc 2 4 Rfcexec out. script

Types de port fichier Interface Idoc 1 Fichier Idoc 2 4 Rfcexec out. script 3 1 3 Startrfc in. script statut. script Fichier Idoc Conf. statut 2 4 Système externe Intermediate DOCument Page : 26

Types de port t. RFC F Le port de type t. RFC est relié

Types de port t. RFC F Le port de type t. RFC est relié à une destination RFC du serveur d ’application pour le système externe. Interface Idoc Interface RFC TCP/IP Interface RFC Système externe Intermediate DOCument Page : 27

Types de port CPI-C F Le port de type CPI-C est relié à une

Types de port CPI-C F Le port de type CPI-C est relié à une destination RFC du serveur d ’application pour le système externe. Interface Idoc R/3 TCP/IP CPI-C LI 6. 2 Interface Idoc R/2 Intermediate DOCument Page : 28

Types de port Internet F l ’Idoc est envoyé avec une adresse Internet au

Types de port Internet F l ’Idoc est envoyé avec une adresse Internet au format MIME. Interface Idoc R/3 SAP office / SAP connect E-mail MIME Système externe Intermediate DOCument Page : 29

Types de port PI F Programming interface Intermediate DOCument Page : 30

Types de port PI F Programming interface Intermediate DOCument Page : 30

Communication avec versions antérieures F Les structures sont modifiées selon les versions. ü Noms

Communication avec versions antérieures F Les structures sont modifiées selon les versions. ü Noms plus longs ü zones supplémentaires FPour la communication avec une version inférieure (scénario ALE), il faut spécifier la version dans la définition du port. Intermediate DOCument Page : 31

Paramétrages de base des systèmes SOMMAIRE Fle paramétrage de base ü Création d ’un

Paramétrages de base des systèmes SOMMAIRE Fle paramétrage de base ü Création d ’un système logique ü Affectation d ’un système logique au système physique ü Cas particulier de l ’ALE Intermediate DOCument Page : 32

Systèmes logiques Identification du système émetteur 1 - Création d ’un système logique F

Systèmes logiques Identification du système émetteur 1 - Création d ’un système logique F IMG > Composantes inter-applications > Répartition (ALE) > Options de base > Installer système logique > Gérer systèmes logiques FUn nom de système logique doit être créé par émetteur de messages SAP. Ce nom ne doit pas être spécifique au nom du système physique mais à sa fonction. Caractéristiques : FTable inter mandant FValable pour l ’ALE et l ’EDI. Intermediate DOCument Page : 33

Systèmes logiques Identification du système émetteur 2 - Affectation du système logique au système

Systèmes logiques Identification du système émetteur 2 - Affectation du système logique au système physique F IMG > Composantes inter-applications > Répartition (ALE) > Options de base > Installer système logique > Affecter système logique au mandant FLe système logique est lié à un mandant d’une instance SAP. Caractéristiques : FTable inter mandant FValable pour l ’ALE et l ’EDI. Intermediate DOCument Page : 34

Systèmes logiques Répartition ALE 3 - Gestion de l ’ALE : F IMG >

Systèmes logiques Répartition ALE 3 - Gestion de l ’ALE : F IMG > Composantes inter-applications > Répartition (ALE) > Gérer modèle de répartition > FUn modèle de répartition doit être défini afin de faire le lien entre les systèmes logiques et le message à transmettre. N. B le message est lié à un document SAP (ex. commande, centre de coût…). Caractéristiques : FModèle avec répartition sur les différents mandants Page : 35 FValable pour l ’ALE seulement Intermediate DOCument

Systèmes logiques Répartition ALE Exemple sur le système UC 4 (4. 0 B) Intermediate

Systèmes logiques Répartition ALE Exemple sur le système UC 4 (4. 0 B) Intermediate DOCument Page : 36

Résumé F Les Idocs sont échangés par l ’intermédiaire du port. F Le port

Résumé F Les Idocs sont échangés par l ’intermédiaire du port. F Le port définit le système cible et les paramètres de communication techniques. ü En émission, le port comprend les paramètres techniques de sortie (lien avec le système externe) ü En réception, il s ’agit d ’une porte d ’entrée dans SAP. FUn paramétrage technique est nécessaire en amont N. B. L ’échange de donnée est également lié au paramétrage SAP Office et SAPConnect pour Internet. Intermediate DOCument Page : 37

Les accords d ’interchange SOMMAIRE F Le paramétrage des accords d ’interchange Exemples :

Les accords d ’interchange SOMMAIRE F Le paramétrage des accords d ’interchange Exemples : F Configuration des partenaires EDI (fournisseur) F Configuration des partenaires ALE Intermediate DOCument Page : 38

Accords d ’interchange F Ils permettent de faire le lien entre le document SAP

Accords d ’interchange F Ils permettent de faire le lien entre le document SAP et l ’Idoc. F Exemple pour l ’envoi des données : ü au départ, un document SAP est enregistré (une commande) ü à l ’enregistrement, un Idoc est généré. ü A partir du n° de fournisseur, les accords d ’interchange sont lus pour trouver le type d ’Idoc, le port … à utiliser. Intermediate DOCument Page : 39

Accords d ’interchange Les quatre vues F Quatre vues : Partenaire Partie à aviser

Accords d ’interchange Les quatre vues F Quatre vues : Partenaire Partie à aviser Général Message + Partenaire Port Sortant Type de port Type d ’Idoc Partie à aviser Message + Partenaire Entrant Code opération Comprenez : Message = document SAP Application Partenaire Code opération Message logique Paramètre MC Partie à aviser Intermediate DOCument Page : 40

Accords d ’interchange entrant F Dans l ’enregistrement de contrôle de tous les Idoc,

Accords d ’interchange entrant F Dans l ’enregistrement de contrôle de tous les Idoc, on trouve les données partenaire et le type de message. Le témoin de test fait également partie de l ’enregistrement de contrôle. F À partir de ces zones, une vue « Accord d ’interchange entrant » est définie de manière unique. Intermediate DOCument Page : 41

Accords d ’interchange entrant Code opération F Parmi les données de l ’accord d

Accords d ’interchange entrant Code opération F Parmi les données de l ’accord d ’interchange entrant figure le « code opération » . ü Il identifie le type de traitement des données et est lié à un module fonction. ü Le module fonction lit les données depuis l ’Idoc entrant et poursuit le traitement des données. Intermediate DOCument Page : 42

Accords d ’interchange sortant « les clés » Fpartenaire : ü numéro : numéro

Accords d ’interchange sortant « les clés » Fpartenaire : ü numéro : numéro SAP ü type : B (banque), KU (client), LI (fournisseur), LS (système logique) ü Fonction : est un client livré, un donneur d ’ordre … ? F message : type, code et fonction ü type : lié au document SAP (ex. centre de coût, commande…) ü variante (fac. ) pour créer un type dérivé. ü fonction (fac. ) : la fonction du message pour créer un sous type dérivé Intermediate DOCument Page : 43

Accords d ’interchange sortants « les données » F témoin de test : lors

Accords d ’interchange sortants « les données » F témoin de test : lors des phases de tests F type de port : le port de sortie F type d ’Idoc ü il est lié à une application (une version spécifique du système cible) ou à un processus de gestion (un type de document à traiter : ex. appels fermes ou appels prévisionnels d ’une commande ) Ex. pour le type de message ORDERS (commande), on trouve le type d ’IDOC ORDERS 01, ORDERS 02, … F destinataire des notifications Intermediate DOCument Page : 44

Accords d ’interchange sortant gestion des messages F Les zones propres à la gestion

Accords d ’interchange sortant gestion des messages F Les zones propres à la gestion des messages sont : ü l ’application (par exemple EF pour Achat), ü la case à cocher « modification de message » (par opposition à « création » ) ü le partenaire F Ces trois zones définissent un type de message et un code opération de manière unique. F À partir de l ’enregistrement MC, une vue « Accord d ’interchange sortant » est définie de manière unique. Intermediate DOCument Page : 45

Accords d ’interchange sortant avec le type de port fichier F Dans ce cas,

Accords d ’interchange sortant avec le type de port fichier F Dans ce cas, quatre options sont possibles : Transfert un seul Idoc et lance le système externe Transfert un seul Idoc et ne lance pas le système externe Transfert par lot d ’Idoc et lance le système externe Transfert par lot d ’Idoc et ne lance pas le système externe Intermediate DOCument Page : 46

Configuration des partenaires EDI Exemple pour un client livré Création de la vue générale

Configuration des partenaires EDI Exemple pour un client livré Création de la vue générale Intermediate DOCument Page : 47

Configuration des partenaires EDI Exemple pour un client livré Vue sortante Vue entrante Intermediate

Configuration des partenaires EDI Exemple pour un client livré Vue sortante Vue entrante Intermediate DOCument Page : 48

Configuration des partenaires EDI Exemple pour un client livré Vue MC Intermediate DOCument Page

Configuration des partenaires EDI Exemple pour un client livré Vue MC Intermediate DOCument Page : 49

Configuration des partenaires ALE un système logique = un mandant = un accord d

Configuration des partenaires ALE un système logique = un mandant = un accord d ’interchange Mandant 001 Mandant 021 UC 4_001 UC 4_021 Intermediate DOCument Page : 50

Accords d ’interchange : résumé F Les partenaires sont saisis dans les accords d

Accords d ’interchange : résumé F Les partenaires sont saisis dans les accords d ’interchange afin que les Idocs puissent être transmis avec succès. F Les accords d ’interchange précisent la méthode d ’envoi des Idocs, le traitement à effectuer ainsi que le mode de traitement. F Le port doit être précisé pour la vue « Sortante » des accords d ’interchange. Intermediate DOCument Page : 51

Quelques codes transactions F WEDI • • Accords d ’interchange port Outil de test

Quelques codes transactions F WEDI • • Accords d ’interchange port Outil de test documentation WE 20 WE 21 WE 19 WE 60 F VOED Configuration EDI F BALD Configuration, développement ALE F BALM Administration ALE et répartition F BD 87 Traitement des IDOC reçus F BD 88 Traitement des IDOC émis F SPRO Customizing (Répartition ALE) ou SALE Intermediate DOCument Page : 52

Les processus d ’envoi et réception de données SOMMAIRE F Le processus d ’envoi

Les processus d ’envoi et réception de données SOMMAIRE F Le processus d ’envoi des données ü Transcription de données R/3 au format IDOC ü Envoi de données et ALE ü Envoi de données et EDI F Le processus de réception des données ü Transcription de formats IDOC en données R/3 F Service ALE : rôle Intermediate DOCument Page : 53

Les processus d ’envoi et réception de données Système Facture externe Idoc maître Interface

Les processus d ’envoi et réception de données Système Facture externe Idoc maître Interface Idoc / Service ALE Facture Idoc(s) de communication Idoc maître Intermediate DOCument Page : 54

 Envoi des données F Le traitement des documents sortants comprend : ü la

Envoi des données F Le traitement des documents sortants comprend : ü la création du document applicatif (ex. une facture) ü la génération de l ’Idoc sortant correspondant ü la recherche du partenaire et du port ü l ’envoi de l ’Idoc vers le système externe via le port F La recherche du partenaire s ’effectue selon les « accords d ’interchange » . Intermediate DOCument Page : 55

Envoi des données et ALE FDéclenchement de l’envoi par : Pointeur de modification, correspondance

Envoi des données et ALE FDéclenchement de l’envoi par : Pointeur de modification, correspondance ou lancement massif. FPointeurs de modification : Toute donnée de base modifiée est transmise vers le système intéressé par cette modification. FL’application envoie un IDOC vers toutes les applications réparties intéressées par le document créé ou modifié. FEnvoi direct ou différé. Intermediate DOCument Page : 56

Envoi des données et EDI FDéclenchement de l’envoi par : correspondance ou lancement massif.

Envoi des données et EDI FDéclenchement de l’envoi par : correspondance ou lancement massif. FEnvoi individuel ou par lot, avec ou sans lancement du sous système. FEnvoi direct ou différé. Intermediate DOCument Page : 57

Réception des données F Le traitement des documents entrants comprend : ü la réception

Réception des données F Le traitement des documents entrants comprend : ü la réception des données Idoc depuis un système externe via un port entrant ü la création d ’un Idoc entrant ü la recherche du type de traitement correct via les accords d ’interchange ü la création d ’un document applicatif FLe port comprend aussi les paramètres techniques d ’entrée (paramètre du système SAP) F Les accords d ’interchange déterminent le traitement Intermediate DOCument Page : 58

Service ALE de l ’interface Idoc L ’interface Idoc comprend les services ALE. Les

Service ALE de l ’interface Idoc L ’interface Idoc comprend les services ALE. Les services ALE comprennent : Fle filtrage d ’Idoc, Fla conversion d ’un Idoc, Fla modification de version, Fla détermination du partenaire destinataire , Fla duplication de l ’Idoc. N. B. différent de l ’ALE compris habituellement Intermediate DOCument Page : 59

Traitement des documents entrants à l ’aide du workflow F Un Idoc est reçu

Traitement des documents entrants à l ’aide du workflow F Un Idoc est reçu par SAP et issu du système externe. L ’interface Idoc réceptionne l ’Idoc sur un port. Les coordonnées du système externe sont vérifiées. Le contenu de l ’Idoc est également vérifié : ex. le partenaire existe t ’il dans SAP ? F Ensuite, c ’est le Business Workflow qui pilote la création du document applicatif. Intermediate DOCument Page : 60

Traitement des documents sortants Gestion des messages FRepose sur la technique de conditions La

Traitement des documents sortants Gestion des messages FRepose sur la technique de conditions La création et l ’envoi d ’un Idoc sont liés à une séquence d ’opérations définie dans le customizing. FL ’Idoc est envoyé à l ’interface Idoc qui se charge d ’effectuer les dernières transcodifications (services ALE). FL ’Idoc est enfin envoyé à un port, techniquement lié au système externe. Intermediate DOCument Page : 61

Résumé F Idoc est une norme SAP pour le transfert de données entre des

Résumé F Idoc est une norme SAP pour le transfert de données entre des systèmes F L ’ALE et l ’EDI mettent en œuvre les Idocs F Un Idoc est un ensemble d’enregistrements de données applicatives et de gestion F Les accords d ’interchange et les ports permettent de gérer l ’émission et la réception d ’Idoc de SAP Intermediate DOCument Page : 62

Le Workflow : la configuration minimale pour la gestion des erreurs SOMMAIRE F le

Le Workflow : la configuration minimale pour la gestion des erreurs SOMMAIRE F le traitement des erreurs F le paramétrage dans SAP Intermediate DOCument Page : 63

Gestion des erreurs F La gestion des erreurs se fait par le workflow ü

Gestion des erreurs F La gestion des erreurs se fait par le workflow ü ü Le paramétrage minimal pour les IDOCs est automatisé. Avertissement en cas de problèmes fonctionnels / techniques Retraitement des messages en erreur Notion de personne / Structure organisationnelle (regroupement) F Déclaration des personnes ou services responsables ü pour les problèmes techniques : Administrateur des IDOCs ü pour les problèmes fonctionnels dans les accords d’interchange F Le paramétrage dans SAP est décrit en annexe. Intermediate DOCument Page : 64

Traitement des documents entrants sans workflow F Les mêmes contrôles que pour le workflow

Traitement des documents entrants sans workflow F Les mêmes contrôles que pour le workflow sont exécutés. F L ’Idoc est transmis directement au module de l ’application. F C ’est au niveau des accords d ’interchange qu ’est géré l ’option Workflow ou non. Intermediate DOCument Page : 65

L ’environnement de développement SOMMAIRE ü Création d’un segment, ü ü Création d’un type

L ’environnement de développement SOMMAIRE ü Création d’un segment, ü ü Création d’un type d’Idoc, Création d’un message logique associé au type d’Idoc, Création d’un module fonction pour le traitement de l’Idoc , Définition des attributs ALE du module fonction pour le traitement de l’IDOC avec les services ALE, ü Association entre le type d’Idoc, le module fonction, le message logique et un objet d’application, ü Définition/utilisation d’un code opération pour l’envoi d’un message Workflow déclenché par des événements (IDOC erroné, …) ü Définition/utilisation d’une tâche Workflow et définition des partenaires pour la réception des tâches Workflow dans leur corbeille d’arrivée Intermediate DOCument Page : 66

1 - Création d ’un segment WEDI > Développement > Segments Idoc (transaction WE

1 - Création d ’un segment WEDI > Développement > Segments Idoc (transaction WE 31) F Utiliser des zones de structure du DDIC F Pour activer la définition d’un segment, faire “ TraiterApposer témoin ‘’libération’’ F Pour modifier la définition d’un segment, ‘’Annuler la libération’’ FLe segment est créé dans le DDIC (CF. SE 12) Intermediate DOCument Page : 67

2 - Création d ’un type d ’Idoc WEDI > Développement > Types d

2 - Création d ’un type d ’Idoc WEDI > Développement > Types d ’Idoc (transaction WE 30) Type d ’IDOC Segment Penser à activer la définition du type d ’Idoc Intermediate DOCument Page : 68

3 - Création du message logique et association au type d ’Idoc F Création

3 - Création du message logique et association au type d ’Idoc F Création d’un type de message spécifique Z… WEDI > Développement > Types de message F Lien type d ’Idoc WEDI > Développement > Types d ’Idoc/Message F Notez bien : La vue VEDI_EDMSG contenant les types de messages logiques est inter-mandant. La table EDIMSG contenant le lien type IDOC/message logique est inter-mandant. Intermediate DOCument Page : 69

4 - Création du module fonction F Copie d ’un module fonction standard (conseillé)

4 - Création du module fonction F Copie d ’un module fonction standard (conseillé) ü Les paramètres d’entrée et de sortie du module doivent respecter les paramètres requis pour la gestion d’un IDOC. ü Le code du module fonction utilise un formatage particulier (ex. gestion des messages d ’exception ou statut) F Nom : en général Z_IDOC_INPUT_<nom du message> F Exemple de structure de programme : ü contrôle du type d ’Idoc et des accords d ’interchange ü contrôle du nom de chaque segment, de la séquence des enregistrements par rapport au type d ’Idoc défini dans SAP ü Traitement Page : 70 ü Mise à jour du statut de l ’Idoc Intermediate DOCument

4 - Création du module fonction <FEUILLE cf. Plan_Idoc. doc ! > Intermediate DOCument

4 - Création du module fonction <FEUILLE cf. Plan_Idoc. doc ! > Intermediate DOCument Page : 71

5 - Paramétrage de la réception de l ’Idoc 5 -1 Définition lien module

5 - Paramétrage de la réception de l ’Idoc 5 -1 Définition lien module fonction/type IDOC/message logique/sens du transfert 5 -2 Définition des propriétés du module fonction 5 -3 Définition du code opération 5 -4 Définition du code opération - traitement des erreurs Intermediate DOCument Page : 72

5 -1 Définition lien module fonction/type IDOC/message logique Accès : transaction WEDI puis Développement

5 -1 Définition lien module fonction/type IDOC/message logique Accès : transaction WEDI puis Développement Message/objet appl. Ou transaction BALD puis IDOCRéception Module fonction/ Message/Objet appl. FNotez bien : la vue VEDIEDIFCT contenant les types de messages logiques est inter-mandant. Intermediate DOCument Page : 73

5 -2 Définition des propriétés du module fonction Accès : transaction BALD puis IDOCRéceptionAttributs

5 -2 Définition des propriétés du module fonction Accès : transaction BALD puis IDOCRéceptionAttributs du module fonction FLe type de saisie indique la manière de traiter les paquets d’IDOC. « 1 » n’autorise que la réception individuelle. FLa case ‘Dialogue possible’ autorise un traitement de transaction à l’écran lorsqu’elle est cochée. FNotez bien : la vue V_TBD 51 contenant ces propriétés est inter-mandant. Intermediate DOCument Page : 74

5 -3 Définition du code opération Accès : transaction WEDI puis GestionCode opér. (réception)

5 -3 Définition du code opération Accès : transaction WEDI puis GestionCode opér. (réception) OU : transaction BALD puis IDOCRéceptionCode d’opération - Type du traitement Intermediate DOCument Page : 75

5 -4 Définition du code opération – Traitement des erreurs (lié avec le Workflow)

5 -4 Définition du code opération – Traitement des erreurs (lié avec le Workflow) F Déclenchement : le module fonction renvoie le paramètre WORKFLOW_RESULT. Si celui-ci est différent de 0 (valeur 99999), il déclenche l’événement de création de tâche Workflow. Accès : transaction BALD puis IDOCRéceptionCode d’opération – Traitement erreurs (BD 67) Intermediate DOCument Page : 76

5 -4 Définition du code opération – Traitement des erreurs (lié avec le Workflow)

5 -4 Définition du code opération – Traitement des erreurs (lié avec le Workflow) Accès : transaction BALD puis IDOCRéceptionLien avec événement (SWE 2) Le type d’objet IDOCAPPL et les événements vus précédemment sont ici liés à un type de récepteur. Remarque : La tâche standard TS 20000051 (CF. transaction PFTC) définit le traitement des erreurs lors de la réception de BAPI-IDOC. Le type de récepteur WORKITEM permet la mise à niveau de la tâche (suppression, …) après traitement des erreurs. Intermediate DOCument Page : 77

5 -4 Définition du code opération – Traitement des erreurs (lié avec le Workflow)

5 -4 Définition du code opération – Traitement des erreurs (lié avec le Workflow) Accès : Outil -> Business Workflow -> Développement >Outils de définition >Tâche (PFTC) Faire « Données supplémentaires -> Affect. De responsables » Il s ’agit de l ’utilisateur responsable du traitement des erreurs. Intermediate DOCument Page : 78

5 -4 Définition du code opération – Traitement des erreurs (lié avec le Workflow)

5 -4 Définition du code opération – Traitement des erreurs (lié avec le Workflow) Accès : : transaction BALD puis IDOCRéceptionContrôle de cohérence Effectuer un contrôle de cohérence sur tout ce qui a été défini auparavant pour le code opération. Corriger les erreurs. Intermediate DOCument Page : 79

5 -4 Définition du code opération – Traitement des erreurs (lié avec le Workflow)

5 -4 Définition du code opération – Traitement des erreurs (lié avec le Workflow) Accès : transaction WEDI puis GestionAdministration IDOC Il s ’agit de définir les valeurs par défaut pour le développement d ’Idoc. En particulier, notez le lien avec le Workflow. Les étapes suivantes sont la création des accords d ’interchange et les tests. . . Intermediate DOCument Page : 80

Développement ALE FExtension ü Ajout de données dans un message ü Modification des programmes

Développement ALE FExtension ü Ajout de données dans un message ü Modification des programmes de traitement (sortant et/ou entrant) FCréation ü ü ü Création du message Création des codes de traitement Création du traitement (sortant et/ou entrant) Création de la tâche standard d’erreur Création des événements Création des liens avec les objets concernés Intermediate DOCument Page : 81

Attention ! FAttention aux reprises de données (volumétrie) FConvergence de paramétrage entre les systèmes

Attention ! FAttention aux reprises de données (volumétrie) FConvergence de paramétrage entre les systèmes FNécessité d’avoir une Stratégie d’archivage IDOC ü Volumétrie/Périodicité FGestion des workflows ü Archivage/Suppression FRéorganisation des pointeurs de modification ü Purge des pointeurs traités Intermediate DOCument Page : 82

Les transactions ALE FParamétrage ALE ü Transaction SALE FAdministration/suivi des IDOCs ü Transaction BALE

Les transactions ALE FParamétrage ALE ü Transaction SALE FAdministration/suivi des IDOCs ü Transaction BALE ü Transaction WEDI FEnvoi des données de base ü Transaction BALM Intermediate DOCument Page : 83

Synthèse codes transactions F WEDI • • Accords d ’interchange port Outil de test

Synthèse codes transactions F WEDI • • Accords d ’interchange port Outil de test documentation WE 20 WE 21 WE 19 WE 60 F VOED Configuration EDI F BALD Configuration, développement ALE F BALM Administration ALE et répartition F BD 87 Traitement des IDOC reçus F BD 88 Traitement des IDOC émis F SPRO Customizing (Répartition ALE) ou SALE Intermediate DOCument Page : 84

Tests de traitement F WE 19 (outil de test) avec les fonctions de debug

Tests de traitement F WE 19 (outil de test) avec les fonctions de debug disponibles ü en partant d ’un Idoc existant ü s ’il s ’agit d ’un Idoc entrant, simulant une sortie (au niveau applicatif) puis une entrée en modifiant l ’enregistrement de contrôle Exemple de l ’exercice : commande d ’ achat puis commande client F S ’il s ’agit de spécifique, tester les messages de succès, cas d ’erreurs, retraitement des anomalies. Intermediate DOCument Page : 85

Tests de traitement F WE 12 : tests des fichiers sortants. Modifie les enregistrements

Tests de traitement F WE 12 : tests des fichiers sortants. Modifie les enregistrements de contrôle pour créer un Idoc entrant à partir d ’un Idoc sortant. F Échange de données avec le système de fichiers : WE 14 (sortant), WE 16 (entrant), WE 17 (confirmation de statut, entrant) F Traitement de l ’enregistrement MC : WE 15 F Transfert de données depuis l ’interface Idoc vers un traitement des documents entrants supplémentaire : WE 19 F Transfert de données vers n ’importe quel port : WE 14 Intermediate DOCument Page : 86

ANNEXE F User-exit F Mise en œuvre Gestion des erreurs - Workflow F Glossaire

ANNEXE F User-exit F Mise en œuvre Gestion des erreurs - Workflow F Glossaire F Exemple de scripts Unix Intermediate DOCument Page : 87