Configuration de votre environnement de programmation d'extension
A l'aide de l'outil d'extensibilité, vous pouvez personnaliser l'application en fonction des besoins de votre entreprise. Vous pouvez ajouter des widgets d'interface utilisateur tels que des libellés, des zones de texte, des cases à cocher, etc. Vous pouvez soit modifier les propriétés par défaut de n'importe quel widget, soit ajouter de nouveaux widgets et spécifier les liaisons d'agencement, ainsi que les propriétés de thème de ces widgets. Vous pouvez synchroniser les différences dans les entrées de thème, les entrées de bundle et les modèles.
Avant de commencer
- Par défaut, toutes les extensions sont sauvegardées dans le répertoire d'installation. Par conséquent, assurez-vous que le répertoire d'installation est accessible sur le serveur sur lequel Sterling Store Engagement est déployé.
- Vérifiez que le répertoire d'installation dispose des droits d'accès en lecture et en écriture. Pour les utilisateurs qui étendent l'application, ils doivent disposer d'un droit d'accès en écriture.
- Pour utiliser Extensibility Workbench, vous devez générer le Javadoc. Pour plus d'informations sur la génération de la Javadoc, voir Générer et accéder à la Javadoc.
- Il est recommandé de déployer l'application en mode WAR (Web Archive) de développement éclaté. Utilisez le
wscdev.warfichier (WAR de développement de l' Store Engagement, en livres sterling ). Ce fichier contient d'autres dossiers etweb.xmlentrées nécessaires à l'évolutivité. En production, vous devez effectuer le déploiementwsc.waren utilisant les extensions requises créées à l'aide duwscdev.warfichier.Pour configurer l'environnement d'extensibilité, procédez comme suit:
- Créez le fichier
wscdev.waren exécutant la commande suivante:buildwar.sh (buildwar.cmd for Windows) -Dappserver=<application server> -Dwarfiles=wscdevNote : Si vous utilisez le mode EAR pour le déploiement, incluezwscdevWAR dans la commande build EAR. - Déployez le fichier WAR de l'application.
- Vérifiez que la valeur de l'argument système
uiExtensibilityModepour le serveur d'applications est définie surtrue.Par défaut, les extensions sont créées dans le répertoire <INSTALL_DIR>/extensions/<app>/webpages/ . Ici,
<app>fait référence au code d'application.Vous pouvez éventuellement créer des extensions dans n'importe quel autre répertoire en définissant la valeur de l'argument système sur
uiExtensibilityWorkspaceDir. Par exemple, -DuiExtensibilityWorkspaceDir=<workspace directory>. Ici,<workspace directory>fait référence au répertoire dans lequel les extensions sont créées. Avant de créer un fichier WAR, copiez les extensions du répertoire de l'espace de travail dans le répertoire d'installation. - Pour Extensibility Workbench, utilisez
wscdev.war. Vérifiez que l' URL permettant de se connecter à Extensibility Workbench est http://<IP address>:<port>/wscdev/store/login.do? depuis le bureau.Remarque: Vous pouvez personnaliser les fenêtres mobiles en entrant l' URL mobile à partir d'un appareil de bureau. L' URL mobile est http://<IP address>:<port>/wscdev/store/mobile/login.do?.
- Créez le fichier
- Pour étendre l'application, il est recommandé que chaque utilisateur dispose d'un environnement d'exécution dédié et d'un déploiement de serveur d'applications. Sinon, les extensions risquent d'être écrasées.
- Vous pouvez insérer le code personnalisé dans le fichier
<screen-name>Extn.js. Si le fichier<screen-name>Extn.jsest déjà présent et que vous modifiez un écran, le fichier<screen-name>Extn.jsexistant n'est pas écrasé. A la place, un nouveau<screen-name>Extn_sample.jsest créé pour s'assurer que le code personnalisé n'est pas perdu. Vous pouvez utiliser le nouvel exemple de fichier comme référence.