Skip to main content

Outil Union

Utilisez l'outil Union pour combiner 2 jeux de données ou plus, en se basant sur les noms ou les positions des colonnes.

Dans la sortie, chaque colonne contient les lignes de chaque entrée. Vous pouvez configurer la façon dont les colonnes s'empilent ou se rejoignent dans la sortie.

Astuce

Cet outil dispose d'un exemple d'outil unique. Consultez la page Accéder aux exemples de workflows pour savoir comment accéder à cet exemple et à de nombreux autres exemples directement dans Designer Cloud.

Composants de l'outil

Union tool anchors.png

Figure : Outil Union avec 2 ancrages.

L'outil Union dispose de 2 ancrages :

  • Ancrage d'entrée : l'ancrage d'entrée se connecte aux flux de données que vous souhaitez unifier. Les 2 crochets pointus sur l'ancrage d'entrée indiquent qu'il accepte plusieurs entrées.

  • Ancrage de sortie : l'ancrage de sortie affiche le jeu de données de sortie.

Configuration de l'outil

Empiler les colonnes verticalement en utilisant : sélectionnez la façon d'empiler les colonnes. Le paramètre par défaut est configuration automatique par nom de colonne.

  • Nom : empilez les données par nom de colonne.

  • Position : empilez les données par ordre de colonne dans le flux.

  • Configuration manuelle : vous permet de spécifier manuellement la façon d'empiler les données. Lorsque vous choisissez cette méthode, les colonnes de chaque entrée sont affichées (indiquées par ligne n°1, n°2, etc.). Vous pouvez réinitialiser une table par position ou par nom.

Avertissement

Lorsque le mode est défini sur Configuration manuelle, Designer Cloud suppose que la configuration ne change pas entre la configuration de l'outil et le moment de l'exécution du workflow. S'il manque quelque chose, une erreur se produit et le workflow s'arrête.

Configuration manuelle des champs

Pour la méthode Configuration manuelle, vous devez configurer vos propriétés de sortie.

Pour commencer, vos flux de données sont décalés horizontalement et verticalement de sorte que les données de chaque jeu de données d'entrée sont dans des cellules différentes.

  1. (Facultatif) Dans le menu déroulant Réinitialiser, vous pouvez commencer par sélectionner Par position ou Par nom. Sélectionnez Réinitialiser pour réinitialiser les colonnes. Utilisez cette option si vous savez que vos flux de données ont des colonnes qui correspondent par position ou nom.

  2. Ensuite, utilisez les flèches pour commencer à empiler vos données. Sélectionnez une cellule et utilisez la flèche gauche ou la flèche droite pour l'empiler avec le champ de données auquel elle correspond.

Propriétés

Lorsque les colonnes diffèrent

Pour les modes d'auto-configuration, vous devez sélectionner la façon de gérer les colonnes qui diffèrent.

  • Avertissement (Continuer le traitement des données) : émettre un avertissement dans la grille de résultats, mais continuer le traitement des lignes.

  • Erreur (Arrêter le traitement des données) : émettre une erreur dans la grille de résultats et arrêter le traitement des enregistrements.

  • Ignorer (Continuer le traitement des données) : ignorer les colonnes qui diffèrent et continuer le traitement des lignes.

Options de sortie de colonnes

  • Sortir toutes les colonnes : la sortie inclut toutes les colonnes. Des valeurs nulles remplissent les colonnes vides.

  • Sortir uniquement les colonnes communes : la sortie n'inclut que les colonnes que chaque entrée a en commun.

Ordre de sortie

Sous Ordre de sortie, cochez Spécifier pour préciser les données du jeu de données d'entrée qui s'affichent en premier dans la sortie. Une fois cette case cochée, sélectionnez et maintenez l'icône de réorganisation dans la table et faites glisser la connexion vers le haut ou vers le bas.

Avertissement

L'option Spécifier l'ordre de sortie peut entraîner un ralentissement.

Comprendre la sortie

Deux aspects de la sortie de l'outil Union sont importants à comprendre : les noms des colonnes et l'ordre des données.

Comprendre les noms des colonnes des données de sortie

Les noms de colonne utilisés dans le jeu de données de sortie sont extraits du flux d'entrée avec la première valeur alphabétique.

Par défaut, vos flux d'entrée de données sont étiquetés #1 et #2 en fonction de l'ordre dans lequel vous les avez connectés à l'ancrage d'entrée de l'outil Union. Ainsi, si les noms de colonnes diffèrent, le jeu de données de sortie utilise les noms de colonnes du jeu de données d'entrée #1.

Si vous préférez utiliser les noms de colonnes du jeu de données d'entrée #2, modifiez le nom des connexions d'entrée. Sélectionnez les flux d'entrée et entrez de nouvelles valeurs. Les noms des colonnes de sortie sont issus de la connexion avec la première valeur alphabétique/numérique dans son nom.

union-change-connection-name.png

Figure : Modification de la source d'entrée pour les noms des colonnes de sortie.

Comprendre l’ordre des données de sortie

L'ordre de sortie par défaut correspond à l'ordre dans lequel vous avez connecté vos jeux de données d'entrée à l'ancrage d'entrée de l'outil Union. Accédez à la section Ordre de sortie pour savoir comment modifier l'ordre de votre sortie de données.