{"id":147279,"date":"2022-09-16T14:55:21","date_gmt":"2022-09-16T14:55:21","guid":{"rendered":"https:\/\/www.ninjaone.com\/blog\/comment-automatiser-la-documentation\/"},"modified":"2024-10-18T21:18:23","modified_gmt":"2024-10-18T21:18:23","slug":"comment-automatiser-la-documentation","status":"publish","type":"post","link":"https:\/\/www.ninjaone.com\/fr\/blog\/comment-automatiser-la-documentation\/","title":{"rendered":"Comment automatiser la documentation ?"},"content":{"rendered":"<p><img fetchpriority=\"high\" decoding=\"async\" class=\"alignnone wp-image-120691 size-full\" title=\"Comment automatiser la documentation ?\" src=\"https:\/\/www.ninjaone.com\/wp-content\/uploads\/2023\/10\/ninjaone-social-1.jpg\" alt=\"Comment automatiser la documentation ?\" width=\"1194\" height=\"627\" \/><\/p>\n<p>Depuis l&rsquo;ajout des champs personnalis\u00e9s \u00e0 NinjaOne, nous avons la possibilit\u00e9 de lire et d&rsquo;\u00e9crire des champs personnalis\u00e9s au niveau de l\u2019appareil via des scripts et le terminal. Les champs personnalis\u00e9s au niveau de l&rsquo;organisation (disponibles dans le cadre de la <a href=\"https:\/\/www.ninjaone.com\/fr\/gestion-de-la-documentation-informatique\/\">fonctionnalit\u00e9 de documentation de NinjaOne<\/a>) ont toujours \u00e9t\u00e9 lisibles via des scripts, mais jusqu&rsquo;\u00e0 pr\u00e9sent, ils n&rsquo;\u00e9taient pas modifiables en \u00e9criture.<\/p>\n<p>Avec la <a href=\"https:\/\/ninjarmm.zendesk.com\/hc\/en-us\/articles\/8327976337677-08-29-2022-NinjaOne-Release-5-3-5\" target=\"_blank\" rel=\"noopener\">version 5.3.5 de NinjaOne<\/a>, nous avons ajout\u00e9 la possibilit\u00e9 d&rsquo;\u00e9crire dans les champs personnalis\u00e9s au niveau de l&rsquo;organisation via des scripts ou le terminal afin de documenter automatiquement.<\/p>\n<h2>\u00c9pargnez-vous des heures de documentation manuelle gr\u00e2ce \u00e0 une multitude de nouvelles possibilit\u00e9s d&rsquo;automatisation<\/h2>\n<p>Il existe fr\u00e9quemment des donn\u00e9es qui seraient utiles pour l&rsquo;\u00e9laboration de scripts sur l&rsquo;ensemble ou un grand nombre de terminaux d\u2019une entreprise. Ces informations peuvent \u00eatre collect\u00e9es et ajout\u00e9es \u00e0 NinjaOne manuellement, mais le fait de permettre l&rsquo;\u00e9criture de champs personnalis\u00e9s au niveau de l&rsquo;organisation par le biais d&rsquo;un script offre des possibilit\u00e9s presque illimit\u00e9es de documentation automatis\u00e9e.<\/p>\n<p><strong>Voici quelques cas concrets d&rsquo;utilisation de l&rsquo;\u00e9criture dans les champs personnalis\u00e9s des organisations :<\/strong><\/p>\n<ul>\n<li>Extraction des cl\u00e9s de licence \u00e0 partir des configurations existantes des terminaux et documentation automatique de ces cl\u00e9s de licence.<\/li>\n<li>Extraire et documenter les identifiants des entit\u00e9s pour des applications comme Azure, Printix, Keeper et d&rsquo;autres solutions multi-locataires.<\/li>\n<li>Extraction et documentation des configurations d&rsquo;applications, d&rsquo;outils et de mat\u00e9riel sous forme de blog XML ou JSON \u00e0 partir du terminal.<\/li>\n<\/ul>\n<p>L&rsquo;avantage le plus important de cette nouvelle fonctionnalit\u00e9 est la possibilit\u00e9 pour les utilisateurs d&rsquo;automatiser des t\u00e2ches comme celles-ci et d&rsquo;\u00e9viter \u00e0 leur \u00e9quipe de passer des heures \u00e0 r\u00e9diger des documents manuellement. Pour les utilisateurs plus avanc\u00e9s, ces cl\u00e9s de licence, ID d\u2019entit\u00e9 et configurations extraites peuvent ensuite \u00eatre r\u00e9f\u00e9renc\u00e9es dans un script ou avec des conditions pour surveiller et alerter en cas changements, d\u00e9ployer des logiciels ou joindre automatiquement un appareil \u00e0 une entit\u00e9.<\/p>\n<h2>Comment \u00e9crire dans les champs personnalis\u00e9s d&rsquo;une organisation dans NinjaOne ?<\/h2>\n<p><strong>1) D\u00e9signez une machine d\u00e9l\u00e9gu\u00e9e<\/strong><\/p>\n<p>L&rsquo;\u00e9criture dans les champs personnalis\u00e9s de l&rsquo;organisation n\u00e9cessite la d\u00e9signation d&rsquo;un d\u00e9l\u00e9gu\u00e9. Cela emp\u00eache que plusieurs appareils \u00e9crivent simultan\u00e9ment dans un champ au niveau de l&rsquo;organisation, ce qui pourrait entra\u00eener des r\u00e9sultats inattendus. Les d\u00e9l\u00e9gu\u00e9s peuvent \u00eatre configur\u00e9s dans l&rsquo;onglet organisations, sous la rubrique documentation.<\/p>\n<p><video class=\"gif-video\" autoplay=\"autoplay\" loop=\"loop\" muted=\"\" width=\"640\" height=\"279\"><source src=\"https:\/\/www.ninjaone.com\/wp-content\/uploads\/2022\/11\/Documentation5.3.5.mp4\" \/><\/video><\/p>\n<p>&nbsp;<\/p>\n<p><strong>2) Configurez votre champ personnalis\u00e9<\/strong><\/p>\n<p>Vous aurez besoin d&rsquo;un champ personnalis\u00e9 au niveau de l&rsquo;organisation pour y \u00e9crire. Ces champs sont configur\u00e9s comme des formulaires dans l&rsquo;application Documentation. Pour \u00e9crire dans un champ par le biais d&rsquo;un script ou d&rsquo;un terminal, vous devez d\u00e9finir le champ scripts sur \u00ab\u00a0\u00e9criture uniquement\u00a0\u00bb ou \u00ab\u00a0lecture\/\u00e9criture\u00a0\u00bb.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-136707\" src=\"https:\/\/www.ninjaone.com\/wp-content\/uploads\/2023\/10\/Setting-read-status-for-scripts.png\" alt=\"D\u00e9finition du statut de lecture pour les scripts\" width=\"600\" height=\"335\" \/><\/p>\n<p>&nbsp;<\/p>\n<p><strong>3) R\u00e9digez votre script<\/strong><\/p>\n<p>Cette mise \u00e0 jour a ajout\u00e9 trois nouvelles commandes pour la cr\u00e9ation de scripts dans NinjaOne :<\/p>\n<ul>\n<li><strong>Ninja-Property-Docs-Set $TemplateID <\/strong>\u00ab\u00a0$DocumentName\u00a0\u00bb $AttributeName<\/li>\n<li><strong>Ninja-Propri\u00e9t\u00e9-Docs-Set-Single <\/strong>\u00ab\u00a0templateName\u00a0\u00bb \u00ab\u00a0fieldName\u00a0\u00bb \u00ab\u00a0new value\u00a0\u00bb<\/li>\n<\/ul>\n<p>Pour rendre cela plus concret, voyons \u00e0 quoi peut ressembler la documentation automatique d&rsquo;un ID d\u2019entit\u00e9 Azure avec NinjaOne.<\/p>\n<p>Supposons que nous ayons assign\u00e9 notre d\u00e9l\u00e9gu\u00e9 et cr\u00e9\u00e9 le document ci-dessous.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-136719\" src=\"https:\/\/www.ninjaone.com\/wp-content\/uploads\/2023\/10\/ad-documentation-example-1.png\" alt=\"documentation publicitaire exemple 1\" width=\"936\" height=\"334\" \/><\/p>\n<p>&nbsp;<\/p>\n<p>\u00c9crivons notre script :<\/p>\n<ul>\n<li>L&rsquo;ID \/ nom du mod\u00e8le est \u00ab\u00a0Active Directory\u00a0\u00bb<\/li>\n<li>Le nom du document est \u00ab\u00a0Tyrell Active Directory\u00a0\u00bb<\/li>\n<li>Le nom de l&rsquo;attribut est azureTenantID<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\">$tenantId = (Get-AzureADTenantDetail).objectId\n\nNinja-Property-Docs-Set 'Active Directory' 'Tyrell Active Directory' azureTenantID $tenantId\n<\/pre>\n<p><strong>4) D\u00e9ployez votre script<\/strong><\/p>\n<p>Enfin, vous devez d\u00e9ployer votre script sur le terminal d\u00e9l\u00e9gu\u00e9 appropri\u00e9. Une fois que le script a \u00e9t\u00e9 ex\u00e9cut\u00e9, le script \u00e9crira dans le champ personnalis\u00e9 au niveau de l&rsquo;organisation et se terminera avec succ\u00e8s.<\/p>\n<p>Nous l&rsquo;ex\u00e9cutons ensuite sur la machine d\u00e9l\u00e9gu\u00e9e pour mettre \u00e0 jour le mod\u00e8le.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-136731\" src=\"https:\/\/www.ninjaone.com\/wp-content\/uploads\/2023\/10\/ad-documentation-example-2.png\" alt=\"exemple de documentation publicitaire 2\" width=\"936\" height=\"334\" \/><\/p>\n<h2>Vous voulez voir NinjaOne \u00e0 l\u2019action ?<\/h2>\n<p><a href=\"https:\/\/www.ninjaone.com\/fr\/planifiez-une-demo-gratuite-fr\/\">Assistez \u00e0 une courte d\u00e9monstration gratuite<\/a>, ou essayez ces fonctionnalit\u00e9s par vous-m\u00eame en vous inscrivant \u00e0 un <a href=\"https:\/\/www.ninjaone.com\/fr\/phase-de-test-gratuit\/\">essai gratuit<\/a>.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Depuis l&rsquo;ajout des champs personnalis\u00e9s \u00e0 NinjaOne, nous avons la possibilit\u00e9 de lire et d&rsquo;\u00e9crire des champs personnalis\u00e9s au niveau de l\u2019appareil via des scripts et le terminal. Les champs personnalis\u00e9s au niveau de l&rsquo;organisation (disponibles dans le cadre de la fonctionnalit\u00e9 de documentation de NinjaOne) ont toujours \u00e9t\u00e9 lisibles via des scripts, mais jusqu&rsquo;\u00e0 [&hellip;]<\/p>\n","protected":false},"author":39,"featured_media":137734,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_relevanssi_hide_post":"","_relevanssi_hide_content":"","_relevanssi_pin_for_all":"","_relevanssi_pin_keywords":"","_relevanssi_unpin_keywords":"","_relevanssi_related_keywords":"","_relevanssi_related_include_ids":"","_relevanssi_related_exclude_ids":"","_relevanssi_related_no_append":"","_relevanssi_related_not_related":"","_relevanssi_related_posts":"","_relevanssi_noindex_reason":"","_lmt_disableupdate":"","_lmt_disable":"","footnotes":""},"categories":[4336,4324,3054],"tags":[],"class_list":["post-147279","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-documentation-informatique","category-ninjaone-fr","category-rmm-fr"],"acf":[],"modified_by":null,"_links":{"self":[{"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/posts\/147279","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/users\/39"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/comments?post=147279"}],"version-history":[{"count":0,"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/posts\/147279\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/media\/137734"}],"wp:attachment":[{"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/media?parent=147279"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/categories?post=147279"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/tags?post=147279"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}