ADD_STOP_ENTITY

This procedure is used to mark certain entity mentions or entity types as not to be extracted. Invokers add stop entities to their own extraction policy. It does not take effect until after CTX_ENTITY.COMPILE is run. Either entity_name or entity_type can be NULL, but not both. If one stop entity is a subset of another, it will be marked as a subset after CTX_ENTITY.COMPILE, and not used in extraction. This procedure issues a commit.

Syntax

CTX_ENTITY.ADD_STOP_ENTITY(
  policy_name                 IN VARCHAR2,
  entity_name                 IN INTEGER,
  entity_type                 IN VARCHAR2 DEFAULT NULL,
  comments                    IN VARCHAR2 DEFAULT NULL);

policy_name

Specify the policy name of the stop entity that is to be added.

entity_name

Specify the entity name to be listed as a stop entity. If entity_type is NULL, all mentions with this entity_name will be listed as stop entities. It is case-sensitive.

entity_type

If entity_name is NULL, this will specify an entire entity type to be listed as stop entity. If entity_name is not NULL, this will specify only the mention <entity_type, entity_name> as a stop entity. It is case-insensitive. The maximum byte length is 4000 bytes.

comments

The maximum byte length is 4000 bytes.

Example

The following example adds a stop entity corresponding to all persons. After compilation, extraction will not report any mentions of entity type person.

exec ctx_entity.add_stop_entity('pol1', NULL, 'person');

The following example adds a stop entity corresponding to <'person', 'john doe'>. After compilation, extraction will not report any mentions of the pair <'person', 'john doe'>. This stop entity is actually a subset of the first stop entity added. It will be marked subset in the CTX_USER_EXTRACT_STOP_ENTITIES view, and will not be used in extraction.

exec ctx_entity.add_stop_entity('pol1', 'john doe', 'person');

The following example adds a stop entity corresponding to all mentions of ford. After compilation, extraction will not report any mentions of the entity ford, irrespective of the entity type of the mention. For example, if a rule matches ford to a person, the extraction will not report this match. If a rule matches ford to a company, the extraction will again not report this match.

exec ctx_entity.add_stop_entity('pol1', 'ford', NULL);

“COMPILE”

“CTX_USER_EXTRACT_STOP_ENTITIES”