Determinación del tipo de campos estándar

Nota: El miembro 'valores' está presente para cualquier campo de tipo lista desplegable, y los campos de lista desplegable que no tienen el miembro 'restringido' son de referencia. La API de servicio Web del Centro de servicio al usuario impone la lista de valores para campos de lista desplegable sobre inserciones o actualizaciones.

La llamada de consulta siempre devuelve el valor, no la etiqueta. La etiqueta correspondiente para un valor en la respuesta de descripción se debe utilizar cuando se muestra el valor para el usuario en cualquier interfaz de usuario.

Campos de fecha hora

Todos los campos de fecha y hora se transfieren a través de la API del servicio Web del Centro de servicio al usuario mediante el tipo de dateTime.iso8601 para XML-RPC o el tipo de dateTime para SOAP. Sin embargo, el Centro de servicio al usuario tiene dos formas diferentes de gestionar fechas y horas internamente.

En algunos casos, los campos de fecha y hora se pueden gestionar de forma idéntica, pero en otros puede ser necesario tratarlos de un modo distinto.

Campos de fecha y hora regulares:

Los campos de fecha y hora regulares se almacenan como número de segundos después de la medianoche del 1 de enero de 1970 GMT. Se convierten automáticamente en la zona horaria de GMT/UTC. No es necesario traducir su marca de hora local al valor de zona horaria de GMT/UTC.

Ejemplos de campos de fecha y hora regulares incluyen todos los campos de fecha de creación y de fecha y hora de inicio y de finalización.

Campos de sólo fecha:

Algunos campos en Centro de servicio al usuario son únicamente campos de sólo fecha. La parte de tiempo para el campo de solo fecha no es relevante y se establece siempre como medianoche en la zona horaria de GMT/UTC.

Los campos de solo fecha se transfieren en la API como tipos de dateTime para SOAP y como tipos de dateTime.iso8601 para llamadas de XML-RPC, ya que XMLRPC no tiene ningún tipo de solo fecha.

Tenga en cuenta las siguientes recomendaciones:

• Se deben gestionar los valores de los campos de solo fecha de forma distinta a los valores de fecha y hora regulares:
• Se debe ignorar cualquier parte de hora.
• Envíe las partes de tiempo incluyendo todos los ceros.

El Centro de servicio al usuario acepta valores de solo fecha que tienen una parte de hora distinta de cero. Sin embargo, la parte de hora se trunca siempre a cero. No se debe alterar ningún valor de solo fecha para explicar cambios de zona horaria, ya que la parte de hora no es relevante.

Campos personalizados

En la interfaz de usuario del Centro de servicio al usuario, las organizaciones pueden definir un número de conjunto de campos personalizados para entidades diferentes. Por lo general, los clientes de la API del servicio Web del Centro de servicio al usuario no necesitan saber si un campo es estándar o personalizado para la organización.

Los campos personalizados tienen un ID de campo único, en lugar de un nombre de ID con caracteres ingleses. Este ID de campo único siempre tiene el prefijo 'cf_' en todas las llamadas. Al hacer solicitudes, se debe prefijar también cualquier ID de campo personalizado con la cadena 'cf_'. Esta restricción no se aplica a la implementación de XML-RPC de la API de servicio Web de Service Desk.

Nota: Todos los campos numéricos personalizados se gestionan como un tipo entero.

Los campos ID

El campo ID se crea automáticamente en la inserción. No se puede cambiar durante la vida del registro, ni siquiera aunque el registro se suprima y, a continuación, se recupere. Se garantiza que cada valor de ID es único global. El ID de un registro es la mejor forma para identificar de forma exclusiva al registro. Al insertar o al actualizar registros, la API acepta un ID de entero.

Los campos ID con referencia cruzada

Muchas entidades tienen campos ID con referencia cruzada, que son similares a los campos de clave externa en una tabla de base de datos. En algunos casos, una entidad puede hacer referencia a otra entidad de su mismo tipo. Por ejemplo, los tickets tienen un vínculo padre que puede dirigir a otro ticket.

También puede consultar cada entidad con referencias cruzadas. Al consultar un campo ID de referencia cruzada, éste devuelve un ID de entidad del tipo apropiado. A continuación, se puede consultar dicho ID para obtener más información sobre la entidad, utilizando el ID en el campo ID para la consulta.

El valor del campo ID con referencia cruzada es un registro válido en su organización, o un valor vacío, que indica una referencia vacía.

Se garantiza que el valor del campo ID con referencia cruzada, si no está vacío, sea una entidad de la organización. Sin embargo, no se garantiza que se pueda consultar esa entidad.

Los usuarios de una organización a los que se les conceden los privilegios necesarios (permisos) para acceder a la operación de consulta en esa entidad pueden consultar siempre dicha entidad. Se puede restringir la visualización o la edición de la entidad a la que se hace referencia para el resto de usuarios que pertenecen a la misma organización.

Además, también hay limitaciones específicas cuando se especifica un valor para un campo ID con referencia cruzada al insertar o actualizar un registro. El valor debe ser una entidad válida del tipo apropiado. El usuario debe tener el acceso adecuado a esa entidad.

Campos de texto largos