IBDB@XE

index

Package IBDB.PKG_GESTIO

Paquet que conte les funcions de gestió.

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez


Program units
FN_ALTA_JUGADOR   Funció que dona de alta un jugador assegurant la seva integritat.
FN_BAIXA_JUGADOR   Funció que dona de baix un jugador.
FN_MODIFICACIO_JUGADOR   Funció que actualitza la informació d'un jugador.
FN_ALTA_CONTRACTES   Funció que dona de alta un contracte assegurant la seva integritat.
FN_BAIXA_CONTRACTES   Funció que dona de baixa un contracte.
FN_MODIFICACIO_CONTRACTES   Funció que actualitza les dades de un contracte assegurant la seva integritat.
FN_ALTA_PARTITS   Funció que dona d'alta un partit assegurant la seva integritat.
FN_BAIXA_PARTITS   Funció que dona de baixa un partit assegurant la seva integritat.
FN_MODIFICACIO_PARTITS   Funció que permet modificar les dades d'un partit assegurant la seva integritat.
FN_ALTA_ARBITRE_PARTIT   Funció que permtet donar d'alta un arbitre assegurant la seva integritat.
FN_MODIFICACIO_ARBITRE_PARTIT   Funció que permtet modificar un arbitre assegurant la seva integritat.
FN_BAIXA_ARBITRE_PARTIT   Funció que permtet donar de baixa un arbitre assegurant la seva integritat.
FN_ALTA_ESTAD_PARTIT_JUGADOR   Funció que permtet donar d'alta les estadístiques d'un partit assegurant la seva integritat.
FN_MODIFICA_EST_PARTIT_JUGADOR   Funció que permtet modificar les estadístiques d'un partit assegurant la seva integritat.
FN_BORRA_EST_PARTIT_JUGADOR   Funció que permtet esborrar estadístiques d'un partit assegurant la seva integritat.


FN_ALTA_JUGADOR

Function FN_ALTA_JUGADOR(p_jugador IBDB.JUGADOR%ROWTYPE) RETURN INTEGER

Funció que dona de alta un jugador assegurant la seva integritat.
 
Funció auditada per PKG_UTILS.PR_AUDITAR_CANVIS
 
La funció garantitza la següent integritat
 .- El numero que proveirà la federació, aquest número no te perquè se únic entre jugadors de diferents països, però si que ho haurà de ser entre jugadors del mateix país.
 .- Només es permetrà guardar si el jugador està de baixa mèdica o baixa per motius personals en cas de que el seu estat sigui de baixa.
 .- Els valors de alçada i pes no poden ser negatius.

S'ha de tenir en compte que els següents triggers es veuen utilitzats durant la crida d'aquesta funció:
  TRG_AUDIT_JUGADOR

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez

Parameters
p_jugador   Tota la informació possible seguint la estructura de la taula JUGADOR.

Returns
PKG_UTILS.C_OK: Si tot s'ha executat correctament
PKG_UTILS.C_PK_ERROR: Error per violació de la clau primaria
PKG_UTILS.C_FK_ERROR: Error per violació de la clau externa
PKG_UTILS.C_UNKNOWN_KO: Error desconegut, veure registre en la taula AUDITORIA.


FN_BAIXA_JUGADOR

Function FN_BAIXA_JUGADOR(p_jugador_id IBDB.JUGADOR.ID%TYPE) RETURN INTEGER

Funció que dona de baix un jugador.
 
Funció auditada per PKG_UTILS.PR_AUDITAR_CANVIS  
Al donar de baixa un jugador existent (eliminar-lo) la informació relacionada a aquest jugador també s’eliminara.
  CONTRACTE
  ESTADISTICA_PARTIT
  DIAGNOSTIC
S'ha de tenir en compte que els següents triggers es veuen utilitzats durant la crida d'aquesta funció:
  TRG_AUDIT_JUGADOR

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez

Parameters
p_jugador_id   Identificador únic per cada jugador.

Returns
PKG_UTILS.C_OK: Si tot s'ha executat correctament
PKG_UTILS.C_NOT_FOUND: Indicarà que no hem pogut trobar el jugador a esborrar.
PKG_UTILS.C_UNKNOWN_KO: Error desconegut, veure registre en la taula AUDITORIA.


FN_MODIFICACIO_JUGADOR

Function FN_MODIFICACIO_JUGADOR(p_jugador IBDB.JUGADOR%ROWTYPE)
  RETURN INTEGER

Funció que actualitza la informació d'un jugador.
 
Funció auditada per PKG_UTILS.PR_AUDITAR_CANVIS S'ha de tenir en compte que els següents triggers es veuen utilitzats durant la crida d'aquesta funció:
  TRG_AUDIT_JUGADOR

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez

Parameters
p_jugador   Conté la informació actualitzada del jugador.

Returns
PKG_UTILS.C_OK: Si tot s'ha executat correctament
PKG_UTILS.C_UNKNOWN_KO: Error desconegut, veure registre en la taula AUDITORIA.


FN_ALTA_CONTRACTES

Function FN_ALTA_CONTRACTES(p_contracte IBDB.CONTRACTE%ROWTYPE)
  RETURN INTEGER

Funció que dona de alta un contracte assegurant la seva integritat.
 
 Funció auditada per PKG_UTILS.PR_AUDITAR_CANVIS
 .- La durada del contracte no pot ser nul·la.
 .- El camp VALOR_ECONOMIC no admet valors, es realitza el calcul automàticament
 S'ha de tenir en compte que els següents triggers es veuen utilitzats durant la crida d'aquesta funció:
  TRG_AUDIT_CONTRACTE

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez

Parameters
p_contracte   Conté la fila d'informació especificada a la taula CONTRACTE.

Returns
PKG_UTILS.C_OK: Si tot s'ha executat correctament
PKG_UTILS.C_PK_ERROR: Error per violació de la clau externa
PKG_UTILS.C_NOT_FOUND: PKG_UTILS.C_UNKNOWN_KO: Error desconegut, veure registre en la taula AUDITORIA.


FN_BAIXA_CONTRACTES

Function FN_BAIXA_CONTRACTES(p_contracte_id IBDB.CONTRACTE.ID%TYPE)
  RETURN INTEGER

Funció que dona de baixa un contracte.
 
Funció auditada per PKG_UTILS.PR_AUDITAR_CANVIS S'ha de tenir en compte que els següents triggers es veuen utilitzats durant la crida d'aquesta funció:
  TRG_AUDIT_CONTRACTE

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez

Parameters
p_contracte_id   Identificador únic de contracte.

Returns
PKG_UTILS.C_OK: Si tot s'ha executat correctament
PKG_UTILS.C_UNKNOWN_KO: Error desconegut, veure registre en la taula AUDITORIA.


FN_MODIFICACIO_CONTRACTES

Function FN_MODIFICACIO_CONTRACTES(p_contracte IBDB.CONTRACTE%ROWTYPE)
  RETURN INTEGER

Funció que actualitza les dades de un contracte assegurant la seva integritat.
 
 Funció auditada per PKG_UTILS.PR_AUDITAR_CANVIS.
 
 .- La durada del contracte no pot ser nul·la.
 .- El camp VALOR_ECONOMIC es sobreescriu i es realitza el calcul automàticament

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez

Parameters
p_contracte   Conté la fila d'informació especificada a la taula CONTRACTE.

Returns
PKG_UTILS.C_OK: Si tot s'ha executat correctament
PKG_UTILS.C_UNKNOWN_KO: Error desconegut, veure registre en la taula AUDITORIA.


FN_ALTA_PARTITS

Function FN_ALTA_PARTITS(p_partit IBDB.PARTIT%ROWTYPE) RETURN INTEGER

Funció que dona d'alta un partit assegurant la seva integritat.
 
 Funció auditada per PKG_UTILS.PR_AUDITAR_CANVIS  S'ha de tenir en compte que els següents triggers es veuen utilitzats durant la crida d'aquesta funció:

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez

Parameters
p_partit   Conté la fila d'informació especificada a la taula PARTIT.

Returns
PKG_UTILS.C_OK: Si tot s'ha executat correctament
PKG_UTILS.C_NOT_FOUND: Un dels dos equips no existeix, per mes informació veure registre en la taula AUDITORIA
PKG_UTILS.C_UNKNOWN_KO: Error desconegut, veure registre en la taula AUDITORIA.


FN_BAIXA_PARTITS

Function FN_BAIXA_PARTITS(p_partit_id IBDB.PARTIT.ID%TYPE) RETURN INTEGER

Funció que dona de baixa un partit assegurant la seva integritat.
 
 Funció auditada per PKG_UTILS.PR_AUDITAR_CANVIS  S'ha de tenir en compte que els següents triggers es veuen utilitzats durant la crida d'aquesta funció:
  TRG_AUDIT_PARTIT

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez

Parameters
p_partit_id   Identificador únic de la taula de PARTIT.

Returns
PKG_UTILS.C_OK: Si tot s'ha executat correctament
PKG_UTILS.C_UNKNOWN_KO: Error desconegut, veure registre en la taula AUDITORIA.


FN_MODIFICACIO_PARTITS

Function FN_MODIFICACIO_PARTITS(p_partit IBDB.PARTIT%ROWTYPE)
  RETURN INTEGER

Funció que permet modificar les dades d'un partit assegurant la seva integritat.
 
 Funció auditada per PKG_UTILS.PR_AUDITAR_CANVIS

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez

Parameters
p_partit   Conté la fila d'informació especificada a la taula PARTIT.

Returns
PKG_UTILS.C_OK: Si tot s'ha executat correctament
PKG_UTILS.C_UNKNOWN_KO: Error desconegut, veure registre en la taula AUDITORIA.


FN_ALTA_ARBITRE_PARTIT

Function FN_ALTA_ARBITRE_PARTIT(pArbitrePartit IBDB.ARBITRE_PARTIT%ROWTYPE)
  RETURN INTEGER

Funció que permtet donar d'alta un arbitre assegurant la seva integritat.
 
 Funció auditada per PKG_UTILS.PR_AUDITAR_CANVIS    IBDB.TRG_NOU_ARBITRE

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez

Parameters
p_partit   Conté la fila d'informació especificada a la taula ARBITRE_PARTIT.

Returns
PKG_UTILS.C_OK: Si tot s'ha executat correctament
PKG_UTILS.C_PK_ERROR: Aquest retorn es pot donar o be perque s'ha exedit del número de arbitres permesos o be per intentar insertar el mateix registre dos cops.
PKG_UTILS.C_NOT_FOUND: L'arbitre o el partit que es volen relacionar no existeix .
PKG_UTILS.C_UNKNOWN_KO: Error desconegut, veure registre en la taula AUDITORIA.


FN_MODIFICACIO_ARBITRE_PARTIT

Function FN_MODIFICACIO_ARBITRE_PARTIT(pArbitrePartit IBDB.ARBITRE_PARTIT%ROWTYPE)
  RETURN INTEGER

Funció que permtet modificar un arbitre assegurant la seva integritat.
 
 Funció auditada per PKG_UTILS.PR_AUDITAR_CANVIS

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez

Parameters
pArbitrePartit   Conté la fila d'informació especificada a la taula ARBITRE_PARTIT.

Returns
PKG_UTILS.C_OK: Si tot s'ha executat correctament
PKG_UTILS.C_UNKNOWN_KO: Error desconegut, veure registre en la taula AUDITORIA.


FN_BAIXA_ARBITRE_PARTIT

Function FN_BAIXA_ARBITRE_PARTIT(p_arbitre_id IBDB.ARBITRE_PARTIT.ID_ARBITRE%TYPE,
                                 p_partit_id  IBDB.ARBITRE_PARTIT.ID_PARTIT%TYPE)
  RETURN INTEGER

Funció que permtet donar de baixa un arbitre assegurant la seva integritat.
 
 Funció auditada per PKG_UTILS.PR_AUDITAR_CANVIS

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez

Parameters
pArbitrePartit   Conté la fila d'informació especificada a la taula ARBITRE_PARTIT.

Returns
PKG_UTILS.C_OK: Si tot s'ha executat correctament
PKG_UTILS.C_UNKNOWN_KO: Error desconegut, veure registre en la taula AUDITORIA.


FN_ALTA_ESTAD_PARTIT_JUGADOR

Function FN_ALTA_ESTAD_PARTIT_JUGADOR(pEstadisticaPartit IBDB.ESTADISTICA_PARTIT%ROWTYPE)
  RETURN INTEGER

Funció que permtet donar d'alta les estadístiques d'un partit assegurant la seva integritat.
 
 La funció te cura de no permetre valors negatius en aquells camps que no son calculat i que per tant, l'usuari te la possiblitat d'omplenar.
 Tanmateix aquesta funció no s'encarrega de validar que el valor de els tirs llirues encistellats sigui menor que el dels tirs lliures intentants.
 El camp PUNTS es un camp calculat i que no encara que l'usuari el vulgui omplenar, serà sobreescrit pel següent càlcul.
     PUNTS := NVL(TIRS_LLIURES_ENCISTELLATS,0) + (NVL(DOS_PUNTS_ENCISTELLATS,0)*2) + (NVL(TRES_PUNTS_ENCISTELLATS,0)*3)
 Funció auditada per PKG_UTILS.PR_AUDITAR_CANVIS
  
La funció crida al procediment definit en el body d'aquest paquet anomenat PR_ESTADISTIQUES_EST_PARTIT

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez

Returns
PKG_UTILS.C_OK: Si tot s'ha executat correctament
PKG_UTILS.C_UNKNOWN_KO: Error desconegut, veure registre en la taula AUDITORIA.


FN_MODIFICA_EST_PARTIT_JUGADOR

Function FN_MODIFICA_EST_PARTIT_JUGADOR(pEstadisticaPartit IBDB.ESTADISTICA_PARTIT%ROWTYPE)
  RETURN INTEGER

Funció que permtet modificar les estadístiques d'un partit assegurant la seva integritat.
 
 Funció auditada per PKG_UTILS.PR_AUDITAR_CANVIS  
La funció crida al procediment definit en el body d'aquest paquet anomenat PR_ESTADISTIQUES_EST_PARTIT
La funció fa una crida interna a FN_VALORACIO_JUGADOR i FN_VALORACIO_JUGADOR_PONDERADA.
S'ha de pensar que l'estadística partit quedarà tal com s'especifiqui en el paràmetre pEstadisticaPartit. Es a dir l'usuari ha d'omplenar el registre tal y com vol que quedi.

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez

Parameters
pEstadisticaPartit   Conté la fila d'informació especificada a la taula ESTADISTICA_PARTIT.

Returns
PKG_UTILS.C_OK: Si tot s'ha executat correctament
PKG_UTILS.C_UNKNOWN_KO: Error desconegut, veure registre en la taula AUDITORIA.


FN_BORRA_EST_PARTIT_JUGADOR

Function FN_BORRA_EST_PARTIT_JUGADOR(pEstadisticaPartit IBDB.ESTADISTICA_PARTIT%ROWTYPE)
  RETURN INTEGER

Funció que permtet esborrar estadístiques d'un partit assegurant la seva integritat.
 
 Encara que el paràmetre de la funció requereix crear un registre complert de la taula ESTADISTICA_PARTIT pel bon funcionament
 de la funció només serà necesari omplenar ID_JUGADOR i ID_PARTIT ja que aquest són la clau primaria de la taula ESTADISTICA_PARTIT .
 Funció auditada per PKG_UTILS.PR_AUDITAR_CANVIS  
La funció crida al procediment definit en el body d'aquest paquet anomenat PR_ESTADISTIQUES_EST_PARTIT

Version
1.0 Març-Juny 2013

Author
Juanjo Díaz Pérez

Returns
PKG_UTILS.C_OK: Si tot s'ha executat correctament
PKG_UTILS.C_UNKNOWN_KO: Error desconegut, veure registre en la taula AUDITORIA.