[Solved]Portal 10.1.4 - Request Help to Modify Item Name using PL/SQL API

Question

I have a region on a page that contains content items. These are PDF files that were uploaded. I want to know how I can programmatically change the description.
I have been looking at both set_attributes() and modify_item_post_upload() functions in the API. Is this my best option, or is there an alternative.
I have been leaning towards calling modify_item_post_upload(), but have a question on the parameters.
I can get p_master_item_id, but what is p_item_id?
I would like to call the method like this:
declare
l_masterid number;
l_display_name varchar2(100);
begin
l_masterid := <some number);
l_display_name := 'New Name for item';
modify_item_post_upload(
p_master_item_id => l_masterid,
p_display_name => l_display_name
end;
So questions are:
1. What modifications do I need for a simple call to change an items name?
2. What additional functions/procedures do I need to call so the display gets updated with the new information? Do I have to clear the cache suing wxutils, or can I just call wwpro_api_invalidation.execute_cache_invalidation; ?
If you want the "rest of the story" - I created a web front end in JDeveloper that allows specific end users to login, upload files, and delete items for a specific portal page containing content items. One of the common mistakes is a misspelling of the display name by the end user. So instead of deleting an item, then re-adding an item, the end user would like to edit the display name for just the item that has the misspelling. I have set this up in JDeveloper with an edit screen that contains just the display name. Now I need a function/procedure that I can call from the application module that will update just the display name for this particular item. I have already coded an ADF model that uses the search_item and converts the results into a result_set, and use that to create a View Object in the ADF for JDeveloper to use. Now to finish this user request, I just need to figure out the PL/SQL API part for modifying a display name. The item still needs to keep it's reference to the uploaded PDF file.
Thanks, Ken

Answer 1

Very nice! I like the code example. In looking at needing to change only the title of the item, I created a procedure that calls set_attribute. Here is the code:
create or replace
procedure update_newslinearchive_item (p_masterid in number, p_displayname in varchar2) as
cursor items_cur(p_id IN NUMBER) is
select * from wwsbr_all_items
where masterid = p_id
and caid = <pagegroup>
and active = 1
and is_current_version = 1
and language = wwctx_api.get_nls_language;
items_rec wwsbr_all_items%rowtype;
begin
dbms_output.put_line('masterid = ' || to_char(p_masterid));
dbms_output.put_line('display_name = ' || p_displayname);
-- Login to the portal for access to function calls
wwctx_api.set_context('<username>','<password>');
-- Verify that the item to be deleted is in the items table
open items_cur(p_masterid);
fetch items_cur into items_rec;
if items_cur%found then
dbms_output.put_line('record found');
wwsbr_api.set_attribute(
p_site_id => items_rec.caid,
p_thing_id => items_rec.id,
p_attribute_site_id => wwsbr_api.SHARED_OBJECTS,
p_attribute_id => wwsbr_api.ATTRIBUTE_TITLE,
p_attribute_value => p_displayname
wwpro_api_invalidation.execute_cache_invalidation;
dbms_output.put_line('Clearing Cache');
-- Now clear the web-cache
wxvutil.invalidate_reset;
wxvutil.invalidate_uri('<server:port/path/to/page>,0,null);
wxvutil.invalidate_exec('<server>',4001,'<webcache password>');
else
dbms_output.put_line('record NOT found');
end if;
close items_cur;
exception
when others then
dbms_output.put_line('SQLCODE = ' || SQLCODE);
dbms_output.put_line('SQLERRM = ' || SUBSTR(SQLERRM,1,200));
if items_cur%isopen then
close items_cur;
end if;
end update_newslinearchive_item;
Thank you for the example for modify_item_post_upload!
Ken