La variable d’environnement PATH de Windows est une variable importante qui peut apporter beaucoup de flexibilité dans nos diverses manipulations du système. Je risque d’en parler (ou en ai déjà parlé par le passé), alors un article dédié pour bien comprendre son fonctionnement est nécessaire !
La solution conseillée pour déployer des fichiers dans une projet SharePoint est de créer un module et d’inclure dans celui-ci les différents fichiers à envoyer sur le site SharePoint ciblé. C’est facile, propre, efficace et tous les fichiers se retrouvent ainsi dans un répertoire choisi, par exemple au nom de notre solution, ou celui du module.
Mais aujourd’hui, une question m’est venue : comment déployer des bibliothèques JavaScript téléchargées et maintenues par NuGet, et les utiliser dans, par exemple, une “WebPart” ?
Je pensais que simplement référencer le chemin relatif dans le fichier “Elements.xml” de mon module suffirait mais : non.
Des recherches sur Google m’ont suggérées beaucoup de choses comme l’utilisation de dossiers mappés, simplement copier/coller les fichiers depuis le dossier “Scripts” dans un module, passer par des CDN, … Rien qui ne me convenait.
Du coup, je me suis mis à réfléchir, à tester… Et pour finir par trouver une solution propre, satisfaisante et qui devrait tenir la route. Je vais tout expliquer en partant d’un projet SharePoint complètement vide, on évitera la moindre confusion ainsi 😃
… Jusqu’à ce que cela nous arrive 😄
On rigole beaucoup de cette fameuse ligne de commande qui, en toute innocence, supprimera récursivement tous les fichiers et dossier à partir du root…
Cette bêtise n’est pas réservée à Linux et j’ai failli expérimenter la même chose aujourd’hui en PowerShell. C’est un excellent cas pratique pour montrer comment éviter ça.
Lorsque que l’on crée une machine virtuelle sur Azure, le disque dur virtuel contenant la partition principale peut être plus ou moins grand, selon la taille de la machine choisie. Cependant, il se peut que pour certaines raisons, il soit nécessaire d’augmenter la taille de cette partition.
Cela peut se faire facilement de façon graphique, via le portail d’administration de notre compte Azure ou bien en ligne de commande, avec Azure PowerShell (des cmdlets utilisables en PowerShell). J’ai choisi ici de passer par PowerShell car cela permet de donner une bonne petite introduction pratique de ce qu’il est possible de faire avec cet outil sur Azure. Il est à noter qu’il existe deux types de machines virtuelles sur cette plateforme : les dites “classiques” et les nouvelles basée sur le modèle “Resource Manager”. Microsoft conseille de passer par ce dernier qui est le plus récent et qui offre la plus grande souplesse d’utilisation. C’est donc ce modèle que j’appliquerai ici.
PowerShell est un interpréteur de commandes amélioré disposant de plus de fonctionnalités que la console classique et permet surtout l’utilisation de scripts proches de ceux que l’on peut retrouver sur Linux, dans le principe. Ce qui est intéressant avec PowerShell est qu’il est buildé sur le framework .NET et utilise donc des objets .NET. Les scripts créés pour PowerShell sont appelés “cmdlets” (pour “command-let”). L’autocomplétion est présente, comme sur la console de commande classique intégrée à Windows mais elle a été améliorée afin de gérer, par exemple, les attributs d’objets instanciés dans notre session.