Activités de base de données entrantes dans une table unique
A l'exécution, les activités de base de données entrantes à table unique vérifient si une opération de base de données s'est produite sur des lignes dans les colonnes spécifiées d'une table de base de données selon l'intervalle défini.
La présente section contient les procédures de configuration des activités de base de données entrantes de table unique suivantes :
- Obtenir lignes insérées - A l'exécution, l'activité Obtenir lignes insérées recherche les lignes ajoutées à la table tampon à partir d'un événement déclencheur INSERT. L'activité Obtenir lignes insérées mappe ensuite les données tampon sur la ou les variables.
- Obtenir lignes mises à jour - A l'exécution, l'activité Obtenir lignes mises à jour recherche les lignes ajoutées à la table tampon à partir d'un événement déclencheur UPDATE. L'activité Obtenir lignes mises à jour mappe ensuite les données tampon sur la ou les variables.
- Obtenir lignes supprimées - A l'exécution, l'activité Obtenir lignes supprimées recherche les lignes ajoutées à la table tampon à partir d'un événement déclencheur DELETE. L'activité Obtenir lignes supprimées mappe ensuite les données tampon sur la ou les variables.
Figure 1. Exemple de déclencheur UPDATE
Après avoir publié votre orchestration avec une activité de base de données entrante dans le dispositif d'intégration, vous devez créer la table tampon et les déclencheurs à l'aide de la console de gestion Web avant le déploiement de l'orchestration. Pour la base de données Oracle, vous devez également créer une séquence à l'aide de la console de gestion Web.
Aucune activité pour cette erreur d'exécution d'opération
Si une orchestration accède à une table tampon contenant une ligne pour une activité qui n'existe pas dans l'orchestration, cette dernière échoue et l'erreur suivante est reportée pendant l'exécution :La table tampon contient l'opération OperType mais il n'existe aucune activité dans l'orchestration pour cette opération.
Où OperType est le type de l'opération, par exemple INSERT. Les valeurs de la colonne IH_OPERATION_NAME dans la table tampon pour l'orchestration doivent être cohérentes avec les activités de base de données dans l'orchestration. Par exemple, si une ligne de la table tampon contient la valeur INSERT dans la colonne IH_OPERATION_NAME mais que l'orchestration ne contient pas d'activité Obtenir lignes insérées, cette erreur est signalée. Chaque orchestration doit disposer d'une table tampon distincte. En outre, les déclencheurs de la table source doit être cohérents avec les opérations de base de données spécifiées dans la table tampon. Par exemple, si l'orchestration contient uniquement une activité Obtenir lignes mises à jour entrante unique, la table de base de données source contient uniquement un déclencheur UPDATE.Ajouter une activité de base de données entrante de table unique à l'orchestration
- 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 Base de données.
- Déplacez l'activité de base de données entrante de table unique souhaitée (Obtenir lignes insérées, Obtenir lignes supprimées ou Obtenir lignes mises à jour) dans l'orchestration.
- Sélectionnez l'activité.
Créer, sélectionner ou éditer un noeud final de base de données
- Cliquez sur la tâche Sélectionner le noeud final dans la liste de contrôle et sélectionnez l'une des actions suivantes :
- Sélectionnez un noeud final existant :
- Sélectionnez Parcourir. L'explorateur de projets apparaît.
- Sélectionnez un noeud final existant et cliquez sur OK. Passez à la procédure "Configurer l'activité".
- Sélectionnez un noeud final existant et éditez le noeud final :
- Sélectionnez Parcourir. L'explorateur de projets apparaît.
- Sélectionnez un noeud final existant et cliquez sur OK.
- Cliquez sur Editer. Le panneau Editer un noeud final apparaît.
- Créez un noeud final : sélectionnez Nouveau. Le panneau Créer un noeud final apparaît.
- Sélectionnez un noeud final existant :
- Créez ou éditez un noeud final HTTP, voir Création ou édition d'un noeud final HTTP.
Sélectionner les colonnes dans la table de base de données source dans laquelle le dispositif d'intégration recherche les modifications en phase d'exécution
- Cliquez sur Sélectionner la table dans la Liste de contrôle. Le panneau Sélectionner la table apparaît.
- Cliquez sur Parcourir... pour sélectionner la table de base de données qui doit être la source des message entrants. La boîte de dialogue Parcourir les tables de base de données apparaît.
- Sélectionnez une table dans la liste et cliquez sur OK. Les informations de colonne de la table sélectionnée sont affichées dans le panneau Sélectionner la table.
- Si le codage de caractère de cette table est différent du codage de la base de données, entrez un autre codage à l'aide de l'une des options suivantes :
- Dans la liste Codage, sélectionnez l'un des types de codage par défaut.
- Entrez le type de codage directement en cliquant dans la zone Codage et en saisissant le type de codage.
Remarque : Certains caractères codés sur deux octets ne sont pas convertis à l'aide du codage SHIFT-JIS. Pour plus d'informations, voir Utilisation du codage Shift-JIS. - Par défaut, toutes les colonnes de la table source sont sélectionnées. Désélectionnez la case Utiliser pour supprimer une colonne de la table tampon obtenue. Cliquez sur Tout utiliser pour resélectionner toutes les colonnes.
- Cliquez dans l'en-tête de la colonne pour trier les lignes par valeur de colonne. Par exemple, pour trier les lignes par nom de colonne, cliquez dans l'en-tête Nom de colonne. Une flèche apparaît à droite du nom de l'en-tête de colonne. Une flèche vers le haut indique que la colonne est triée par ordre alphabétique, de a à z. Une flèche vers le bas indique que la colonne est triée par ordre alphabétique inversé, de z à a. Cliquez sur la flèche pour inverser l'ordre alphabétique.
- Pour l'activité Obtenir lignes mises à jour uniquement - Si vous souhaitez que la table tampon obtenue contienne à la fois les nouvelles valeurs et les valeurs initiales des colonnes mises à jour, procédez comme suit :
- Cliquez sur Anciennes valeurs. La boîte de dialogue Colonnes d'anciennes valeurs pour les mises à jour apparaît.
- Cochez la case Stocker pour les colonnes de base de données dont vous souhaitez sauvegarder les valeurs initiales.
- Vous pouvez modifier les noms par défaut attribués aux colonnes pour stocker les valeurs d'origine. Cliquez deux fois sur la cellule Nom de colonne pour stocker les anciennes valeurs appropriée.
- Cliquez sur OK.Les colonnes sélectionnées sont affichées dans la zone Depuis l'activité du panneau Mapper les sorties, préfixées par la chaîne : old_. Vous pouvez mapper les valeurs nouvelles et initiales dans le panneau Mapper les sorties.
Remarque : Pour plus d'informations, voir Définition de colonnes pour anciennes valeurs dans des mises à jour. - Si nécessaire, modifiez les valeurs des paramètres Type de données, Codage ou NULL admis. Cliquez sur la zone pour effectuer une nouvelle sélection.
- Type de données - Par défaut, type de données de la colonne dans la table de base de données source. Si le type de données requis pour la colonne de la table tampon est différent du type de données de la table source, sélectionnez un type de données différent en cliquant dans la cellule Type de données et en sélectionnant un autre type de données dans la liste.
Vous devez sélectionner un type de données approprié pour les types de données identifiés UNSUPPORTEDRemarque : Pour le type de données XMLTYPE dans une base de données Oracle et les types de données MONEY dans une base de données SQL Server, Studio n'associe pas automatiquement le type de données correct, vous devez donc sélectionner manuellement le type de données approprié.Avertissement : Vous devez sélectionner un type de données compatible avec le type de données source pour éviter les données invalides en phase d'exécution. Par exemple, ne sélectionnez pas le type de données SMALLINT pour la table tampon si le type de données source est INTEGER car, pendant l'exécution, un nombre élevé stocké dans une colonne INTEGER n'est pas converti correctement en type de données SMALLINT.
- Taille - Taille de la colonne définie dans la table. Cette taille est extraite de la table de base de données et n'est pas configurable.
- Codage - Par défaut, codage par défaut en cours, défini au niveau de la base de données ou de la table. Si le codage requis pour la colonne est différent du codage par défaut en cours, sélectionnez un codage différent en cliquant dans la cellule Codage et en sélectionnant un autre Codage dans la liste.
- NULL admis - Par défaut, paramètre NULL admis de la colonne dans la table de base de données source. La case Utiliser doit être sélectionnée pour les colonnes où nullable=false. Une colonne marquée nullable=false ne peut pas contenir de caractère NULL en phase d'exécution.
- Type de données - Par défaut, type de données de la colonne dans la table de base de données source. Si le type de données requis pour la colonne de la table tampon est différent du type de données de la table source, sélectionnez un type de données différent en cliquant dans la cellule Type de données et en sélectionnant un autre type de données dans la liste.
Vous devez sélectionner un type de données approprié pour les types de données identifiés UNSUPPORTED
- Cliquez sur Réinitialiser pour réinitialiser toutes les propriétés de colonne à leurs valeurs par défaut. Cette action réinitialise également la case Utiliser pour toutes les colonnes.
- Cliquez sur Régénérer pour mettre à jour la liste des colonnes, en référence au dernier état de la base de données source. Les modifications récentes de la source sont mises à jour dans ce panneau.
- Configurez les Spécification de règles de distribution pour les activités de base de données.Remarque : Si vous sélectionnez l'option Une fois exactement dans la tâche Règles de distribution, vous devez créer des tables de contrôle qui sont utilisées par le dispositif d'intégration en phase d'exécution. Vous créez les tables de contrôle près avoir publié l'orchestration depuis Studio vers le dispositif d'intégration. Vous créez les tables de contrôle à l'aide de la console de gestion Web avant de déployer le projet.Remarque : Si vous sélectionnez l'option Une fois exactement, vous devez activer la persistance. Pour plus d'informations, voir Activation de la persistance.
- Configurez les options de nouvelle tentative. Pour plus d'informations, voir Options de nouvelle tentative pour les activités de base de données entrantes.
Mappez la sortie de l'activité
- Sélectionnez la tâche Mapper les sorties dans la Liste de contrôle.
Les paramètres de sortie de l'activité sont affichés sous l'élément rows dans le panneau Depuis l'activité. Les paramètres de sortie affichés dans le panneau Depuis l'activité correspondent aux colonnes que vous avez sélectionnées dans la tâche Sélectionner la table. Si l'option Par lots a été sélectionnée dans Règles de distribution, le symbole d'occurrences multiples apparaît en regard de l'élément row.
Remarque : Pour l'activité Obtenir lignes mises à jour uniquement - Si des colonnes ont été sélectionnées dans la boîte de dialogue Colonnes d'anciennes valeurs pour les mises à jour (dans la tâche Sélectionner la table), ces paramètres de sortie supplémentaires (précédés par défaut de la chaîne old_) apparaissent également sous l'élément rows.Vous devez mapper toutes les colonnes d'anciennes valeurs, visibles dans le panneau Mapper les sorties. - Mappez les paramètres de sortie obligatoires sur des variables. Voir Création d'une mappe pour des instructions générales sur le mappage. Il n'est pas obligatoire de mapper les paramètres de sortie pour cette activité. Remarque : Après avoir publié votre orchestration avec une activité de base de données entrante dans le dispositif d'intégration, vous devez créer la table tampon à l'aide de la console de gestion Web avant le déploiement de l'orchestration.