Configuration des activités OData
Lors de l'exposition des données d'arrière-plan comme API OData utilisant Cast Iron :
- Dans ce cas, les activités HTTP Recevoir demande et HTTP Envoyer réponse sont utilisées pour exposer les API OData.
- La sortie de cette activité HTTP Recevoir demande (uri, method, host, accept et content-type, autres en-têtes http, charge) est transmise en entrée de l'activité Lire OData.
- Procédure de configuration de l'activité Lire OData
- Créez ou ouvrez une orchestration. Une représentation graphique de l'orchestration s'affiche.
- Sélectionnez l'onglet Activités et développez le dossier Transformer.
- Faites glisser l'activité Lire OData vers l'orchestration.
- Dans la liste de contrôle, cliquez sur Configurer.
- Sélectionnez la version dans la zone Version d'OData.
- Sélectionnez Format de données d'entrée. Vous pouvez sélectionner soit Schéma XML existant, soit Nouveau schéma XML pour la prise en charge de plusieurs entités.
- Si vous avez sélectionné Schéma XML existant, cliquez sur Parcourir pour sélectionner le schéma XML existant.
- Si vous avez sélectionné Nouveau schéma XML pour la prise en charge de plusieurs entités, collez le contenu du nouveau schéma XML et cliquez sur Générer des mappes.
- Sélectionnez Mapper les sorties dans la Liste de contrôle. Le schéma XML généré pour contenir la réponse de l'activité s'affiche sous forme de noeuds sous le paramètre readODataOutputPayload dans le panneau Depuis l'activité.
- Renseignez les propriétés de mappage d'entrée en faisant référence à l'activité Lire OData.
- Créez une mappe entre les paramètres de sortie et les variables d'orchestration.
Remarque :- La sortie de l'activité Lire OData sert à exécuter la logique métier sur les systèmes d'extrémité/d'arrière-plan à l'aide des connecteurs disponibles dans Cast Iron.
- La sortie de ces activités de logique métier (code de réponse http, charge) et de l'activité Lire OData (serviceName, protocol, host, method, accept, content-type, resourcePath, entities, additionalPath, fieldName, primaryKeys et additionalConfiguration) est fournie en entrée de l'activité Ecrire dans OData.
- La valeur de serviceName dans le mappage d'entrée de l'activité Lire OData doit comporter la même valeur que la propriété URL (chemin après le nom d'hôte) dans l'activité HTTP Recevoir demande.
- Le format de la propriété primaryKeys dans le mappage d'entrée de l'activité Lire OData est décrit dans la section Activité Lire OData.
- Procédure de configuration de l'activité Ecrire dans OData
- Créez ou ouvrez une orchestration. Une représentation graphique de l'orchestration s'affiche.
- Sélectionnez l'onglet Activités et développez le dossier Transformer.
- Faites glisser l'activité Ecrire dans OData vers l'orchestration.
- Dans la liste de contrôle, cliquez sur Configurer.
- Sélectionnez la version dans la zone Version d'OData.
- Sélectionnez Format de données d'entrée. Vous pouvez sélectionner soit Schéma XML existant, soit Nouveau schéma XML pour la prise en charge de plusieurs entités.
- Si vous avez sélectionné Schéma XML existant, cliquez sur Parcourir pour sélectionner le schéma XML existant.
- Si vous avez sélectionné Nouveau schéma XML pour la prise en charge de plusieurs entités, collez le contenu du nouveau schéma XML et cliquez sur Générer des mappes.
- Sélectionnez Mapper les entrées dans la Liste de contrôle. Les schémas XML générés à partir de l'objet sélectionné de l'activité Ecrire dans OData s'affichent sous forme de noeuds sous le paramètre writeODataInput dans le panneau Vers l'activité.
- Renseignez les propriétés de mappage d'entrée en faisant référence à la sectionActivité Ecrire dans OData.
- Créez une mappe entre les paramètres de sortie et les variables d'orchestration.
Remarque : La sortie de l'activité Ecrire dans OData qui contient la charge de réponse, le code d'état http et des en-têtes est transmise à l'activité HTTP Envoyer réponse.
Remarque :
- Seuls les méthodes HTTP DELETE et GET sont prises en charge dans Cast Iron version 7.5.1.
- Les paramètres de requête OData ne sont pas pris en charge à partir de Cast Iron version 7.5.1.
- Les structures d'objet métier contenant des zones de type de données simples ne sont prises en charge que dans Cast Iron version 7.5.1. La structure d'objet métier contenant des types complexes enfant n'est pas prise en charge.