Installer un package npm à partir d’un registre privé avec le ServiceNow IDE

Installez les packages Node Package Manager (npm) à partir d’un registre privé en tant que dépendances dans votre application pour les utiliser comme bibliothèques tierces.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Pour installer des packages à partir de registres privés, vous devez configurer les paramètres utilisateur de votre gestionnaire de package dans le ServiceNow IDEfichier . Ensuite, vous pouvez choisir dans quelles applications installer les packages.

ServiceNow IDE Utilise le registre NPM public (https://registry.npmjs.org) comme source de package par défaut. Si votre réseau bloque l’accès à ce registre, vous devez avoir accès à un autre registre pour télécharger des packages et créer des applications dans le ServiceNow IDE. Si l’accès au registre npm public est bloqué sur votre système, vous devez configurer un registre npm privé dans les paramètres utilisateur de votre gestionnaire de package dans le ServiceNow IDE.

Remarque :

Pour installer des packages à partir d’un registre privé, le registre doit répondre avec l’en-tête HTTP Access-Control-Allow-Origin .

Procédure

1. Accédez à la Tous > Développement d'application > IDE ServiceNow.
2. Ouvrez un espace de travail.
3. Utilisez l’un des raccourcis clavier suivants pour ouvrir la palette de commandes :
   • Windows : Ctrl-Maj-P
   • Mac : Cmd-Maj-P
4. Saisir les préférences : Ouvrez Paramètres utilisateur (JSON) et appuyez sur Entrée.
5. Spécifiez un registre privé comme registre par défaut ou un registre inclus dans le champ d’application à partir duquel vous pouvez installer des packages.

   Option	Exemple
   Registre par défaut	"package-manager.defaultRegistry": "<private-registry-url>",
   Registre inclus dans le périmètre	"package-manager.scopedRegistries": [ { "scope": "@<scope>", "registry": "<private-registry-url>" }, ... ]

   Remarque :

   Pour installer des packages à partir de registres publics, vous pouvez spécifier un registre public comme registre par défaut ou un registre à portée en plus de tout registre privé.
6. Fournissez vos informations d’identification pour accéder au registre privé.

   Option	Description
   Authentification de base	Fournissez un nom d’utilisateur et un mot de passe pour accéder au registre par défaut que vous avez spécifié. "package-manager.basicAuth": [ { "registry": "<private-registry-url>", "user": "<user-name>", "pass": "<password>" }, ... ]
   Authentification héritée	Fournissez un jeton hérité pour accéder au registre par défaut que vous avez spécifié. Les jetons hérités sont des informations d’identification d’authentification de base codées au format Base64. "package-manager.legacyAuth": [ { "registry": "<private-registry-url>", "token": "<legacy-token>" }, ... ]
   Authentification jeton	Fournissez un jeton de porteur pour accéder au registre par défaut que vous avez spécifié. "package-manager.tokenAuth": [ { "registry": "<private-registry-url>", "token": "<token>" }, ... ]

7. Enregistrez vos modifications dans le fichier settings.json .
8. Installez les packages à partir des registres configurés.
   1. Utilisez l’un des raccourcis clavier suivants pour ouvrir la palette de commandes :
      • Windows : Ctrl-Maj-P
      • Mac : Cmd-Maj-P
   2. Entrez Gestionnaire de package : Installer les dépendances et appuyez sur Entrée.
   3. Sélectionnez une application dans laquelle installer les packages en tant que dépendances.
   Les packages sont installés dans le répertoire node_modules .

Paramètres utilisateur pour l’accès au registre privé

Dans l’exemple suivant, un utilisateur a configuré l’accès à un registre privé à l’aide de l’authentification de base. L’utilisateur a également configuré ses paramètres pour installer des packages à partir d’un registre public avec le périmètre @example .

{
    "files.autoSave": "off",
    "package-manager.defaultRegistry": "<private-registry-url>",
    "package-manager.basicAuth": [
        {
        "registry": "<private-registry-url>",
            "user": "<user-name>",
            "pass": "<password>"
        }
    ],
    "package-manager.scopedRegistries": [
        {
            "scope": "@example",
            "registry": "<public-registry-url>"
        }
    ]
}

Que faire ensuite

Utilisez les packages que vous avez installés en tant que bibliothèques tierces dans votre application. Pour plus d'informations, consultez Utiliser des bibliothèques tierces dans des applications dans le ServiceNow IDE.