Passer au contenu principal
Documentation
Documentation
Adaptive Planning
Dernière mise à jour : 2023-06-23
Configurer Workday Adaptive Planning Data Agent Service Manager

Configurer Workday Adaptive Planning Data Agent Service Manager

Après avoir installé Workday Adaptive Planning Data Agent Service Manager sur votre ordinateur, vous devez le lancer et le configurer.

Conditions préalables

  • Autorisations requises : Intégration > Concepteurs de données
  • Vérifiez que vous avez téléchargé et installé Workday Adaptive Planning Data Agent Service Manager.
  • Vérifiez que vous avez accès à un nom d'utilisateur et un mot de passe Adaptive Planning valides.
  • Vérifiez que votre réseau autorise
    *.adaptiveplanning.com
     et que le port 443 est ouvert sur votre ordinateur.

Navigation

Compass.png Dans le menu de navigation, accédez à
Intégration
Concevoir des intégrations
.

Étapes

  1. Lancez Workday Adaptive Planning Data Agent Service Manager et vérifiez la connectivité.
  2. Configurez Workday Adaptive Planning Data Agent Service Manager.

Lancer Workday Adaptive Planning Data Agent Service Manager et vérifier la connectivité

  1. Recherchez et lancez Workday Adaptive Planning Data Agent Service Manager en local sur votre ordinateur.
  2. Cliquez sur
    Diagnose and Configure Network
     dans l'invite de connexion pour ouvrir la boîte de dialogue des paramètres et URL de cluster.
  3. Fournissez des paramètres de proxy si votre réseau l'exige et cliquez sur
    Update Proxy Settings
     pour les enregistrer.
  4. Cliquez sur
    Test Service Internet Access
    , puis sur
    Test Your Internet Access
     pour vérifier votre connectivité.
  5. Cliquez sur
    Cluster URLs
     et passez en revue les paramètres. Par défaut, l'administrateur et les URL de serveur utilisent
    Adaptive Planning
    adaptiveplanning.com
     domaines.
  6. Connectez-vous avec un nom valide
    Adaptive Planning
     Nom d'utilisateur et Mot de passe pour ouvrir Workday Adaptive Planning Data Agent Service Manager. Si votre instance fonctionne avec Workday et que vous avez synchronisé les utilisateurs entre Workday et
    Adaptive Planning
    , vous devez utiliser vos identifiants Workday. Voir Se connecter à l'agent de données et à l'éditeur de script avec Workday Credentials.
  7. Affichez le champ Service Internet Connection pour vérifier que le statut de la connexion internet au service est vert vif et
    Sain
    .
Dans l'onglet
Configuration
du Data Agent Service Manager, cliquez sur
Actualiser
 pour rétablir la connexion au serveur sélectionné. Vous pouvez également cliquer sur
Diagnose and Configure Network
 pour ajuster les paramètres réseau.
L'ordinateur exécutant Workday Adaptive Planning Data Agent Service Manager doit pouvoir accéder à .adaptiveplanning.com via le port 443.
(Facultatif) Définir l'URL de base du cluster des appareils
Le bouton
Diagnose and Configure
 vous permet de définir l'URL d'une base de cluster d'appareils si votre :
Tableaux de bord
 s'exécute en tant qu'appareil dans un cluster personnalisé. Ce bouton vous permet également de définir les URL de votre choix.
Adaptive Planning
 Informations du serveur. Contactez le support Adaptive Planning avant de les modifier.
  1. Cliquez sur
    Set as Required for this Cluster
     pour enregistrer une modification apportée à l'URL de base du cluster.
  2. Cliquez sur
    Appliquer les paramètres de cluster
     pour enregistrer les modifications apportées à
    Adaptive Planning
     Les informations du serveur ou cliquez sur
    Restaurer les valeurs par défaut
     pour restaurer les valeurs par défaut.
  3. Le champ Verify the Service Internet Connection de l'onglet
    Setup
     de Data Agent Service Manager devient vert et indique
    Sain
    .
URL et zone géographique de la passerelle
Les champs de l'URL et de la zone géographique de la passerelle sont automatiquement renseignés lorsque vous installez et désignez des agents.
Le bouton
Switch Geography
 s'active dans l'onglet Cluster URLs si
Recommended Actions
 dans l'onglet
Setup
 indique un conflit de zone géographique avec la passerelle.
Ouvrez un dossier dans Workday Customer Center avant de modifier les paramètres de la passerelle et de la zone géographique.

Configurer Workday Adaptive Planning Data Agent Service Manager

Après avoir établi la connexion réseau :
  1. Cliquez sur
    Service Info & Options
     dans Workday Adaptive Planning Data Agent Service Manager.
  2. Cliquez sur
    Actualiser
     plusieurs fois si vous avez ajusté vos paramètres réseau et que vous ne voyez pas les modifications appliquées.
  3. Passez en revue vos paramètres :
    • Remote Access URL (Host Hint) :
       (lecture seule) l'URL identifie de manière unique la passerelle qui connecte Workday Adaptive Planning Data Agent Service Manager au serveur Integration.
    • Data Agent Service Id :
       (lecture seule) identifie de manière univoque le service d'agent spécifique. Lorsque cet ID est ajouté à l'URL d'accès distant, l'URL résultant indique l'URL exacte pour l'adressage du service spécifique de l'agent de données.
    • Stockage max. sur disque par agent (Mo) :
       stockage sur disque en mégaoctets correspond au stockage des informations extraites par chaque agent. Saisissez -1 pour un stockage illimité.
    • Number of Kettle Job Runners :
       nombre d'exécuteurs de jobs Kettle autorisés sur cet ordinateur, généralement 1. Bonne pratique : une valeur moindre est meilleure, car plus d'exécuteurs pourront utiliser davantage de RAM.
    • Max Memory per Job Runner (MB) :
       mémoire maximale en mégaoctets par exécuteur de job.
    • Max Temp Disk Size per Job Runner (MB) :
       taille maximale du disque temporaire en mégaoctets par exécuteur de job. Saisissez -1 pour un stockage illimité.
    • Trusted Tenants :
       environnements clients autorisés à créer de nouveaux agents sur cet ordinateur via Internet et sans se connecter à cet ordinateur. Vous pouvez également sélectionner
      Users from any Tenant can create Agents on this PC
      (non recommandé)
      , mais cela ne garantit pas que vous contrôlez l'accès à vos données.
    • Restrict Job Runner Access to Files :
       sélectionné par défaut. Limite l'accès aux fichiers locaux directement sous le contrôle de l'agent de données. Décochez cette case pour accéder aux fichiers dans le système de fichiers.
    • Verbose Logging
       : sélectionnez cette option pour un niveau de journalisation détaillé.
    • Log all Comms :
      consigne les entrées du journal pour toutes les bases de données et la communication réseau entre Workday Adaptive Planning Data Agent Service Manager et les agents.
    • Scrub Non-printing characters :
       retire ou transforme des caractères XML non autorisés et les caractères erronés des flux de texte d'entrée. Prérequis à
      scrubbingRules.txt
       pour supprimer les caractères supplémentaires dont vous n'avez pas besoin. Pour en savoir plus, consultez la section suivante
      Supprimer les caractères indiqués des flux de texte saisi dans JDBC et Microsoft Dynamics GP
      .
  4. Résolvez les problèmes de connexion en sélectionnant
    Show Data Agent Service Log
     pour afficher les fichiers journaux.
  5. Cliquez sur
    Apply Data Agent Service Settings
     pour appliquer les modifications.
  6. Passez à la section Créer un agent de données.
Supprimer les caractères indiqués des flux de texte saisi dans JDBC et Microsoft Dynamics GP
Lorsqu'un agent de données charge des données via une source de données JDBC ou Microsoft Dynamics GP, les données sont écrites sur le disque dur local au format XML. Ce dernier peut contenir des caractères de contrôle :
  • TAB (0x9)
  • New Line (0xA)
  • Carriage Return (0xD)
  • Autres caractères non imprimables
Les agents de données diffusent les données dans ces fichiers XML sans encodage. Si les caractères de contrôle sont en dehors de la plage de caractères XML, des erreurs apparaissent. Vous pouvez supprimer ou transformer des caractères XML illégaux, ainsi que d'autres caractères indésirables, des flux de texte d'entrée en utilisant un
scrubbingRules.txt
 fichier.
  1. Créez un fichier texte nommé
    scrubbingRules.txt
     à
    C:\Program Files\Workday Adaptive Planning Data Agent.
     Pour les versions 7.1.44 et antérieures de l'agent de données, utilisez
    C:\Program Files\Adaptive Data Agent
  2. Listez les caractères que vous souhaitez supprimer ou transformer dans le
    scrubbingRules.txt
     fichier.
    • Chaque ligne doit contenir l'ancien caractère et la nouvelle valeur séparés par "=".
    • Laissez la nouvelle valeur vide si vous supprimez le caractère. Chaque caractère doit être représenté par sa valeur Unicode.
    • Les lignes commençant par un # sont traitées comme un commentaire.
    Exemple
    scrubbingRules.txt
     contenu du fichier :
    
#Tab, New Line and CR

0009=

000A=

000D=

#|=_

007C=005F
  3. Lancez Workday Adaptive Planning Data Agent Service Manager.
  4. Cliquez sur l'onglet
    Informations de service et options
    , puis
    Nettoyage des caractères non imprimables
    .
  5. Cliquez sur
    Apply Data Agent Service Settings
    .
    Si vous sélectionnez
    Nettoyage des caractères non imprimables
    , tous les caractères XML illégaux disparaîtront des données d'entrée, même si ces caractères n'apparaissent pas dans votre
    scrubbingRules.txt
     fichier.
  6. Redémarrez le service Windows Data Agent.
Le nettoyage des caractères non imprimables
 n'affecte pas les sources de données par script. Utilisez des scripts pour supprimer ou transformer des caractères, le cas échéant.

Localiser les journaux pour résoudre des problèmes avec l'agent de données

Si vous avez besoin de résoudre des problèmes ou si le support vous les demande, vous pouvez trouver les journaux dans :
C:Windows\System32\config\systemprofile\AppData\Local\Adaptive AgentService\Agents\<agentId>\Logs\AgentLog.txt
C:Windows\System32\config\systemprofile\AppData\Local\AdaptiveDaemon\DaemonLog.txt