Configurations des passerelles de données
Une configuration des passerelles de données est un ensemble de sorties de données qui définit où les données des journaux de session, des tableaux de bord publiés et/ou des objets personnalisés sont envoyées. Pour chaque sortie, les données peuvent être envoyées vers un fichier, un point de terminaison HTTP, une instance Splunk ou une base de données.
Ajouter une sortie à une configuration de passerelles de données
Une configuration de passerelles de données peut consister en un certain nombre de sorties individuelles. Les données de chacune des sorties sont ajoutées à un fichier de configuration unique.
- Cliquez sur l’onglet Système et sélectionnez Passerelles de données > Configuration.
-
Cliquez sur Ajouter une nouvelle sortie de passerelle. L’assistant Sortie de la passerelle de données s’affiche.
- Saisissez un nom unique pour la sortie.
- Sélectionnez un type de sortie, Fichier, Point de terminaison HTTP, Splunk, ou Base de données et remplissez les champs pour ce type de sortie.
- Cliquez sur Suivant.
- Sélectionnez les données à envoyer au fichier de configuration pour le type de sortie spécifié :
- Journaux de session - Les passerelles de données traiteront les données du journal de session pour le type de sortie spécifié.
- Tableaux de bord publiés - Les passerelles de données traiteront les données des tableaux de bord publiés et configurés pour le type de sortie spécifié.
- Instantané de l’analyse de la file d’attente de travaux – Les passerelles de données vont traiter les données d’analyse de file d’attente de travaux pour le type de sortie spécifié.
- Données d’objet personnalisées - Les passerelles de données traiteront les données de toute action Blue Prism configurée pour utiliser l’objet métier interne des passerelles de données.
-
Cliquez sur Suivant. Une prévisualisation des données de sortie s’affiche.
Les données produites en sortie peuvent être modifiées directement en cliquant sur Modifier la sortie avancée. Pour plus d’informations sur la configuration avancée, consultez Sorties avancées.
- Cliquez sur OK pour fermer le message. Pour plus d’informations sur le redémarrage du processus de passerelle de données, consultez Démarrer et arrêter le moteur de passerelles de données.
Types de données de sortie
Exportez les données sélectionnées dans le fichier spécifié. Bien que la création de données de sortie dans l’assistant de configuration des passerelles de données ne prenne en charge que l’envoi de données vers des fichiers au format .txt, les données de sortie avancées et les configurations personnalisées peuvent être modifiées pour prendre en charge d’autres formats de fichier, comme .csv.
Pour plus de détails sur la manière de la faire, consultez la structure du fichier de configuration.
Des chemins dynamiques de fichiers peuvent être utilisés pour inclure la date de création dans les noms de fichiers en utilisant des variables pour l’année, le mois, le jour et l’heure.
Par exemple : C:\Session Logs\session_logs_%{+YYYY-MM-dd}.txt
Un nouveau fichier texte sera créé chaque jour à l’emplacement indiqué avec la date du jour dans le nom du fichier : session_logs_2019-04-30.txt
Les variables peuvent aussi être utilisées dans les chemins de fichier pour créer des noms de dossier en fonction de la date. Par exemple :
C:\Session Logs\%{+YYYY}\%{+MM}\%{+dd}\session_logs_%{+YYYY-MM-dd-hh}.txt
Des dossiers seront créés en fonction de la date du jour et le nom du fichier sera ajouté. Par exemple :
C:\Session Logs\2019\04\30\session_logs_2019-04-30-11.txt
Le fichier/dossier horodaté généré lors de l’utilisation des chemins dynamiques de fichiers est au format UTC.
Des chemins dynamiques de fichiers peuvent être utilisés dans les configurations créées en utilisant l’assistant des passerelles de données et la configuration avancée.
Envoyez les données sélectionnées à l’URL Splunk spécifiée avec le jeton API associé.
Afin de configurer correctement une sortie Splunk, il est nécessaire d’activer le collecteur d’événement HTTP dans votre configuration Splunk. Pour plus de détails, consultez le lien https://docs.splunk.com/Documentation/Splunk/7.3.1/Data/UsetheHTTPEventCollector.
Envoyez les données sélectionnées au tableau de la base de données SQL Server. Choisissez un identifiant de passerelles de données si l’authentification est nécessaire pour accéder à la base de données.
Pour utiliser un autre port que le port par défaut, vous pouvez ajouter un numéro de port alternatif au nom du serveur, en les séparant à l’aide de deux points. Par exemple, bp-server-1:8001.
Configurations personnalisées
Les utilisateurs ayant la permission Passerelles de données – Configuration avancée peuvent créer une configuration personnalisée en modifiant directement le code sous-jacent. Cela permet aux utilisateurs de créer une configuration ayant des fonctionnalités qui vont au-delà de ce qui est disponible dans l’assistant, comme la capacité de n’envoyer que des champs d’événements spécifiques à une sortie ou de personnaliser le format des données envoyées à une sortie.
Pour plus d’informations sur la composition des fichiers de configuration, consultez Structure du fichier de configuration.
-
À partir de Passerelles des données – Configuration avancée, cliquez sur Afficher la configuration
Le code de configuration s’affiche.
- Cliquez sur Modifier la configuration pour que le code de configuration soit modifiable.
-
Lorsque les mises à jour nécessaires ont été faites, cliquez sur Enregistrer et confirmez.
Le moteur des passerelles de données doit être redémarré pour que les modifications soient prises en compte. Pour plus d’informations, consultez Démarrer et arrêter le moteur de passerelles de données.
La configuration personnalisée remplace les sorties de la configuration existante. Cela est reflété dans l’écran des passerelles de données, où le code de configuration avancée remplace la liste des sorties.
Cliquez à n’importe quel moment sur Supprimer dans la configuration personnalisée pour revenir à la composition d’origine de la configuration et afficher les sorties d’origine.
Sorties avancées
Lors de la création ou la modification d'une sortie, les utilisateurs ayant la permission Passerelles de données – Configuration avancée peuvent modifier le code directement dans la sortie pour créer une configuration avancée.
À partir de l'écran de prévisualisation de la configuration de sortie, cliquez sur Modifier la sortie avancée pour ouvrir l'éditeur avancé.
La sortie peut être modifiée en saisissant des données ou en les collant à partir du presse-papiers. Les fichiers, jusqu'à une taille de 10k, peuvent également être importés dans une sortie, remplaçant ainsi toutes les données actuelles. Lorsque les modifications nécessaires ont été effectuées, cliquez sur Enregistrer la sortie avancée.
Une fois qu'une sortie a été enregistrée comme sortie avancée, même si aucune modification n'a été apportée, elle ne peut plus être configurée dans l'assistant de sortie des passerelles de données, mais seulement dans l'éditeur avancé.
Gérer une configuration de passerelles de données
Les sorties d'une configuration de passerelles de données sont listées dans l'écran Passerelles de données > Configuration. Cliquez sur Gérer pour afficher les options permettant de copier, modifier ou supprimer une ou plusieurs configurations.
À chaque fois qu'une configuration de passerelles de données est modifiée, que ce soit une sortie nouvelle, mise à jour ou supprimée, le moteur des passerelles de données doit être redémarré. Pour plus d'informations, consultez Démarrer et arrêter le moteur de passerelles de données.
Cliquez sur Copier pour la sortie que vous voulez dupliquer. En fonction du type de sortie, l'assistant des passerelles de données ou l'éditeur avancé s'ouvriront, permettant à la sortie dupliquée d'être mise à jour, comme nécessaire. Lorsque la sortie a été enregistrée, redémarrez le processus de passerelles de données.
Cliquez sur Supprimer pour que la sortie requise supprime de la configuration et redémarrez le processus de passerelles de données.
Cliquez sur Modifier pour la sortie requise. En fonction de la sortie, l'assistant de sortie ou l'éditeur avancé s'affichent, permettant à la sortie d'être mise à jour. Lorsque la sortie a été enregistrée, redémarrez le processus de passerelles de données.
Suppression de la sortie sélectionnée
Cochez la case Sélectionner tout dans la colonne Nom de la sortie afin de sélectionner toutes les sorties concernées par la suppression du groupe. Cochez/décochez la case correspondant à une sortie spécifique, selon le besoin. Cliquez sur Supprimer les éléments sélectionnés afin de supprime la ou les sorties sélectionnées.
Configurations personnalisées
Les utilisateurs ayant la permission Passerelles de données – Configuration avancée peuvent créer une configuration personnalisée en modifiant directement le code sous-jacent. Cela permet aux utilisateurs de créer une configuration ayant des fonctionnalités qui vont au-delà de ce qui est disponible dans l'assistant, comme la capacité de n'envoyer que des champs d'événements spécifiques à une sortie ou de personnaliser le format des données envoyées à une sortie.
Pour plus d'informations sur la composition des fichiers de configuration, consultez Structure du fichier de configuration.
-
À partir de Passerelles des données – Configuration avancée, cliquez sur Afficher la configuration
Le code de configuration s'affiche.
- Cliquez sur Modifier la configuration pour que le code de configuration soit modifiable.
-
Lorsque les mises à jour nécessaires ont été faites, cliquez sur Enregistrer et confirmez.
Le moteur des passerelles de données doit être redémarré pour que les modifications soient prises en compte. Pour plus d'informations, consultez Démarrer et arrêter le moteur de passerelles de données.
La configuration personnalisée remplace les sorties de la configuration existante. Cela est reflété dans l'écran des passerelles de données, où le code de configuration avancée remplace la liste des sorties.
Cliquez à n'importe quel moment sur Supprimer dans la configuration personnalisée pour revenir à la composition d'origine de la configuration et afficher les sorties d'origine.