Activités de base de données sortantes dans une table unique

La présente section contient les procédures de configuration des activités de base de données sortantes de table unique suivantes.

Ces activités incluent :
  • Insérez lignes - Cette activité extrait les données d'une ou de plusieurs variables qui sont mappées sur les paramètres d'entrée de l'activité et insère ces données en tant que lignes dans la table de base de données spécifiée.
  • Mettre à jour lignes - Cette activité extrait les données d'une ou de plusieurs variables qui sont mappées sur les paramètres d'entrée de l'activité et met à jour les lignes dans la table de base de données spécifiée avec ces nouvelles données.
  • Supprimer lignes - Cette activité extrait les données d'une ou de plusieurs variables qui sont mappées sur les paramètres d'entrée de l'activité et supprimer les lignes dans la table de base de données spécifiée, en fonction de ces données.
Pour les activités Mettre à jour lignes et Supprimer lignes, le dispositif d'intégration intègre la table de base de données afin de déterminer quelles colonnes de la table sont des colonnes de clé primaire. A l'exécution, lorsque les activités Mettre à jour lignes ou Supprimer lignes sont démarrées, le dispositif d'intégration utilise la valeur de la variable entrante qui contient le numéro de la clé primaire afin de déterminer les lignes à mettre à jour ou à supprimer.
Par exemple, la colonne PK est définie dans la base de données comme étant une colonne de clé primaire pour la table de base de données. La case Utiliser est cochée pour la colonne PK dans la tâche Sélectionner la table de la Liste de contrôle pour l'activité Supprimer lignes. Dans le panneau Mapper les entrées de l'activité Supprimer lignes, la variable appelée myIncomingPK est mappée sur l'élément PK de la ligne, comme illustré dans la Figure 1 :
Figure 1. La variable myIncomingPK est mappée sur l'élément PK de la ligne
A l'exécution, si la valeur de la variable myIncomingPK est égale à 3, la ligne contenant PK égale à 3 est supprimée de la table, comme illustré dans la Figure 2 :
Figure 2. La ligne contenant la clé primaire égale à 3 est supprimée
Si aucune colonne de clé primaire n'est spécifiée dans la tâche Sélectionner la table de la Liste de contrôle, spécifiez au moins une colonne pour jouer le rôle de clé primaire. Indiquez la ou les colonnes de clé primaire actives dans la boîte de dialogue Configurer les clés primaires que vous pouvez ouvrir en cliquant sur Clés dans la tâche Sélectionner la table de la Liste de contrôle pour les activités Supprimer lignes et Mettre à jour lignes. Si aucune clé primaire n'est indiquée dans la table de base de données ou sélectionnée en tant que clé primaire active dans la boîte de dialogue Configurer les clés primaires, toutes les lignes de la table de base de données sont affectées par l'opération de suppression ou de mise à jour.

Vous pouvez également utiliser la boîte de dialogue Configurer les clés primaires pour spécifier des colonnes supplémentaires qui agissent en tant que colonnes de clé primaire. Par exemple, pour la table de la figure précédente, vous pouvez définir que la colonne Nom doit jouer le rôle d'une colonne de clé primaire, outre la colonne primaire PK qui a été définie dans la base de données, comme étant une colonne de clé primaire.

Ajouter une activité de base de données sortante de table unique à l'orchestration

  1. Créez ou ouvrez une orchestration. Une représentation graphique de l'orchestration s'affiche.
  2. Sélectionnez l'onglet Activités et développez le dossier Base de données.
  3. Déplacez l'activité de base de données sortante de table unique souhaitée (Insérer lignes, Supprimer lignes ou Mettre à jour lignes) dans l'orchestration.
  4. Sélectionnez l'activité.

Créer, sélectionner ou éditer un noeud final de base de données

  1. 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 :
      1. Sélectionnez Parcourir. L'explorateur de projets apparaît.
      2. 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 :
      1. Sélectionnez Parcourir. L'explorateur de projets apparaît.
      2. Sélectionnez un noeud final existant et cliquez sur OK.
      3. 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.
  2. 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

  1. Cliquez sur Sélectionner la table dans la Liste de contrôle. Le panneau Sélectionner la table apparaît.
  2. 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.
  3. 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.
  4. 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.
    Cette action définit le codage de toutes les colonnes de la table tampon obtenue.
    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.
  5. 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.
  6. 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.
  7. 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 :
    1. Cliquez sur Anciennes valeurs. La boîte de dialogue Colonnes d'anciennes valeurs pour les mises à jour apparaît.
    2. Cochez la case Stocker pour les colonnes de base de données dont vous souhaitez sauvegarder les valeurs initiales.
    3. 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.
    4. 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.
  8. 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 UNSUPPORTED
      Remarque : 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.
  9. 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.
  10. 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.
  11. 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.
  12. 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.

Spécifiez la table de base de données cible pour l'activité

  1. Cliquez sur Sélectionner la table dans la Liste de contrôle. Le panneau Sélectionner la table apparaît.
  2. Cliquez sur Parcourir... pour sélectionner la table de base de données cible. La boîte de dialogue Parcourir les tables de base de données apparaît.
  3. 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.
  4. 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.
    Cette action définit le codage de toutes les colonnes de la table tampon obtenue.
    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.
  5. 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. Si une colonne n'est pas sélectionnée, elle n'apparaît pas dans le panneau Mapper les entrées et n'est pas mise à jour pendant l'exécution. Cliquez sur Tout utiliser pour resélectionner toutes les colonnes.
  6. 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.
  7. 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 UNSUPPORTED
      Remarque : 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.
  8. 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.
  9. 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.
  10. Pour l'activité Mettre à jour lignes uniquement - Cochez la case Insérez une ligne si elle n'existe pas déjà. si, à l'exécution, vous souhaitez que l'activité Mettre à jour lignes tente d'abord de mettre à jour la ligne spécifiée mais, si la ligne n'existe pas, tente de l'insérer dans la table de base de données.
  11. Pour l'activité Mettre à jour lignes uniquement - Si vous souhaitez sauvegarder les nouvelles valeurs et les valeurs initiales dans la base de données, procédez comme suit :
    1. Cliquez sur Anciennes valeurs. La boîte de dialogue Colonnes d'anciennes valeurs pour les mises à jour apparaît.
    2. Cochez la case Stocker pour les colonnes de base de données dont vous souhaitez sauvegarder les valeurs initiales.
    3. Vous pouvez changer les noms par défaut attribués aux colonnes qui servent à stocker les valeurs d'origine à l'exécution. Cliquez deux fois sur la cellule Nom de colonne pour stocker l'ancienne valeur appropriée.
    4. Cliquez sur OK.Les colonnes sélectionnées sont affichées dans la zone Vers 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.
  12. Pour les activités Mettre à jour lignes ou Supprimer lignes uniquement - Pour spécifier des colonnes de clé primaire actives en plus des colonnes de clé primaire déjà définies par la base de données, procédez comme suit :
    1. Cliquez sur Clés. La boîte de dialogue Configurer les clés primaires apparaît.
    2. Pour spécifier une colonne en tant que colonne de clé primaire active, cliquez sur la colonne, puis sur >>.
    3. Cliquez sur OK.
    Remarque : Si aucune colonne de clé primaire (telle qu'elle est définie par la base de données) n'est spécifiée dans la tâche Sélectionner la table de la Liste de contrôle, spécifiez au moins une colonne qui tienne lieu de colonne de clé primaire active.
    Répétez cette étape pour spécifier d'autres colonnes de clé primaire actives.
  13. 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.
  14. Configurez les options de nouvelle tentative. Pour plus d'informations, voir Options de nouvelle tentative pour les activités de base de données sortantes.

Mappez l'entrée de l'activité

  1. Sélectionnez la tâche Mapper les entrées dans la Liste de contrôle.
    Les paramètres d'entrée de l'activité sont affichés sous l'élément row dans le panneau Vers l'activité. Les paramètres d'entrée 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 la case Traiter par lots plusieurs lignes par message a été cochée dans les Règles de distribution, le symbole d'occurrences multiples apparaît en regard de l'élément de ligne.
    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.
  2. Mappez tous les paramètres d'entrée. Voir Création d'une mappe pour des instructions générales sur le mappage. Vous devez mapper tous les paramètres d'entrée de l'activité.

Mappez la sortie de l'activité

  1. Sélectionnez la tâche Mapper les sorties dans la Liste de contrôle.
    La case Obtenir le nombre de lignes détermine les éléments affichés dans le panneau Mapper les sorties :
    • Si la case Obtenir le nombre de lignes est désélectionnée dans les Règles de distribution, le panneau Mapper les sorties est vide.
    • Si la case Obtenir le nombre de lignes est sélectionnée dans les Règles de distribution, le panneau Mapper les sorties affiche l'élément rowCount.Si la case Traiter par lots plusieurs lignes par message est cochée dans les Règles de distribution, le symbole d'occurrences multiples apparaît en regard de l'élément rowCount.
  2. Si le paramètre de sortie RowCount apparaît, mappez le paramètre de sortie RowCount si vous le souhaitez. Voir Création d'une mappe pour des instructions générales sur le mappage. Il n'est pas obligatoire de mapper les paramètre de sortie pour cette activité.