APEX_COLLECTION – Parte 4

En la entrada anterior, puede encontrar el segundo grupo de funciones y procedimientos del paquete API APEX_COLLECTION, en esta, continuamos con el grupo final de las mismas.

Procedimiento RESET_COLLECTION_CHANGED

Utilice este procedimiento para restablecer el indicador de cambio de colección (marcar como no cambiado) para una colección determinada.

Si no existe una colección con el nombre especificado para el usuario actual en la misma sesión y para el ID de aplicación actual, se genera un error de aplicación.

La sintaxis del procedimiento es:

APEX_COLLECTION.RESET_COLLECTION_CHANGED (
     p_collection_name IN VARCHAR2);

Donde:

Un ejemplo del uso de este procedimiento es:

BEGIN
     APEX_COLLECTION.RESET_COLLECTION_CHANGED (
          p_collection_name => ‘DEPARTMENTS’);
END;

Procedimiento RESET_COLLECTION_CHANGED_ALL

Utilice este procedimiento para restablecer el indicador de cambio de colección (marcar como no cambiado) para todas las colecciones en la sesión actual del usuario.

La sintaxis del procedimiento es:

APEX_COLLECTION.RESET_COLLECTION_CHANGED_ALL;

Un ejemplo del uso de este procedimiento es:

BEGIN
     APEX_COLLECTION.RESET_COLLECTION_CHANGED_ALL;
END;

Procedimiento SORT_MEMBERS

Utilice este procedimiento para reordenar los miembros de una colección dada por el número de columna especificado por p_sort_on_column_number. Esto ordena la colección por una columna/atributo en particular en la colección y reasigna los ID de secuencia de cada número de modo que no existan espacios. Si no existe una colección con el nombre especificado para el usuario actual en la misma sesión y para el ID de aplicación actual, se genera un error de aplicación.

La sintaxis del procedimiento es:

APEX_COLLECTION.SORT_MEMBERS (
     p_collection_name IN VARCHAR2,
     p_sort_on_column_number IN NUMBER);

Donde:

Un ejemplo del uso de este procedimiento es:

BEGIN
     APEX_COLLECTION.SORT_MEMBERS (
          p_collection_name => ‘DEPARTMENTS’,
          p_sort_on_column_number => ‘2’;
END;

Procedimiento TRUNCATE_COLLECTION

Utilice este procedimiento para eliminar todos los miembros de una colección con nombre.

Si no existe una colección con el nombre especificado para el usuario actual en la misma sesión y para el ID de aplicación actual, se genera un error de aplicación.

La sintaxis del procedimiento es:

APEX_COLLECTION.TRUNCATE_COLLECTION (
     p_collection_name IN VARCHAR2);

Donde:

Un ejemplo del uso de este procedimiento es:

BEGIN
     APEX_COLLECTION.TRUNCATE_COLLECTION(
          p_collection_name => ‘DEPARTMENTS’);
END;

Procedimiento UPDATE_MEMBER

Utilice este procedimiento para actualizar el miembro especificado en la colección con nombre dada.

Si no existe una colección con el nombre especificado para el usuario actual en la misma sesión y para el ID de aplicación actual, se genera un error de aplicación. Si el miembro especificado por el ID de secuencia p_seq no existe, se genera un error de aplicación.

Nota: El uso de este procedimiento establece las columnas identificadas y anula las columnas no identificadas. Para actualizar columnas específicas, sin afectar los valores de otras columnas, use «UPDATE_MEMBER_ATTRIBUTE Procedimiento Firma 1».

La sintaxis del procedimiento es:

APEX_COLLECTION.UPDATE_MEMBER (
     p_collection_name IN VARCHAR2,
     p_seq IN VARCHAR2 DEFAULT NULL,
     p_c001 IN VARCHAR2 DEFAULT NULL,
     p_c002 IN VARCHAR2 DEFAULT NULL,
     p_c003 IN VARCHAR2 DEFAULT NULL,
     …
     p_c050 IN VARCHAR DEFAULT NULL,
     p_n001 IN NUMBER DEFAULT NULL,
     p_n002 IN NUMBER DEFAULT NULL,
     p_n003 IN NUMBER DEFAULT NULL,
     p_n004 IN NUMBER DEFAULT NULL,
     p_n005 IN NUMBER DEFAULT NULL,
     p_d001 IN DATE DEFAULT NULL,
     p_d002 IN DATE DEFAULT NULL,
     p_d003 IN DATE DEFAULT NULL,
     p_d004 IN DATE DEFAULT NULL,
     p_d005 IN DATE DEFAULT NULL,
     p_clob001 IN CLOB DEFAULT empty_clob(),
     p_blob001 IN BLOB DEFAULT empty-blob(),
     p_xmltype001 IN XMLTYPE DEFAULT NULL );

Donde:

Un ejemplo del uso de este procedimiento es:

BEGIN
     APEX_COLLECTION.UPDATE_MEMBER (
          p_collection_name => ‘Departments’,
          p_seq => ‘2’,
          p_c001 => ‘Engineering’,
          p_c002 => ‘Sales’);
END;

Procedimiento UPDATE_MEMBERS

Utilice este procedimiento para actualizar la matriz de miembros de la colección con nombre dada. Si no existe una colección con el nombre especificado para el usuario actual en la misma sesión y para el ID de aplicación actual, se genera un error de aplicación. El recuento de elementos en la tabla p_seq PL/SQL se usa como el número total de elementos en todas las tablas PL/SQL. Es decir, si p_seq.count = 2 y p_c001.count = 10, solo 2 miembros se actualizan_apex_application_globalted. Si p_seq es nulo, se genera un error de aplicación. Si el miembro especificado por el ID de secuencia p_seq no existe, se genera un error de aplicación.

La sintaxis del procedimiento es:

APEX_COLLECTION.UPDATE_MEMBERS (
     p_collection_name IN VARCHAR2,
     p_seq IN apex_application_global.VC_ARR2 DEFAULT empty_vc_arr,
     p_c001 IN apex_application_global.VC_ARR2 DEFAULT empty_vc_arr,
     p_c002 IN apex_application_global.VC_ARR2 DEFAULT empty_vc_arr,
     p_c003 IN apex_application_global.VC_ARR2 DEFAULT empty_vc_arr,
     …
     p_c050 IN apex_application_global.VC_ARR2 DEFAULT empty_vc_arr,
     p_n001 IN apex_application_global.N_ARR DEFAULT empty_n_arr,
     p_n002 IN apex_application_global.N_ARR DEFAULT empty_n_arr,
     p_n003 IN apex_application_global.N_ARR DEFAULT empty_n_arr,
     p_n004 IN apex_application_global.N_ARR DEFAULT empty_n_arr,
     p_n005 IN apex_application_global.N_ARR DEFAULT empty_n_arr,
     p_d001 IN apex_application_global.D_ARR DEFAULT empty_d_arr,
     p_d002 IN apex_application_global.D_ARR DEFAULT empty_d_arr,
     p_d003 IN apex_application_global.D_ARR DEFAULT empty_d_arr,
     p_d004 IN apex_application_global.D_ARR DEFAULT empty_d_arr,
     p_d005 IN apex_application_global.D_ARR DEFAULT empty_d_arr)

Nota: Cualquier atributo de carácter que supere los 4000 caracteres se trunca a 4000 caracteres. Además, la cantidad de miembros agregados se basa en la cantidad de elementos en la primera matriz.

Donde:

Un ejemplo del uso de este procedimiento es:

DECLARE
     l_seq apex_application_global.vc_arr2;
     l_carr apex_application_global.vc_arr2;
     l_narr apex_application_global.n_arr;
     l_darr apex_application_global.d_arr;
BEGIN
     l_seq(1) := 10;
     l_seq(2) := 15;
     l_carr(1) := ‘Apples’;
     l_carr(2) := ‘Grapes’;
     l_narr(1) := 100;
     l_narr(2) := 150;
     l_darr(1) := sysdate;
     l_darr(2) := sysdate;

     APEX_COLLECTION.UPDATE_MEMBERS (
          p_collection_name => ‘Groceries’,
          p_seq => l_seq,
          p_c001 => l_carr,
          p_n001 => l_narr,
          p_d001 => l_darr);
END;

Procedimiento UPDATE_MEMBER_ATTRIBUTE Firma 1

Actualice el atributo de miembro especificado en la colección con nombre dada. Si no existe una colección con el nombre especificado para el usuario actual en la misma sesión para el ID de aplicación actual, se genera un error de aplicación. Si el miembro especificado por el ID de secuencia p_seq no existe, se genera un error de aplicación. Si el número de atributo especificado no es válido o está fuera del rango 1-50, se genera un error. Cualquier valor de atributo que supere los 4000 bytes se trunca a 4000 bytes.

La sintaxis del procedimiento es:

APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
     p_collection_name IN VARCHAR2,
     p_seq IN NUMBER,
     p_attr_number IN NUMBER,
     p_attr_value IN VARCHAR2);

Donde:

Un ejemplo del uso de este procedimiento es:

BEGIN
     APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
          p_collection_name => ‘Departments’,
          p_seq => 2,
          p_attr_number => 1,
          p_attr_value => ‘Engineering’);
END;

Procedimiento UPDATE_MEMBER_ATTRIBUTE Firma 2

Actualice el atributo de miembro CLOB especificado en la colección con el nombre dado.

Si no existe una colección con el nombre especificado para el usuario actual en la misma sesión para el ID de aplicación actual, se genera un error de aplicación.

Si el miembro especificado por el ID de secuencia p_seq no existe, se genera un error de aplicación.

Si el número de atributo especificado no es válido o está fuera del rango válido (actualmente solo 1 para CLOB), se genera un error.

La sintaxis del procedimiento es:

APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
     p_collection_name IN VARCHAR2,
     p_seq IN NUMBER,
     p_clob_number IN NUMBER,
     p_clob_value IN CLOB );

Donde:

Un ejemplo del uso de este procedimiento es:

BEGIN
     APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
          p_collection_name => ‘Departments’,
          p_seq => 2,
          p_clob_number => 1,
          p_clob_value => ‘Engineering’);
END;

Procedimiento UPDATE_MEMBER_ATTRIBUTE Firma 3

Actualice el atributo de miembro BLOB especificado en la colección con nombre dada. Si no existe una colección con el nombre especificado para el usuario actual en la misma sesión para el ID de aplicación actual, se genera un error de aplicación. Si el miembro especificado por el ID de secuencia p_seq no existe, se genera un error de aplicación. Si el número de atributo especificado no es válido o está fuera del rango válido (actualmente solo 1 para BLOB), se genera un error.

La sintaxis del procedimiento es:

APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
     p_collection_name IN VARCHAR2,
     p_seq IN NUMBER,
     p_blob_number IN NUMBER,
     p_blob_value IN BLOB);

Donde:

Un ejemplo del uso de este procedimiento es:

BEGIN
     APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
          p_collection_name => ‘Departments’,
          p_seq => 2,
          p_blob_number => 1,
          p_blob_value => l_blob_content);
END;

Procedimiento UPDATE_MEMBER_ATTRIBUTE Firma 4

Actualice el atributo de miembro XMLTYPE especificado en la colección con nombre dada. Si no existe una colección con el nombre especificado para el usuario actual en la misma sesión para el ID de aplicación actual, se genera un error de aplicación. Si el miembro especificado por el ID de secuencia p_seq no existe, se genera un error de aplicación. Si el número de atributo especificado no es válido o está fuera del rango válido (actualmente solo 1 para XMLTYPE), se genera un error.

La sintaxis del procedimiento es:

APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
     p_collection_name IN VARCHAR2,
     p_seq IN NUMBER,
     p_xmltype_number IN NUMBER,
     p_xmltype_value IN BLOB);

Donde:

Un ejemplo del uso de este procedimiento es:

BEGIN
     APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
          p_collection_name => ‘Departments’,
          p_seq => 2,
          p_xmltype_number => 1,
          p_xmltype_value => l_xmltype_content);
END;

Procedimiento UPDATE_MEMBER_ATTRIBUTE Firma 5

Actualice el atributo de miembro NUMBER especificado en la colección con nombre dada. Si no existe una colección con el nombre especificado para el usuario actual en la misma sesión para el ID de aplicación actual, se genera un error de aplicación. Si el miembro especificado por el ID de secuencia p_seq no existe, se genera un error de aplicación. Si el número de atributo especificado no es válido o está fuera del rango válido (actualmente solo del 1 al 5 para NÚMERO), se genera un error.

La sintaxis del procedimiento es:

APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
     p_collection_name IN VARCHAR2,
     p_seq IN NUMBER,
     p_attr_number IN NUMBER,
     p_number_value IN NUMBER);

Nota: Cualquier atributo de carácter que supere los 4000 caracteres se trunca a 4000 caracteres. Además, la cantidad de miembros agregados se basa en la cantidad de elementos en la primera matriz.

Donde:

Un ejemplo del uso de este procedimiento es:

BEGIN
     APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
          p_collection_name => ‘Departments’,
          p_seq => 2,
          p_attr_number => 1,
          p_number_value => 3000);
END;

Procedimiento UPDATE_MEMBER_ATTRIBUTE Firma 6

Actualice el atributo de miembro DATE especificado en la colección nombrada dada. Si no existe una colección con el nombre especificado para el usuario actual en la misma sesión para el ID de aplicación actual, se genera un error de aplicación. Si el miembro especificado por el ID de secuencia p_seq no existe, se genera un error de aplicación. Si el número de atributo especificado no es válido o está fuera del rango válido (actualmente solo del 1 al 5 para DATE), se genera un error.

La sintaxis del procedimiento es:

APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
     p_collection_name IN VARCHAR2,
     p_seq IN NUMBER,
     p_attr_number IN NUMBER,
     p_date_value IN DATE);

Nota: Cualquier atributo de carácter que supere los 4000 caracteres se trunca a 4000 caracteres. Además, la cantidad de miembros agregados se basa en la cantidad de elementos en la primera matriz.

Donde:

Un ejemplo del uso de este procedimiento es:

BEGIN
     APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
          p_collection_name => ‘Departments’,
          p_seq => 2,
          p_attr_number => 1,
          p_date_value => sysdate );
END;