ServiceDesk Plus On-Demand

Cómo integrar ADManager Plus y ServiceDesk Plus On-Demand

• En ADManager Plus, vaya a la pestaña Automatización y haga clic en Integraciones HCM.
• En Aplicaciones HCM, haga clic en el mosaico HCM personalizado para integrar una nueva solución HCM personalizada.
• En la ventana de Integración HCM personalizada que aparece, introduzca un Nombre y una Descripción adecuados, cargue un Logotipo de ServiceDesk Plus On-Demand y haga clic en Guardar.
• Haga clic en el mosaico ServiceDesk Plus On-Demand añadido en el paso anterior para configurar los métodos de autorización de la API, los endpoints y la asignación de datos del LDAP.
• En la sección Autorización, seleccione OAuth 2.0 como Tipo de autorización.
  • Prefijo de la cabecera: Zoho-Oauthtoken
  • Tipo de concesión OAuth 2.0: El código de autorización es el tipo de concesión predeterminado.
  • URL de retorno de llamada: La URL de retorno de llamada es a donde se le redirigirá después de la autenticación. Esto debe registrarse con el proveedor de la API.
  • URL de autorización: https://accounts.zoho.in/oauth/v2/auth?access_type=offline URL del token de acceso: https://accounts.zoho.in/oauth/v2/token
  • ID del cliente y secreto del cliente:> Introduzca un ID válido y su clave secreta. Consulte a continuación para saber cómo generar el ID del cliente y el secreto del cliente.
  • Alcance: SDPOnDemand.requests.ALL.
  • Haga clic en Opciones avanzadas y elija las cabeceras y los parámetros de consulta en el menú desplegable de Añadir a.
• En la sección Configuración de endpoints de la API, añada lo siguiente:
  • URL del endpoint:
    • https://<SDP_SERVER>/api/v3/requests?input_data=<URL encoded input params>
    • Sustituya <SDP_SERVER> por su instancia de ServiceDesk Plus On-Demand.
    • Para crear los parámetros de entrada codificados en URL, construya la entrada JSON con el siguiente formato.
    • {"list_info":{"row_count":"100","start_index":1,"fields_required":["udf_fields.udf_char2","udf_fields.udf_char3"],"search_criteria":[{"field":"last_updated_time","condition":"is","value":"$(LAST_24_HRS)"},{"field":"subject","condition":"like","value":"New employee joining the organization","logical_operator":"and"}],"sort_fields":[{"field":"subject","order":"asc"}]}}
    • En el JSON anterior, sustituya el valor del conjunto json "fields_required" por los atributos personalizados creados en la plantilla de solicitud de ServiceDesk Plus On-Demand para la creación de usuarios.
    • Codifique la entrada utilizando un codificador de URL y sustitúyala en la URL de endpoints en lugar de ""<URL encoded input params>". Puede utilizar cualquier herramienta en línea para codificar url los input_params como
      https://www.urlencoder.org/https://<SDP_SERVER>/api/v3/requests?input_data=<URL encoded input params>
    Nota: Haga clic aquí para ver las referencias API de ServiceDesk Plus On-Demands.
  • Haga clic en Opciones avanzadas para añadir cabeceras y parámetros
  • Método: Elija Get.
  • Cabeceras: Configure las respectivas cabeceras HTTP y sus valores.
    • Aceptar: application/vnd.manageengine.sdp.v3+json
    • Tipo de contenido: application/x-www-form-urlencoded
    • Host: Introduzca la URL de su instancia de ServiceDesk Plus On-Demand
  • Parámetros: Añada los parámetros de consulta necesarios para la configuración de los endpoints.
  • Tipo de mensaje: Seleccione Ninguno.

    Filtro de muestra:

    

    Solicitud de muestra:

    https://<sdp_server>/api/v3/requests?input_data=%7B%22list_info%22%3A%7B%22row_count%22%3A%22100%22%2C%22start_index%22%3A1%2C%22fields_required%22%3A%5B%22udf_fields.udf_char2%22%2C%22udf_fields.udf_char3%22%5D%2C%22search_criteria%22%3A%5B%7B%22field%22%3A%22last_updated_time%22%2C%22condition%22%3A%22is%22%2C%22value%22%3A%22%24(LAST_24_HRS)%22%7D%2C%7B%22field%22%3A%22subject%22%2C%22condition%22%3A%22like%22%2C%22value%22%3A%22New%20employee%20joining%20the%20organization%22%2C%22logical_operator%22%3A%22and%22%7D%5D%2C%22sort_fields%22%3A%5B%7B%22field%22%3A%22subject%22%2C%22order%22%3A%22asc%22%7D%5D%7D%7D

    Ejemplo de solicitud:ainput_data antes de codificar:

    {"list_info":{"row_count":"100","start_index":1,"fields_required":["udf_fields.udf_char2","udf_fields.udf_char3"],"search_criteria":[{"field":"last_updated_time","condition":"is","value":"$(LAST_24_HRS)"},{"field":"subject","condition":"like","value":"New employee joining the organization","logical_operator":"and"}],"sort_fields":[{"field":"subject","order":"asc"}]}} NOTA: "udf_fields.udf_char2","udf_fields.udf_char3" son los atributos AD creados como campos adicionales y añadidos en la plantilla SDP.
  • Marque la opción Repetir llamada a este endpoint para llamar repetidamente a la API hasta obtener la respuesta requerida. En el menú desplegable, seleccione el parámetro y especifique el valor de incremento. También puede establecer una condición que, cuando se cumpla, llame al endpoint repetidamente.
  Nota: Puede configurar varios endpoints para una solución HCM.
• Una vez hecho esto, haga clic en Probar y guardar. Una ventana de respuesta mostrará todos los elementos solicitados.
• Haga clic en Fuente de datos - Asignación de atributos del LDAP para hacer coincidir los endpoints y asignar los atributos del LDAP de AD con los atributos respectivos en la solución HCM.
• Introduzca el Nombre de la configuración y la Descripción y, a continuación, seleccione la Categoría de automatización en el menú desplegable.
• En el campo Seleccionar endpoints, seleccione aquellas columnas que sean exclusivas de los usuarios (como employeeIdenifier y username) pero que tengan el mismo valor en todos los endpoints.
• En el campo Asignación de atributos, seleccione el atributo en el menú desplegable Nombre de atributo del LDAP y asígnelo a la columna correspondiente en la solución HCM.
• Haga clic en Guardar.

Pasos para generar un ID del cliente y un secreto del cliente:

• Navegue hasta la consola API (https://api-console.zoho.com/).
• Haga clic en Añadir cliente y elija el tipo de cliente como Aplicaciones basadas en servidor.
• Introduzca el nombre del cliente deseado.
• Introduzca el URI de la página de inicio como URL de ADManager Plus (por ejemplo: http://:).
• Introduzca los URI de redirección autorizado como (URL de la página de inicio//OAuthCode.do).
• Introduzca un URI de dominio JavaScript válido.
• Haga clic en Crear para generar el ID del cliente y el Secreto del cliente.