Page générale de l'étape REST dans ( DataStage )
Sur la page Général de l'étape REST, vous pouvez configurer une connexion au service Web REST. Vous pouvez également créer une connexion réutilisable qui pourra être utilisée pour configurer les connexions pour plusieurs étapes REST.
Vous devez indiquer des valeurs pour les zones suivantes pour configurer les paramètres de connexion pour le service Web REST.
- Méthode HTTP
- Sélectionnez les méthodes HTTP à utiliser pour se connecter au service Web REST.
- GET
- Extrait les informations sous la forme d'une entité identifiée par l'URI (Uniform Resource Identifier) de la demande du corps de la demande.
- POST
- Demande que le serveur d'origine accepte les données incluses dans le corps du message de demande. Cette méthode est souvent utilisée pour transférer des données de ressources.
- PUT
- Demande que l'entité incluse soit stockée sous l'URI de demande spécifié.
- SUPPRIMER
- Demande au serveur d'origine de supprimer la ressource identifiée par l'URI de la demande.
- OPTIONS
- Affiche la liste des méthodes HTTP prises en charge par le serveur pour l'identificateur URI spécifié.
- HEAD
- Extrait uniquement les informations d'en-tête de la réponse. Cette méthode est souvent utilisée pour vérifier que des liens hypertextes sont valides et identifier si les liens ont été modifiés.
- PATCH
- Modifie des ressources existantes. Vous pouvez utiliser la méthode PATCH pour mettre à jour une zone unique de la ressource.
- Connexion réutilisable
- Vous pouvez réutiliser un objet de connexion qui a été créé dans une autre étape REST du même assemblage. Les connexions réutilisables sont disponibles uniquement dans l'assemblage où vous les avez créées. Pendant l'exécution du travail, la connexion est partagée pour démarrer plusieurs services REST créés par les étapes multiples qui utilisent la même connexion réutilisable. La connexion réutilisable est également conçue pour transmettre les cookies de session entre différentes demandes sans configuration utilisateur. La connexion réutilisable permet de gagner du temps lors de la création d'une connexion avec le serveur sur lequel le service REST est déployé. Lorsque l'option Connexion réutilisable est sélectionnée, la zone Suffixe URL est affichée sur la page Général dans laquelle vous indiquez une partie de l'URL du service REST.
- URL
- Indiquez une chaîne URL pour le service Web REST. Vous pouvez inclure un paramètre local dans l'URL en spécifiant la balise <localparam>. Vous devez mapper les paramètres locaux pour entrer des éléments de données ou des valeurs fixes sur la page Mappages. Pour spécifier un DataStage® paramètre de tâche dans l' URL e au moment de l'exécution, cliquez sur l'icône Insérer un paramètre (
{#}), puis sélectionnez le nom d'un paramètre de tâche.
- Version HTTP
- Sélectionnez la version HTTP avec laquelle vous souhaitez exécuter le service Web REST. La méthode OPTIONS n'est pas disponible pour HTTP version 1.0 car la méthode OPTIONS a été introduite dans HTTP version 1.1.
- Délai d'attente
- Indiquez le nombre de millisecondes à attendre avant de considérer que la demande a dépassé le délai d'attente. La valeur par défaut est 5 000 millisecondes et la valeur maximale 1 800 000 millisecondes.
- Configuration de proxy
- Sélectionnez cette option pour choisir un serveur proxy comme passerelle intermédiaire permettant d'accéder à des ressources REST. Cliquez sur Configurer pour spécifier les détails de connexion, tels que nom, port, segment, domaine, nom d'utilisateur et mot de passe à utiliser pour se connecter au serveur proxy.
Si cette option est sélectionnée, le client utilise un serveur proxy HTTP pour se connecter à la destination. Le serveur proxy se connecte ensuite pour le compte du client. Lorsque la connexion est établie, le serveur proxy gère le flux TCP vers et depuis le client.
- Abandon du travail en cas d'erreur
- Sélectionnez cette option pour arrêter le travail en cas d'échec de l'appel REST.