Intégration SAP

Orien a la capacité d'extraire des données SAP d'une instance SAP via des API. Actuellement, Orien peut recevoir des charges utiles JSON de:

    1. Emplacements Fonctionnels SAP
    2. Équipement SAP
    3. Matériel SAP
    4. Centres de Travail SAP
    5. Points de Mesure SAP
    6. Documents de Mesure SAP
    7. Achèvement de la Maintenance Planifiée SAP

Vous trouverez ci-dessous un guide sur la façon d'afficher et d'utiliser vos données SAP dans Orien. L'intégration SAP d'Orien nécessite qu'une clé API Orien Self-Service valide et non expirée soit transmise dans la charge utile JSON du corps. Pour plus de détails, consultez la documentation API pour Orien, cliquez ici Documentation de l'API Libre-Service.

Pour plus d'informations sur les routes et fonctionnalités de l'API Orien, consultez la documentation Swagger pour Orien ici: Documentation Swagger.

Ce processus utilisera la Hiérarchie Externes d'Orien et ses fonctionnalités. Pour obtenir de l'aide sur l'utilisation de la Hiérarchie Externe, utilisez cet article: Hiérarchie Externe.  

Si vous avez des questions sur le processus ou si vous souhaitez savoir comment initialiser ces données SAP dans Orien, contactez le support Orien à l'adresse: support@orien.zendesk.com 

 

Configuration du Point de Terminaison SAP


Points de Terminaison SAP peuvent être configurés pour chaque base de données et sont configurés par Orien IT et devront être effectués avant cette étape. Pour toute demande de renseignements ou d'aide, veuillez contacter le support Orien à: support@orien.zendesk.com. Pour afficher la Config du Point de Terminaison SAP, sélectionnez le module SAP Config au niveau de la base de données.

Une fois sélectionné, vous pourrez configurer les Points de Terminaison pour ces Données/Base de Données Client spécifiques. Les propriétés et les valeurs de chacune de ces configurations de point de terminaison sont répertoriées ci-dessous.

Lorsqu'un Point de Terminaison SAP est sélectionné, diverses propriétés peuvent être attribuées pour configurer le point de terminaison (par exemple, Limiteur de Page, Critères, Description AA, type d'URL, Point de Terminaison d'Intégration) et un type d'usine (par exemple, Usine de Matériaux, Usine de Planification, Usine de Maintenance) sont requis pour chaque Configuration de Point de Terminaison. 

mceclip1.png

 

 

Itinéraires API SAP


Pour les itinéraires ci-dessous, vous devrez ajouter l'URL de base de votre instance Orien et ajouter le Code d'Entreprise attribué à votre instance. Développez les Itinéraires pour afficher un exemple de charge utile. Un exemple sera : Lorem.orien.app/api/ss/v1/integration-change/sap-functional-location/. Ces routes recevront des charges utiles JSON des données suivantes :

 
FLOC - /api/ss/v1/integration-change/sap-functional-location/
[
   {
      "FunctionalLocation":"?0100000000000014126",
      "ParentFunctionalLocation":"?0100000000000014120",
      "FunctionalLocationCategory":"I",
      "StructureIndicator":"",
      "ReferenceFunctionalLocation":"AAA1",
      "StatusProfile":"",
      "Class":"AA_AAAA_1111",
      "ClassType":"001",
      "CatalogueProfile":"AAAAA11",
      "FunctionalLocationDescription":"Description",
      "FunctionalLocationLabel":"AAA-AAA-A11-AAA-AAA-1AA-111-AAA-AAA-AAA",
      "LongText":"",
      "LanguageKey":"E",
      "AdditionalDescription":"",
      "MaintenancePlant":"A099",
      "SortField":"AA-3301",
      "CostCentre":"1401030710",
      "ConstructionType":"",
      "MaintenancePlanningPlant":"I011",
      "PlannerGroup":"",
      "MainWorkCentre":"",
      "PlantMainWorkCentre":"",
      "ObjectType":"",
      "UserStatus":"",
      "ManufacturerSerialNumber":"",
      "InventoryNo":"",
      "Manufacturer":"",
      "ModelNumber":"",
      "AcquisitionDate":"",
      "AcquisitionValue":"",
      "CurrencyKey":"",
      "StartupDate":"",
      "PlantSection":"",
      "Location":"",
      "SystemStatus":"",
      "CatalogueProfileDescription":"",
      "FunctionalLocationCategoryDescription":"",
      "MaintenancePlantDescription":"",
      "ConstructionTypeDescription":"",
      "PlannerGroupDescription":"",
      "MainWorkCentreDescription":"",
      "ObjectTypeDescription":"",
      "PlantSectionDescription":"",
      "LocationDescription":""
   }
]
Equipment - /api/ss/v1/integration-change/sap-equipment/
[
   {
    "EquipmentNumber":"000000000010224014",
    "FunctionalLocation":"?0100000000000168814",
    "ValidFromDate":"20180919"
    "UserStatus":"INOP",
    "ValidToDate":"99991231",
    "EquipmentCategory":"R"
    "TechnicalObjectDescription":"Diesel Engine",  
    "ObjectType":"DLTB"
    "SortField":"MD33176034"
    "ConstructionType":"20006059"
    "CostCentre":"AA11111111"
    "CompanyCode":"AA01",
    "MaintenancePlant":"A111"
    "PlanningPlant":"A111"
    "PlannerGroup":"A11"
    "MainWorkCentre":"AA1AA",
    "CatalogueProfile":""
    "ManufacturerSerialNumber":""
    "Manufacturer ":""
    "ModelNumber":"1234"
    "InventoryNo":"INv001",
    "PlantSection":"",
    "Location":"",
    "InstallationLocationDate":""
    "InstallLocationTime":""
    "SystemStatus":"INSTL",
    "ObjectTypeDescription":"Drill Track"
    "ConstructionTypeDescription":"Drill"
    "CompanyCodeDescription":""
    "MaintenancePlantDescription":""
    "PlanningPlantDescription":""
    "PlannerGroupDescription":""
    "MainWorkCentreDescription":""
    "PlantSectionDescription":""
    "LocationDescription":""  
    }
]
Materials - /api/ss/v1/integration-change/sap-material/
[
   {
    "MaterialNumber":"",
    "Description":"",
    "PlantCode":"",
    "MaterialType":"",
    "MaterialGroup":"",
    "ManufacturerPartNumber":"",
    "Manufacturer":"",
    "IntMaterialNumber":"",
    "ValidationClass":"",
    "StockClass":"",
    "BaseUnitIssue":"",
    "MovingAveragePrice":"",
    "PurchasePrice":"",
    "CompanyCode":"",
    "Currency":"",
    "DeletionFlag":"",
    "SystemStatus":""
    }
]
Work Centers - /api/ss/v1/integration-change/sap-work-center/
[
   {
    "PlanningPlant":"",  
    "WorkCentre":"",
    "Catagory":""
    "Description":"'"
    "Usage":""
    "ControlKey":""
    "ControlKeyIndicator":"",
    "CapacityCatagory":"",
    "CapacityPlannerGroup":"",
    "UnitOfMeasure":""
    "CapacityUtilisation":""
    "CostCentre":"",
    "SystemStatus":""
    }
]
Measuring Points - /api/ss/v1/integration-change/sap-measuring-point/
[
   {
        "MeasuringPoint":"",
        "MeasuringPointObject":"",
        "SortField":"",
        "LanguageKey":"",
        "ItemCategoryText":"",
        "MaintenancePlanCategory":"",
        "FunctionalLocation":"",
        "EquipmentNumber":"",
        "MaintenancePlanningPlant":"",
        "InternalCharacteristic":"",
        "CharacterField":"",
        "BaseUnitOfMeasure":"",
        "CodeGroup":"",
        "IndicatorRefMeasPoint":"",
        "TransferredMeasuringPoint":"",
        "MeasurementDate":"",
        "MeasurementTime":"",
        "AnnualEstimate":"",
        "IndicatorCounterBackwards":"",
        "LowerMeasurementRange":"",
        "UpperMeasurementRange":"",
        "MeasurementDocument":"",
        "MeasurementDocumentTime":"",
        "MeasurementDocumentDate":"",
        "CounterReading":"",
        "MeasurementCounterReading":""
   }
 ]
Measurement Document - /api/ss/v1/integration-change/sap-measure-docs/
[
   {
        "MeasurementDocument":"",
        "MeasuringPoint":"",
        "MaintenancePlanningPlant":"",
        "EquipmentNumber":"",
        "FunctionalLocationLabel":"",
        "DateOFTheMeasurement":"",
        "TimeOFTheMeasurement":"",
        "MeasurementDocumentText":"",
        "LanguageKey":"",
        "MeasurementReading":"",
        "MeasurementReadinginUnitOfEntry":"",
        "UnitOfMeasurementForDocumentEntry":"",
        "CounterReading":"",
        "CounterReadingDifference":"",
        "CounterReadingDifferenceIndicator":"",
        "CounterReplacedIndicator":""
   emma  }
 ]
Planned Maintenance Last Completion - /api/ss/v1/integration-change/sap-planned-completion/
[
   {
    "PlanningPlant":"",
    "MaintenancePlan":"",
    "MaintenanceItem":"",
    "Equipment":"",
    "FunctionalLocation":"",
    "KeyTaskListGroup ":"",
    "GroupCounter":"",
    "OperationNumber":"",
    "MaintenancePlanCallNumber":"",
    "DateCreated":"",
    "WorkOrderNumber":"",
    "CompletionDate":"",
    "ObjectStatus":""
    }
]

 

Ordre des Initialisations


Les Initialisations doivent être exécutées dans un processus général car certains objets techniques ont des prérequis (par exemple, un équipement est alloué à un FLOC). Nous recommandons que les Initialisations soient exécutées séquentiellement dans l'ordre suivant:

    1. Emplacements Fonctionnels SAP
    2. Équipement SAP
    3. Matériel SAP
    4. Centres de Travail SAP
    5. Points de Mesure SAP
    6. Achèvement de la Maintenance Planifiée SAP

 

Objets de Référence SAP


Les Objets de Référence SAP sont utilisés pour spécifier les données reçues de SAP. Ceci est utile lorsque les données SAP sont utilisées dans plusieurs bases de données. Chacun de ces objets utilise le champ Code comme paramètre avec un champ de description facultatif. Le tableau ci-dessous est un exemple des valeurs attendues.

ERROR MESSAGE DESCRIPTION RESOLUTION
Catalogue Profile   {Catalogue Profile Name}
Construction Type   000000000020009999
Functional Location Category Technical system - standard W
Object Type   DIST
Planner Group   A99
Plant Plant Name {Plant Code}

 

Les Objets de Référence SAP comprennent les Centres de Travail SAP. Les Centres de Travail peuvent être créés, modifiés et supprimés dans cet onglet.

WORK CENTRE FIELD SAMPLE VALUE
Description (STEXT) Mechanic
Plant (WERKS) A999
Category (VERWE) AAA
USAGE (PLANV) 001
Control Key (STEUS) PMAA
Indicator Control Key is Referenced (STEUS_REF)  
Capacity Category (KAPART)  
Capacity Planner Group (PLANR) PM
Base Unit of Measurement  H
Capacity utilisation (NGRAD) 100
Cost Center (KOSTL) 0400690139
Cost Per Unit/Rate  
Currency Key  
System Status  
Code(ARBPL) AA1AA111
Notes  

 

Enregistrements de Synchronisation de Données


Tout au long du processus d'initialisation, la progression des actions clés sera enregistrée et disponible dans le module Synchronisation de Données. Le module affichera l'historique des processus complétés sur la base de données sélectionnée. Vous trouverez ci-dessous un exemple de l'écran Synchronisation de Données qui a fait l'objet de plusieurs processus précédents.

 

Lorsque Afficher les Messages est sélectionné, le processus a été séparé en tous ses messages de session. Cela permet d'identifier à quelle étape se trouve actuellement la synchronisation des données ou si des erreurs se sont produites. Vous trouverez ci-dessous un exemple de messages reçus d'un processus Point De Mesure SAP complété:

 

Planificateurs Delta


Pour recevoir des Deltas (mises à jour) de SAP sur les données existantes au sein de la Hiérarchie Externe, un planificateur devra être installé et configuré dans chaque base de données pour chaque type d'Intégration (FLOC, Équipement, Matériaux, etc.). Pour notre guide de l'utilisateur sur la configuration des planificateurs, veuillez consulter notre article ici: Orien Planificateur

Lors de la création d'un planificateur pour extraire les Deltas vers Orien, voici les champs obligatoires:

PROPERTY TYPE SOURCE
Description String Manual Input
Type Collection Static Orien Field - Must use 'Apply Integration Changes'
Schedule Interval (days) Integer Manual Input
Hour of the Day (0 to 23) Integer Manual Input
Disabled Boolean Manual Input
Next Due date Date Manual Input
Integration Type Collection Static Orien Field
Integration Server Collection Static Orien Field
Plant Collection User-defined Ref Object in SAP Config
API Key String Manual Input

Parallèlement aux Planificateurs Delta, un Planificateur de Contrôle de Délai d'Intégration doit être appliqué à chaque Base de Données Intégrée et exécuté au moins une fois par semaine

Remarque

Les Deltas doivent être exécutés quotidiennement. Les données Delta ne sont stockées dans le système que pendant 7 jours.

 

Une fois tous les Planificateurs configurés, cela ressemblera à ceci:

mceclip1.png

 

Cet article vous a-t-il été utile?
Utilisateurs qui ont trouvé cela utile : 0 sur 0