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

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 2 minutes de lecture

    • Installez les packages NPM (Node Package Manager) à 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 packages dans le ServiceNow IDE. Ensuite, vous pouvez choisir dans quelles applications installer les packages.

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

    Procédure

    1. Accédez à la Tout > Développement d’applications > ServiceNow IDE.
    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-shift-p
    4. Entrer les préférences : Ouvrez Réglages 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.
      OptionExemple
      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 à champ d’application en plus de tout registre privé.
    6. Fournissez vos informations d’identification pour accéder au registre privé.
      OptionDescription
      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. Utilisez l’un des raccourcis clavier suivants pour ouvrir la palette de commandes :
      • Windows : Ctrl-Maj-P
      • Mac : cmd-shift-p
    9. Entrez dans Gestionnaire de packages : Installer les dépendances et appuyez sur Entrée.
    10. Sélectionnez une application pour installer des 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 la portée @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 les applications de ServiceNow IDE.