# Pages

> Browse PeopleSoft page definitions with field controls, source records, subpages, components, and PeopleCode.

---

Site [llms.txt](/llms.txt)

---

<div id="pslens-context-panel" class="card border-info mb-4 d-none">
  <div class="card-header bg-light text-info py-2 fw-bold d-flex align-items-center border-bottom border-info-subtle">
    <i class="bi bi-info-circle-fill me-2"></i>
    <span>Tailored Operational Context</span>
  </div>
  <div class="card-body p-0">
    <ul class="list-group list-group-flush">
      <li id="row-db" class="list-group-item d-flex align-items-center justify-content-between py-2 d-none">
        <strong>Target Database:</strong>
        <span id="ctx-db" class="badge bg-secondary font-monospace">&mdash;</span>
      </li>
      <li id="row-type" class="list-group-item d-flex align-items-center justify-content-between py-2 d-none">
        <strong>Context Type:</strong>
        <span id="ctx-type" class="badge bg-light text-dark border font-monospace text-uppercase">&mdash;</span>
      </li>
      <li id="row-severity" class="list-group-item d-flex align-items-center justify-content-between py-2 d-none">
        <strong>Alert Severity:</strong>
        <span id="ctx-severity" class="badge">&mdash;</span>
      </li>
      <li id="row-time" class="list-group-item d-flex align-items-center justify-content-between py-2 d-none">
        <strong>Triggered Time:</strong>
        <span id="ctx-time" class="text-muted small">&mdash;</span>
      </li>
      <li id="row-details" class="list-group-item py-2 d-none">
        <strong id="label-details" class="d-block mb-1">Firing Context:</strong>
        <code id="ctx-details" class="d-block p-2 bg-light border rounded small"
          style="white-space: pre-wrap; word-break: break-all;">&mdash;</code>
      </li>
      <li id="row-sql" class="list-group-item py-2 d-none">
        <div class="d-flex justify-content-between align-items-center mb-1">
          <strong id="label-sql">Contextual SQL:</strong>
          <button id="btn-copy-sql" type="button" class="btn btn-sm btn-outline-secondary py-0 px-2 small">
            <i class="bi bi-clipboard me-1"></i>Copy SQL
          </button>
        </div>
        <pre class="mb-0 p-2 bg-light border rounded small"><code id="ctx-sql" style="white-space: pre-wrap; word-break: break-word;">&mdash;</code></pre>
      </li>
    </ul>
  </div>
</div>

<script>
  (function () {
    const params = new URLSearchParams(window.location.search);
    const metadata = params.get('metadata');
    if (!metadata) return;

    try {
      
      const base64 = metadata.replace(/-/g, '+').replace(/_/g, '/');
      const jsonStr = decodeURIComponent(escape(window.atob(base64)));
      const data = JSON.parse(jsonStr);

      if (data) {
        let hasData = false;

        if (data.db) {
          document.getElementById('ctx-db').textContent = data.db;
          document.getElementById('row-db').classList.remove('d-none');
          hasData = true;
        }

        if (data.type) {
          document.getElementById('ctx-type').textContent = data.type;
          document.getElementById('row-type').classList.remove('d-none');
          hasData = true;
        }

        if (data.severity) {
          const severityBadge = document.getElementById('ctx-severity');
          const severity = data.severity.toLowerCase();
          severityBadge.textContent = severity.toUpperCase();
          if (severity === 'critical') {
            severityBadge.className = 'badge bg-danger';
          } else if (severity === 'warning') {
            severityBadge.className = 'badge bg-warning text-dark';
          } else {
            severityBadge.className = 'badge bg-info';
          }
          document.getElementById('row-severity').classList.remove('d-none');
          hasData = true;
        }

        if (data.t) {
          const date = new Date(data.t * 1000);
          document.getElementById('ctx-time').textContent = date.toLocaleString();
          document.getElementById('row-time').classList.remove('d-none');
          hasData = true;
        }

        if (data.details) {
          document.getElementById('ctx-details').textContent = data.details;

          
          const labelDetails = document.getElementById('label-details');
          if (data.type === 'object') {
            labelDetails.textContent = 'Object Metadata Details:';
          } else if (data.type === 'report') {
            labelDetails.textContent = 'Report Description:';
          } else {
            labelDetails.textContent = 'Firing Context:';
          }

          document.getElementById('row-details').classList.remove('d-none');
          hasData = true;
        }

        if (data.sql) {
          document.getElementById('ctx-sql').textContent = data.sql;
          document.getElementById('row-sql').classList.remove('d-none');
          const copyBtn = document.getElementById('btn-copy-sql');
          if (copyBtn && navigator.clipboard) {
            copyBtn.addEventListener('click', function () {
              navigator.clipboard.writeText(data.sql).then(function () {
                copyBtn.innerHTML = '<i class="bi bi-check2 me-1"></i>Copied';
                setTimeout(function () {
                  copyBtn.innerHTML = '<i class="bi bi-clipboard me-1"></i>Copy SQL';
                }, 2000);
              });
            });
          }
          hasData = true;
        }

        if (hasData) {
          document.getElementById('pslens-context-panel').classList.remove('d-none');
        }
      }
    } catch (e) {
      console.error('Failed to parse operational context metadata:', e);
    }
  })();
</script>

Pages are the visual screens users interact with in PeopleSoft: the panel definitions from `PSPNLDEFN` and the per-control bindings from `PSPNLFIELD`. psLens shows the full control list (every field, label, group box, and subpage on the page), the underlying records each control reads from, and the rest of the metadata graph hanging off the page: which components include it, which PeopleCode is attached, which projects contain it.

## Object Relationships

Pages bridge individual record fields to complete application transactions:

- **Binds Record Fields**: Pages (`PSPNLDEFN`) contain visual controls (`PSPNLFIELD`) bound to fields (`FIELDNAME`) on underlying records (`RECNAME`).
- **Grouped in Components**: One or more pages are assembled into a component definition (`PSPNLGROUP`) to create a complete transaction.
- **Includes Subpages**: Pages embed reusable subpages and secondary pages to modularize user interface design.

## How psLens Improves Page Inspection

Investigating page definitions in Application Designer requires opening the page layout, double-clicking individual controls to verify record and field bindings, querying `PSPNLGROUP` to find parent components, checking page properties for Activate PeopleCode, and walking owning projects for migration history.

psLens presents the full control inventory, distinct underlying records, embedded subpages, containing components, Activate PeopleCode, and project membership in a single view with everything one click away.

## Search Page

URL: `/pages?db={database}`

<figure><img src="/images/screenshots/metadata/pages-search.png"
			alt="Page search results for USER_% showing USERAGENTID, USERID, USERMAINT_SRCHREC, USERPROFILEPAGE and others"><figcaption>
			<p>Page search results for <code>USER_%</code></p>
		</figcaption>
</figure>


Wildcard `%` search supported. Each result card shows the page type (Standard Page, Subpage, Secondary Page, or Search Record) so you can spot reusable subpages versus standalone screens at a glance. The **Advanced Filters** panel lets you exclude subpages or limit to standard pages only.

## Detail Page

URL: `/pages/{PAGENAME}?db={database}`

<figure><img src="/images/screenshots/metadata/pages-detail.png"
			alt="Detail page for USERPROFILEPAGE showing page properties and field controls"><figcaption>
			<p>Page detail for <code>USERPROFILEPAGE</code> — default view</p>
		</figcaption>
</figure>


The main pane shows **Page Properties** (type, size, style, audit metadata) and the full **Page Fields/Controls** table with each control's record/field binding, label, occurs level, and field type. The sidebar has 6 related-data toggles.

<figure><img src="/images/screenshots/metadata/pages-detail-expanded.png"
			alt="Page detail with all panels expanded"><figcaption>
			<p>All panels expanded on a Secondary Page</p>
		</figcaption>
</figure>


## Related Data Panels

### Page Fields/Controls

<figure><img src="/images/screenshots/metadata/pages-panel-fields.png"
			alt="Page Fields panel listing every control on the USERPROFILEPAGE"><figcaption>
			<p>Every control on the page with its field, record, and label</p>
		</figcaption>
</figure>


The control inventory: every field control on the page with its `PSPNLFIELD` row attributes. Each record/field reference deep-links into the matching psLens detail page.

### Records Used on Page

<figure><img src="/images/screenshots/metadata/pages-panel-records.png"
			alt="Records Used on Page panel for USERPROFILEPAGE"><figcaption>
			<p>Distinct records referenced by any control on the page</p>
		</figcaption>
</figure>


The de-duplicated list of records this page reads from. Clicking a record opens its detail page so you can confirm the schema, sample data, or check what else uses it.

### Subpages Included

<figure><img src="/images/screenshots/metadata/pages-panel-subpages.png"
			alt="Subpages Included panel"><figcaption>
			<p>Subpages embedded inside this page</p>
		</figcaption>
</figure>


Lists every subpage embedded inside this page. Useful when a control's data seems to come from somewhere "magic" (it's almost always a subpage doing the work).

### Components Using Page

<figure><img src="/images/screenshots/metadata/pages-panel-components.png"
			alt="Components Using Page panel"><figcaption>
			<p>Components whose item list includes this page</p>
		</figcaption>
</figure>


Lists the components that include this page. Answers "which transactions show this screen to a user?"

### PeopleCode

<figure><img src="/images/screenshots/metadata/pages-panel-peoplecode.png"
			alt="PeopleCode panel for the page"><figcaption>
			<p>Page-level PeopleCode (Activate event) attached to this page</p>
		</figcaption>
</figure>


Page Activate PeopleCode. The only event type that lives directly on a page object.

### Included in Projects

<figure><img src="/images/screenshots/metadata/pages-panel-projects.png"
			alt="Included in Projects panel for the page"><figcaption>
			<p>App Designer projects that include this page</p>
		</figcaption>
</figure>


App Designer projects containing this page as a project item.