Création et mise à jour d'instances de Script Application à l'aide du support push de ligne de commande

Les créateurs peuvent localiser vos instances de Script Application et les ajouter à vos pages de portail à l'aide de la barre d'outils de contenu lorsqu'elles sont stockées dans une bibliothèque de site Web Content Manager. Vous pouvez insérer les fichiers qui sont associés à des applications basées sur des scripts à partir de votre système de fichiers local vers une instance Script Application dans une bibliothèque de site Web Content Manager en exécutant la commande sp push.

Pourquoi et quand exécuter cette tâche

Remarque : Si vous ajoutez Script Application à des pages pour lesquelles vous avez sélectionné le profil léger, vous ne pouvez pas démarrer la boîte de dialogue de portail pour utiliser les fonctions d'édition et d'importation. Les instances de Script Application que vous avez créées et éditées sur des pages avec des profils autres que le profil simple ou ailleurs peuvent être ajoutées aux pages du profil simple à partir des instances de Script Application pour une utilisation à l'exécution.

Vous pouvez éditer et tester votre application localement à l'aide de votre éditeur et de votre navigateur favoris, puis l'insérer dans une zone de site au sein d'une bibliothèque Web Content Manager sur le portail. Les applications des zones de site qui sont activées pour Script Application peuvent ensuite être utilisées pour créer des pages de portail dans l'onglet Composants de page de la barre d'outils. L'installation de Script Application avec un groupe de correctifs inclut les zones de site nommées Bibliothèque de Script Application et Zone de site des instances de Script Application. Les utilisateurs peuvent insérer des applications sur ces zones de site à l'aide de cet utilitaire de ligne de commande. Vous pouvez activer d'autres zones de site à utiliser avec Script Application. Pour plus d'informations sur cette procédure, voir Création et activation d'une zone de site personnalisée.

Procédure

Ouvrez une ligne de commande et recherchez le dossier racine de votre application. Entrez la commande suivante :
```
sp push -wcmContentName your_application_name
```
Par défaut, la commande sp push utilise les paramètres par défaut du fichier sp-config.json où vous avez installé l'application de ligne de commande de Script Application. Cette commande crée l'objet de contenu Web Content Manager pour votre application. Elle lui affecte le nom que vous avez spécifié via l'argument -wcmContentName dans la zone de site Web Content Manager qui est identifiée par le paramètre wcmSiteArea de ce fichier. La zone de site par défaut dans le fichier sp-config.json est Script Portlet Library/Script Portlet Applications. Les applications insérées sont stockées dans la zone de site Script Application de la bibliothèque Script Application dans Web Content Manager.
Facultatif : Si vous exécutez la commande sp push à partir d'un autre dossier que le dossier d'application, vous devez utiliser l'argument -contentRoot pour spécifier votre dossier d'application.
Par exemple, utilisez le code suivant :
```
sp push -contentRoot c:\samples\scripts\hello
```

Que faire ensuite

Utilisez l'une des options de ligne de commande générale suivantes à l'aide de l'outil de ligne de commande Script Application.

Tableau 1. Options de ligne de commande générale
Commandes	Description
`list projects`	Répertorie les projets Web Content Manager présents sur le portail.
`list vportals`	Répertorie les portails virtuels hébergés par le portail.
`push`	Créez ou mettez à jour le contenu d'une instance Script Application.

En outre, vous pouvez définir les modificateurs facultatifs suivants lorsque vous utilisez l'application de ligne de commande. Utilisez-les pour spécifier des valeurs de configuration dont vous pouvez avoir besoin pour votre environnement. Vous pouvez spécifier ces options sur la ligne de commande ou dans un fichier sp-config.json. Le fichier de configuration sp-config.json définit les options de référence qui sont utilisées sur toutes les instances de Script Application. Ainsi, vous n'avez pas besoin de définir ces options communes sur la ligne de commande chaque fois que vous utilisez l'application. Lorsque vous spécifiez une option dans le fichier de configuration sp-config.json, omettez le tiret de tête du nom d'option. Script Application utilise la séquence de préférences suivante lorsqu'il traite ces options :

Une option spécifiée sur la ligne de commande. Une option que vous spécifiez sur la ligne de commande remplace les options qui sont définies dans les fichiers sp-config.json.
Une option définie dans le fichier de configuration sp-config.json spécifié à l'aide de l'option -contentRoot, comme indiqué précédemment à l'étape 2.
Une option définie dans le fichier de configuration sp-config.json situé dans le même répertoire que le fichier sp.sh ou sp.bat.

Tableau 2. Options de communication du portail
Option	Propriété associée	Description
`-scriptPortletServer value`	`scriptPortletServer`	URL du serveur de portail qui héberge un environnement Script Application. Les demandes push sont envoyées à ce serveur. La valeur est formatée comme suit : `http://host:port` ou `https://host:port`.
`-laxSSL true\|false`	`laxSSL`	Indique si la validation de certificat doit être désactivée lorsque HTTPS est utilisé. La valeur par défaut est `false`. Affectez `true` à cette option uniquement pour les serveurs de test locaux sécurisés.
`-connectTimeout value`	`connectTimeout`	Définit, en millisecondes, le temps d'attente maximal avant que la ligne de commande ne se connecte au serveur de portail. La valeur par défaut est `15000` ou 15 secondes. Une erreur est générée si le portail n'accepte pas la connexion dans le délai d'attente imparti.
`-socketTimeout value`	`socketTimeout`	Définit, en millisecondes, le temps d'attente maximal avant que le portail ne réponde à une commande une fois qu'une connexion est établie. La valeur par défaut est `15000` ou 15 secondes. Une erreur est générée si le portail ne répond pas à la commande dans le délai d'attente imparti.
`-contenthandlerPath alt_content_handler_path`	`contenthandlerPath`	Utilisez cette option pour définir un chemin d'accès de remplacement pour la racine de contexte de portail ou le servlet de gestionnaire de contenu. Si vous n'utilisez pas cette option, la valeur par défaut /wps/mycontenthandler est utilisée, ce qui correspond à une installation de portail par défaut. Si vous avez modifié la racine de contexte ou les chemins de servlet de gestionnaire de contenu, les utilisateurs de l'outil de ligne de commande de Script Application doivent indiquer une valeur de remplacement pour le paramètre `contenthandlerPath` afin de permettre l'établissement de la connexion au serveur de portail à partir de l'outil client.

Tableau 3. Options d'authentification du portail
Option	Propriété associée	Description
`-portalUser value`	`portalUser`	ID utilisateur HCL Portal que vous utilisez pour vous connecter afin d'exécuter la demande push.
`-portalPassword`	`portalPassword`	Mot de passe de l'utilisateur HCL Portal qui exécute la demande push. Remarque : Si le portail nécessite une authentification, ne définissez pas le mot de passe dans un fichier de configuration .json, car le mot de passe est stocké sous forme de texte en clair et cela représente une vulnérabilité de sécurité potentielle. En revanche, vous pouvez autoriser la ligne de commande à demander le mot de passe ou vous pouvez utiliser l'option de ligne de commande `-portalPassword`. Il est recommandé d'autoriser l'outil à demander le mot de passe, car ainsi, le mot de passe n'est pas répercuté sur la ligne de commande et n'apparaît donc pas dans l'historique des commandes.
`-performAuth true\|false`	`performAuth`	Indique si le portail exige une authentification avant d'exécuter une commande. La valeur par défaut est `true`. Un nom d'utilisateur et un mot de passe doivent être fournis pour que le serveur puisse exécuter une commande.

Tableau 4. Options de specification de contenu
Option	Propriété associée	Description
`-contentRoot value`	`contentRoot`	Chemin d'accès relatif ou absolu à un répertoire du poste de travail contenant le contenu à insérer sur le portail. Si le chemin d'accès est relatif, il est relatif au répertoire de travail en cours. Lorsque vous utilisez l'option `-prebuiltZIP`, l'option `-contentRoot` spécifie le répertoire qui contient le fichier de configuration .json facultatif du portlet. Ce répertoire correspond également à l'emplacement où est consigné le fichier journal recensant les actions réalisées par la commande push. La valeur par défaut correspond au répertoire de travail en cours.
`-prebuiltZIP value`	`prebuiltZIP`	Chemin d'accès à un fichier compressé existant qui fournit le contenu qui doit être inséré sur le portail à la place du contenu présent dans le répertoire de travail en cours. La propriété `-contentRoot` peut être utilisée pour localiser le fichier de configuration sp-config.json propre à l'application, si celui-ci ne figure pas dans le répertoire de travail en cours.
`-mainHtmlFile` `value`	`mainHtmlFile`	Chemin d'accès au principal fichier .html de Script Application. Le principal fichier .html est le premier fichier qui est rendu par le portlet. Si `-contentRoot` est spécifié, le chemin de fichier .html doit être relatif à la valeur de `-contentRoot`. Si `-prebuiltZIP` est spécifié, le chemin de fichier .html doit être relatif au répertoire de niveau supérieur dans le fichier compressé requis par la commande push. Si vous n'indiquez pas ce chemin, l'outil tente de localiser un fichier nommé index.html ou index.htm dans le chemin spécifié par `-contentRoot` ou dans le répertoire de niveau supérieur du fichier compressé. Si l'un de ces fichiers est détecté, il est utilisé comme valeur du principal fichier .html. Sinon, l'outil vous invite à spécifier la valeur.

Tableau 5. Portlet et options de spécification de contenu Web Content Manager
Option	Propriété associée	Description
`-wcmContentName value`	`wcmContentName`	Nom de l'instance Script Application à créer ou à mettre à jour dans la zone de site Web Content Manager qui est spécifiée par la propriété `wcmSiteArea` ou l'option de ligne de commande. Il n'existe pas de valeur par défaut. Indiquez ce nom au moyen de la propriété ou de l'option de ligne de commande sauf si vous mettez à jour une instance Script Application existante sur une page via `wcmContentID` ou que vous spécifiez le chemin d'accès complet à une instance de contenu via `wcmContentPath`.
`-wcmContentID value`	`wcmContentID`	ID contenu Web Content Manager d'une instance Script Application existante sur une page de portail. Définissez cette valeur à la place de `wcmContentName` uniquement si vous mettez à jour une instance Script Application existante sur une page de portail. De plus, définissez-la uniquement après avoir cliqué sur Exporter config pour l'application avec le mode édition de Script Application activé. N'utilisez pas cette option lorsque vous créez ou mettez à jour une application Script Application dans une zone de site Bibliothèque Web Content Manager partagée.
`-wcmContentPath value`	`wcmContentPath`	Chemin d'accès complet de Web Content Manager, y compris la bibliothèque et la zone de site, à votre application. Vous ne pouvez pas utiliser cet argument avec `wcmSiteArea` et `wcmContentName` ou si l'un ou l'autre de ces paramètres est utilisé par défaut par sp-config.json.
`-wcmContentTitle value`	`wcmContentTitle`	Définit ou met à jour le titre de l'instance Script Application. La valeur par défaut correspond au nom d'application qui est spécifié via l'option `wcmContentName` si vous ne l'indiquez pas ici.
`-wcmSiteArea value`	`wcmSiteArea`	La zone de site Web Content Manager dans laquelle sont créées les instances Script Application.
`-projectContext value`	`projectContext`	Contexte du projet de portail qui gère la publication des modifications sur le contenu Script Application.
`-virtualPortalContext value`	`virtualPortalContext`	Contexte du portail virtuel qui contient l'instance Script Application que vous souhaitez créer ou mettre à jour.