--- sourceDocument: Yokohama Créer ou modifier des applications sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/application-development Release : - yokohama ft:locale : - fr-FR ft:publication_title : - Yokohama Créer ou modifier des applications ft:clusterId : - cadev bundleId : - cadev workflow : - Creator --- Intégration du contrôle de source ================================= Intégration du contrôle de source {#ariaid-title1} ================================================== * Rversion finale: Yokohama * * Mis à jour 30 janv. 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture Permettre aux développeurs d'applications de s'intégrer à un référentiel de contrôle de source Git. Enregistrez et gérez plusieurs versions d'une application à partir d'une instance de non-production. La liaison d'une application au contrôle de source permet à tous les développeurs d'applications sur une instance de non-production : * Importez des applications à partir d'un référentiel Git. * Transmission par pull et application de modifications distantes à partir d'un référentiel Git. * Validez toutes les modifications locales sur l'instance dans un référentiel Git. * Créez des balises pour les lier en permanence à une version donnée d'une application. * Créez des branches pour gérer plusieurs versions d'une application simultanément. {#c_SourceControlIntegration__ul_f23_qsk_p5} Exigences d'intégration {#c_SourceControlIntegration__section_bgq_czg_kjb} -------------------------------------------------------------------------- Pour lier une application au contrôle de source : * L'utilisateur doit disposer du rôle d'administrateur. * L'instance de non-production doit disposer d'un accès réseau au référentiel Git. * Chaque application doit se trouver dans son propre référentiel Git. * Les informations d'identification de l'utilisateur du référentiel doivent accorder l'accès en lecture et en écriture. {#c_SourceControlIntegration__ul_spw_bhl_p5} Remarque : Tous les développeurs d'application dans l'instance partagent un ensemble unique d'informations d'identification par référentiel. Options disponibles à partir de ServiceNow Studio {#c_SourceControlIntegration__section_k2d_kyg_kjb} ---------------------------------------------------------------------------------------------------- Après avoir lié une application au contrôle de source, les développeurs d'applications peuvent l'utiliser ServiceNow Studio pour gérer le référentiel. À partir de Studio, les développeurs peuvent : * Modifiez les informations d'identification du référentiel d'applications. * Validez tous les changements locaux sur l'instance. * Appliquer les modifications distantes à partir du référentiel. * Créez une succursale. * Changez de succursale. * Importez une application à partir d'un référentiel distant. {#c_SourceControlIntegration__ul_u55_hl4_q5} Il n'est pas recommandé d'utiliser le contrôle de source pour gérer les applications sur une instance de production. Le déploiement en production peut avoir des conséquences imprévues, reportez-vous à la section [Conseils pour le déploiement de la production](https://servicenow-prod.fluidtopics.net/bc73ZN4ovNc66RbVr8D7Mg "Lorsque vous développez des personnalisations pour des applications sur la ServiceNow plateforme, vous les déployez via le référentiel d’applications vers une instance de production. Cette rubrique examine et fournit des mises en garde concernant les compromis entre l’installation d’une application à partir du référentiel d’applications et le référentiel Git avec contrôle de source."). Au lieu de cela, vous pouvez gérer les applications sur une instance de production à l'aide du référentiel d'applications, d'un ensemble de mises à jour ou du ServiceNow Store. Pour plus d'informations sur la gestion des applications sur une instance de production, reportez-vous à la section [Partage d'applications](https://servicenow-prod.fluidtopics.net/AsrG0tqQkjBvyJax06qUQQ "Les administrateurs peuvent partager des applications qui sont terminées et prêtes à être utilisées sur d’autres instances."). Options disponibles à partir d'un référentiel Git {#c_SourceControlIntegration__section_spn_nyg_kjb} ---------------------------------------------------------------------------------------------------- La ServiceNow plate-forme offre une prise en charge limitée de la modification des fichiers d'application liés en dehors d'une instance. Depuis Git, les développeurs peuvent : * Déplacer les fichiers d'application vers une structure de répertoire Git différente. * Modifiez les fichiers d'application en dehors de ServiceNow Studio. {#c_SourceControlIntegration__ul_gtn_34f_kjb} Le système génère un fichier texte de propriétés appelé sn_source_control.properties au niveau racine du référentiel. Pour déplacer les fichiers d'application vers une structure de répertoire Git différente, les développeurs d'applications peuvent définir le path paramètre pour spécifier le chemin du sous-dossier contenant leurs fichiers d'application. Par exemple, si vous avez déplacé votre application vers le sous-dossier src/app , définissez le path`sur path=src/app`. Le système génère un fichier checksum.txt dans le référentiel Git pour déterminer si des fichiers d'application ont été modifiés en dehors de Studio. Lorsque la valeur de la somme de contrôle du fichier correspond à la valeur de somme de contrôle actuelle, l'intégration ignore le processus de validation et de nettoyage. Lorsque les valeurs de la somme de contrôle ne correspondent pas, l'intégration valide et nettoie les fichiers d'application dans le cadre de l'opération de contrôle de source. Le processus de désinfection : * Crée des entrées de journal de mise à niveau pour chaque action de nettoyage effectuée. * Supprime les dossiers et fichiers non pris en charge du référentiel. * Abandonne toutes les opérations de contrôle de source lorsqu'un fichier d'application système échoue à la validation du schéma XML. Par exemple, si un enregistrement de dictionnaire de base de données échoue à la validation du schéma XML, le système abandonne toutes les opérations. * Ignore l'opération de contrôle de source actuelle lorsqu'un fichier d'application non système échoue à la validation du schéma XML. {#c_SourceControlIntegration__ul_sqt_z4f_kjb} L'intégration du contrôle de source nettoie uniquement le contenu du chemin d'accès de l'application répertorié dans le fichier sn_source_control.properties . Le contenu du référentiel en dehors du chemin d'accès de l'application est ignoré. Prise en charge de Serveur MID {#c_SourceControlIntegration__section_ew2_4y1_njb} --------------------------------------------------------------------------------- Utilisez un Serveur MID existant pour vous connecter à un référentiel de contrôle de source. [La liaison](https://servicenow-prod.fluidtopics.net/kZ0bEcXzBZDASq1NNqY3IA "La liaison d’une application ou d’une personnalisation d’application au contrôle de source permet aux développeurs d’applications de gérer les changements à partir d’un référentiel Git.") ou [l'importation d'une](https://servicenow-prod.fluidtopics.net/YkTufjSOZY1aFTyNV0XMzQ "Importez une application ou une application-personnalisation à partir d’un référentiel de contrôle de source pour continuer à la développer sur cette instance.") application via un MID Server permet d'accéder aux référentiels derrière un pare-feu. Configurer le Serveur MID pour l'intégration du contrôle de source {#c_SourceControlIntegration__section_rft_qbh_4tb} --------------------------------------------------------------------------------------------------------------------- Configurez un Serveur MID pour l'intégration du contrôle de source afin d'activer la communication et le mouvement de données entre une instance et des ServiceNow applications, sources de données et services externes. * Ajoutez l'extension \<\< bundle \>\> aux propriétés glide.attachment.extensions . * Si les MID Servers doivent passer par un proxy pour accéder au dépôt git distant, procédez comme suit : * Ajoutez la ligne suivante au fichier agent\\conf\\wrapper-override.conf : * wrapper.java.additionial.3=-Dhttps.proxyHost=\ * wrapper.java.additionial.4=-Dhttps.proxyPort=\ * Redémarrer le MID * Ajouter une nouvelle entrée dans \<\< Politique de sécurité MID \>\> : * Nom : \ * Cocher \<\< Actif \>\> uniquement {#c_SourceControlIntegration__ul_z4l_2ch_4tb} {#c_SourceControlIntegration__ul_cfh_5bh_4tb} Validations de contrôle de source de débruitage {#c_SourceControlIntegration__section_oky_ssg_4tb} -------------------------------------------------------------------------------------------------- Ignorer le déchargement dans les fichiers XML des champs de mise à jour bruyants pour tout enregistrement de métadonnées dans le contrôle de source. * **[Conseils pour le déploiement de la production](https://servicenow-prod.fluidtopics.net/bc73ZN4ovNc66RbVr8D7Mg)** Lorsque vous développez des personnalisations pour des applications sur la ServiceNow® plateforme, vous les déployez via le référentiel d'applications vers une instance de production. Cette rubrique examine et fournit des mises en garde concernant les compromis entre l'installation d'une application à partir du référentiel d'applications et le référentiel Git avec contrôle de source. * **[Opérations de contrôle de source disponibles](https://servicenow-prod.fluidtopics.net/cXhwaa6~kXrNglTZR0Mkew)** L'intégration du contrôle de source prend principalement en charge les opérations à partir de Studio, mais peut également prendre en charge certaines opérations directement à partir du référentiel GIT. * **[Importer l'application ou la personnalisation d'application à partir du contrôle de source](https://servicenow-prod.fluidtopics.net/YkTufjSOZY1aFTyNV0XMzQ)** Importez une application ou une application-personnalisation à partir d'un référentiel de contrôle de source pour continuer à la développer sur cette instance. * **[Lier une application ou une personnalisation d'application au contrôle de source](https://servicenow-prod.fluidtopics.net/kZ0bEcXzBZDASq1NNqY3IA)** La liaison d'une application ou d'une personnalisation d'application au contrôle de source permet aux développeurs d'applications de gérer les changements à partir d'un référentiel Git. * **[Migrer l'historique des ensembles de mises à jour terminé vers le contrôle de source](https://servicenow-prod.fluidtopics.net/yp69PRDvhw3PPm9FnexX_A)** Lors de la liaison au contrôle de source, cette fonctionnalité permet aux développeurs d'applications de choisir de migrer les informations des ensembles de mises à jour terminés vers l'historique du contrôle de source. * **[Modifier une configuration de référentiel Git](https://servicenow-prod.fluidtopics.net/0v8jnJJdg8_WUq~ZkldomQ)** Vous pouvez modifier un référentiel Git pour modifier la sélection du protocole réseau, les informations d'identification ou d'autres entrées de champ. * **[Appliquer les changements distants](https://servicenow-prod.fluidtopics.net/0Q8uf6mBHDldp~Vox6DKUQ)** Les développeurs d'applications peuvent extraire des modifications d'un référentiel GIT lié pour appliquer les modifications distantes à l'instance locale. * **[Valider les changements](https://servicenow-prod.fluidtopics.net/F~FPl97Ch4HOZhocp2CxXA)** Les développeurs d'applications peuvent valider leurs modifications sur l'instance dans le référentiel Git lié. Vous pouvez sélectionner quelques changements à valider ou valider tous les changements sur l'instance en une seule fois. * **[Dissimuler les changements locaux](https://servicenow-prod.fluidtopics.net/UYOw4FZjx9R1r82kGV6fUA)** Les développeurs d'applications peuvent supprimer et enregistrer les changements localement pour les appliquer ultérieurement. * **[Changer de branche](https://servicenow-prod.fluidtopics.net/6OTbbC3EYBLzc0f0o5Fubg)** Les développeurs d'applications peuvent passer à une autre branche de référentiel pour travailler sur une autre version de l'application. * **[Créer une branche](https://servicenow-prod.fluidtopics.net/Z~eTfWft4bMYh1a~xIzdYg)** Les développeurs d'applications peuvent créer une branche pour travailler sur une nouvelle version d'une application existante. * **[Définir la branche par défaut](https://servicenow-prod.fluidtopics.net/Zpcr7j9~GY2UnIUSwBEBag)** Définissez une branche par défaut lorsque vous souhaitez utiliser une branche autre que la branche principale pour les nouveaux changements ou pour votre référentiel de développement principal. * **[Gérer les dissimulations](https://servicenow-prod.fluidtopics.net/Y85mwKWU~8f3hQ_ptR1yTg)** Les développeurs d'applications peuvent appliquer ou supprimer des changements dissimulés à partir de Studio. * **[Résoudre des conflits](https://servicenow-prod.fluidtopics.net/mqadiN01DHmmkZAwXgEzMA)** Les développeurs d'applications peuvent choisir la version du fichier d'application à utiliser lors de l'application de modifications distantes ou dissimulées. * **[Afficher l'historique de validation](https://servicenow-prod.fluidtopics.net/J4QQs7sFipyUHousvmmNBA)** Les développeurs d'applications peuvent afficher l'historique des validations des applications liées à un référentiel de contrôle de source. * **[Déplacer des fichiers d'application dans un référentiel GIT](https://servicenow-prod.fluidtopics.net/ACHaffsccpcSkkGApdGTVg)** Déplacez les fichiers d'application liés au contrôle de source vers n'importe quel dossier du référentiel. Autorisez les développeurs d'applications à stocker le contenu de prise en charge, tel que les tests automatisés, dans le même référentiel que les applications qu'ils prennent en charge. * **[Évitement des collisions](https://servicenow-prod.fluidtopics.net/5ZB2sPSpLxNNF7lTIdKtxw)** Évitez de modifier un fichier d'application dans différents ensembles de mises à jour pour garantir une expérience transparente pendant le processus de validation. * **[Chargement delta](https://servicenow-prod.fluidtopics.net/3F_~h3~IBeOPaq7zxjUsBQ)** Le \<\< delta loading \>\> est un moyen optimisé de charger une application à partir d'un référentiel Git. * **[Débruitez vos validations de contrôle de source](https://servicenow-prod.fluidtopics.net/fw9kr5Am4QEDU9f8cFxs6g)** En tant que développeur de contrôle de source, vous pouvez fusionner les branches Git, sans obtenir de bruit provenant des champs qui sont mis à jour automatiquement par le système.