Search Results jtf_assign_pub




Overview

The APPS.JTF_AM_WF_EVENTS_PUB package is a public PL/SQL API within the Oracle E-Business Suite Territory Management (formerly Assignment Manager, or "AM") module. Its primary business function is to serve as the Workflow-facing event interface for the Assignment Manager engine. Where the core assignment engine determines which resource — a sales representative, an opportunity owner, a lead owner, or another assignable entity — should be associated with a given business object, this package exists to raise and manage Workflow events that drive resource assignment across those objects.

The package is classified as a PUBLIC API and is recorded as VALID in the ETRM repository for release 12.2.2. It is documented with a dependency on JTF_ASSIGN_PUB, the central Assignment Manager public package, which indicates that JTF_AM_WF_EVENTS_PUB operates as a workflow-event wrapper layered over the assignment engine rather than as a standalone assignment processor. This relationship clarifies why a search for jtf_assign_pub surfaces this object: the two packages are directly linked, with JTF_ASSIGN_PUB both referencing and being referenced by JTF_AM_WF_EVENTS_PUB.

Key Procedures and Functions

The package exposes eight documented public procedures, each corresponding to an assignment operation against a distinct business entity type:

  • ASSIGN_SR_RESOURCE — processes resource assignment for service request records.
  • ASSIGN_DR_RESOURCE — processes resource assignment for the corresponding "DR" entity (dealer/detail requirement records within the Assignment Manager model).
  • ASSIGN_TASK_RESOURCE — handles assignment events for task records, typically tied to the Tasks schema objects.
  • ASSIGN_ESC_RESOURCE — manages escalation-driven resource assignment.
  • ASSIGN_DEF_RESOURCE — handles default resource assignment, the fallback path when explicit matching rules do not produce an owner.
  • ASSIGN_ACC_RESOURCE — processes assignment for account-based entities.
  • ASSIGN_OPPR_RESOURCE — processes assignment for opportunity records.
  • ASSIGN_LEAD_RESOURCE — processes assignment for lead records.

Each procedure is designed to be invoked when a Workflow event fires on the relevant entity, allowing the Assignment Manager engine to resolve and persist an owner. The uniform naming convention demonstrates that the package's design intent is to provide one documented entry point per assignable object type.

Tables Accessed

Per the ETRM metadata, the package references a small set of supporting objects through APPS synonyms:

  • WF_PARAMETER_LIST_T — the Workflow parameter list type, used to build and pass event parameters between the Workflow engine and the assignment API.
  • DUAL — used for single-row value evaluation during event handling.
  • PLITBLM — the standard PL/SQL index-by table of strings utility used for intermediate collections.

In addition, the documented dependency list records references to JTF_TASKS_VL, JTF_TERRITORY_PUB, JTF_TERR_CHAR_360LIST, JTF_TERR_DATE_LIST, and JTF_TERR_NUMBER_LIST. These indicate that territory matching logic and territory qualifier lists feed into the assignment decision, and that task data is read from the Tasks view during task assignment.

Usage Notes

JTF_AM_WF_EVENTS_PUB is typically invoked indirectly rather than called directly by end users or forms. It is most commonly triggered from Oracle Workflow event subscriptions configured against Assignment Manager business events, and from the Assignment Manager concurrent programs that process assignments and escalations. Because the package is classified as a public API, it may also be called from custom PL/SQL when a custom event or integration needs to force a resource assignment for a supported entity. Developers extending Assignment Manager should prefer routing assignment calls through JTF_ASSIGN_PUB and allow this package to manage the associated Workflow events, preserving the documented division of responsibility between the two packages.