PC SOFT

AYUDA EN LÍNEA
DE WINDEV, WEBDEV Y WINDEV MOBILE


Este contenido proviene de una traducción automática.. Haga clic aquí para ver la versión original en inglés.
  • Búsqueda genérica/búsqueda por coincidencia de datos de salida
  • Búsqueda realizada sobre un elemento clave o sobre un elemento no clave
  • Realizar una búsqueda en una clave compuesta
  • Buscar en un artículo de array
  • Buscar y filtrar
  • Navegar por los registros correspondientes a una condición
  • Búsqueda por coincidencia exacta en Access
  • Bloqueos
  • Optimización de las operaciones de navegación
  • Conector Nativo XML
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Otros
Procedimientos almacenados
Posiciones en la primera Record de un archivo de datos cuyo valor para un artículo específico es estrictamente igual al valor buscado (búsqueda de coincidencia exacta). El Record se lee y las variables correspondientes HFSQL se actualizan.
En la mayoría de los casos, HReadSeekFirst se utiliza para establecer la posición en el archivo de datos para realizar un bucle de navegación entre los registros que corresponden a una condición. HReadNext se usa para leer el siguiente Record correspondiente a la condición.
Pueden darse varios casos después de la llamada a HReadSeekFirst:
  • a Record correspondiente a la condición se encontró, bloqueado (si es necesario) y cargado en la memoria: HFound devuelve True.
  • si no existe ningún registro que corresponda a la condición, pero existe un registro de mayor valor: se lee el registro, la función HOut devuelve False y la función HFound devuelve False.
  • el archivo de datos está vacío: no se realiza ninguna operación de lectura, HOut devuelve True y HFound devuelve False.
  • la función intenta bloquear un registro ya bloqueado en modo de lectura: no se realiza ninguna operación de lectura, HErrorLock devuelve True y HOut devuelve True.
    Observación: Por defecto, se realiza una gestión automática de errores de bloqueo y de conflictos de modificación (excepto en el código de procedimientos almacenados). La gestión automática de errores se puede personalizar o desactivar en cualquier momento con la función HOnError.
La función HReadSeekFirst puede utilizarse con archivos de datos, vistas HFSQL o consultas.
Observación: la búsqueda puede ser cancelada por HCancelSeek.
Windows MobileJavaPHP Caso especial: gestión de esclusas:
  • Windows Mobile In Mobile, los cierres se gestionan sólo en los archivos de datos de HFSQL Client/Server y en los archivos de datos gestionados por un Conector Nativo. No se pueden bloquear los registros HFSQL Mobile. De hecho, el sistema operativo del Pocket PC no permite bloquear registros.
  • PHP En PHPla gestión de bloqueos no está disponible.
  • Java En Javadurante un acceso por parte de JDBC, la gestión de bloqueos no está disponible para las bases de datos a las que accede JDBC.
Versiones 15 y posteriores
WINDEV MobileAndroid Esta función ahora está disponible para aplicaciones Android.
Nueva funcionalidad versión 15
WINDEV MobileAndroid Esta función ahora está disponible para aplicaciones Android.
WINDEV MobileAndroid Esta función ahora está disponible para aplicaciones Android.
Versiones 17 y posteriores
iPhone/iPad Esta función ahora está disponible para aplicaciones iPhone/iPad.
Nueva funcionalidad versión 17
iPhone/iPad Esta función ahora está disponible para aplicaciones iPhone/iPad.
iPhone/iPad Esta función ahora está disponible para aplicaciones iPhone/iPad.
Versiones 18 y posteriores
Widget Android Esta función ahora está disponible en modo Android Widget.
Universal Windows 10 App Esta función ahora está disponible en modo Windows Store apps.
Nueva funcionalidad versión 18
Widget Android Esta función ahora está disponible en modo Android Widget.
Universal Windows 10 App Esta función ahora está disponible en modo Windows Store apps.
Widget Android Esta función ahora está disponible en modo Android Widget.
Universal Windows 10 App Esta función ahora está disponible en modo Windows Store apps.
Observación: A partir de la versión 19, HFSQL es el nuevo nombre de HyperFileSQL.
Versiones 21 y posteriores
Universal Windows 10 App Esta función ahora está disponible en modo Universal Windows 10 App.
Nueva funcionalidad versión 21
Universal Windows 10 App Esta función ahora está disponible en modo Universal Windows 10 App.
Universal Windows 10 App Esta función ahora está disponible en modo Universal Windows 10 App.
Ejemplo
// Find the first record for which
// the CUSTOMER name is MOORE
HReadSeekFirst(CUSTOMER, NAME, "MOORE")
IF HFound(CUSTOMER) = False THEN
Error("Customer not found")
RETURN
ELSE
// Continue the process on the customer named MOORE
END
Sintaxis
<Result> = HReadSeekFirst(<Data file> , <Item> , <Valor buscado> [, <Opciones>])
<Result>: booleano
  • True si se encontró el Record (corresponde al valor devuelto por HFound).
  • False si se produce un problema. Este problema puede ser causado por:
    • un problema de posicionamiento (archivo de datos vacío, ...): HFound devuelve False y HError devuelve 0.
    • un error: HError devuelve un número entero distinto de 0. HErrorInfo devuelve más detalles.
<Data file>: Cadena de caracteres (con o sin comillas)
Nombre del archivo de datos HFSQL, vista o consulta utilizada.
<Item>: Cadena de caracteres (con o sin comillas)
Nombre del artículo sobre el que se realizará la búsqueda. Este elemento puede ser o no una clave de búsqueda.
Hyper File 5.5 La búsqueda sólo puede realizarse en un elemento clave.
<Valor buscado>: Tipo de valor
Valor del artículo buscado.
<Opciones>: Constante o combinación de constantes opcional
Permite configurar:
  • el modo de bloqueo aplicado al buscado Record
  • el tipo de búsqueda realizada.
hLockReadWriteBloqueo de lectura/escritura: el Record que se lee actualmente no puede ser leído o modificado por otra aplicación.
El bloqueo de teclas se ignora si se utiliza una consulta.
OLE DB Bloquear en sólo escritura. Equivale a la constante hLockWrite.
PHP Esta constante no está disponible.
Java Acceso con JDBC: Esta constante no está disponible.
hLockWriteBloqueo de escritura: el Record que se lee actualmente puede ser leído por otra aplicación pero no puede ser modificado por otra aplicación.
El bloqueo de teclas se ignora si se utiliza una consulta.
PHP Esta constante no está disponible.
Java Acceso con JDBC: Esta constante no está disponible.
hLockNoSin bloqueo (incluso si se llamó a HStartLock): el Record puede ser leído o modificado por otra aplicación durante la lectura.
PHP Esta constante no está disponible.
Java Acceso con JDBC: Esta constante no está disponible.
Versiones 17 y posteriores
hForwardOnly
Nueva funcionalidad versión 17
hForwardOnly
hForwardOnly
Conectores Nativos Esta constante sólo se puede utilizar con Conectores Nativos.
Se utiliza para acelerar la búsqueda de datos durante una búsqueda simple que no utiliza las siguientes funciones:
  • Leyendo el anterior Record.
  • Modificando un Record.
  • Posición de almacenamiento.
Si se utiliza una de estas características, el resultado puede diferir del esperado.
Esta constante se puede utilizar, por ejemplo, durante una búsqueda utilizada para llenar una memoria tabla.
hGenericBúsqueda genérica (ver las Notas)
Una búsqueda de coincidencia exacta es realizada por Default (constante no especificada).
hLimitParsingLa navegación se detendrá tan pronto como se encuentre el último valor buscado o si ningún valor corresponde a la búsqueda..
El actual Record corresponderá a este último Record encontrado.
HFound devolverá False y HOut devolverá True.
Esta constante se utiliza para optimizar la velocidad de búsqueda en el modo Cliente/Servidor y en las bases de datos externas (accesibles a través de OLE DB o a través de Conectores Nativos).
hKeepFilterEl filtro set de HFilter será tenido en cuenta, incluso si la clave de búsqueda no está optimizada para el filtro. Recordatorio: la función HFilter devuelve la clave de búsqueda optimizada para el filtro.
Atención: en este caso, pueden surgir problemas de rendimiento en archivos de datos demasiado grandes.
Hyper File 5.5 Este Variable no puede ser usado.
By Default, la búsqueda realizada después de HReadSeekFirst ignora el filtro.
hNoRefresh
OLE DBConectores Nativos La función HReadSeekFirst no actualiza el contenido de la tabla o consulta. Si es posible, la consulta no se vuelve a ejecutar. Se guardan todas las posiciones guardadas.
Windows Mobile Los bloqueos se gestionan únicamente en los archivos de datos de HFSQL Client/Server o en los archivos de datos gestionados por un Conector Nativo. No se pueden bloquear los registros HFSQL Mobile. De hecho, el sistema operativo del Pocket PC no permite bloquear registros.
PHP La gestión de los bloqueos no está disponible.
Java Acceso con JDBC: La gestión de las cerraduras no está disponible para las bases de datos a las que accede el JDBC.
OLE DBConectores Nativos Las opciones de bloqueo no tendrán efecto si los bloqueos no son soportados por el proveedor OLE DB o por Conector Nativo.
OLE DB El modo de bloqueo especificado con la función HReadSeekFirst seguirá siendo efectivo al llamar a las funciones HReadPrevious y HReadNext.
Para modificar el bloqueo de teclas, debe utilizar:
Observaciones

Búsqueda genérica/búsqueda por coincidencia de datos de salida

  • Búsqueda genérica (principalmente en las posiciones de la cadena de caracteres): Busca todos los registros que empiezan con el valor especificado.
    Por ejemplo: Cuando se realiza una búsqueda genérica en "Smith" (para el elemento NAME), todos los registros cuyo elemento Name comience con "Smith" coincidirán con la búsqueda. Por lo tanto, el Record que contiene "Smither" coincidirá con la búsqueda (HFound devuelve True).
    Observación: Para la compatibilidad con WINDEV 5.5, la búsqueda genérica de una cadena vacía ("") es equivalente al uso de la función HReadFirst.
  • Búsqueda de coincidencia de fecha exacta : Busca todos los registros que coinciden exactamente con el valor especificado..
    Por ejemplo: Cuando se realiza una búsqueda de coincidencia exacta en "Smith" (para el elemento NOMBRE), HFound devuelve True para los registros cuyo elemento coincide exactamente con "Smith".
  • Ejemplos de búsquedas realizadas en el archivo CLIENTE ordenado por nombre:
Valor buscadoOpcionesHReadSeekFirst establece la posición sobre el Record.Devoluciones de HFoundDevoluciones de HOutExplicaciones
De los cuales1TrueFalseDe los cuales existen.
El final del archivo de datos no se ha alcanzado todavía.
Davo1FalseFalseDavo no existe. Posición en el primer valor mayor (Davon).
El final del archivo de datos no se ha alcanzado todavía.
MorohGeneric8TrueFalseMoor no existe pero la búsqueda es genérica y se encuentra Moore (entre otros).
El final del archivo de datos no se ha alcanzado todavía.
MoroNo se encontró el Record (no hay movimiento, el Record actual no cambia).FalseFalseEl moro no existe.
El final del archivo de datos no se ha alcanzado todavía.
NorbertNo se encontró el Record (no hay movimiento, el Record actual no cambia).FalseTrueNorbert no existe.
Posición en el primer valor mayor (este valor no existe): se ha llegado al final del archivo de datos.

Vea el Hyper File 5.5 y 7: ¿Cómo gestionar los caracteres de espacio en las búsquedas? tabla para más detalles

Búsqueda realizada sobre un elemento clave o sobre un elemento no clave

La búsqueda se puede realizar en un elemento clave o no clave.
Si la búsqueda se realiza en un elemento clave:
  • la búsqueda es rápida y el resultado está ordenado.
  • si la navegación es continuada por HReadNext, los siguientes registros corresponderán a los valores mayores o iguales al valor buscado. En este caso, HOut debe ser revisado después de cada operación de lectura para saber si se ha llegado al final del archivo de datos.
Si la búsqueda se realiza en un elemento no clave:
  • el elemento seleccionado aparecerá en rojo en el editor de código y aparecerá un aviso en la "Panel"Errores de compilación.
    Observación: El completado automático propone únicamente los elementos clave.
  • si el navegador es continuado por HReadNext, los siguientes registros corresponderán a los valores iguales al valor buscado.

Realizar una búsqueda en una clave compuesta

Se pueden utilizar varios métodos para realizar una búsqueda en una clave compuesta:
1. Utilizando una lista de valores .
La siguiente sintaxis se utiliza para realizar una búsqueda en una clave compuesta:
HReadSeekFirst(<File Name>, <Name of Composite Key>,
[<Search value of first element of composite key>,
<Search value of first element of composite key>, ...])
Ejemplo:
// Find the record
HReadSeekFirst(CUSTOMER, LASTNAME_FIRSTNAME, ["MOORE", "Vince"])

2. Uso de HBuildKeyValue
Ejemplo:
bufSoughtVal is Buffer = HBuildKeyValue(CUSTOMER, LASTNAME_FIRSTNAME, sLastName, sFirstName)
HSeekFirst(CUSTOMER, LASTNAME_FIRSTNAME, bufSoughtVal)
WHILE HFound(CUSTOMER)
HDelete(CUSTOMER)
HNext(CUSTOMER, LASTNAME_FIRSTNAME)
END

3. Uso de HConvert
Para construir el valor de una clave compuesta sin utilizar la función HBuildKeyValue, es necesario:
  • llenar los componentes del texto en su tamaño completo con Charact( 0).
  • convertir los componentes numéricos con la función HConvert.
Ejemplo:
MyCompositeKey = Complete(Customer.CustomerLastName, Dimension(Customer.LastName), Charact(0)) + ...
Complete(Customer.FirstName, Dimension(Customer.FirstName), Charact(0))
Hyper File 5.5 Para realizar búsquedas genéricas en una clave compuesta, todos los componentes de la clave compuesta deben ser componentes de texto. De lo contrario, se realiza una búsqueda por coincidencia exacta.

Buscar en un artículo de array

La búsqueda se realiza en el primer elemento array (elemento cuyo índice es 1). Para realizar una búsqueda en los otros elementos de array, utilice los filtros o consultas.

Buscar y filtrar

Si un filtro está activado (HFilter), el filtro es tenido en cuenta por la búsqueda sólo si la clave utilizada es idéntica.
Para tener en cuenta este filtro en el resto de la navegación (incluso si la clave de búsqueda no está optimizada para el filtro), utilice la constante hKeepFilter.
Hyper File 5.5 Si se activa un filtro, la búsqueda lo ignora.

Navegar por los registros correspondientes a una condición

En la mayoría de los casos, HReadSeekFirst se utiliza para establecer la posición en el archivo de datos para realizar un bucle de navegación entre los registros que corresponden a una condición. HReadNext y HReadPrevious se utilizan para leer los registros siguientes y anteriores correspondientes a la condición.
Para ignorar la búsqueda mientras se va a la siguiente o anterior Record, utilice una de las siguientes funciones:
WINDEVWEBDEV - Código ServidorReportes y ConsultasAjaxCódigo de Usuario (UMC)OLE DBConectores Nativos

Búsqueda por coincidencia exacta en Access

Para realizar una búsqueda de coincidencia exacta en una base de datos ACCESS, se recomienda utilizar NoSpace si hay caracteres de espacio al final del valor buscado.
WINDEVWEBDEV - Código ServidorReportes y ConsultasiPhone/iPadUniversal Windows 10 AppWindows MobileAjaxCódigo de Usuario (UMC)HFSQLHFSQL Client/ServerHyper File 5.5OLE DBConectores Nativos

Bloqueos

Las cerraduras se aplican sólo cuando se encuentra un Record.
Por defecto (no hay modo de bloqueo especificado en <Opciones>), la Record no está bloqueada.
Si se solicita un bloqueo (constantes hLockWrite o hLockReadWrite), se leerá el registro solo si este aún no ha sido bloqueado.
No es necesario especificar un parámetro de bloqueo si el archivo de datos está bloqueado por HStartLock: el bloqueo especificado por HStartLock se tiene en cuenta automáticamente. Para ignorar la cerradura establecida por HStartLock, usa la constante hLockNo.
Recordatorio: Un Record cerrado puede ser desbloqueado por HUnlockRecNum.
OLE DBConectores Nativos Las opciones de bloqueo no tendrán efecto si el proveedor de OLE DB o Conector Nativo (también llamado Native Access) no admite bloqueos.
WINDEVWEBDEV - Código ServidorReportes y ConsultasiPhone/iPadUniversal Windows 10 AppAjaxCódigo de Usuario (UMC)HFSQLHFSQL Client/ServerHyper File 5.5OLE DBConectores Nativos

Optimización de las operaciones de navegación

Para optimizar los primeros tiempos de navegación en un archivo de datos, usa HOptimize en este archivo de datos.
WINDEVWEBDEV - Código ServidorReportes y ConsultasCódigo de Usuario (UMC)Conectores Nativos

Conector Nativo XML

El comportamiento de la función HReadSeekFirst depende de las funciones HActivateAutoFilter y HDeactivateAutoFilter.
HActivateAutoFilter está habilitado por Default.
Por lo tanto, para leer el contenido del archivo XML, lea el contenido del archivo principal (el padre) y luego lea el contenido de los archivos relacionado (los hijos).
Por Default, cuando se lee un archivo, se aplica automáticamente un filtro a los archivos de relacionado para leer sólo los registros correspondientes al archivo principal.
Por ejemplo:
TEl Email de esta persona puede ser recuperado al navegar por el archivo de la persona.
Para ello, simplemente set la posición en el archivo "Persona" y aplicar HReadSeekFirst al archivo "Email".
En este caso, la Record leída en el archivo "Correo electrónico" corresponderá al primer correo electrónico asociado con la Record actual en el archivo "Persona".
Si este mecanismo está desactivado (HDeactivateAutoFilter), el Record leído en el archivo "Email" corresponderá al primer Record que se encuentre en el archivo "Email" (y no al hijo del Record leído en el archivo "Persona").
Componente : wd250hf.dll
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
//EXEMPLO DE USO DE CHAVE COMPOSTA COM 2 CAMPOS
//EXEMPLO DE USO DE CHAVE COMPOSTA COM 2 CAMPOS

valorNovo is int = TABLEGRID_T027_GRUPOS_PERGUNTAS.COL_T027_ORDEM + 1

bufSearch is Buffer = HBuildKeyValue(T027_GRUPOS_PERGUNTAS,T027_CHAVECOMPOSTA, pgnIDQuestionario,gnIDGrupoPergunta)

IF HReadSeekFirst(T027_GRUPOS_PERGUNTAS,T027_CHAVECOMPOSTA,bufSearch) = True
IF HFound(T027_GRUPOS_PERGUNTAS) = True
T027_GRUPOS_PERGUNTAS.T027_ORDEM = valorNovo
HModify(T027_GRUPOS_PERGUNTAS)
END
END

TableDisplay(TABLEGRID_T027_GRUPOS_PERGUNTAS,taInit)
TableDisplay(TABLEGRID_T027_GRUPOS_PERGUNTAS,taReExecuteQuery)
BOLLER
17 07 2019
Vamos a cambiar el registro.
//Aula 1153 WinDev Curso ErpAmarildo 11 - Tabela Codigo de Alteração

//Nessa aula de hoje
//vamos fazer a alteração do registro.

//En esta clase de hoy
//Vamos a cambiar el registro.

//In this class today
//Let's do the registry change.

IF TableSelect(TABLE_QRY_RELACAO_EMPRESAS)=-1 THEN RETURN
_indice is int=TableSelect(TABLE_QRY_RELACAO_EMPRESAS)
HReadSeekFirst(empresa,empresaID,TABLE_QRY_RELACAO_EMPRESAS.COL_EmpresaID)
IF HFound(empresa) THEN
Open(WIN_Form_empresa)
END
TableDisplay(TABLE_QRY_RELACAO_EMPRESAS,taReExecuteQuery)
TableSelectPlus(TABLE_QRY_RELACAO_EMPRESAS,_indice)
De matos
18 05 2017
Example
// adds a row into the looper
//by Boller - nome das janelas = GPU_WindowPages
//------------------------------------------------
ok is boolean = HReadSeekFirst(GPU_WindowPages,GPU_WindowPages.Name,sElementName,hKeepFilter)
IF ok = True AND HFound(GPU_WindowPages) = False
GPU_WindowPages.Name = sElementName
HAdd(GPU_WindowPages)
END
//------------------------------------------------
BOLLER
24 04 2017
Como Pegar Saldo Anterior Caixa
1) Nessa aula de hoje, vou mostrar como
pegar o saldo incial do caixa.
2) Vamos ter um campo saldo inicial do caixa conta
3) vamos fazer uma query lendo os totais de entrada e saida
4) Vamos atualizar o saldo

//Qry_Saldo_caixa_Inicial
SELECT
SUM(caixa.valor_entradas) AS total_valor_entradas,
SUM(caixa.valor_saidas) AS total_valor_saidas
FROM
caixa
WHERE
caixa.id_empresa = {Parametro_empresa}
AND caixa.Caixa_contaID = {Parametro_contaID}
AND caixa.data_documento<{Parametro_data_inicial}

//
//Chama Rotina Saldo Caixa

saldo_caixa()

//Rotina Saldo Caixa

PROCEDURE saldo_caixa()

HReadSeekFirst(caixa_conta,caixa_contaID,gn_recebe_id_conta)
cy_saldo_inicial is currency=caixa_conta.saldo_inicial // Iniciar 100,00
qry_saldo_caixa_inicial.Parametro_contaID=gn_recebe_id_conta // 1
qry_saldo_caixa_inicial.Parametro_data_inicial=EDT_Data_Inicial // 10 01 2017
qry_saldo_caixa_inicial.Parametro_empresa=gnEmpresaCodigo // 1
HExecuteQuery(qry_saldo_caixa_inicial,hQueryDefault) // executando query
cy_saldo_entradas is currency=qry_saldo_caixa_inicial.total_valor_entradas
//vai somar todas entradas menores que a data inicial = 09 01 2017
cy_saldo_saidas is currency=qry_saldo_caixa_inicial.total_valor_saidas
//vai somar todas saidas menores que a data inicial = 09 01 2017
cy_saldo_inicial=cy_saldo_inicial+cy_saldo_entradas-cy_saldo_saidas
EDT_Saldo_Anterior=cy_saldo_inicial

http://windevdesenvolvimento.blogspot.com.br/2017/01/aula-1031-dicas-012-pegar-saldo.html

https://www.youtube.com/watch?v=xpqkboM8LFY
De matos
13 01 2017
Exemplo HreadSeekFirst - Ncm
PROCEDURE ncm_estado_ler()
HReadSeekFirst(ncm_estado,chave_Ncm_classificacao_Uf,[material.ncm_classificacao,cliente.endereco_uf])
IF HFound(ncm_estado) THEN
info("existe")
ELSE
info("nao Existe")
END

//Blog com Exemplo e video
http://windevdesenvolvimento.blogspot.com.br/2015/11/windev-curso-144-chavecomposta.html
De matos AMARILDO
23 01 2016