Sincronización de los campos personalizados con el dominio

Como proveedor de servicios, a veces se necesita información adicional para resolver ciertos tipos de ticket. Para dichos tickets, se pueden configurar campos adicionales según los requisitos de la organización. Estos campos se conocen como campos personalizados en ServiceAide Cloud Service Management.

Se pueden agregar los campos personalizados a los dominios del conjunto de datos en la aplicación. A continuación, se pueden utilizar estos campos al crear informes y vistas adhoc. Para agregar los campos personalizados a un dominio, sincronice el dominio con los datos de los campos personalizados.

El procedimiento para sincronizar los campos personalizados con el dominio Compartido es diferente del procedimiento para el dominio de Cloud SM.

Requisito previo

Se debe verificar que se han creado los campos personalizados. Para obtener más información, consulte Creación y gestión de las plantillas de campos personalizados.
Se debe verificar que se dispone de los permisos de diseñador de dominios.

Siga los pasos siguientes:

Inicie sesión en Cloud Service Management y vaya a INFORMES, CENTRO DE SERVICIO AL USUARIO, Generación de informes avanzados.

Al agregar campos personalizados, es posible que se dañe el dominio. Por consiguiente, es importante realizar una copia de seguridad del dominio existente antes de realizar los cambios nuevos. Realice una copia de seguridad de los archivos del dominio para revertir a la configuración existente en caso de que se dañen los archivos. Para obtener más información, consulte Copia de seguridad de los archivos del dominio y Restaurar los archivos del dominio.
Si no se guardan los archivos del dominio, la restauración se establecerá en el dominio predeterminado. Se perderán los informes, las vistas adhoc y los cuadros de mandos que se han creado.
Verifique que el nombre del campo personalizado no contenga caracteres acentuados. Por ejemplo, situação_id162 es un campo personalizado con caracteres acentuados.
Para que el campo personalizado esté disponible en la generación de informes avanzados, haga clic en Acciones, Sincronización de los campos personalizados.
Se mostrará una lista de campos personalizados disponibles en una ficha nueva. Si ya se han agregado los campos personalizados al dominio, la lista muestra los campos como seleccionados.

Nota: Para obtener un mejor rendimiento, sincronice los campos personalizados que son necesarios para los informes. El límite máximo para sincronizar los campos personalizados configurables es 50.
El atributo personalizado con el nombre Join no es compatible con la generación de informes avanzados. Sin embargo, el nombre Join es compatible si el atributo tiene un prefijo o sufijo. Por ejemplo, se admite el nombre de atributo personalizado attributJoin o joinAttribute.
Seleccione los campos personalizados que se desean agregar y borre los campos que se desean eliminar. Haga clic en Sincronizar.
Se muestra un mensaje de confirmación y los campos personalizados se agregan o eliminan del dominio.
Si se está utilizando el dominio Cloud SM, realice el paso 5. Si se está utilizando el dominio Compartido, realice los pasos 6 – 12.
Verifique que los campos personalizados se agregan al dominio:
1. Haga clic en la ficha Página principal y, a continuación, haga clic en Acciones, Crear vista adhoc.
2. Seleccione el dominio Cloud SM y haga clic en Seleccionar datos.
3. En el panel Fuente, vaya al conjunto de datos como Tickets o Elementos de configuración. Verifique que los campos personalizados se agregan a la carpeta Atributos personalizados del respectivo conjunto de datos.
Si se está utilizando el dominio Compartido, haga clic en la ficha Página principal y, a continuación, haga clic en Acciones, Editar dominio. Se abrirá la página Editar dominio en una nueva ventana.
Desde el Diseño de dominio, haga clic en Editar con el diseñador de dominio. Se abrirá la ventana Diseñador de dominio.

En la ficha Calculated Fields (Campos calculados), convierta el campo personalizado con tipos de datos que no son de cadena a los respectivos tipos de datos.

Los campos personalizados con tipos de datos como números enteros, números dobles y booleanos se almacenan como tipo de datos de cadena. Convierta el tipo de datos al tipo de datos original para mostrarlos adecuadamente en el informe.

El campo personalizado creado está disponible en las tablas _PIVOT del tipo correspondiente. Por ejemplo, si se crea un campo personalizado del tipo solicitud de servicio, el campo estará disponible en la siguiente tabla:
Tabla dbo_VAPP_SERVICE_REQUEST_ATTRIBUTES_PIVOT.
Haga doble clic en el campo personalizado para el que desea cambiar el tipo de datos.

Introduzca el nombre del campo, el tipo de datos y la expresión para la conversión. Se utiliza la siguiente lista de expresiones para la conversión de los tipos de datos:

Tipo de datos	Expresión	Descripción
Integer (Entero)	str2int(custom field)	Permite convertir los datos a un número entero. Por ejemplo, para convertir el campo Ticket_Id de la tabla dbo_VAPP_SERVICE_REQUEST_ATTRIBUTES_PIVOT, se deben introducir los valores siguientes: Nombre del campo: Ticket_Id_trasnform Tipo: Integer Expresión: str2int(dbo_VAPP_SERVICE_REQUEST_ATTRIBUTES_PIVOT.Ticket_Id)
Doble	str2double(custom field)	Permite convertir el tipo de datos a un número doble. Por ejemplo, para convertir el campo TotalCost de la tabla dbo_VAPP_SERVICE_REQUEST_ATTRIBUTES_PIVOT, se deben introducir los valores siguientes: Nombre del campo: TotalCost_transform Tipo: Doble Expresión: str2int(dbo_VAPP_SERVICE_REQUEST_ATTRIBUTES_PIVOT.TotalCost)
Fecha	EPOCH_TO_UTC_DATETIME(str2int(custom field))	Permite convertir el tipo de datos a un formato de fecha. Por ejemplo, para convertir el campo start_date de la tabla dbo_VAPP_SERVICE_REQUEST_ATTRIBUTES_PIVOT, se deben introducir los valores siguientes: Nombre del campo: start_date_trasnform Tipo: Timestamp Expresión: EPOCH_TO_UTC_DATETIME str2int(dbo_VAPP_SERVICE_REQUEST_ATTRIBUTES_PIVOT.start_date))
Cadena-Concatenación	concat(custom field 1, ’,’,custom field 2)	Permite unir dos cadenas en una. Por ejemplo, para convertir el campo contact_person de la tabla dbo_VAPP_ITEM, se deben introducir los valores siguientes: Nombre del campo: contact_person Tipo: String Expresión: concat(dbo_VAPP_ITEM.person_last_name,',', dbo_VAPP_ITEM.person_first_name)

En la ficha Mostrar, agregue los campos personalizados del panel Recurso al panel Conjuntos y elementos y haga clic en Aceptar.
Seleccione los campos personalizados y los atributos necesarios para la creación o el filtrado de informes. Es posible modificar las propiedades de visualización como, por ejemplo, la etiqueta, la descripción de las tablas y los conjuntos y elementos de cada uno de los campos seleccionados. Realice las siguientes tareas en la ficha Mostrar:
Busque en el panel Recurso los campos personalizados y los atributos que desee agregar desde un JoinTree. Todos los campos y atributos personalizados creados están disponibles en las tablas dinámicas. Los atributos se muestran según el campo Relacionado con un formulario de la plantilla a la que se agrega.
Por ejemplo, se ha creado el atributo ITEM_ID y se ha agregado a la plantilla relacionada con la petición de cambio. Se encuentra el atributo ITEM_ID en la tabla dbo_VAPP_CHANGE_ATTRIBUTES_PIVOT en JoinTree.
Para mover el atributo personalizado del panel Recursos:
- Utilice el icono Agregar a conjuntos para agregar debajo de un conjunto en el panel Conjutos y elementos.
- Utilice el icono Agregar al conjunto seleccionado como un nuevo conjunto al panel Conjuntos y elementos.
Para eliminar un atributo de un conjunto, seleccione el atributo desde Conjuntos y elementos y haga clic en Eliminar elemento.
Nota: Compruebe que el ID del campo es único para cada campo personalizado.
(Opcional) Para activar la traducción de los campos personalizados en un idioma obligatorio:
1. Seleccione el atributo personalizado en el panel Conjuntos y elementos y en el panel Propiedades, haga clic en Editar.
2. Introduzca la clave de la etiqueta y la clave de la descripción y haga clic en Guardar.
  - El formato de la clave de la etiqueta es Etiqueta_campo Tipo_personalizado Ticket_conjuntodatos.
  - El formato de la clave de la descripción es Descripción_campo Tipo_personalizado Ticket_conjuntodatos.
3. Desde la página Editar dominio, descargue el archivo de configuración regional necesarios de los paquetes de la configuración regional. Por ejemplo, el archivo de configuración regional para francés tiene el sufijo _fr_FR y el portugués (Brasil) tiene el sufijo _pr_BR Brasil.
4. Abra el archivo de configuración regional en un editor y agregue la información del atributo.
  Por ejemplo, para el atributo ID del ticket agregado con la etiqueta de clave como Ticket_ID y la clave de la descripción como Ticket_ID_Desc en el archivo de configuración regional francesa:
  Ticket_ID=Identification de billets
  Ticket_ID_Desc=Ticket numéro d'identification
5. Guarde y cierre el archivo.
6. En la página Editar dominio, haga clic en Cambiar al archivo de configuración regional correspondiente. Busque el archivo de configuración regional y haga clic en Seleccionar. El archivo de configuración regional se actualiza con la información del atributo personalizado.
Haga clic en Aceptar. Se abre la página Editar dominio.
Haga clic en Enviar. Los campos personalizados se agregan a los dominios. A partir de este momento, se pueden utilizar estos campos personalizados para crear informes y vistas ad hoc.

Si la generación de informes avanzados no funciona correctamente después de actualizar el dominio, restaure el dominio con los archivos guardados recientemente. Para obtener más información, consulte Restaurar los archivos del dominio.

Compatibilidad del campo personalizado para los activos

Para cada una de las plantillas de activos listos para usar, la aplicación muestra diez atributos personalizados (atributo 1-atributo 10). Estos atributos personalizados pueden asignarse al atributo personalizado que se agregue. Por ejemplo, se agrega un nombre de atributo personalizado- número de cubículo a la plantilla de activos de hardware. El atributo 1 en el conjunto de activos de hardware del dominio asigna este atributo recién agregado. Se pueden cambiar las etiquetas de los atributos como desee que aparezcan en el informe.

Copia de seguridad de los archivos del dominio

Lleve a cabo una copia de seguridad de los archivos del dominio antes de agregar los campos personalizados a los dominios. El procedimiento de copia de seguridad incluye guardar los archivos de diseño del dominio y de seguridad en el equipo local. Si el dominio está dañado, utilice estos archivos para restaurar la configuración de la generación de informes avanzados en los archivos guardados recientemente.

Siga los pasos siguientes:

Inicie sesión en Cloud Service Management y vaya a INFORMES, Generación de informes avanzados, Acciones, Editar dominio.
Archivo de seguridad: en la página Editar dominio localice custom_cloud_sm_security.xml en la esquina superior derecha. Haga clic en custom_cloud_security.xml y guárdelo en el equipo local de la ubicación de su elección.
Archivo de diseño del dominio: haga clic en Editar con el diseñador de dominios, Exportar diseño y guarde el archivo schema.xml en el equipo local de la ubicación de su elección.

Restauración de los archivos del dominio

Si la función de generación de informes avanzados no funciona correctamente después de actualizar el dominio, utilice la seguridad guardada y los archivos de diseño del dominio para restaurar la funcionalidad. La restauración se realiza con los archivos recientemente guardados.

Siga los pasos siguientes:

Vaya a INFORMES, CENTRO DE SERVICIO AL USUARIO, Generación de informes avanzados, Acciones y haga clic en Editar dominio.
Archivo de seguridad:
1. Busque custom_cloud_sm_security.xml en la sección Información opcional. Haga clic en Eliminar para eliminar el archivo de seguridad existente de la aplicación.
2. Haga clic en Agregar archivo de seguridad en la sección Información opcional. Cargue el archivo de seguridad desde la ubicación donde se ha guardado la copia de seguridad de los archivos del dominio y haga clic en Seleccionar.
  Se restaurará el archivo de seguridad.
Archivo de diseño del dominio:
1. Seleccione la opción Dominio y haga clic en Examinar.
2. Cargue el archivo de diseño del dominio desde la ubicación donde se ha guardado la copia de seguridad y aparecerá un mensaje de confirmación. Haga clic en Aceptar.
  El dominio se restaura.
3. Para validar la restauración, haga clic en Editar con el diseñador del dominio y haga clic en Comprobar diseño.