ADD_STOP_SECTION
Adds a stop section to an automatic section group. Adding a stop section causes the automatic section indexing operation to ignore the specified section in XML documents.
Note: Adding a stop section causes no section information to be created in the index. However, the text within a stop section is always searchable.
Adding a stop section is useful when your documents contain many low information tags. Adding stop sections also improves indexing performance with the automatic section group.
The number of stop sections you can add is unlimited.
Stop sections do not have section names and hence are not recorded in the section views.
Syntax
CTX_DDL.ADD_STOP_SECTION(
section_group IN VARCHAR2,
tag IN VARCHAR2
);section_group
Specify the name of the automatic section group. If you do not specify an automatic section group, then this procedure returns an error.
tag
Specify the tag to ignore during indexing. This parameter is case-sensitive. Defining a stop tag as such also stops the tag’s attribute sections, if any.
Qualify the tag with document type in the form (doctype)tag. For example, if you wanted to make the <fluff> tag a stop section only within the mydoc document type, specify (mydoc)fluff for tag.
Example
Defining Stop Sections
The following example adds a stop section identified by the tag <fluff> to the automatic section group myauto:
begin
ctx_ddl.add_stop_section('myauto', 'fluff');
end;This example also stops any attribute sections contained within <fluff>. For example, if a document contained:
<fluff type="computer">Then the preceding example also stops the attribute section fluff@type.
Doctype Sensitive Stop Sections
The following example creates a stop section for the tag <fluff> only in documents that have a root element of mydoc:
begin
ctx_ddl.add_stop_section('myauto', '(mydoc)fluff');
end;