---
sourceDocument: Xanadu : créer des intégrations avec des applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Xanadu : créer des intégrations avec des applications

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Utiliser le composant GetMainWindowHandle

# Utiliser le composant GetMainWindowHandle {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute de lecture

Récupérez le descripteur de fenêtre d'une fenêtre principale d'un processus actif à l'aide du composant GetMainWindowHandle dans Studio de conception de bureau de RPA. Ce composant accepte l'ID du processus comme entrée et renvoie la valeur Entier du processus spécifié.

## Avant de commencer

Rôle requis : aucun

## Pourquoi et quand exécuter cette tâche

Vous pouvez configurer les propriétés du composant GetMainWindowHandle. Pour en savoir plus sur ces propriétés, reportez-vous à la section [Propriétés des composants de processus système](https://servicenow-prod.fluidtopics.net/mNIzl2BWFn9MbLI2GIbEvw "Découvrez les propriétés des composants du processus système dans Studio de conception de bureau de RPA.").

## Procédure

1. Dans la fenêtre Toolbox (Boîte à outils), accédez à UtilitésProcessus système.
2. Faites glisser le composant GetMainWindowHandle vers l'aire de conception.
3. Pour configurer les champs d'entrée, reportez-vous à la section [Configurer les propriétés des ports](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA.").
4. Connectez les ports de données et de contrôle de GetMainMainWindowHandle aux ports correspondants de l'autre composant, comme décrit dans la table suivante.  
   {#use-sysprocess-getmainwindhandle__table_jnw_jn1_krb__entry__3}

   | Type de port | Objectif de la connexion | Obligatoire? |
   |-|-|-|
   | Données d'entrée (ProcessId) | Utilise l'ID de processus de la fenêtre sous forme de chaîne à partir d'un composant précédemment exécuté. | Oui |
   | Sortie de données (entier) | Renvoie le handle Windows du processus spécifié et le transmet au composant suivant. | Oui |
   | Contrôler dans | Se connecte au port de sortie de contrôle d'un ou de plusieurs composants. | Oui |
   | Contrôler la sortie | Se connecte au port d'entrée de contrôle d'un autre composant ou au composant final par défaut. | Non |
   [ ]

   {#use-sysprocess-getmainwindhandle__table_jnw_jn1_krb}
5. **Facultatif :** Pour tester le composant, sous l'onglet CONCEPTION , cliquez sur Exécuter.