Tema
Este artículo describe cómo utilizar la automatización, la CLI y la API con la función de documentación de NinjaOne.
Entorno
Documentación de NinjaOne
Descripción
Puede utilizar la API pública de NinjaOne y el componente ninjarmm-cli para gestionar sus documentos y plantillas en NinjaOne.
Selecciona una categoría para obtener más información:
Scripts
- Vaya a Administración> Biblioteca > Automatización > Añadir > Nuevo script.
- Desde aquí puedes acceder a los fragmentos personalizados de NinjaOne. Los fragmentos personalizados son bloques de construcción dentro de los scripts que dicen «lee esto» o «escribe esto», lo que ayuda a crear un script que interactúa con la documentación.
- Para empezar, selecciona el lenguaje de programación que prefieras, el sistema operativo y la arquitectura. Usa Ctrl + Espacio para abrir el menú de fragmentos.
Ahora, cuando ejecutes el script en un dispositivo (ya sea mediante una tarea programada, un script programado o de forma ad hoc), podrás obtener información automáticamente de la documentación a la que se hace referencia.
CLI
Los campos de la documentación se pueden leer a través de la CLI; esto incluye permitir que se pase HTML a través de la CLI para establecer el valor de los campos WYSIWYG. Para obtener información más detallada sobre la creación de scripts y la documentación, consulte Campos personalizados y documentación: CLI y creación de scripts. Para obtener más información sobre el HTML WYSIWYG, consulte WYSIWYG: HTML compatible y estilos en línea.
A continuación se muestra un ejemplo de la interfaz relacionada con la documentación para la CLI de Windows:
templates - obtener la lista de plantillas, que contiene documentos y atributos
documents "<id/nombre de la plantilla>" - obtener la lista de documentos de una plantilla por id o nombre (se requieren comillas)
get "<id/nombre de la plantilla>" "<nombre del documento>" <nombre del atributo> - obtener un atributo de un documento por nombre del documento e id/nombre de la plantilla (se requieren comillas)
get "<nombre de una sola plantilla>" <nombre del atributo> - obtener el atributo de un documento único por nombre de plantilla (se requieren comillas)
org-set "<id/nombre de la plantilla>" "<nombre del documento>" <nombre del atributo> "<valor del atributo / lista de valores separados por comas>" - establecer el atributo en el documento/atributo especificado por nombre de documento e id/nombre de plantilla (se requieren comillas)
org-set "<nombre de plantilla única>" <nombre del atributo> "<valor del atributo / lista de valores separados por comas>" - establece el atributo en un único documento/atributo por nombre de plantilla (se requieren comillas)
org-clear "<id/nombre de la plantilla>" "<nombre del documento>" <nombre del atributo> - borra el valor del documento por nombre del documento e id/nombre de la plantilla (se requieren comillas, se representa como NULL)
org-clear "<nombre de una sola plantilla>" <nombre del atributo> - borra el valor de un solo documento por nombre de la plantilla (se requieren comillas, se representa como NULL)
org-options "<id/nombre de la plantilla>" "<nombre del documento>" <nombre del atributo>: obtiene la lista de valores válidos para el nombre del atributo del documento por nombre del documento e ID/nombre de la plantilla (aplicable a atributos de menú desplegable y de selección múltiple)
org-options "<nombre de una sola plantilla>" <nombre del atributo>: obtiene la lista de valores válidos para el nombre del atributo de un solo documento por nombre de la plantilla (aplicable a atributos de menú desplegable y de selección múltiple)
También se puede acceder a esto mediante la interfaz de PowerShell en Windows, que es:
Ninja-Property-Docs-Templates
Ninja-Property-Docs-Names $TemplateId
Ninja-Property-Docs-Names "$TemplateName"
Ninja-Property-Docs-Get $TemplateId "$DocumentName" $AttributeName
Ninja-Property-Docs-Set $TemplateID "$DocumentName" $AttributeName
Ninja-Property-Docs-Get-Single "templateName" "fieldName"
Ninja-Property-Docs-Set-Single "templateName" "fieldName" "new value"
Ninja-Property-Docs-Clear
Ninja-Property-Docs-Options
API
Los campos de documentación se pueden crear y actualizar a través de puntos finales de la API pública con autenticación client_credential y permiten la integración de servicios de terceros. Para obtener más información, consulta Operaciones de la API pública de NinjaOne.