Configuration de l'étape Excel en tant que cibleDataStage)
Vous pouvez configurer l'étape Excel pour qu'elle génère un fichier Microsoft Excel. Chaque lien d'entrée de l'étape Excel est associé à une feuille Microsoft Excel distincte. Les feuilles Microsoft Excel sont nommées et associées aux liens d'entrée qui sont Sheet1, Sheet2, Sheet3, etc. Chaque colonne du lien d'entrée est mise en correspondance avec une colonne de Microsoft Excel.
L'étape Excel ne prend en charge que le format OOXML (.xlsx) des fichiers Microsoft Excel en tant que fichier cible.
L'étape Excel prend en charge la propagation des colonnes d'exécution (fonction RCP). Lorsque la propagation des colonnes au moment de l'exécution est activée sur un lien de sortie d'une étape en amont, les colonnes propagées supplémentaires sont ajoutées après les colonnes définies dans l'étape Excel.
L'étape Excel ne prend pas en charge la génération de fichiers .xls ou de fichiers chiffrés par mot de passe.
- Pour configurer l'étape Excel en tant que cible :
- Dans le canevas parallèle, double-cliquez sur l'étape Excel et ouvrez la section Propriétés du volet de détails.
- Dans la liste Mode d'écriture, sélectionnez Créer un fichier.
- Dans la section Fichier de sortie, spécifiez les paramètres suivants :
- Facultatif : Sélectionnez Créer une ressource de données pour créer un fichier en tant que ressource de données à la fin de l'exécution du travail. Le nouvel actif de données apparaît dans la liste des actifs de données de l'onglet Actifs de votre projet.
- Facultatif : Spécifiez la méthode d'écriture. Si vous sélectionnez Générer plusieurs fichiers, l'étape Excel crée plusieurs fichiers Microsoft Excel en fonction de paramètres supplémentaires. Si vous sélectionnez Fichier spécifique, l'étape Excel crée un fichier Microsoft Excel portant le nom spécifié dans la propriété Nom du fichier.
- Dans le champ Nom du fichier, indiquez le chemin d'accès complet du fichier Microsoft Excel dans lequel vous souhaitez écrire les données. Utilisez le nom du chemin /ds-storage/PXRuntime/Projects/<projectid>/<filename>.
- Facultatif : Spécifiez le mode Mise à jour des fichiers. Si vous sélectionnez Créer (Erreur si existant), l'exécution de votre tâche échoue si le fichier Microsoft Excel cible existe déjà. Si vous sélectionnez Écraser, l'étape Excel écrase le fichier existant.
- Dans la section Propriétés, spécifiez les éléments suivants :
- Facultatif : Sélectionnez Adjuster la largeur de la colonne. Si vous choisissez Oui, l'étape Excel ajuste la largeur de chaque colonne de la feuille Microsoft Excel générée pour qu'elle corresponde au contenu de la colonne.
- Cliquez sur Sauvegarder.
Écriture de données dans plusieurs fichiers Excel
Vous pouvez utiliser l'étape Excel pour écrire des données dans plusieurs fichiers Microsoft Excel lorsque vous disposez d'une grande quantité de données.
Le nombre maximum d'enregistrements pris en charge par le format OOXML de Microsoft Excel (.xlsx) est de 1 048 576. Lorsque les liens d'entrée comportent plus de 1 048 576 enregistrements, vous devez diviser les enregistrements en plusieurs fichiers Microsoft Excel. Même si les liens n'ont pas plus de 1 048 576 enregistrements, vous pouvez les écrire dans plusieurs fichiers Microsoft Excel car l'ouverture d'un fichier Microsoft Excel volumineux nécessite une grande quantité de mémoire.
- Pour écrire des données dans plusieurs fichiers Excel :
- Sur le canevas parallèle, cliquez deux fois sur l'étape Excel.
- Dans la liste Mode d'écriture, sélectionnez Créer un fichier.
- Dans la section Fichier de sortie, indiquez ce qui suit :
- Dans la méthode d'écriture, sélectionnez Générer plusieurs fichiers. L'étape Excel crée plusieurs fichiers Microsoft Excel dans l'emplacement spécifié à la zone Nom de fichier.
- Dans la zone Nom de fichier, indiquez l'emplacement où vous souhaitez créer plusieurs fichiers Microsoft Excel.
Vous pouvez spécifier le préfixe des noms de fichiers suivant l'emplacement du fichier. Par exemple, si vous souhaitez créer des fichiers Microsoft Excel à l'adresse C:\tmp et utiliser Sample comme préfixe des noms de fichier, indiquez C:\tmp\Sample dans la zone Nom de fichier. L'étape Excel ajoute un numéro séquentiel à trois chiffres et une extension de fichier (.xlsx) au préfixe. Si le nombre de fichiers dépasse 999, le nom de fichier contient le nombre de chiffres requis.
- Facultatif : Spécifiez le mode Mise à jour des fichiers. Si vous sélectionnez Créer (Erreur si existant), l'exécution de votre tâche échoue si le fichier Microsoft Excel cible existe déjà. Si vous sélectionnez Remplacer, paramètre par défaut, l'étape Excel écrase le fichier existant.
- Dans la section Propriétés, spécifiez les éléments suivants :
- Indiquez le Nombre maximal de lignes dans une feuille. La valeur par défaut est 65536. Ce nombre inclut une ligne de nom de colonne lorsque vous sélectionnez Noms de colonne dans la liste En-tête de colonne.
- Cliquez sur OK.
Écrire des données dans un fichier Excel existant
Vous pouvez utiliser l'étape Excel pour concevoir des tâches qui écrivent des données dans un fichier Microsoft Excel existant ou qui copient un fichier Excel et écrivent des données dans la copie. Un fichier Microsoft Excel peut être mis à jour par une étape Excel à la fois. Vous ne pouvez avoir qu'une seule étape Excel qui mette à jour le même fichier Microsoft Excel dans un travail.
Lorsque l'étape Excel écrit des données dans un fichier Microsoft Excel existant, l'étape écrit uniquement les données de cellule. Si une cellule Microsoft Excel dans laquelle l'étape écrit a un format quelconque, l'étape conserve le format existant. Si le fichier Microsoft Excel contient une formule ou un graphique qui fait référence à des cellules écrites par l'étape Excel, la formule ou le graphique est recalculé lorsqu'il est ouvert par Microsoft Excel.
Vous pouvez écrire dans des colonnes Microsoft Excel à partir de n'importe quelle DataStage®. Les noms et l'ordre des colonnes de DataStage et des colonnes de Microsoft Excel ne doivent pas nécessairement correspondre. Si la feuille Microsoft Excel comporte un en-tête sur la première ligne, vous pouvez configurer l'étape Excel pour que les valeurs de la première ligne soient utilisées pour déterminer la colonne dans laquelle les enregistrements sont écrits. Vous pouvez écrire jusqu'à 1 048 576 lignes d'une feuille Microsoft Excel. Les colonnes sources de DataStage doivent être définies au moment de la conception.
- Pour écrire des données dans un fichier existant :
- Sur le canevas, cliquez deux fois sur l'étape Excel.
- Dans l'onglet Entrée, sélectionnez le lien d'entrée dans la zone Nom d'entrée.
- Dans l'onglet Étape, dans la liste Mode d'écriture, sélectionnez Modifier un fichier existant
- Spécifiez les détails du fichier cible dans lequel écrire les données.
- Dans la section Fichier de sortie, sélectionnez Créer un actif de données pour créer un actif et l'ajouter automatiquement à l'onglet Assets.
- Dans la zone Nom de fichier, indiquez le nom du fichier dans lequel écrire les données.
- Si vous mettez à jour plus de 32 colonnes dans la feuille Microsoft Excel, indiquez le numéro de la colonne dans le champ Nombre de colonnes à charger.
- Si vous sélectionnez Première ligne est l'en-tête dans la Section des propriétés, entrez une valeur dans le champ Débuter l'écriture à partir de cette ligne.
Une valeur doit être supérieure ou égale à 2 ou supérieure ou égale à 1.
- Cliquez sur Editer dans la section Mappe, puis sur Importer des colonnes.
- Spécifiez les détails Microsoft Excel à importer dans la page Importation.
- Dans la liste Feuille, sélectionnez la feuille Microsoft Excel à mettre à jour.
- Dans la liste des colonnes, sélectionnez les colonnes Microsoft Excel à mettre à jour.
- Cliquez sur Import.
- Mettez en correspondance les colonnes importées de Microsoft Excel avec les DataStage colonnes définies dans le lien d'entrée. Sélectionnez une colonne pour écrire les données.
- Répétez les étapes pour la section Propriétés et le mappage de tous les liens d'entrée.
- Cliquez sur Sauvegarder.