Independent Sub-Pages

Part of: Sub-Pages guide See also: Settings Tab | Membership Tabs

Independent sub-pages display entity-specific data in a table with Add/Delete operations, separate from Settings and Membership tabs.

Prompt Template (Recommended)

Based on the sub-pages guide, generate a '<SUB_PAGE_NAME>' independent page for '<ENTITY_NAME>' with:
- IPA API object: `<entity>`
- Data field: `<field_name>` (<data_format>)
- Table column: "<Column Display Name>"
- Parent pathname: `<entity-pathname>`
- Entity data type: `<EntityType>`
- Operations: 'Refresh', 'Delete', 'Add'
- 'Add' modal:
    - IPA call for available options: `<related_entity>_find` with `<parameters>`
    - IPA command: `<entity>_add_<relation>`
- 'Delete' modal:
    - IPA command: `<entity>_remove_<relation>`

Placeholders

Placeholder	Example
<SUB_PAGE_NAME>	Privileges
<entity>	role
<field_name> (<data_format>)	memberof_privilege (string[])
<entity-pathname>	roles
<EntityType>	Role
<related_entity>_find	privilege_find
<entity>_add_<relation>	role_add_privilege

Example

Based on the sub-pages guide, generate a 'Privileges' independent page for 'Roles' with:
- IPA API object: `role`
- Data field: `memberof_privilege` (string[] of privilege names)
- Table column: "Privilege name"
- Parent pathname: `roles`
- Entity data type: `Role`
- Operations: 'Refresh', 'Delete', 'Add'
- 'Add' modal:
    - IPA call for available options: `privilege_find` with `no_members: true`
    - IPA command: `role_add_privilege`
- 'Delete' modal:
    - IPA command: `role_remove_privilege`

What Agent Infers vs Must Specify

Inferred	Must Specify
Data transformation (string[] → {cn: string}[])	Data field name
Type definitions in MembershipTable.tsx	Data format hint (string[])
from type for table	IPA API commands
Component patterns	API parameters

Files to Modify

File	Changes
globalDataTypes.ts	Add field to entity interface
<entity>Utils.tsx	Add to createEmpty<Entity>()
rpc<Entity>.ts	Add queries/mutations
<Entity>Tabs.tsx	Add new tab
AppRoutes.tsx	Add route

API Requirements

Parent entity query: Must include all: true to return data fields.

// Available items query
getPrivileges: build.query<FindRPCResponse, string>({
  query: (searchValue) => getCommand({
    method: "privilege_find",
    params: [[searchValue], { no_members: true }],
  }),
}),

// Add/Remove mutations
addPrivilegeToRole: build.mutation({
  query: (payload) => getCommand({
    method: "role_add_privilege",
    params: [[payload.roleCn], { privilege: payload.privileges }],
  }),
}),

Component Structure

const <Entity><SubPage> = (props) => {
  useUpdateRoute({ pathname: "<parent-pathname>", noBreadcrumb: true });
  
  return (
    <TabLayout id="subpage">
      <MemberOfToolbar ... />
      <MemberTable entityList={data} idKey="cn" from="privileges" ... />
      <Pagination ... />
      {showAddModal && <MemberOfAddModal ... />}
      {showDeleteModal && <MemberOfDeleteModal ... />}
    </TabLayout>
  );
};

Differences from Membership Tabs

Aspect	Membership	Independent
Add API	_add_member + entityType	Custom (e.g., role_add_privilege)
Reusable	Yes	Usually entity-specific

Reference Implementations

• src/pages/Roles/RolesPrivileges.tsx

• src/pages/DNSZones/DnsResourceRecords.tsx