AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Administrar bases de datos / HFSQL / Funciones HFSQL
  • 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
  • Versiones anteriores
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
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).
OLE DBConectores Nativos El archivo <Alias> utiliza los parámetros de conexión de <Data file> (parámetros definidos en el análisis).
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.
Para asociar el alias a un archivo de datos físico de nombre diferente, debe utilizar HChangeConnection, HChangeName y HChangeDir.

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:
HAlias("*")

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: 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.
WINDEVWEBDEV - Código ServidorReportes y ConsultasUniversal Windows 10 AppiPhone/iPadIOS WidgetMac CatalystJavaCódigo de Usuario (UMC)AjaxProcedimientos almacenados

Cambiar el directorio o modificar la conexión

Si se ha utilizado HChangeDir o HConnect con el archivo de datos inicial, estos cambios se ignoran para el archivo de datos <Alias>..
Una vez creado el alias, le recomendamos que utilice HChangeConnection para definir los parámetros de conexión en el archivo de alias.
WINDEV

Versiones anteriores

Esta función sustituye a HAlias_55, que se mantiene por compatibilidad con WINDEV 5.5.
Componente: wd290hf.dll
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 27/05/2022

Señalar un error o enviar una sugerencia | Ayuda local