Create Folder with a category definition?

Question

Hi,
Is there any way to attach a CATEGORY_DEFINITION to a folder in a worskpace?. I have only seen CATEGORY_CONFIGURATION attached. What I am trying to say, is there is any way to assign category attribute information to subfolder in a worksapce. Thanks in advance,
Igor.
Mensaje editado por:
user511556

Answer 1

I also need to accomplish the task of setting metadata attributes at the folder level. I do not believe that it is impossible. The Collaboration Suite web interface appears to do this very thing. It may be impossible using the oracle.ifs.fdk API, but that's just a weakness in the high-level API in my opinion. The data is being stored somewhere, that much is for sure.
If the oracle.ifs.fdk API is insufficient to handle this task, Oracle ought to support an alternate means to get the job done. This is a fundamental part of any useful document management system.
When examining the CONTENT schema in the database, it is obvious that both documents and folders support category instances in one form or another. It is also obvious that these two types of PUBLICOBJECTs are dealt with very differently in the database.
At the end of this post are given two PLSQL procedures and one function that will populate a document with a given ID with metadata for my own custom category called "File Metadata". The second procedure and the function are just helpers called by the first. You'll need to grant the CONTENT user select privileges on SYS.DBA_TAB_COLUMNS. This is how the procedure gets the names of the metadata attribute columns, which will be different for every custom category. Naturally, you will have to modify the parameters and procedure body to make it work for your own custom category, using the name of your category and your own metadata attribute names as well. If you run the SELECTs in a sql editor, you will see how the data is laid out in the CONTENT schema. Though the procedure does not indicate this, everything starts with the ODMV_PUBLICOBJECT view.
This procedure will not work for folders because the database layout for folder category attributes is different. I have yet to fully map it out, though I am deep into it. I will post a solution here when I find it.
If anybody already knows the solution, please don't hesitate to post it. This is a cry for help. The category structure for folders is very difficult to trace. The actual metadata values are very elusive. Here's what I have found thus far:
Let's say I have a folder whose ID is 958609. Here's the folder object itself, and all its child objects:
select *
from odmv_publicobject
where id = 958609
or securingpublicobject = 958609;
Some of these children are category override instances. In my system, category overrides are the rows with a CLASSID of 2646. If you look up this ID in ODMV_CLASSOBJECT, you will see that it is ADHOCCONFIGURATION. This is different from a document's category instance, which has a custom CLASSID which points to a custom category in the ODMV_METADATASCHEMACATEGORY view. We see a divergence between document and folder category implementation already at this point. This query gives me the "ad hoc" category instance for my folder:
select *
from odmv_publicobject
where securingpublicobject = 958609
and classid in (
select id
from odmv_classobject
where name = 'ADHOCCONFIGURATION'
Among the child objects of my folder lie some more interesting things. It appears that the metadata attributes themselves are to be found here. The following query finds them all. Note the similarity to the preceding query. The only thing that changed was the type of CLASSOBJECT we are looking for.
select *
from odmv_publicobject
where securingpublicobject = 958609
and classid in (
select id
from odmv_classobject
where name = 'METADATACATEGORYATTRIBUTEOVERRIDE'
order by id asc;
Now that I have these objects, it would seem like an easy task to look them up in whatever table they are stored in, and change the attribute values. But I cannot find this table (yet). This is where I am stuck. Any suggestions, please?
Another odd fact: if you change folder metadata, all subfolders will reflect the change. Documents, however, do not change. Folders appear to inherit parent folder category metadata unless it is explicitly changed. I think this behavior extends all the way up to the domain object itself. Perhaps the domain object holds a bit of the secret. The domain object is a PUBLICOBJECT just like folders, documents, users, etc.
Anyway, once this metadata attribute override table is found, it will be an easy matter to write PLSQL that can read and write folder metadata attribute values. Forget about oracle.ifs.fdk; it will not serve us here. As you can see, the official word is that it cannot be done, even though we can all see it works in Collaboration Suite, and we can see some of the implementation in the database.
The document metadata writing procedure:
PROCEDURE update_file_metadata (
p_docid IN NUMBER,
p_folderid IN NUMBER,
p_create_date IN NUMBER,
p_footer_number IN VARCHAR2,
p_to IN VARCHAR2,
p_from IN VARCHAR2,
p_entered_by IN VARCHAR2,
p_hardcopy_available IN VARCHAR2,
p_subject IN VARCHAR2,
p_revision_number IN VARCHAR2,
p_document_vendor IN VARCHAR2,
p_drawing_number IN VARCHAR2,
p_title IN VARCHAR2,
p_drawing_revision IN VARCHAR2,
p_drawing_sheet_number IN VARCHAR2,
p_drawing_vendor IN VARCHAR2
IS
l_metadata_id NUMBER(20);
l_category_id NUMBER(20);
l_displayname VARCHAR2(500);
l_query VARCHAR2(2000);
BEGIN
-- Get the category id for the named category
SELECT associatedschemaobject
INTO l_category_id
FROM odm_schemacategory
WHERE id IN (
SELECT id
FROM odm_metadataschemacategory
WHERE displayname LIKE 'File Metadata'
-- Find the metadata id.
find_metadata_id('File Metadata', p_docid, l_metadata_id);
-- Get the column names for the category metadata table.
-- The column names are the key to the ODMV_MDATAATTRSCHEMACATEGORY view.
l_query := '';
FOR rec IN (
SELECT column_name
FROM sys.dba_tab_columns
WHERE table_name = 'ODM_ECM_' || l_category_id
AND column_name not like 'ID'
) LOOP
-- Get the human-readable name of the attribute.
SELECT displayname
INTO l_displayname
FROM ODMV_MDATAATTRSCHEMACATEGORY
WHERE name = rec.column_name;
IF(l_displayname = 'Created/Received Date' AND p_create_date IS NOT NULL) THEN
l_query := l_query || rec.column_name || ' = ''' || escape_naughties(p_create_date) || ''',';
END IF;
IF(l_displayname = 'Footer Number' AND p_footer_number IS NOT NULL) THEN
l_query := l_query || rec.column_name || ' = ''' || escape_naughties(p_footer_number) || ''',';
END IF;
IF(l_displayname = 'To' AND p_to IS NOT NULL) THEN
l_query := l_query || rec.column_name || ' = ''' || escape_naughties(p_to) || ''',';
END IF;
IF(l_displayname = 'From' AND p_from IS NOT NULL) THEN
l_query := l_query || rec.column_name || ' = ''' || escape_naughties(p_from) || ''',';
END IF;
IF(l_displayname = 'Entered By' AND p_entered_by IS NOT NULL) THEN
l_query := l_query || rec.column_name || ' = ''' || escape_naughties(p_entered_by) || ''',';
END IF;
IF(l_displayname = 'Sealed Stamped Documents/Drawings Available' AND p_hardcopy_available IS NOT NULL) THEN
l_query := l_query || rec.column_name || ' = ''' || escape_naughties(p_hardcopy_available) || ''',';
END IF;
IF(l_displayname = 'Subject' AND p_subject IS NOT NULL) THEN
l_query := l_query || rec.column_name || ' = ''' || escape_naughties(p_subject) || ''',';
END IF;
IF(l_displayname = 'Revision Number' AND p_revision_number IS NOT NULL) THEN
l_query := l_query || rec.column_name || ' = ''' || escape_naughties(p_revision_number) || ''',';
END IF;
IF(l_displayname = 'Document Vendor' AND p_document_vendor IS NOT NULL) THEN
l_query := l_query || rec.column_name || ' = ''' || escape_naughties(p_document_vendor) || ''',';
END IF;
IF(l_displayname = 'Drawing Number' AND p_drawing_number IS NOT NULL) THEN
l_query := l_query || rec.column_name || ' = ''' || escape_naughties(p_drawing_number) || ''',';
END IF;
IF(l_displayname = 'Title' AND p_title IS NOT NULL) THEN
l_query := l_query || rec.column_name || ' = ''' || escape_naughties(p_title) || ''',';
END IF;
IF(l_displayname = 'Drawing Revision' AND p_drawing_revision IS NOT NULL) THEN
l_query := l_query || rec.column_name || ' = ''' || escape_naughties(p_drawing_revision) || ''',';
END IF;
IF(l_displayname = 'Drawing Sheet Number' AND p_drawing_sheet_number IS NOT NULL) THEN
l_query := l_query || rec.column_name || ' = ''' || escape_naughties(p_drawing_sheet_number) || ''',';
END IF;
IF(l_displayname = 'Drawing Vendor' AND p_drawing_vendor IS NOT NULL) THEN
l_query := l_query || rec.column_name || ' = ''' || escape_naughties(p_drawing_vendor) || ''',';
END IF;
END LOOP;
IF(l_query IS NOT NULL) THEN
l_query := 'UPDATE ODM_ECM_' || l_category_id || ' SET ' || l_query;
l_query := RTRIM(l_query, ',');
l_query := l_query || ' WHERE ID = ''' || l_metadata_id || '''';
-- DEBUG: Uncomment to see the query we have written.
--RAISE_APPLICATION_ERROR(-20102, l_query);
EXECUTE IMMEDIATE l_query;
END IF;
END;
PROCEDURE find_metadata_id (
p_category IN VARCHAR2,
p_docid IN NUMBER,
o_metadata_id OUT NUMBER
IS
BEGIN
SELECT id
INTO o_metadata_id
FROM odm_publicobject
WHERE securingpublicobject = p_docid
AND classid IN (
SELECT associatedschemaobject
FROM odm_schemacategory
WHERE id IN (
SELECT id
FROM odm_metadataschemacategory
WHERE displayname LIKE p_category
END;
-- Basically analogous to a perl untaint.
FUNCTION escape_naughties(
p_badstring IN VARCHAR2
) RETURN VARCHAR2
IS
BEGIN
RETURN REPLACE(p_badstring, '''', '''''');
END;