playwright-praman-sap-testing

name: playwright-praman-sap-testing description: > Playwright plugin for SAP UI5 test automation. Provides fixtures for UI5 control discovery, SAP authentication (BTP SAML, Basic, Office365), FLP navigation, OData V2/V4 data access, Fiori Elements testing (ListReport, ObjectPage), AI-powered test generation, and business intent APIs (Procurement MM, Sales SD, FI, PP). Use when testing SAP Fiori applications, Fiori Elements apps, or any SAP UI5 application with Playwright. Import from 'playwright-praman'.

SAP UI5 Test Automation with Praman

Praman is a Playwright plugin for SAP UI5 applications. It bridges Playwright's web-first approach with SAP's UI5 framework, providing stable selectors, SAP auth strategies, FLP navigation, and AI-driven test generation.

Quick Start

// playwright.config.ts
import { defineConfig } from '@playwright/test';
import { defineConfig as definePramanConfig } from 'playwright-praman';

export default defineConfig({
  use: {
    praman: definePramanConfig({
      auth: { strategy: 'basic', baseUrl: 'https://your-sap-system.example.com' },
    }),
  },
});

// my.test.ts
import { test, expect } from 'playwright-praman';

test('create purchase order', async ({ ui5, ui5Navigation }) => {
  await ui5Navigation.navigateToApp('PurchaseOrder-manage');
  await ui5.fill({ id: 'vendorInput' }, 'SUP-001');
  await ui5.click({ controlType: 'sap.m.Button', properties: { text: 'Save' } });
  await expect(ui5.waitForUI5()).resolves.toBeUndefined();
});

When to Use Praman vs Native Playwright

Fixture Map

import { coreTest as test } from 'playwright-praman'; // ui5 only
import { moduleTest as test } from 'playwright-praman'; // ui5 + table/dialog/date/odata
import { navTest as test } from 'playwright-praman'; // ui5 + navigation

SAP Control Type Namespace Reference

sap.m.*          — Mobile-first controls (Button, Input, Select, Table, List, Dialog)
sap.ui.table.*   — Grid Table (classic desktop table — higher density)
sap.ui.comp.*    — Smart controls (SmartField, SmartTable, SmartFilterBar)
sap.ui.core.*    — Core framework (Icon, HTML, View)
sap.f.*          — Fiori controls (DynamicPage, FlexibleColumnLayout, Card)
sap.tnt.*        — Tools and Navigation Theme (NavigationList, SideNavigation)
sap.uxap.*       — UX AP Patterns (ObjectPage, ObjectPageSection)

SmartField note: SmartField wraps an inner control. getControlType() returns sap.ui.comp.smartfield.SmartField — NOT the inner sap.m.Input or sap.m.ComboBox. Always use the outer SmartField type in selectors.

Auth Strategy Selection

SAP System Type       → Strategy
─────────────────────────────────────────────────────
OnPrem + LDAP/AD      → 'basic' (username/password form)
OnPrem + SAML2        → 'btp-saml' (redirect flow)
BTP Cloud Foundry     → 'btp-saml' (BTP IAS redirect)
Office 365 / Azure AD → 'office365' (Microsoft SSO)
API / Service Account → custom (APIAuthStrategy)
Multi-tenant          → custom (MultiTenantAuthStrategy)
Certificate / mTLS    → custom (CertificateAuthStrategy)

// playwright.config.ts — with auth storage
export default defineConfig({
  projects: [
    {
      name: 'auth',
      testMatch: '**/auth-setup.ts',
    },
    {
      name: 'tests',
      dependencies: ['auth'],
      use: { storageState: '.auth/session.json' },
    },
  ],
});

See authentication.md for all 6 strategies.

FLP Semantic Object Hash Format

FLP navigation hashes follow the pattern: #SemanticObject-Action?param=value

// Navigate to standard apps
await ui5Navigation.navigateToApp('PurchaseOrder-manage'); // ME23N equivalent
await ui5Navigation.navigateToApp('SalesOrder-manage'); // VA03 equivalent
await ui5Navigation.navigateToApp('Material-display'); // MM60 equivalent

// Navigate by tile title (for WorkZone)
await ui5Navigation.navigateToTile('Manage Purchase Orders');

// Navigate with intent parameters
await ui5Navigation.navigateToIntent('PurchaseOrder', 'manage', {
  PurchaseOrder: '4500001234',
});

// Navigate by raw hash
await ui5Navigation.navigateToHash("#PurchaseOrder-manage&/PurchaseOrder('4500001234')");

UI5 Selector Guide

// By stable ID (fastest — use when you control the app)
await ui5.control({ id: 'submitButton' });

// By control type + text (stable across locales — preferred for buttons)
await ui5.control({ controlType: 'sap.m.Button', properties: { text: 'Save' } });

// By control type + binding path (stable across UI changes)
await ui5.control({ controlType: 'sap.m.Input', bindingPath: { path: '/Vendor' } });

// Scoped by ancestor (avoids false matches in complex layouts)
await ui5.control({
  controlType: 'sap.m.Input',
  ancestor: { id: 'vendorForm' },
});

// Multiple controls
const rows = await ui5.controls({ controlType: 'sap.m.ColumnListItem' });

Domain Reference Files