DataHistoryManager

SelectVersions

Sintaxis:

SelectVersions(<Filtro>, <Columnas>, <Orden>, <MaxCount>)

Parámetros:

Tipo: Structure.
Estructura que contiene las condiciones de selección de versiones. Se utiliza el par “Clave” – “Valor” siguiente:

• Metadata – valor de tipo MetadataObject: Catalog, MetadataObject: Document, MetadataObject: InformationRegister, MetadataObject: BusinessProcess, MetadataObject: Task, MetadataObject: ChartOfAccounts, MetadataObject: ChartOfCharacteristicTypes, MetadataObject: ExchangePlan, MetadataObject: ChartOfCalculationTypes, MetadataObject: Constant.
• Se utiliza para seleccionar versiones por objeto de metadatos. Si se establecen restricciones de derechos de acceso a nivel de registro (RLS) para el objeto de metadatos, o no se otorga el derecho ReadMissingDataHistory, entonces se lee el dato. Si falta el dato, la versión se excluye de la selección.
• Data – valor de tipo CatalogRef.,DocumentRef.,InformationRegisterRecordKey.,BusinessProcessRef.,TaskRef.,ChartOfAccountsRef.,ChartOfCharacteristicTypesRef.,ExchangePlanRef.,ChartOfCalculationTypesRef.,ConstantValueKey.. Se utiliza para seleccionar versiones de un objeto de datos o un registro de registro de información específico. Si se habilita la restricción de derechos de acceso a nivel de registro (RLS) para el objeto de metadatos, o no se otorga el derecho ReadMissingDataHistory, entonces se lee el dato. Si falta el dato, se genera una excepción.
• DataPresentation – valor de tipo String. Se utiliza para buscar una ocurrencia de valor pasado en la presentación del objeto.
• VersionNumber – valor de tipo Number. Se utiliza para filtrar por número de versión.
• StartDate – valor de tipo Date. Filtra las versiones con una fecha de creación posterior o igual a la fecha especificada.
• EndDate – valor de tipo Date. Filtra las versiones con una fecha de creación anterior o igual a la fecha especificada.
• User – valor de tipo UUID o matriz de tales objetos. Filtra las versiones por ID del usuario que creó la versión. Las condiciones creadas por los valores que se pasaron en la matriz se combinan con OR.
• UserName – valor de tipo String o una matriz de tales objetos. Filtra las versiones por ID del usuario que creó la versión, verifica la ocurrencia. Los nombres deben corresponder a los nombres devueltos utilizando el método de contexto global UserName (UserName). Las condiciones creadas por los valores que se pasaron en la matriz se combinan con OR.
• UserFullName – valor de tipo String o una matriz de tales objetos. Filtra las versiones por ID del usuario que creó la versión, verifica la ocurrencia. Los nombres deben corresponder a los nombres devueltos por el método UserFullName. Las condiciones creadas por los valores que se pasaron en la matriz se combinan con OR.
• DataChangeType – valor de la enumeración DataChangeType o la matriz DataChangeType. Filtra por tipo de cambio.
• Comment – valor de tipo String. Filtra por comentario, verifica la ocurrencia de una cadena.
• Transaction – valor de tipo String. Filtra por transacción, verifica la igualdad.
• Node – ExchangePlanRef.. Filtra por nodo del plan de intercambio.
• FieldValues – valor de tipo Array. Filtra por valor de campo. La matriz tiene elementos de tipo Structure que describen las condiciones colocadas en estas versiones. Selecciona las versiones que satisfacen todas las condiciones de la lista (las condiciones se combinan con AND):
  • Field – valor de tipo String. Obligatorio. Se utiliza para buscar versiones que contienen el campo especificado. Si se especifica una sección tabular, la búsqueda se realiza en todos los subcampos.
  • ValueAfterChange – valor de tipo Arbitrary. Busca versiones con datos que contienen el objeto de metadatos especificado y el valor que es igual al valor pasado. Filtra todas las versiones donde se establece el valor. ValueAfterChange debe completarse si ValueBeforeChange no está completado.
  • ValueBeforeChange – valor de tipo Arbitrary. Busca versiones con datos que contienen el objeto de metadatos especificado y el valor anterior que es igual al valor pasado. Selecciona todas las versiones en cuyas versiones anteriores se establece el valor y no solo la versión en la que se cambia el valor. ValueBeforeChange es necesario si ValueAfterChange no está completado.
• FieldValuesChange – valor de tipo Array. Filtra por cambio real del valor del campo de versión. La matriz contiene cadenas con el nombre del campo. La cadena contiene el nombre del objeto de metadatos, por ejemplo, para filtrar datos por el atributo Precio del objeto Pedido, especifique “Precio”, y para filtrar datos por el atributo Precio de la sección tabular ElementosPedido, especifique “ElementosPedido.Precio”. Puede buscar por un objeto de metadatos eliminado o recibido al intercambiar. La versión recibida al intercambiar puede contener objetos de metadatos que faltan en la configuración actual de la base de información, por eso solo puede seleccionar tales atributos por sus nombres completos. Si no se encuentra el objeto de metadatos por la cadena, se ignora la condición.

Se requieren valores de Metadata o Data. No se requieren otros valores. Si ambos campos (Metadata y Data) están completos, el objeto de metadatos del objeto pasado en el parámetro Data debe coincidir con el objeto de metadatos pasado en el parámetro Metadata.

Tipo: Array, String, Undefined.
Una matriz (o una cadena separada por comas) de nombres de columnas incluidas en la selección. Las siguientes columnas están disponibles:

• Data
• DataPresentation
• VersionNumber
• Date
• User
• UserName
• UserFullName
• DataChangeType
• Comment
• Transaction
• Node

Si esta propiedad se establece en Undefined, la tabla resultante incluye todas las columnas.
Valor predeterminado: Undefined.

Tipo: Array, String, Undefined.
Un nombre de columna o una matriz de nombres de columna para ordenar la selección. Cada nombre de columna puede complementarse con una dirección de ordenación (separada por un espacio), una de las siguientes: “Asc” (ascendente) o “Desc” (descendente). La dirección de ordenación predeterminada es ascendente.
Si esta propiedad se establece en Undefined, el método utiliza la siguiente configuración de orden:

• Con un filtro de Metadata: “Date Desc”, “VersionNumber Desc”
• Con un filtro de Data: “VersionNumber Desc”

Valor predeterminado: Undefined.

Tipo: Undefined, Number.
El número máximo de versiones incluidas en la selección.
Si el valor del parámetro es un número, el método selecciona las versiones que coinciden con el filtro en el orden especificado hasta que su número total alcance el valor de este parámetro.
Si el valor del parámetro es Undefined, el método selecciona todas las versiones que coinciden con el filtro.
Valor predeterminado: Undefined.

Valor devuelto:

Tipo: ValueTable.
Busca el historial de datos de las versiones que coinciden con el filtro especificado.
La tabla de valores tiene las siguientes columnas:

• Data. CatalogRef., DocumentRef., InformationRegisterRecordKey., BusinessProcessRef., TaskRef., ChartOfAccountsRef., ChartOfCharacteristicTypesRef., ExchangePlanRef., ChartOfCalculationTypesRef., ConstantValueKey.. La referencia al objeto de búsqueda de versiones del historial de datos.
• DataPresentation. String. La presentación de datos, la referencia al objeto o la clave del registro de registro de información.
• VersionNumber. Number. El número de versión del objeto.
• Date. Date. La fecha de creación de la versión.
• User. UUID. El ID de usuario que creó la versión del historial de datos.
• UserName. String. El nombre de usuario que creó la versión del historial de datos.
• UserFullName. String. El nombre completo del usuario que creó la versión del historial de datos.
• DataChangeType. DataChangeType. El tipo de cambio de objeto que creó la versión del historial de datos.
• Comment. String. El comentario de la versión del historial de datos.
• Transaction. String. El ID de transacción que creó la versión del historial de datos.
• Node. ExchangePlanRef.. La referencia al nodo del plan de intercambio del que se recuperó el cambio del objeto.

Descripción:

Busca el historial de datos de las versiones que coinciden con el filtro especificado.

Disponibilidad:

Servidor, cliente grueso, conexión externa.
La llamada al método ejecuta una llamada al servidor.

Ejemplo:

Disponible desde:

Disponible desde la versión 8.3.10.