Introduction to DQL -Documentum Query Language-
The language used to query Documentum which is a content management
system used to create, manage, deliver, and archive all types of content from text documents and spreadsheets to digital images, HTML, and XML components.
Contents
Define DQL
Behind the scenes
Describe a SELECT statement
Describe how search conditions are specified in a WHERE clause
Using DQL to search a specific cabinet/folder location
Describe the DQL REGISTER statement
DQL (Documentum Query Language) is a query language which allows you to do very complex queries involving:
1. Property searches
2. Searches for words and phrases within documents
3. Other specialized searching capabilities added for document and content management
DQL uses syntax that is a superset of ANSI-standard SQL (Structured Query Language)
In fact, part of your DQL statements are translated automatically into SQL before being executed by the eContent Server
Behind the Scenes
A DQL query is sent to the eContent Server using one of four API methods
readquery, execquery, query, or cachequery
A DQL engine on eContent Server generates
SQL queries for the RDBMS
Verity queries for the full-text search engine
The results of the query are stored on the server in a non-persistent collection
object. Typically, a Documentum client will automatically present the results
of the query to the user in some useful way.
Alternatively, a Developer may want to use the resulting collection object or
manipulate the results programmatically.
Basic Select Statement
Select (list the properties you want returned)
From (list the type of objects you want searched)
Using WHERE clause
Allows the search to be narrowed by imposing search conditions on your
Query
select [all | distinct] value [as name] {,value [as name] } from source_list [(all)]
...
[where qualification ]
Eg :
SELECT object_name, title FROM dm_document WHERE FOLDER (ID(0b9af3ce800001ff)) AND title LIKE %SOP%
Searching folders and cabinets
The scope of the search can be specified as folder and cabinet in the where clause to provide a way to search the cabinet/folder hierarchy.
Eg : select object_name from dm_document where folder(/Sales)
REGISTER statement
Registers an RDBMS table so the eContent Server can see" it
Allows access to data in an existing RDBMS table that may be
created to support additional application data
part of another application
owned by someone else
Does not verify that the table or its columns exist
All columns in a table need not be registered
Creates a dm_registered object in the System cabinet which
provides a description of the table and user access to it
REGISTER permissions
Only the Docbase owner with a SUPERUSER privilege can register a table from
within Documentum.
To register a table, you must have at least READ permission on the table (through the
RDBMS grant command).
The eContent Server account (installation owner) needs the appropriate RDBMS
privileges on the table to perform different operations on rows in the table. |