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
  • Condiciones de uso
  • Múltiples cambios de nombre
  • Cambiar la unidad o el directorio
  • función HChangeName: Uso con el proveedor de Conectores Nativos y/o OLE DB
  • Varios
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
Modifica el nombre físico de un archivo de datos.
Recordatorio: Por Default, el archivo físico se crea con el nombre que se le dio en el análisis.
Ejemplo
// Create the statistical file for January
HChangeName(Stat, "JanuaryStatistics")
HCréation(Stat)
Sintaxis
<Result> = HChangeName(<Data file> , <Physical name>)
<Result>: booleano
  • True si se realizó la operación,
  • False si se produce un problema. La función HError permite identificar el error.
<Data file>: Cadena de caracteres
Nombre del archivo de datos (definido en el análisis). Este nombre es usado por todas las funciones para manejar los archivos de datos HFSQL.
<Physical name>: Cadena de caracteres
Nuevo nombre físico del archivo de datos.
  • Si este parámetro es una cadena vacía ("""), el nombre físico utilizado corresponderá al nombre físico definido en el análisis.
  • Este parámetro no debe contener ningún nombre de unidad y ningún nombre de directorio.
  • Este nombre se guardará al cerrar el archivo de datos.
  • La propiedad PhysicalName permite conocer el nombre físico del archivo de datos definido con la función HChangeName.
OLE DBConectores Nativos Dependiendo de la base de datos utilizada, el nombre físico del archivo de datos puede ir precedido del nombre de la base de datos, el nombre del usuario o el nombre del esquema. En ese caso:
  • el nombre físico completo se especifica en la descripción de el archivo de datos en el editor de análisis ("Nombre de la tabla en la base de datos externa").
  • HChangeName también puede utilizarse para cambiar el nombre físico del archivo de datos. Consulte Uso con el proveedor de Conectores Nativos y/o OLE DB.
Observaciones

Condiciones de uso

  • El archivo de datos debe cerrarse para que esta modificación se tenga en cuenta (utilice HClose si es necesario), de lo contrario la modificación se tendrá en cuenta durante la siguiente apertura.
  • Conectores Nativos XML: HChangeName cambia el nombre del TAG XML asociado a el archivo de datos descrito en el análisis (no cambia el nombre físico). Para cambiar el nombre del fichero, hay que utilizar una conexión (HDescribeConnection especificando el nombre del fichero XML como fuente de datos) y asociar esta conexión al fichero mediante HChangeConnection.

Múltiples cambios de nombre

Se puede llamar a la función HChangeName varias veces con parámetros diferentes. Cuando el nombre físico se redefine varias veces para el mismo nombre lógico, el apellido que se le dio reemplaza a todos los demás.

Cambiar la unidad o el directorio

La función HChangeName solo permite cambiar el nombre del archivo físico. Para modificar su ubicación, utilice HChangeDir y HSubstDir.
Reportes y ConsultasOLE DBConectores Nativos

función HChangeName: Uso con el proveedor de Conectores Nativos y/o OLE DB

Por Default, el nombre lógico pasado a HChangeName se considera como el único nombre en el tabla. Se encapsula utilizando los caracteres de encapsulación correspondientes a la base de datos o especificados por el proveedor de la base de datos OLE antes de ser enviados a la base de datos (esto se utiliza para gestionar los nombres de tabla que contienen caracteres especiales).
Para proporcionar un nombre de archivo compuesto por <Nombre de usuario>.<Nombre de tabla> (o según la base de datos, <Nombre de esquema>.<Nombre de tabla>) en HChangeName, estos nombres deben estar ya formateados (utilizando los caracteres de encapsulación correspondientes a la base de datos, o especificados por el proveedor de OLE DB).
Ejemplo para SQLServer:
Los caracteres de encapsulación son " " " ".
Para renombrar CLIENTE como DBO.CLIENTE utilizando HChangeName, debe pasar "DBO". "CLIENTE".
Por lo tanto, se debe utilizar el siguiente código:
HChangeName(CUSTOMER, """DBO"".""CUSTOMER""")

Varios

  • Si la gestión de ".REP" está habilitada (HSetREP), la modificación de la ruta se guarda en el archivo ".REP" (véase gestión de archivos .REP).
  • HChangeName es equivalente a HSubstName, disponible en WINDEV 5.5/WEBDEV 1.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