Chargement des données à l'aide de la connexion directe

Remarque :

L'option Télécharger des données à l'aide d'une connexion directe (Upload data using direct connection) est disponible pour les modèles d'application spécifiques aux processus qui utilisent un système source ServiceNow ou un système source Salesforce. L'option Télécharger des données à l'aide d'une connexion directe (Upload data using direct connection) est également disponible pour les modèles d'application génériques Journal des événements (Event log) et Processus personnalisé (Custom Process), si vous souhaitez configurer une connexion directe à ServiceNow ou Salesforce.

Remarque :

L'option Télécharger des données à l'aide d'une connexion directe ( Upload data using direct connection ) est l'option par défaut pour les modèles d'application qui utilisent un système source pour lequel une connexion directe est disponible.

Prérequis

Charger des données en utilisant une connexion directe utilise les connexions Integration Service . Cela implique que vous devez avoir :

• une licence pour Integration Service;

• Integration Service activé sur votre locataire ;

• accès à Orchestrator et aux dossiers Orchestrator.

Les connexions Integration Service sont limitées par dossier. Si vous souhaitez utiliser une connexion à partir d'un dossier spécifique, vous devez avoir accès à ce dossier dans Orchestrator pour le voir dans Process Mining. Si vous créez une nouvelle connexion à partir de Process Mining, cette connexion est créée dans vos espaces de travail personnels dans Orchestrator.

Reportez-vous au guide Integration Service pour plus d'informations sur les licences Integration Service et les connexions Integration Service.

Configuration d'une connexion directe

Vous pouvez configurer à l'aide d'une connexion directe à votre système source à partir de l' étape Sélectionner la source de données au lieu de configurer une connexion à l'aide de CData Sync.

L'option Télécharger des données à l'aide d'une connexion directe ( Upload data using direct connection ) charge les données dans votre application de processus directement depuis le système source.

Suivez ces étapes pour configurer une connexion directe au système source :

1. Sélectionnez l'option Télécharger des données en utilisant une connexion directe (Upload data using direct connection ).

   Système source utilisé pour le modèle d'application affiché.

2. Sélectionnez Se connecter (Connect).

   Un nouvel onglet de navigateur s'ouvre, dans lequel vous pouvez saisir les détails d'authentification pour la connexion.

Attention :

Si vous utilisez un modèle d'application spécifique à un processus, assurez-vous que les informations d'identification de l'utilisateur ont accès à la liste par défaut des tables et des champs spécifiés dans le modèle d'application. Reportez-vous aux Modèles d'applications pour plus de détails.

Mappage des tables d'entrée

1. Une table est ajoutée dans la section Tables sources pour chaque table extraite et est automatiquement mappée à la table d'entrée correspondante dans la section Tables cibles .

2. Assurez-vous que chaque table est mappée sur la table cible correcte. Si nécessaire, sélectionnez une table différente dans la liste Tables cibles (Target tables) pour corriger le mappage.

3. Sélectionnez Suivant.

Si vous téléchargez une table qui n'est pas répertoriée comme une table requise, une nouvelle table est automatiquement ajoutée dans la section Tables sources pour chaque fichier téléchargé et une table d'entrée correspondante est créée dans la section Tables cibles . Par défaut, le nom de fichier du fichier téléchargé est utilisé comme nom des tables.

Remarque : un message d'avertissement s'affiche indiquant que la table doit être configurée avant que les données puissent être téléchargées pour la table. Lorsqu'une nouvelle table est téléchargée, elle devient disponible dans les transformations de données. D'autres étapes sont cependant nécessaires pour que ces données soient visibles sur les tableaux de bord. Tout d'abord, les données de la table doivent être chargées à l'aide d'une requête SQL. Ensuite, la table doit être intégrée au modèle de données de l'application de processus. Reportez-vous à Modèles de données pour plus d'informations sur l'ajout d'une table dans le modèle de données.

Configuration des tables d'entrée

Les paramètres de la table d'entrée cible sont automatiquement détectés et il vous suffit de les vérifier.

Suivez ces étapes pour modifier les paramètres d'une table d'entrée.

1. Localisez la table que vous souhaitez configurer et sélectionnez l'icône Modifier la table pour ouvrir le panneau Modifier la table pour la table sélectionnée.
2. Modifiez les paramètres comme vous le souhaitez et sélectionnez Enregistrer (Save).

Le tableau suivant décrit les paramètres de la table.

Paramètre	Description
Nom de la table	Le nom de la table d'entrée dans les transformations de données.
Obligatoire	Option pour définir la table comme obligatoire. Si TRUE, la table sera requise ultérieurement lors de la publication ou de l'importation de l'application de processus. Si la table n'est pas téléchargée, une erreur est générée. Si FALSE, la table est considérée comme Facultatif (Optional), lors de la publication ou de l'importation de l'application. Si la table n'est pas téléchargée, une table vide sera créée de sorte que les requêtes SQL ultérieures n'échoueront pas.
Détection automatique	Vous permet d’identifier les types de champ dans le fichier d’entrée et d’appliquer automatiquement les types de champ détectés aux champs correspondants dans le tableau cible.
Encodage	L'encodage utilisé dans le fichier.
Délimiteur	Le délimiteur séparant les différents champs.
FinLigne	Le caractère utilisé pour indiquer la fin d'une ligne et le début d'une nouvelle.
Guillemet	Le guillemet utilisé dans le cas où les champs sont encapsulés entre guillemets.
Caractère d’échappement	Le caractère d’échappement utilisé pour interpréter correctement les caractères qui seraient sinon traités comme des caractères de contrôle spéciaux ( tels que des guillemets ou des délimiteurs). Remarque : par défaut, le caractère de guillemet sélectionné est utilisé comme caractère d'échappement. Vous pouvez également sélectionner la barre oblique inverse (\) comme caractère d’échappement.
Type de charge	Le type de charge de la table. Remarque : si vous sélectionnez Incrémental comme type de charge, vous devez spécifier des paramètres supplémentaires afin de configurer le chargement incrémentiel pour la table.

Charge de données incrémentielle

Avec une charge complète, toutes les données sont extraites de la source et chargées dans le système cible, que les données aient changé ou soient restées les mêmes depuis le dernier chargement. Une charge incrémentielle extrait uniquement les données qui ont changé (ajoutées ou mises à jour) depuis le dernier chargement. Une charge incrémentielle est généralement plus rapide et moins gourmande en ressources qu'une charge complète, surtout lorsqu'il s'agit de grands volumes de données où seul un petit sous-ensemble peut changer fréquemment.

Pour activer le chargement de données incrémentiel pour une table, vous devez définir le type de chargement de la table sur Incrémental. La charge incrémentielle nécessite un identifiant unique pour garantir que les données sont chargées correctement, et un champ (comme un horodatage ou une version) pour suivre les modifications dans les données sources.

Le tableau suivant décrit les paramètres supplémentaires requis pour la charge incrémentielle .

Paramètre	Description
Clés primaires	Le ou les champs de clé primaire ou les champs qui identifient de manière unique chaque enregistrement dans la source de données.
Champ Horodatage	Le champ utilisé pour suivre la dernière mise à jour ou ajout de chaque enregistrement.
Format d’horodatage	Le format de la valeur d'horodatage utilisée dans le champ Horodatage .

Important :

La méthode d'extraction utilisée pour charger les données peut nécessiter une configuration supplémentaire ou spécifique pour l'extraction incrémentielle.

Consultez Chargement des données à l'aide de CData Sync pour plus d'informations sur la configuration de l'extraction incrémentielle pour CData Sync.

Consultez la section Charger des données à l'aide de Theobald Xtract Universal pour plus d'informations sur la configuration de l'extraction incrémentielle pour Theobald Xtract Universal.

Consultez Charger des données en utilisant DataUploader pour plus d'informations sur la configuration de DataUploader pour une extraction incrémentielle.

Attention : Si vous basculez le type de charge sur Complète ( Full), assurez-vous de configurer la méthode d'extraction utilisée en conséquence.

Suppression d'un fichier source

Si vous avez sélectionné accidentellement un fichier source lors du téléchargement des données sources, vous pouvez le supprimer de l'écran Données d'entrée (Input data).

Remarque : un fichier source ne peut être supprimé que si aucune donnée n'a été téléchargée pour lui.

Suivez ces étapes pour supprimer un fichier source.

1. Localisez le fichier source que vous souhaitez supprimer dans la liste Tables sources .
2. Pointez votre souris sur la table et sélectionnez Supprimer le fichier.

Le fichier d’entrée a été supprimé.

Suppression d'une table d'entrée

Vous pouvez supprimer une table d'entrée que vous avez précédemment téléchargée directement à partir de la page des tables de mappage dans l'écran Données d'entrée. La suppression d'une table d'entrée supprimera les données de votre application de processus. Si vous souhaitez utiliser ultérieurement les données de votre application de processus, vous devez charger à nouveau la table d'entrée.

Important : la suppression d'une table peut entraîner l'échec des transformations de données.

Suivez les étapes suivantes pour supprimer une table.

1. Localisez la table que vous souhaitez supprimer et sélectionnez l'icône Supprimer la table. Un message de confirmation s’affiche.
2. Sélectionnez Supprimer (Delete).

Mappage des champs d'entrée

Remarque :

Pour la table sélectionnée, les champs d'entrée requis pour la table sont affichés dans la section Champs requis (Required Fields) de la page Champs (Fields) .

Les champs source détectés dans la table d’entrée sont automatiquement mappés aux champs correspondants dans la table cible.

1. Assurez-vous que chaque champ est mappé au champ cible approprié. Si nécessaire, sélectionnez un champ différent dans la liste Champs cibles (Target fields) pour corriger le mappage.

2. Sélectionnez Suivant (Next) pour continuer.

Configuration des champs d'entrée

Les paramètres des champs d'entrée cibles sont automatiquement détectés et il vous suffit de les vérifier.

Suivez ces étapes pour modifier les paramètres d'un champ d'entrée.

1. Localisez le champ que vous souhaitez configurer et sélectionnez l'icône Modifier le champ pour ouvrir le panneau Modifier le champ pour le champ sélectionné.
2. Modifiez les paramètres comme vous le souhaitez et sélectionnez Enregistrer (Save).

Le tableau suivant décrit les paramètres de la table.

Paramètre	Description
Nom	Le nom du champ. Remarque : le champ Nom est obligatoire.
Détection automatique	Permet d'identifier le type de champ dans le fichier d'entrée et d'appliquer automatiquement le type de champ détecté pour le champ de la table cible.
Saisie de texte	Le type de données du champ. Texte Entier Décimale Booléen Date DateTime Remarque : en fonction du type de champ, vous devez spécifier les paramètres d'analyse pour configurer le champ.
Obligatoire	Option pour définir le champ comme obligatoire. Si cette option est sélectionnée, le champ est requis lors de la publication ou de l'importation de l'application de processus. Une erreur est alors générée si le champ est manquant. S'il n'est pas sélectionné, le champ est considéré comme facultatif. Lorsqu'il est manquant, le champ sera ajouté avec des valeurs NULL, de sorte que les requêtes SQL ultérieures n'échoueront pas.
Unique	L'option permettant de définir la valeur du champ a une valeur distincte ou unique pour chaque enregistrement.
Non NULL	Option permettant de définir que le champ doit avoir une valeur pour chaque enregistrement. Le champ ne peut pas être laissé vide ou rempli avec une valeur NULL.

Paramètres d'analyse pour les types de champ

Le tableau suivant décrit les paramètres d'analyse disponibles pour les différents types de champs.

Type de champ	Paramètres d’analyse
Entier	Séparateur pour les milliers Aucun (None) Point (.) Virgule (,)
Décimale	Séparateur décimal Point (.) Virgule (,) Séparateur pour les milliers Aucun (None) Point (.) Virgule (,)
Booléen	Valeur Vrai : TRUE ou 1 Valeur False FALSE ou 0 Remarque : Valeur Vrai (True Value) et Valeur Faux (False Value) sont des paramètres obligatoires et doivent être différents.
Date	Format de date (consultez Exemple de paramètres d'analyse pour les formats de date).
DateTime	Format de date et heure Format de date (Date et heure des paramètres d'analyse pour les formats Datetime.)

Exemple de paramètres d'analyse pour les formats de date

Format	Exemple
yyyy-MM-dd	2025-04-05 2025-4-5
mm/jj/aa	04/05/25 4/5/25
mm/dd/yyyy	04/05/2025 4/5/2025
mm-jj-aaaa	04-05-2025 4-5-2025
jj-mm-aaaa	05-04-2025 5-4-2025
JJ/MM/AAAA	05/04/2025

Exemple de paramètres d'analyse pour les formats DateTime

Format	Exemple
aaaa-mm-jj hh:mm:ss[.nnn]	2025-04-05 14:30:45.123 2025-4-5 14:30:45.123
aaaa/mm/jj hh:mm:ss[.nnn]	2025/04/05 14:30:45.123 2025/4/5 14:30:45.123
mm/jj/aaaa hh:mm:ss[.nnn]	04/05/2025 14:30:45.123 4/5/2025 14:30:45.123 04/05/2025 14:30:45 4/5/2025 14:30:45
aaaa-mm-jjThh:mm:ss[.nnn]	2025-04-05T14:30:45.123 2025-4-5T14:30:45.123
mm-jj-aaaa hh:mm:ss[.nnn]	04-05-2025 14:30:45.123 4-5-2025 14:30:45.123 04-05-2025 14:30:45 4-5-2025 14:30:45
jj-mm-aaaa hh:mm:ss[.nnn]	05-04-2025 14:30:45.123 5-4-2025 14:30:45.123 05-04-2025 14:30:45 5-4-2025 14:30:45
aaaa-mm-jjThh:mm:ss[.nnn]+00:00*	2025-04-05T14:30:45.123+02:00 2025-04-05T14:30:45-03:00 2025-04-05T14:30:45 2025-4-5T14:30:45.123+02:00 2025-4-5T14:30:45-03:00 2025-4-5T14:30:45Z
aaaa-mm-jjThh:mm:ss[.nnn]+0000*	2025-04-05T09:30:00+0000 2025-04-05T09:30:00.123+0000
aaaa-mm-jj hh:mm:ss[.nnn]+00:00*	2025-04-05 09:30:00+00:00 2025-04-05 09:30:00.123+00:00
aaaa-mm-jj hh:mm:ss[.nnn]+0000*	2025-04-05 09:30:00+0000 2025-04-05 09:30:00.123+0000
jj/mm/aaaa hh:mm:ss[.nnn]	05/04/2025 14:30:45.123 5/4/2025 14:30:45.123
mm/jj/aa hh:mm:ss[.nnn] AM/PM	04/05/25 02:30:45 PM 4/5/25 02:30:45 PM

*) Les horodatages qui incluent des informations de fuseau horaire sont automatiquement convertis en UTC lors de l'ingestion des données.