Docs For Class toba_ap_tabla

Métodos Propios

toba_ap_tabla_db	__construct()
void	activar_baja_logica()	Activa el mecanismo de baja lógica En este mecanismo en lugar de hacer DELETES actualiza una columna
void	activar_modificacion_clave()	Permite que las modificaciones puedan cambiar las claves del registro
void	activar_perfil_de_datos()	Activa el uso de perfil de datos en la carga del componente
void	activar_proceso_carga_externa_consulta_php()
void	activar_proceso_carga_externa_dao()	Carga una columna separada del proceso común de carga Se brinda un DAO que carga una o más columnas denominadas como 'externas' Una columna externa no participa en la sincronización posterior, pero por necesidades casi siempre estéticas necesitan mantenerse junto al conjunto de datos.
void	activar_proceso_carga_externa_datos_tabla()	Carga una columna separada del proceso común de carga Se brinda un Datos Tabla que carga una o más columnas denominadas como 'externas' Una columna externa no participa en la sincronización posterior, pero por necesidades casi siempre estéticas necesitan mantenerse junto al conjunto de datos.
void	activar_proceso_carga_externa_sql()	Carga una columna separada del proceso común de carga Se brinda una query que carga una o más columnas denominadas como 'externas' Una columna externa no participa en la sincronización posterior, pero por necesidades casi siempre estéticas necesitan mantenerse junto al conjunto de datos.
void	activar_transaccion()	Utilizar una transaccion de BD cuando sincroniza la tabla
void	adjuntar_campos_externos()
void	adjuntar_campos_externos_masivo()
void	agregar_schema()
boolean	cargar_con_datos()	Carga el datos_tabla asociado CON un conjunto de datos especifico
boolean	cargar_con_sql()	Carga el datos_tabla asociado CON una query SQL directa
boolean	cargar_con_where()	Carga el datos_tabla asociaciado a partir de una clausula where personalizada
boolean	cargar_con_where_from_especifico()	Carga el datos_tabla asociado CON clausulas WHERE y FROM especificas, el entorno no incide en ellas
boolean	cargar_por_clave()	Carga el datos_tabla asociado restringiendo POR valores especificos de campos de la tabla
void	carga_inicial_campos_externos()
void	completa_campos_externos_fila_con_proceso()
void	desactivar_transaccion()	No utilizar una transaccion de BD cuando sincroniza la tabla
void	ejecutar_con_binarios()
void	ejecutar_sql()	Shortcut de toba::db()->ejecutar
void	es_seq_tabla_ext()
void	evt__perdida_sincronizacion()	Ventana para manejar la pérdida de sincronización con la tabla en la base de datos El escenario es que ejecuto un update/delete usando los valores de las columnas originales y no arrojo resultados, con lo que se asume que alguien más modifico el registro en el medio La transacción con la bd aún no se terminó (si es que esta definida)
void	evt__post_delete()	Ventana de extensión posterior al borrado de un registro durante una sincronización con la base
void	evt__post_insert()	Ventana de extensión posterior a la inserción de un registro durante una sincronización con la base
void	evt__post_sincronizacion()	Ventana para incluír validaciones (disparar una excepcion) o disparar procesos antes de terminar de sincronizar con la base de datos
void	evt__post_update()	Ventana de extensión posterior a la actualización de un registro durante una sincronización con la base
void	evt__pre_delete()	Ventana de extensión previa al borrado de un registro durante una sincronización con la base
void	evt__pre_insert()	Ventana de extensión previo a la inserción de un registro durante una sincronización con la base
void	evt__pre_sincronizacion()	Ventana para incluír validaciones (disparar una excepcion) o disparar procesos previo a sincronizar con la base de datos
void	evt__pre_update()	Ventana de extensión previo a la actualización de un registro durante una sincronización con la base
void	get_flag_mod_clave()
void	get_from_default()
void	get_lock_optimista()
void	get_select_col()
void	get_sql_campos_default()
array	get_sql_inserts()	Retorna los sql de insert de cada registro cargado en el datos_tabla, sin importar su estado actual
void	get_usar_trim()
void	get_valores_llaves()
array	info()	Método de debug que retorna las propiedades internas
void	ini()	Ventana para agregar configuraciones particulares despues de la construccion
void	inicializar()	Ventana para agregar configuraciones particulares antes de que el objeto sea construido en su totalidad
void	log()	Shorcut a toba::logger()->debug incluyendo infomación básica del componente
void	pertenece_a_tabla()	recibe una columna y una tabla y devuelve verdadero si la columna
void	set_lock_optimista()	Activa/Desactiva un mecanismo de chequeo de concurrencia en la edición
void	set_schema()
void	set_usar_trim()	Activa/Desactiva el uso automático del trim sobre datos en el insert o update
integer	sincronizar()	Sincroniza los cambios en los registros de esta tabla con la base de datos
integer	sincronizar_actualizados()	Sincroniza con la BD aquellos registros que suponen actualizaciones
integer	sincronizar_eliminados()	Sincroniza con la BD los registros borrados en esta tabla
integer	sincronizar_insertados()	Sincroniza con la BD aquellos registros que suponen altas
void	usar_clase_consulta_php()
void	usar_metodo_dao()
void	usar_metodo_dt()
void	usar_metodo_sql_fila()
void	verificar_existencia_valores()

Constructor __construct [línea 55]

toba_ap_tabla_db __construct(
toba_datos_tabla
$datos_tabla 
)

Parámetros:

toba_datos_tabla

$datos_tabla:

Tabla que persiste

Redefinido en subclases como:

toba_ap_tabla_db_s::__construct()

activar_baja_logica [línea 245]

void activar_baja_logica(
string
$columna, mixed
$valor 
)

Activa el mecanismo de baja lógica En este mecanismo en lugar de hacer DELETES actualiza una columna

Parámetros:

string	$columna:	Columna que determina la baja lógica
mixed	$valor:	Valor que toma la columna al dar de baja un registro

activar_modificacion_clave [línea 255]

void activar_modificacion_clave(
)

Permite que las modificaciones puedan cambiar las claves del registro

Implementation of:

toba_ap_tabla::activar_modificacion_clave(): Permite que las modificaciones puedan cambiar las claves de una fila

activar_perfil_de_datos [línea 120]

void activar_perfil_de_datos(
)

Activa el uso de perfil de datos en la carga del componente

activar_proceso_carga_externa_consulta_php [línea 224]

void activar_proceso_carga_externa_consulta_php(

$metodo, 
$id_consulta_php, 
$col_parametros, 
$col_resultado, [
$sincro_continua = true], [
$estricto = true], [
$carga_masiva = 0], [
$metodo_masivo = ''] 
)

Parámetros:

	$metodo:
	$id_consulta_php:
	$col_parametros:
	$col_resultado:
	$sincro_continua:
	$estricto:
	$carga_masiva:
	$metodo_masivo:

activar_proceso_carga_externa_dao [línea 181]

void activar_proceso_carga_externa_dao(
string
$metodo, [string
$clase = null], [string
$include = null], array
$col_parametros, array
$col_resultado, [boolean
$sincro_continua = true], [boolean
$estricto = true], [
$carga_masiva = 0], [
$metodo_masivo = ''] 
)

Carga una columna separada del proceso común de carga Se brinda un DAO que carga una o más columnas denominadas como 'externas' Una columna externa no participa en la sincronización posterior, pero por necesidades casi siempre estéticas necesitan mantenerse junto al conjunto de datos.

Parámetros:

string	$metodo:	Método que obtiene los datos.
string	$clase:	Clase a la que pertenece el método. Si es NULL usa el mismo AP
string	$include:	Archivo donde se encuentra la clase. Si es NULL usa el mismo AP
array	$col_parametros:	Columnas que espera recibir el DAO.
array	$col_resultado:	Columnas del registro resultante que se tomarán para rellenar la tabla
boolean	$sincro_continua:	En cada pedido de página ejecuta el DAO para actualizar los valores de las columnas
boolean	$estricto:	Indica si es imperioso que la columna externa posea un estado o se permite que no posea valor.
	$carga_masiva:
	$metodo_masivo:

activar_proceso_carga_externa_datos_tabla [línea 210]

void activar_proceso_carga_externa_datos_tabla(
string
$tabla, string
$metodo, array
$col_parametros, array
$col_resultado, [boolean
$sincro_continua = true], [boolean
$estricto = true], [
$carga_masiva = 0], [
$metodo_masivo = ''] 
)

Carga una columna separada del proceso común de carga Se brinda un Datos Tabla que carga una o más columnas denominadas como 'externas' Una columna externa no participa en la sincronización posterior, pero por necesidades casi siempre estéticas necesitan mantenerse junto al conjunto de datos.

Parámetros:

string	$tabla:	Identificador del objeto_datos_tabla a utilizar.
string	$metodo:	Método que obtiene los datos.
array	$col_parametros:	Columnas que espera recibir el DAO.
array	$col_resultado:	Columnas del registro resultante que se tomarán para rellenar la tabla
boolean	$sincro_continua:	En cada pedido de página ejecuta el DAO para actualizar los valores de las columnas
boolean	$estricto:	Indica si es imperioso que la columna externa posea un estado o se permite que no posea valor.
	$carga_masiva:
	$metodo_masivo:

activar_proceso_carga_externa_sql [línea 155]

void activar_proceso_carga_externa_sql(
string
$sql, array
$col_parametros, array
$col_resultado, [boolean
$sincro_continua = true], [boolean
$estricto = true] 
)

Carga una columna separada del proceso común de carga Se brinda una query que carga una o más columnas denominadas como 'externas' Una columna externa no participa en la sincronización posterior, pero por necesidades casi siempre estéticas necesitan mantenerse junto al conjunto de datos.

Parámetros:

string	$sql:	Query de carga que devolvera un registro conteniendo las columnas 'externas'
array	$col_parametros:	Columnas que espera recibir el sql, en la sql necesitan esta el campo entre % (%nombre_campo%)
array	$col_resultado:	Columnas del registro resultante que se tomarán para rellenar la tabla
boolean	$sincro_continua:	En cada pedido de página ejecuta la sql para actualizar los valores de las columnas
boolean	$estricto:	Indica si es imperioso que la columna externa posea un estado o se permite que no posea valor.

activar_transaccion [línea 128]

void activar_transaccion(
)

Utilizar una transaccion de BD cuando sincroniza la tabla

adjuntar_campos_externos [línea 1372]

void adjuntar_campos_externos(

$datos, 
$parametros 
)

Parámetros:

	$datos:
	$parametros:

Access:

protected

adjuntar_campos_externos_masivo [línea 1341]

void adjuntar_campos_externos_masivo(

$datos, 
$externos, 
$parametros 
)

Parámetros:

	$datos:
	$externos:
	$parametros:

Access:

protected

agregar_schema [línea 304]

void agregar_schema(

$elemento 
)

Parámetros:

$elemento:

Access:

protected

cargar_con_datos [línea 393]

boolean cargar_con_datos(
array
$datos, [boolean
$anexar_datos = false], [boolean
$usar_cursores = false] 
)

Carga el datos_tabla asociado CON un conjunto de datos especifico

Parámetros:

array	$datos:	Datos a cargar en formato RecordSet. No incluye las columnas externas.
boolean	$anexar_datos:	Si es false borra todos los datos actuales de la tabla, sino los mantiene y adjunto los nuevos
boolean	$usar_cursores:	En caso de anexar datos, fuerza a que los padres de la fila sean los cursores actuales de las tablas padre

Return:

Falso si no se encontro ningún registro

cargar_con_sql [línea 369]

boolean cargar_con_sql(

$sql, [boolean
$anexar_datos = false], [boolean
$usar_cursores = false] 
)

Carga el datos_tabla asociado CON una query SQL directa

Parámetros:

boolean	$anexar_datos:	Si es false borra todos los datos actuales de la tabla, sino los mantiene y adjunto los nuevos
boolean	$usar_cursores:	En caso de anexar datos, fuerza a que los padres de la fila sean los cursores actuales de las tablas padre
	$sql:

Return:

Falso si no se encontro ningún registro

cargar_con_where [línea 338]

boolean cargar_con_where(
string
$clausula, [boolean
$anexar_datos = false], [boolean
$usar_cursores = false] 
)

Carga el datos_tabla asociaciado a partir de una clausula where personalizada

Parámetros:

string	$clausula:	Cláusula where que será anexada con un AND a las cláusulas básicas de la tabla
boolean	$anexar_datos:	Si es false borra todos los datos actuales de la tabla, sino los mantiene y adjunto los nuevos
boolean	$usar_cursores:	En caso de anexar datos, fuerza a que los padres de la fila sean los cursores actuales de las tablas padre

Return:

Falso si no se encontro ningun registro

cargar_con_where_from_especifico [línea 355]

boolean cargar_con_where_from_especifico(
[array
$where = null], [array
$from = null], [boolean
$anexar_datos = false], [boolean
$usar_cursores = false] 
)

Carga el datos_tabla asociado CON clausulas WHERE y FROM especificas, el entorno no incide en ellas

Parámetros:

array	$where:	Clasulas que seran concatenadas con un AND
array	$from:	Tablas extra que participan (la actual se incluye automaticamente)
boolean	$anexar_datos:	Si es false borra todos los datos actuales de la tabla, sino los mantiene y adjunto los nuevos
boolean	$usar_cursores:	En caso de anexar datos, fuerza a que los padres de la fila sean los cursores actuales de las tablas padre

Return:

Falso si no se encontro ningún registro

cargar_por_clave [línea 322]

boolean cargar_por_clave(
array
$clave, [boolean
$anexar_datos = false], [boolean
$usar_cursores = false] 
)

Carga el datos_tabla asociado restringiendo POR valores especificos de campos de la tabla

Parámetros:

array	$clave:	Arreglo asociativo campo-valor
boolean	$anexar_datos:	Si es false borra todos los datos actuales de la tabla, sino los mantiene y adjunto los nuevos
boolean	$usar_cursores:	En caso de anexar datos, fuerza a que los padres de la fila sean los cursores actuales de las tablas padre

Return:

Falso si no se encontro ningun registro

Implementation of:

toba_ap_tabla::cargar_por_clave(): Obtiene del medio un conjunto de datos a partir de una definición de sus campos clave

carga_inicial_campos_externos [línea 1168]

void carga_inicial_campos_externos(

$datos 
)

Parámetros:

$datos:

completa_campos_externos_fila_con_proceso [línea 1207]

void completa_campos_externos_fila_con_proceso(

$fila, 
$proceso 
)

Parámetros:

	$fila:
	$proceso:

Access:

protected

desactivar_transaccion [línea 137]

void desactivar_transaccion(
)

No utilizar una transaccion de BD cuando sincroniza la tabla

Generalmente por que la transaccion la abre/cierra algun proceso de nivel superior

ejecutar_con_binarios [línea 779]

void ejecutar_con_binarios(

$sql, 
$binarios, [
$id_fila = null] 
)

Parámetros:

	$sql:
	$binarios:
	$id_fila:

Access:

protected

ejecutar_sql [línea 770]

void ejecutar_sql(

$sql, [
$id_fila = null] 
)

Shortcut de toba::db()->ejecutar

Parámetros:

	$sql:
	$id_fila:

Access:

protected

es_seq_tabla_ext [línea 587]

void es_seq_tabla_ext(

$col 
)

Parámetros:

$col:

Abstract:
Access:	protected

Redefinido en subclases como:

toba_ap_tabla_db_s::es_seq_tabla_ext()

evt__perdida_sincronizacion [línea 667]

void evt__perdida_sincronizacion(
integer
$id_fila, string
$sql_origen 
)

Ventana para manejar la pérdida de sincronización con la tabla en la base de datos El escenario es que ejecuto un update/delete usando los valores de las columnas originales y no arrojo resultados, con lo que se asume que alguien más modifico el registro en el medio La transacción con la bd aún no se terminó (si es que esta definida)

Parámetros:

integer	$id_fila:	Id. de fila de la tabla en la cual se encontró el problema
string	$sql_origen:	Sentencia que se intento ejecutar

Information Tags:

Ventana:

evt__post_delete [línea 761]

void evt__post_delete(
mixed
$id_registro 
)

Ventana de extensión posterior al borrado de un registro durante una sincronización con la base

Parámetros:

mixed

$id_registro:

Clave interna del registro

Access:

protected

Information Tags:

Ventana:

evt__post_insert [línea 733]

void evt__post_insert(
mixed
$id_registro 
)

Ventana de extensión posterior a la inserción de un registro durante una sincronización con la base

Parámetros:

mixed

$id_registro:

Clave interna del registro

Access:

protected

Information Tags:

Ventana:

evt__post_sincronizacion [línea 655]

void evt__post_sincronizacion(
)

Ventana para incluír validaciones (disparar una excepcion) o disparar procesos antes de terminar de sincronizar con la base de datos

La transacción con la bd aún no se terminó (si es que esta definida)

Information Tags:

Ventana:

evt__post_update [línea 747]

void evt__post_update(
mixed
$id_registro 
)

Ventana de extensión posterior a la actualización de un registro durante una sincronización con la base

Parámetros:

mixed

$id_registro:

Clave interna del registro

Access:

protected

Information Tags:

Ventana:

evt__pre_delete [línea 754]

void evt__pre_delete(
mixed
$id_registro 
)

Ventana de extensión previa al borrado de un registro durante una sincronización con la base

Parámetros:

mixed

$id_registro:

Clave interna del registro

Access:

protected

Information Tags:

Ventana:

evt__pre_insert [línea 726]

void evt__pre_insert(
mixed
$id_registro 
)

Ventana de extensión previo a la inserción de un registro durante una sincronización con la base

Parámetros:

mixed

$id_registro:

Clave interna del registro

Access:

protected

Information Tags:

Ventana:

evt__pre_sincronizacion [línea 648]

void evt__pre_sincronizacion(
)

Ventana para incluír validaciones (disparar una excepcion) o disparar procesos previo a sincronizar con la base de datos

La transacción con la bd ya fue iniciada (si es que esta definida)

Information Tags:

Ventana:

evt__pre_update [línea 740]

void evt__pre_update(
mixed
$id_registro 
)

Ventana de extensión previo a la actualización de un registro durante una sincronización con la base

Parámetros:

mixed

$id_registro:

Clave interna del registro

Access:

protected

Information Tags:

Ventana:

get_flag_mod_clave [línea 983]

void get_flag_mod_clave(
)

Abstract:
Access:	protected

Redefinido en subclases como:

toba_ap_tabla_db_s::get_flag_mod_clave()

get_from_default [línea 885]

void get_from_default(
)

Abstract:
Access:	protected

Redefinido en subclases como:

toba_ap_tabla_db_s::get_from_default()

get_lock_optimista [línea 287]

void get_lock_optimista(
)

get_select_col [línea 883]

void get_select_col(

$col 
)

Parámetros:

$col:

Abstract:
Access:	protected

Redefinido en subclases como:

toba_ap_tabla_db_s::get_select_col()

get_sql_campos_default [línea 589]

void get_sql_campos_default(

$where 
)

Parámetros:

$where:

Abstract:
Access:	protected

Redefinido en subclases como:

toba_ap_tabla_db_s::get_sql_campos_default()

get_sql_inserts [línea 1105]

array get_sql_inserts(
)

Retorna los sql de insert de cada registro cargado en el datos_tabla, sin importar su estado actual

get_usar_trim [línea 274]

void get_usar_trim(
)

get_valores_llaves [línea 1328]

void get_valores_llaves(

$datos, 
$parametros 
)

Parámetros:

	$datos:
	$parametros:

Access:

protected

info [línea 109]

array info(
)

Método de debug que retorna las propiedades internas

ini [línea 85]

void ini(
)

Ventana para agregar configuraciones particulares despues de la construccion

Access:

protected

Information Tags:

Ventana:

inicializar [línea 79]

void inicializar(
)

Ventana para agregar configuraciones particulares antes de que el objeto sea construido en su totalidad

See:	toba_ap_tabla_db::ini()
Deprecated:
Access:	protected

Information Tags:

Ventana:

log [línea 100]

void log(

$txt 
)

Shorcut a toba::logger()->debug incluyendo infomación básica del componente

Parámetros:

$txt:

Access:

protected

pertenece_a_tabla [línea 296]

void pertenece_a_tabla(

&$col, 
$tabla 
)

recibe una columna y una tabla y devuelve verdadero si la columna

pertenece a la tabla y falso en caso contrario

Parámetros:

	&$col:
	$tabla:

set_lock_optimista [línea 282]

void set_lock_optimista(
[
$usar = true] 
)

Activa/Desactiva un mecanismo de chequeo de concurrencia en la edición

Parámetros:

$usar:

set_schema [línea 260]

void set_schema(

$schema 
)

Parámetros:

$schema:

set_usar_trim [línea 269]

void set_usar_trim(
boolean
$usar 
)

Activa/Desactiva el uso automático del trim sobre datos en el insert o update

Parámetros:

boolean

$usar:

sincronizar [línea 437]

integer sincronizar(
[
$filas = array()] 
)

Sincroniza los cambios en los registros de esta tabla con la base de datos

Sólo se utiliza cuando la tabla no está involucrada en algun datos_relacion, sino la sincronización es guiada por ese objeto

Parámetros:

$filas:

Return:

Cantidad de registros modificados

Information Tags:

Throws:

toba_error En case de error en la sincronizacion, se aborta la transaccion (si se esta utilizando)

Implementation of:

toba_ap_tabla::sincronizar(): Sincroniza los cambios en la tabla con el medio de persistencia

sincronizar_actualizados [línea 518]

integer sincronizar_actualizados(
[
$filas = array()] 
)

Sincroniza con la BD aquellos registros que suponen actualizaciones

Parámetros:

$filas:

Return:

Cantidad de modificaciones a la base

Implementation of:

toba_ap_tabla::sincronizar_actualizados(): Sincroniza los cambios que suponen inserts o updates

sincronizar_eliminados [línea 466]

integer sincronizar_eliminados(
[
$filas = array()] 
)

Sincroniza con la BD los registros borrados en esta tabla

Parámetros:

$filas:

Return:

Cantidad de modificaciones a la base

Implementation of:

toba_ap_tabla::sincronizar_eliminados(): Sincroniza los cambios que suponen eliminaciones

sincronizar_insertados [línea 491]

integer sincronizar_insertados(
[
$filas = array()] 
)

Sincroniza con la BD aquellos registros que suponen altas

Parámetros:

$filas:

Return:

Cantidad de modificaciones a la base

usar_clase_consulta_php [línea 1309]

void usar_clase_consulta_php(

$param_clase, 
$parametros, [
$es_carga_inicial = false] 
)

Parámetros:

	$param_clase:
	$parametros:
	$es_carga_inicial:

Access:

protected

usar_metodo_dao [línea 1264]

void usar_metodo_dao(

$param_dao, 
$parametros, [
$es_carga_inicial = false] 
)

Parámetros:

	$param_dao:
	$parametros:
	$es_carga_inicial:

Access:

protected

usar_metodo_dt [línea 1289]

void usar_metodo_dt(

$param_dt, 
$parametros, [
$es_carga_inicial = false] 
)

Parámetros:

	$param_dt:
	$parametros:
	$es_carga_inicial:

Access:

protected

usar_metodo_sql_fila [línea 1244]

void usar_metodo_sql_fila(

$fila, 
$parametros 
)

Parámetros:

	$fila:
	$parametros:

Access:

protected

verificar_existencia_valores [línea 1397]

void verificar_existencia_valores(

$fila, 
$parametros, [
$evento = null] 
)

Parámetros:

	$fila:
	$parametros:
	$evento:

Access:

protected

	Centrales \| Componentes \| Debug \| Fuentes \| SalidaGrafica \| Seguridad \| Varios

[ árbol de herencia: Componentes ] [ índice: Componentes ] [ índice general ]