Documentation

DepartamentoPDO
in package

FinalYes

Clase para el acceso a datos de los departamentos mediante PDO.

  • Esta clase contiene todos los métodos necesarios para realizar operaciones CRUD y de gestión de estados sobre la tabla T02_Departamento.
Tags
author

Gonzalo Junquera Lorenzo

since
04/02/2026
version
1.0.0

Table of Contents

Methods

altaDepartamento()  : Departamento|null
Inserta un departamento nuevo en la BBDD.
bajaFisicaDepartamento()  : bool
Elimina un departamento de la base de datos
bajaLogicaDepartamento()  : bool
Deshabilita un departamento poniendo la fecha de baja actual.
buscaDepartamentoPorCod()  : Departamento|null
Busca un departamento existente en la BBDD por codDepartamento.
buscaDepartamentosPorDesc()  : array<string|int, Departamento>
Busca departamentos existente en la BBDD por la descripción.
buscaDepartamentosPorDescEstado()  : array<string|int, Departamento>
Busca departamentos existente en la BBDD por la descripción y el estado de alta o baja.
buscaDepartamentosPorDescEstadoPaginado()  : array<string|int, Departamento>
Busca departamentos existente en la BBDD por la descripción, el estado de alta o baja y devuelve en función de la paginaActual.
contarDepartamentosPorDescEstado()  : int
Cuenta departamentos existente en la BBDD por la descripción y el estado de alta o baja.
insertarDepartamentos()  : bool
Inserta en la BBDD un conjunto de departamentos a partir de un array.
modificaDepartamento()  : Departamento|null
Modifica un departamento existente en la BBDD.
rehabilitaDepartamento()  : bool
Habilita un departamento poniendo la fecha de baja a null
validaCodNoExiste()  : bool
Comprueba si existe un departamento con el código indicado en la BBDD.

Methods

altaDepartamento()

Inserta un departamento nuevo en la BBDD.

public static altaDepartamento(string $codDepartamento, string $descDepartamento, float $volumenDeNegocio) : Departamento|null
Parameters
$codDepartamento : string

Código del departamento a insertar

$descDepartamento : string

Descripción departamento a insertar

$volumenDeNegocio : float

Volumen de negocio del departamento a insertar

Return values
Departamento|null

Objeto con el nuevo departamento de la BBDD. Null si no lo ha insertado correctamente.

bajaFisicaDepartamento()

Elimina un departamento de la base de datos

public static bajaFisicaDepartamento(string $codDepartamento) : bool
Parameters
$codDepartamento : string

Código del departamento a eliminar

Return values
bool

True si se borró correctamente, false si no se borró

bajaLogicaDepartamento()

Deshabilita un departamento poniendo la fecha de baja actual.

public static bajaLogicaDepartamento(string $codDepartamento) : bool
Parameters
$codDepartamento : string

Código del departamento a deshabilitar

Return values
bool

True si lo deshabilitó correctamente y False en caso contrario.

buscaDepartamentoPorCod()

Busca un departamento existente en la BBDD por codDepartamento.

public static buscaDepartamentoPorCod(string $codDepartamento) : Departamento|null
Parameters
$codDepartamento : string

Codigo departamento a buscar

Return values
Departamento|null

Objeto departamento encontrado en la BBDD. Null si no lo ha encontrado.

buscaDepartamentosPorDesc()

Busca departamentos existente en la BBDD por la descripción.

public static buscaDepartamentosPorDesc(string $descDepartamento) : array<string|int, Departamento>
Parameters
$descDepartamento : string

Descripción de los departamentos a buscar.

Return values
array<string|int, Departamento>

Array de objeto departamento encontrados en la BBDD. Vacío si no encuentra ninguno.

buscaDepartamentosPorDescEstado()

Busca departamentos existente en la BBDD por la descripción y el estado de alta o baja.

public static buscaDepartamentosPorDescEstado(string $descDepartamento, string $estadoDepartamento) : array<string|int, Departamento>
Parameters
$descDepartamento : string

Descripción de los departamentos a buscar.

$estadoDepartamento : string

Estado de alta, baja de los departamentos a buscar.

Return values
array<string|int, Departamento>

Array de objeto departamento encontrados en la BBDD. Vacío si no encuentra ninguno.

buscaDepartamentosPorDescEstadoPaginado()

Busca departamentos existente en la BBDD por la descripción, el estado de alta o baja y devuelve en función de la paginaActual.

public static buscaDepartamentosPorDescEstadoPaginado(string $descDepartamento, string $estadoDepartamento, int $paginaActual) : array<string|int, Departamento>
  • Realiza una consulta filtrada por descripción y estado, aplicando un límite y un desplazamiento calculado en base a la página actual y la constante global RESULTADOSPORPAGINA.
Parameters
$descDepartamento : string

Descripción de los departamentos a buscar.

$estadoDepartamento : string

Estado de alta, baja de los departamentos a buscar.

$paginaActual : int

El número de la página que se desea visualizar.

Return values
array<string|int, Departamento>

Array de objeto departamento encontrados en la BBDD. Vacío si no encuentra ninguno.

contarDepartamentosPorDescEstado()

Cuenta departamentos existente en la BBDD por la descripción y el estado de alta o baja.

public static contarDepartamentosPorDescEstado(string $descDepartamento, string $estadoDepartamento) : int
Parameters
$descDepartamento : string

Descripción de los departamentos a buscar.

$estadoDepartamento : string

Estado de alta, baja de los departamentos a buscar.

Return values
int

Número total de registros encontrados.

insertarDepartamentos()

Inserta en la BBDD un conjunto de departamentos a partir de un array.

public static insertarDepartamentos(array<string|int, mixed> $aDepartamentos) : bool
Parameters
$aDepartamentos : array<string|int, mixed>

Array con los departamentos.

Tags
throws
Exception

Si ocurre un error inesperado durante la transacción.

see
DBPDO::ejecutarConsultasTransaccion()
Return values
bool

True si insertó todos los departamentos en la BBDD y False si no insertó ningun por fallar aunque sea uno sólo.

modificaDepartamento()

Modifica un departamento existente en la BBDD.

public static modificaDepartamento(Departamento $oDepartamento, string $nuevoDescDepartamento, float $nuevoVolumenDeNegocio) : Departamento|null
Parameters
$oDepartamento : Departamento

Objeto del departamento a modificar

$nuevoDescDepartamento : string

Descripción departamento a modificar

$nuevoVolumenDeNegocio : float

Volumen de negocio del departamento a modificar

Return values
Departamento|null

Objeto departamento modificado en la BBDD. Null si no lo ha modificado correctamente.

rehabilitaDepartamento()

Habilita un departamento poniendo la fecha de baja a null

public static rehabilitaDepartamento(string $codDepartamento) : bool
Parameters
$codDepartamento : string

Código del departamento a habilitar

Return values
bool

True si lo habilitó correctamente y False si no lo habilitó.

validaCodNoExiste()

Comprueba si existe un departamento con el código indicado en la BBDD.

public static validaCodNoExiste(string $codDepartamento) : bool
Parameters
$codDepartamento : string

Código del departamento a buscar

Return values
bool

True si encontró un departamento en la BBDD y False si no lo encontró.


        
On this page

Search results