Pages

Register a custom table in Oracle Apps: (AD_DD Package)


      To register custom table, table columns and Primary Key under FND
  • You register your custom tables using a AD_DD package.
  • Flexfields, Value sets and Oracle Alert are depending on this information. Therefore you need to register custom tables and table columns that will be used with flexfields, Value sets or Oracle Alert.
  • You can also use the AD_DD API to delete the registrations of tables and columns. You should delete the column registration first, then the table registration.
  • To alter a registration you should first delete the registration, then re-register the table or column. 
  • The AD_DD API does NOT check for the existence of the registered table or column in the database schema, but only updates the required AOL tables. You must ensure that the tables and columns registered actually exist and have the same format as that defined using the AD_DD API.
  • You need NOT register views.
  • You should include calls to the table registration routines in a PL/SQL script.
  • You should run the AD_DD procedures against the APPS schema. You must commit your changes for them to take effect.
Procedures in the AD_DD Package:

 procedure register_table (
   p_appl_short_name in varchar2,
                           p_tab_name    in varchar2,
                           p_tab_type    in varchar2,
                           p_next_extent in number default 512,
                            p_pct_free    in number default 10,
                            p_pct_used    in number default 70
  );
p_appl_short_ name: The application short name of the application that owns the table (usually your custom application).
p_tab_name: The name of the table (in uppercase letters).
p_tab_type: Use 'T' if it is a transaction table (almost all application tables), or 'S' for a "seed data" table.
p_next_extent: The next extent size, in kilobytes. Do not include the 'K'.
p_pct_free: The percentage of space in each of the table's blocks reserved for future updates to the table (1-99). 
p_pct_used: Minimum percentage of used space in each data block of the table (1-99). The sum of p_pct_free and p_pct_used must be less than 100.

procedure register_column (
  p_appl_short_name in varchar2,
                           p_tab_name   in varchar2,
                           p_col_name   in varchar2,
                           p_col_seq    in number,
                          p_col_type   in varchar2,
                           p_col_width  in number,
                           p_nullable   in varchar2,
                           p_translate  in varchar2,
                           p_precision  in number default null,
                           p_scale      in number default null
                           );
p_col_name: The name of the column (in uppercase letters).
p_col_seq: The sequence number of the column in the table (the order in which the column appears in the table definition).
p_col_type: The column type ('NUMBER', 'VARCHAR2', 'DATE', etc.).
p_col_width: The column size (a number). Use 9 for DATE columns, 38 for NUMBER columns (unless it has a specific width).
p_nullable: Use 'N' if the column is mandatory or 'Y' if the column allows null values.
p_translate: Use 'Y' if the column values will be translated for an Oracle E-Business Suite product release (used only by Oracle E-Business Suite products) or 'N' if the values are not translated (most application columns).
p_precision: The total number of digits in a number.
p_scale: The number of digits to the right of the decimal point in a number.

procedure delete_table  (
p_appl_short_name in varchar2,
                        p_tab_name    in varchar2
);

procedure delete_column (
p_appl_short_name in varchar2,
                        p_tab_name    in varchar2,
                        p_col_name    in varchar2
);
How to use:

·         Input is your custom table name. (Execute below queries.)
·         Spool the records.
·         Execute the spooled records in apps.
·         Commit;
Useful query:

To register tables:

select 'EXEC '||'AD_DD.REGISTER_TABLE(''XXCUST'', '''||TABLE_NAME||''',''T'',8,10,90);' from all_tables
where table_name = :TABLE_NAME;

To register table’s columns:

select 'EXEC '||'AD_DD.REGISTER_COLUMN(''XXCUST'', '''||TABLE_NAME||''','''||COLUMN_NAME||''','||COLUMN_ID||','''||DATA_TYPE||''','||DATA_LENGTH||','''||NULLABLE||''',''N'');' from all_tab_columns
where table_name = :TABLE_NAME
ORDER BY COLUMN_ID;

select 'EXEC '||'AD_DD.REGISTER_PRIMARY_KEY(''XXCUST'','''||INDEX_NAME||''','''||TABLE_NAME||''','''||ITYP_NAME||''',''S'',''Y'',''Y'');'
FROM ALL_INDEXES
WHERE table_name = :TABLE_NAME
and uniqueness = 'UNIQUE';

select 'EXEC '||'AD_DD.REGISTER_PRIMARY_KEY_COLUMN(''XXCUST'','''||A.INDEX_NAME||''','''||A.TABLE_NAME||''','''||A.COLUMN_NAME||''','||A.COLUMN_POSITION||');'
FROM ALL_IND_COLUMNS A, ALL_INDEXES B
WHERE A.TABLE_NAME = :TABLE_NAME
AND A.INDEX_NAME = B.INDEX_NAME
AND B.UNIQUENESS = 'UNIQUE';

To delete the registered Tables, columns

select 'EXEC '||'AD_DD.DELETE_TABLE(''XXCUST'', '''||TABLE_NAME);' from all_tables
where table_name = :TABLE_NAME;

select 'EXEC '||'AD_DD.REGISTER_COLUMN(''XXCUST'', '''||TABLE_NAME||''','''||COLUMN_NAME);' from all_tab_columns
where table_name = :TABLE_NAME
ORDER BY COLUMN_ID;

Example:

EXECUTE ad_dd.register_table('XXC', 'XXCUST_TABLE', 'T', 8, 10, 90);

EXECUTE ad_dd.register_column('XXC', 'XXCUST_TABLE', 'COLUMN1', 2, 'VARCHAR2', 30, 'N', 'N');