Administración de servicios de Aranda (versión preliminar)

Este conector está disponible en los siguientes productos y regiones:

Service	Class	Regions
Copilot Studio	Premium	Todas las regiones de Power Automate excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas	Estándar	Todas las regiones de Logic Apps excepto las siguientes:      - Regiones de Azure Government      - Regiones de Azure China      - Departamento de Defensa de EE. UU. (DoD)
Power Apps	Premium	Todas las regiones de Power Apps excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)
Power Automate	Premium	Todas las regiones de Power Automate excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)

Contacto
Nombre	Aranda Software
URL	https://arandasoft.com/
Correo Electrónico	soporte@arandasoft.com

Metadatos del conector
Publicador	Aranda Software Corporation
Sitio web	https://arandasoft.com/
Directiva de privacidad	https://arandasoft.com/politica-de-privacidad/
Categorías	Gestión empresarial; Colaboración

Aranda Service Management Suite (ASMS)

Aumente la productividad de su empresa y transforme la experiencia de los usuarios con Aranda Service Management Suite, la solución multiinquilino que le permite administrar, integrar y automatizar procesos y servicios empresariales. Crear, buscar y actualizar registros almacenados en cualquier área de trabajo (proyecto) de ASMS, incluidos incidentes, requisitos y cambios, entre otros.

Requisitos previos

Tenga en cuenta los siguientes requisitos previos para continuar:

• Una suscripción y una instancia de Aranda Service Management Suite (ASMS). Comience aquí: https://arandasoft.com/
• Una suscripción activa de Microsoft Power Automate con funcionalidades del conector Premium.

Obtención de credenciales

• Para realizar la autenticación, use el token de integración. En el vínculo siguiente encontrará información sobre cómo obtener el token de integración.

Introducción al conector

1. Requiere una suscripción a Aranda Service Management Suite (ASMS).

2. Obtención del token de integración

3. Obtenga la dirección URL de instancia de la API de ASMS de Aranda Service Management (ApiAsms).

4. Establezca una conexión con el conector de Aranda Service Management Suite.

5. Seleccione una de las siguientes funciones que ofrece el conector:

   

6. Para obtener documentación detallada sobre el conector, consulte https://docs.arandasoft.com/connectors

Puede usar este conector en los casos siguientes:

1. Crear, buscar y actualizar vales, entre otras acciones disponibles.
2. Obtenga la rastreabilidad de vales.
3. Descargue los datos adjuntos relacionados con un vale.
4. Busque artículos de knowledge base (KB) en Aranda Service Management Suite.
5. Descargue datos adjuntos de artículos de knowledge base (KB).
6. Crear, buscar y actualizar elementos de configuración (ICI).
7. Permite a las organizaciones resolver sus solicitudes de soporte técnico internas, administrar y simplificar el proceso de resolución de problemas técnicos.
8. Permite el seguimiento de las comunicaciones entre los solicitantes y los agentes de soporte técnico.
9. Ofrezca respuestas automatizadas para informar a los solicitantes del estado de su vale.

Respuesta exitosa

Código	Nombre	Description
200	OK	La solicitud fue exitosa
204	Sincontenido	No se encontraron datos en la solicitud

Errores y soluciones comunes

Código	Nombre	Description	Solución
400	Solicitud incorrecta	CriteriaNeedsSomeArguments	Compruebe que los parámetros de búsqueda no están vacíos
400	Solicitud incorrecta	InvalidAdditionalFieldId	Compruebe que los identificadores de los campos adicionales son correctos.
400	Solicitud incorrecta	InvalidItemType	El tipo de caso es incorrecto, cambie el identificador de tipo de caso.
400	Solicitud incorrecta	InvalidProjectId	El identificador del proyecto es incorrecto, cambie el identificador del proyecto al que asociará el caso.
400	Solicitud incorrecta	InvalidStateId	Compruebe el estado agregado al crear o actualizar un vale
400	Solicitud incorrecta	InvalidUploadType	Error al adjuntar un archivo, Solicitar asistencia del administrador del sistema
400	Solicitud incorrecta	RequestNeedsSomeArguments	Compruebe los campos obligatorios del vale y agregue el valor correspondiente de estos en el conector.
400	Solicitud incorrecta	SearchListIsRequired	Solicitar ayuda de un administrador del sistema
400	Solicitud incorrecta	Nombre del parámetro: {Name parameter}	Compruebe que las propiedades mencionadas en el error no son null
400	Solicitud incorrecta	Es un nombre de parámetro null: {Name parameter}	Compruebe que las propiedades mencionadas en el error no son null
400	Solicitud incorrecta	ItemTypeIsRequired	Agregar tipo de caso
400	Solicitud incorrecta	ModelIdIsEmpty	Agregue el parámetro modelId. Es necesario.
400	Solicitud incorrecta	StateIdIsEmpty	Agregue el parámetro stateId. Es necesario.
400	Solicitud incorrecta	ServiceIdIsEmpty	Agregue el parámetro serviceId. Es necesario.
400	Solicitud incorrecta	CategoryIdIsEmpty	Agregue el parámetro categoryId. Es necesario.
400	Solicitud incorrecta	TypesListNeedsSomeArguments	Requiere agregar el tipo de caso al buscar vales, Solicitar asistencia de un administrador del sistema
400	Solicitud incorrecta	'{PARAMETER_NAME}' AdditionalFieldIsRequired	El campo adicional '{PARAMETER_NAME}' es obligatorio
400	Solicitud incorrecta	ModelNotActive	El modelo asociado al caso no está activo
400	Solicitud incorrecta	FailedToCloseTaskPendingCloseTasksPredecessors	Si intenta cerrar el caso y el caso primario tiene tareas pendientes para cerrar
400	Solicitud incorrecta	DuplicatedObject	La ci ya existe en la base de datos
400	Solicitud incorrecta	Nombre del parámetro EmptyValue: {PARAMETER_NAME}	Se requiere el parámetro {PARAMETER_NAME}
400	Solicitud incorrecta	Nombre del parámetro EmptyEnumeration: {PARAMETER_NAME}	El parámetro {PARAMETER_NAME} es una lista y es necesaria
403	Prohibido	DoNotHavePermissionForThisAction	Hable con el administrador del sistema para asignar permisos.

Código	Nombre	Description	Solución
500	Error Interno del Servidor		Solicitar ayuda de un administrador del sistema
500	Error Interno del Servidor	FailureExportExcel	Solicitar ayuda de un administrador del sistema
500	Error Interno del Servidor	FailureGetAdditionalFields	Solicitar ayuda de un administrador del sistema
500	Error Interno del Servidor	FailureGetCategoriesByService	Solicitar ayuda de un administrador del sistema
500	Error Interno del Servidor	FailureGetChangeFSC	Solicitar ayuda de un administrador del sistema
500	Error Interno del Servidor	FailureGetFields	Solicitar ayuda de un administrador del sistema
500	Error Interno del Servidor	FailureGetFieldsList	Solicitar ayuda de un administrador del sistema
500	Error Interno del Servidor	FailureGetFiles	Solicitar ayuda de un administrador del sistema
500	Error Interno del Servidor	FailureGetLookupValues	Solicitar ayuda de un administrador del sistema
500	Error Interno del Servidor	FailureGetMailTemplates	Solicitar ayuda de un administrador del sistema
500	Error Interno del Servidor	FailureGetModelByCategory	Solicitar ayuda de un administrador del sistema
500	Error Interno del Servidor	FailureGetOperators	Solicitar ayuda de un administrador del sistema
500	Error Interno del Servidor	FailureGetReassignmentReasons	Solicitar ayuda de un administrador del sistema
500	Error Interno del Servidor	FailureGetSimilarItems	Solicitar ayuda de un administrador del sistema
500	Error Interno del Servidor	FailureSearchQuickManagement	Solicitar ayuda de un administrador del sistema

Preguntas más frecuentes

1. ¿Cómo recuperar los identificadores de los atributos necesarios para usar las diferentes acciones del conector (por ejemplo, proyecto, servicio, categoría, grupo, especialista)?

   Los identificadores se pueden recuperar de muchas maneras:

   • Con el Administrador de consultas de Aranda, puede crear un informe que consulte la tabla Aranda Service Management Suite (ASMS) donde se encuentran los datos necesarios. Si necesita instrucciones sobre los objetos de datos de la solución, visite el vínculo https://docs.arandasoft.com/docs/database.html siguiente e identifique la versión de la base de datos de Aranda correspondiente a la instalación de ASMS.
   • Si usa una instalación local de ASMS, puede consultar la tabla ASMS donde se encuentran los datos necesarios a través de un cliente SQL.
   • A través del Centro de soporte técnico de Aranda, creando una solicitud de soporte técnico a través de los canales de contacto indicados en el siguiente sitio web soporte técnico.

2. ¿Cuál es el tamaño máximo de los archivos que se van a adjuntar al usar la acción "Agregar datos adjuntos"?

   El tamaño máximo depende de la configuración específica de la instancia o instalación de ASMS. Pregunte al administrador de ASMS.

3. ¿Cuál es el nivel de acceso a datos requerido por la cuenta del técnico cuyo token se usa en la configuración de la conexión de ASMS requerida por el conector?

   El nivel de acceso es el mismo que la cuenta del técnico que se usa en ASMS de forma periódica. En otras palabras, en función de los roles y permisos del técnico correspondiente en ASMS, se puede acceder a los datos con el conector.

4. ¿Debe la cuenta del técnico cuyo token se usará en el conector se denominará o concurrente?

   Dado que el conector puede acceder a la instancia de ASMS relacionada varias veces por hora, se recomienda encarecidamente que la cuenta sea un tipo con nombre.

5. ¿La creación o modificación de casos mediante el conector sigue las mismas reglas de validación de datos presentes en la interfaz de ASMS?

   Sí, sigue las mismas reglas de validación. Por ejemplo, al crear un caso para un proyecto, servicio y categoría específicos, si se deben rellenar campos nativos y adicionales, estos datos también son necesarios al enviar el caso a través del conector.

6. ¿Se puede usar el conector para las instancias de ASMS en entornos locales y en la nube?

   Sí, se puede usar en instalaciones locales y en la nube de ASMS. En Instalaciones locales, debe tener en cuenta la conectividad entre el servidor ASMS y el entorno de Power Automate.

7. Tengo una licencia de Power Automate que solo me permite usar conectores estándar. ¿Puedo usar el conector de ASMS?

   No es posible, el conector de ASMS es de tipo Premium.

8. Quiero crear flujos en Power Automate que comiencen desde eventos en ASMS (por ejemplo, cuando se ha creado un caso, cuando se asigna un caso a un grupo específico). ¿Es posible usar desencadenadores que comienzan desde eventos que se producen en ASMS?

   Sí, es posible. Se recomiendan los pasos siguientes:

   • Inicialice un desencadenador "Cuando se recibe una solicitud HTTP" y cree un esquema JSON del cuerpo de la solicitud que contiene la estructura de datos que se espera que se reciba de ASMS. Una vez creado el desencadenador, obtendrá una dirección URL HTTP POST (dirección URL de webHook) que se usará en la instancia de ASMS. No olvide tener en cuenta el mecanismo de autenticación para acceder a la dirección URL del webHook (por ejemplo, token).
   • Cree una regla de negocios en ASMS para el conjunto de condiciones que, cuando se cumplan, debe iniciar el flujo en Power Automate. Como acción dentro de la regla, seleccione "Invoke Webhook" (Invocar webhook) y, en la dirección URL de destino de invocación, escriba la dirección URL de webHook obtenida anteriormente, los parámetros que se van a enviar y el cuerpo de la solicitud (que debe coincidir con el esquema JSON del cuerpo de la solicitud). Para obtener más información sobre cómo invocar un webhook desde una regla en ASMS, visite el vínculo siguiente: Regla de webhook.
   • Pruebe la regla creada y valide que se envía una solicitud HTTP a la dirección URL del webHook e inicializa el flujo en Power Automate.

9. ¿Puedo invocar puntos de conexión de la API REST de ASMS como acciones desde flujos en Power Automate?

   Sí, es posible. Use la acción "HTTP" y rellene los datos necesarios en él (URI, Método, Encabezados, Cuerpo, entre otros).

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado	Parámetros para crear una conexión.	Todas las regiones	No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre	Tipo	Description	Obligatorio
Host ASMS	cuerda / cadena	Host ASMS	Cierto
Token de autorización	securestring	Token de autorización	Cierto

Limitaciones

Nombre	Llamadas	Período de renovación
Llamadas API por conexión	100	60 segundos

Acciones

Actualizar elemento de configuración	Actualice las API en la CMDB de Aranda.
Agregar datos adjuntos a mayúsculas y minúsculas	Adjunte un archivo a un registro de casos específico en ASMS.
Agregar nota al caso	Agregue una nota a un registro de caso específico en ASMS.
Buscar elementos de configuración	Recupera una lista de registros de LAS API de CMDB en función de los criterios de búsqueda agregados en la consulta.
Buscar en los artículos	Recupera una lista de artículos en función de los criterios de búsqueda agregados en la consulta.
Caso de actualización	Actualiza un registro para un caso de ASMS.
Casos de búsqueda	Recupera una lista de registros de casos de ASMS en función de los criterios de búsqueda agregados en la consulta.
Crear caso	Cree un nuevo registro de casos en ASMS.
Crear elemento de configuración	Cree las API en la instancia de Aranda CMDB.
Descargar los datos adjuntos del artículo	Descargue los datos adjuntos relacionados con el artículo.
Descargar los datos adjuntos del caso	Descargue los datos adjuntos relacionados con el artículo.
Obtención del historial de casos	Obtener el historial de casos, no se incluyen notas predeterminadas.
Obtener caso	Obtiene un registro de los metadatos de un caso de ASMS.
Obtener elemento de configuración	Obtenga CI por nombre y serie.

Actualizar elemento de configuración

Agregar datos adjuntos a mayúsculas y minúsculas

Agregar nota al caso

Buscar elementos de configuración

Buscar en los artículos

Caso de actualización

Casos de búsqueda

Crear caso

Crear elemento de configuración

Descargar los datos adjuntos del artículo

Descargar los datos adjuntos del caso

Obtención del historial de casos

Obtener caso

Obtener elemento de configuración

Definiciones

binario