|
|
|
|
- Archivo de datos físicos associated con un alias
- Cancelación de los alias de uno o más archivos de datos
- Alias y consultas
- Manejo del archivo de alias y sus elementos
- Cambiar el directorio o modificar la conexión
HAlias (Función)
No disponible con este tipo de conexión
Crea un alias lógico de un archivo de datos (o consulta) o cancela todos los alias existentes. El alias también puede ser cancelado por HCancelAlias. Recordatorio: Un alias permite trabajar en diferentes archivos de datos físicos que tienen la misma lógica description. Por ejemplo, un archivo de datos se describe en el análisis y la función HAlias crea el alias del archivo. Observación: Esta página de ayuda explica cómo crear un alias con HAlias. A partir de la versión 27, puede utilizar las variables de Alias. Este tipo de Variable facilita la creación y los alias de manipular. // Data Source variable to handle the alias after its creation OrderCheck is Data Source <description=Order> // New feature of version 19: // <description=Order> is used to get the code completion // for the items in the Order data file // Create an alias for the "Order" data file IF HAlias(Order, OrderCheck) = True THEN // "OrderCheck" can now be used in processes. // It behaves like the "Order" file described in the analysis. // By default, the name of the associated physical file corresponds to // the name of the data source, therfore "OrderCheck" in this case // To handle the same physical file as the initial one, the name must be modified: HChangeName(OrderCheck, Order.PhysicalName) // To use a file on another database or in another directory, // you must use HChangeConnection or HChangeDir ELSE Error("Failure creating the alias", HErrorInfo()) RETURN END
Sintaxis
<Result> = HAlias(<Data file> [, <Alias>])
<Result>: booleano - True si se creó el alias,
- False si se produce un problema. La función HError permite identificar el error.
<Data file>: Cadena de caracteres Nombre lógico del archivo de datos (definido en el análisis) o nombre de la consulta (creado con el editor de la consulta). Si este parámetro corresponde a "*", se cancelan todos los alias definidos en la aplicación actual.. Los archivos de datos correspondientes se cierran automáticamente. <Alias>: Cadena de caracteres opcional o fuente de datos Nombre del alias, usado para definir la estructura del alias. Si no se especifica este parámetro, se cancelan todos los alias creados para <Data file>.. Los archivos de datos correspondientes se cierran. Para optimizar sus aplicaciones, se recomienda utilizar una Variable de tipo Fuente de datos (ver ejemplo). Observaciones Archivo de datos físicos associated con un alias Por Default, el nombre especificado para el alias se asigna al archivo de datos físicos correspondiente al alias. Cancelación de los alias de uno o más archivos de datos La cancelación de un alias ( HCancelAlias) cierra el archivo de datos associated. Para cancelar los alias de un archivo de datos, se debe utilizar la función HAlias sin especificar el nombre del alias. Para Cancel todos los alias definidos en todos los archivos de datos del proyecto actual, sólo hay que utilizar la siguiente sintaxis: Alias y consultas - Si la consulta fue creada a través de la programación de (HExecuteSQLQuery), basta con crear la consulta de alias con esta misma función especificando el nombre del alias.
- If la consulta fue creada por editor de reportes, para crear un alias, debe hacerlo usted:
- ejecutar la consulta inicial.
- utilice HAlias y especifique el nombre de la consulta así como el nombre del alias.
- utilizar HExecuteQuery con la consulta de alias. El alias se inicializa.
Por ejemplo:
QueryAlias is Data Source HAlias(QRY_Query1, QueryAlias) HExecuteQuery(QueryAlias)
Observación: Al crear el alias, se debe haber ejecutado la consulta inicial. Ejemplo:
QueryAlias is Data Source IF HExecuteQuery(QRY_Query1) = False THEN Error(HError(hErrCurrent)) ELSE HReadFirst(QRY_Query1) Trace(QRY_Query1.City) HAlias(QRY_Query1, QueryAlias) IF HExecuteQuery(QueryAlias) = False THEN Error(HError(hErrCurrent)) ELSE FOR EACH AliasQuery Trace(QueryAlias.City) END END END
Manejo del archivo de alias y sus elementos - Para evitar el error "Identificador desconocido" al utilizar un archivo de alias y sus elementos, se recomienda utilizar una variable de tipo Fuente de datos para declarar el nombre del alias antes de llamar a la función HAlias.
Por ejemplo:
Order2018 is Data Source HAlias(Order, Order2018)
Atención: los Externo se puede utilizar una palabra clave, pero ralentiza la ejecución significativamente. - En HReadSeek, HReadFirst, HReadNext, ... el nombre del elemento alias no puede utilizarse directamente: el nombre del artículo debe estar entre comillas.
Por ejemplo:
HReadSeekFirst(srcAlias, "KeyItem", "Sought Value")
- El nombre de la fuente de datos no debe ir entre comillas, si Nombramiento automático de las fuentes de datos está activado en la ventana del proyecto description.
- En el editor de ventanas o páginas, los controles no pueden vincularse directamente a los elementos de los archivos de alias. Debes hacerlo:
- asignar un valor a cada control en el código.
- utilizar la función ControlAlias o la DataBinding property antes de llamar:
Ejemplo:
ControlAlias(Control, srcAlias) OR ControlAlias(GR_ControlGroup, srcAlias) OR ControlAlias(WIN_Window, srcAlias) OR EDT_CustomerName.DataBinding = "SrcAlias.CustomerName"
- Los archivos de alias pueden ser manejados por HListItem y HListKey. Los archivos de alias pueden ser re-indexados.
- De forma predeterminada, la contraseña de un archivo de alias es idéntica a la contraseña del archivo de datos inicial. Esta contraseña puede ser modificada por HPass. El nombre del archivo de datos utilizado en esta función corresponde al nombre del alias.
- La modificación de los archivos de datos de automatic puede aplicarse a los archivos de alias.
- Los bloqueos realizados en los archivos de datos o en los registros son efectivos entre los alias de la misma instancia de una aplicación.
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|