IBM Enterprise Records, Versión 5.1.+            

Artefactos de consulta comunes de IBM Enterprise Records

En este tema se describen las clases y propiedades de IBM® Enterprise Records que se utilizan con más frecuencia en las consultas relacionadas con informes de IBM Enterprise Records.

Estas no son solo las clases y propiedades que puede utilizar en las consultas de informes, sino que son los elementos utilizados con más frecuencias en los escenarios típicos de elaboración de informes.

Las siguientes secciones se refieren a estas clases y propiedades por su "nombre simbólico" neutral relacionado con el entorno local en oposición a su nombre de visualización relacionado con la interfaz de usuario. Debe utilizar el nombre simbólico de una clase P8 CM de RM o una propiedad P8 CM de RM como identificadores de columna en las sentencias SQL de las consultas de informes P8 CM de RM.

Propiedades comunes

En la siguiente tabla se describen varios tipos de propiedad de IBM Enterprise Records que son comunes a muchas clases de IBM Enterprise Records y que resultan útiles a la hora de elaborar informes.

Tabla 1. Tipos de propiedad comunes de IBM Enterprise Records
Nombre simbólico Tipo de datos Descripción
Id Id Identidad exclusiva de cada objeto de instancia P8 CM
Aggregation String Indica el tipo general de un objeto de IBM Enterprise Records. Los valores válidos son "RecordInfo", "ClassificationScheme", "RecordCategory", "RecordFolder" y "Volume".
DateCreated DateTime Fecha original de creación de la instancia
Creator String Nombre de usuario del autor
DateLastModified DateTime Fecha de la última modificación de la instancia
LastModifier String Nombre de usuario del último modificador de la instancia
IsDeleted boolean "True" si el objeto de IBM Enterprise Records se ha eliminado de forma lógica. Por lo general, se incluye como una marca de "False" en una cláusula WHERE
Location, HomeLocation Object [Location] Por lo general, se aplica a los registros físicos y a los contenedores físicos. Esta valor de propiedad se utiliza frecuentemente en una cláusula LEFT OUTER JOIN con la tabla Location para determinar el valor LocationName del objeto Ubicación.
Tipo de entidad de RM
Valor exclusivo de solo lectura que se asigna a cada clase OOTB de IBM Enterprise Records. Los valores comunes son:
100
ClassificationScheme (plan de archivos)
101
RecordCategory
102
RecordFolder
103
Volume
105
ElectronicRecordFolder
106
PhysicalBox, Box
108
HybridRecordFolder
110
PhysicalRecordFolder
301
ElectronicRecordInfo
302
EmailRecordInfo
303
Marcadores (registro físico)
Se utilizan en la mayoría de las ocasiones con una cláusula WHERE para especificar un subtipo concreto.

Contenedores de registros

En la siguiente tabla se describen varios tipos de propiedad de IBM Enterprise Records que son comunes a las clases de contenedor preconfiguradas (por ejemplo, Categoría de registro, Carpeta de registro o Volumen) y que resultan útiles a la hora de elaborar informes.

Tabla 2. Propiedades relacionadas con la clase de contenedor de registros
Nombre simbólico Tipo de datos Descripción
PathName String Nombre completo de vía de acceso en el almacén de objetos.
DateOpened DateTime Representa la fecha original de apertura del contenedor.
DateClosed DateTime Representa la fecha original de cierre del contenedor.
ReOpenedDate DateTime Representa la fecha original de reapertura del contenedor.
Inactive boolean "True" si el contenedor ya no está activo.
DisposalSchedule Object [Disposal Schedule] El programa, si existe alguno, asignado al contenedor.
DisposalSchedule AllocationDate DateTime Fecha en la que se asoció DispositionSchedule con esta instancia.
CurrentPhaseAction Object [Action1] Instancia de acción asociada con la fase de disposición actual.
CurrentPhase ReviewDecision String Comentarios de revisión de la fase de disposición actual.
CurrentPhase DecisionDate DateTime

Fecha de la decisión de revisión de la fase actual.

Especificación de relaciones de contención en una consulta

La sintaxis utilizada para especificar un subcontenedor descendente depende del nivel de profundidad dentro de la jerarquía del contenedor en el que se realizará la búsqueda.

En el caso general de un nivel inferior de la jerarquía, se aplica el operador P8 CM SQL "INSUBFOLDER". Por ejemplo:
SELECT ... FROM RecordFolder rf 
WHERE rf.This INSUBFOLDER '/...'
En el caso concreto de un subcontenedor hijo inmediato, puede utilizar el operador "INFOLDER":
SELECT ... FROM RecordFolder rf 
WHERE rf.This INFOLDER '/...'
Sin embargo, la propiedad Parent de la clase de contenedor resulta más eficaz:
SELECT ... FROM RecordFolder rf 
WHERE rf.Parent = OBJECT('/...')
Cuando la relación de contención se encuentre entre un contenedor y un objeto de documento/registro hijo inmediato, el uso de la tabla ReferentialContainmentRelationship resulta más eficaz que el del operador "INFOLDER":
SELECT ... FROM RecordInfo ri INNER JOIN ReferentialContainmentRelationship rcr ON ri.This = rcr.Head 
WHERE rcr.Tail = OBJECT('/...')
Tabla 3. Propiedades de clase ReferentialContainmentRelationship
Nombre simbólico Tipo de datos Descripción
Head Object [RecordInfo] Referencia al objeto contenido
Tail Object [Folder] Referencia al objeto contenedor
ContainmentName String Nombre exclusivo del contenido dentro del contenedor.

Registros

En la siguiente tabla se describen varios tipos de propiedad de IBM Enterprise Records que son comunes a las clases de registro preconfiguradas (por ej. Registro electrónico, Registro de marcadores, ...) y que resultan útiles a la hora de elaborar informes:

Tabla 4. Propiedades relacionadas con la clase de registro
Nombre simbólico Tipo de datos Descripción
DocumentTitle String Nombre del registro. No es necesariamente el mismo que el containmentName del registro dentro de un contenedor.
Associated RecordType Object [RecordType] La instancia RecordType, si existe alguna, asociada con una instancia de registro.
CutOffInherited From Id ID del objeto mediante el cual se asocia un registro con un programa de disposición. El Id es el de un contenedor de registro o un RecordType.
CurrentPhaseAction Object [Action1] Instancia de acción asociada con la fase de disposición actual.
CurrentPhase ReviewDecision String Comentarios de revisión de la fase de disposición actual.
CurrentPhase DecisionDate DateTime Fecha de la decisión de revisión de la fase actual.
IsVitalRecord boolean "True" si el registro es de tipo vital.
VitalRecord ReviewDate DateTime Fecha de la última revisión de registro vital.
VitalRecord NextReviewDate DateTime Fecha de la siguiente revisión de registro vital.
CurrentClassification String (Confidencial de DoD) Valor establecido de marca de seguridad actual.
DowngradeOnDate DateTime (Confidencial de DoD) Fecha de degradación del registro programada.
Instrucciones de degradación String (Confidencial de DoD) Instrucciones de degradación.
DeclassifyOnDate DateTime

(Confidencial de DoD) Fecha de desclasificación del registro programada.

Clases relacionadas con disposiciones

Tabla 5. Propiedades relacionadas con el programa de disposición aplicable
Nombre simbólico Tipo de datos Descripción
DisposalSchedule Name String Nombre del programa.
CutoffDisposal Trigger Object [Disposal Trigger] Activador asociado con este programa.
Tabla 6. Propiedades relacionadas con el programa de disposición aplicable
Nombre simbólico Tipo de datos Descripción
DisposalTrigger Name String Nombre del activador.
EventType integer
Utiliza la lista de opciones "EventType":
  1. Predefinido
  2. Externo
  3. Metadatos
  4. Cíclico
Tabla 7. Propiedades relacionadas con la fase aplicable
Nombre simbólico Tipo de datos Descripción
PhaseName String Nombre de fase.
PhaseAction Object [Action1]
Tabla 8. Propiedades relacionadas con Action1 aplicables
Nombre simbólico Tipo de datos Descripción
ActionName String Nombre de acción.
ActionType integer Utiliza la lista de opciones "ActionType":
  1. Revisión
  2. Exportación
  3. Transferencia
  4. Destrucción
  5. Transferencia provisional
  6. Límite del corte
  7. Revisión vital
  8. Destrucción automática
Tabla 9. Propiedades relacionadas con el tipo de registro
Nombre simbólico Tipo de datos Descripción
RecordTypeName String Nombre de tipo de registro
DisposalSchedule Object [Disposal Schedule] La instancia del programa de disposición asociada con la instancia del tipo de registro
DisposalSchedule AllocationDate DateTime Fecha en la que se asoció DispositionSchedule con esta instancia.

Ubicación

Los objetos de la clase Location se asocian tanto con registros físicos como con clases de contenedor de registros físicos. Estas clases tienen por lo general una propiedad Location de objeto tipo que acepta instancias de la clase Location. En algunas instancias, existe también una propiedad de ubicación de origen del mismo tipo.

Tabla 10. Propiedades relacionadas con la ubicación
Nombre simbólico Tipo de datos Descripción
LocationName String Nombre de ubicación
BarcodeID String Representa un valor de código de barras procedente del contenedor físico real.

Retención de registros

Una retención de IBM Enterprise Records se puede aplicar a registros individuales o a contenedores de registros. Las instancias de la clase RecordHold representan diferentes situaciones de retención que se aplican a cero o más elementos. La clase RecordHold se utiliza tanto con registros como con contenedores de registros. Existe una relación muchos a muchos entre las retenciones y los elementos retenidos: una determinada instancia de RecordHold se puede aplicar a más de un registro o contenedor de registros y cualquier registro/contenedor de registros se puede asociar con más de una instancia de RecordHold al mismo tiempo. Estas relaciones se establecen mediante la clase RecordHoldLink o RMFolderHoldLink.

Tabla 11. Propiedades relacionadas con la retención de registros
Nombre simbólico Tipo de datos Descripción
HoldName String Nombre de retención
HoldType String Se asocia con la lista de opciones "HoldTypeList"
Active boolean "True" indica que la instancia de retención está activa actualmente.
Tabla 12. Propiedades relacionadas con la clase HoldLink
Nombre simbólico Tipo de datos Descripción
Head Object [RecordInfo] o [RMFolder] Miembro de elemento retenido de este enlace
Tail Object [RecordHold] Miembro de retención de este enlace.
DateCreated DateTime Representa la fecha en la que este elemento retenido "se situó en una retención".
IsDynamicHold Boolean "True" para indicar que esta relación de retención se estableció mediante el servicio de limpieza de disposición de IBM Enterprise Records en contraposición con la aplicación manual.

Eventos RMAudit

Si se habilita la función de auditoría de IBM Enterprise Records, podrá utilizar instancias de la clase RMAudit para notificar las acciones de los usuarios en varias instancias de clase de IBM Enterprise Records (por ejemplo, registros, contenedores de registro y otras entidades).

Tabla 13. Propiedades relacionadas con la clase RMAudit
Nombre simbólico Tipo de datos Descripción
SourceObjectID Id Id del objeto sobre el que se ha operado para activar el evento de auditoría.
LastModifier String Nombre abreviado del usuario que ha realizado operaciones sobre el objeto de origen.
InitiatingUser String Nombre de usuario con el formato de nombre principal o nombre distinguido.
DateLastModified DateTime Fecha en la sucedió el evento.
AuditActionType String Nombre de la acción; por ejemplo, Desclasificar, Suprimir, Destruir, Degradar, Exportar, Reubicar, Transferir, Actualizar, Retener, Suprimir retención o Revocar declaración.


Feedback

Última actualización: Agosto de 2011


© Copyright IBM Corp. 2011.
Este centro de información se basa en la tecnología Eclipse. (http://www.eclipse.org)