@pega/dx-component-builder-sdk 0.8.1 → 0.8.3

package/tests/assets/components/SDK-Angular/createAll/override-sdk/field/user-reference/user-reference.component.ts

@@ -0,0 +1,207 @@
+import { Component, OnInit, Input, forwardRef } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { FormControl, FormGroup, ReactiveFormsModule } from '@angular/forms';
+import { MatAutocompleteModule } from '@angular/material/autocomplete';
+import { MatInputModule } from '@angular/material/input';
+import { MatOptionModule } from '@angular/material/core';
+import { MatSelectModule } from '@angular/material/select';
+import { MatFormFieldModule } from '@angular/material/form-field';
+import { AngularPConnectService } from '@pega/angular-sdk-library';
+import { Utils } from '@pega/angular-sdk-library';
+import { OperatorComponent } from '@pega/angular-sdk-library';
+import { ComponentMapperComponent } from '@pega/angular-sdk-library';
+
+declare const window: any;
+
+const OPERATORS_DP = 'D_pyGetOperatorsForCurrentApplication';
+const DROPDOWN_LIST = 'Drop-down list';
+const SEARCH_BOX = 'Search box';
+
+@Component({
+  selector: 'app-user-reference',
+  templateUrl: './user-reference.component.html',
+  styleUrls: ['./user-reference.component.scss'],
+  standalone: true,
+  imports: [
+    CommonModule,
+    OperatorComponent,
+    ReactiveFormsModule,
+    MatFormFieldModule,
+    MatSelectModule,
+    MatOptionModule,
+    MatInputModule,
+    MatAutocompleteModule,
+    forwardRef(() => ComponentMapperComponent)
+  ]
+})
+export class UserReferenceComponent implements OnInit {
+  @Input() pConn$: any;
+  @Input() formGroup$: FormGroup;
+
+  PCore$: any;
+  angularPConnectData: any = {};
+  controlName$: string;
+  value$;
+  userName$: string;
+  label$: string;
+  userID$: string;
+  options$: any;
+  bReadonly$: boolean;
+  bRequired$: boolean;
+  showAsFormattedText$: boolean;
+  displayAs$: string;
+  testId: string;
+  helperText: string;
+
+  fieldControl = new FormControl('', null);
+
+  constructor(private angularPConnect: AngularPConnectService, private utils: Utils) {}
+
+  ngOnInit(): void {
+    if (!this.PCore$) {
+      this.PCore$ = window.PCore;
+    }
+
+    // First thing in initialization is registering and subscribing to the AngularPConnect service
+    this.angularPConnectData = this.angularPConnect.registerAndSubscribeComponent(this, this.onStateChange);
+
+    this.controlName$ = this.angularPConnect.getComponentID(this);
+
+    this.checkAndUpdate();
+
+    if (this.formGroup$) {
+      // add control to formGroup
+      this.formGroup$.addControl(this.controlName$, this.fieldControl);
+      this.fieldControl.setValue(this.value$);
+    }
+  }
+
+  ngOnDestroy() {
+    if (this.formGroup$) {
+      this.formGroup$.removeControl(this.controlName$);
+    }
+
+    if (this.angularPConnectData.unsubscribeFn) {
+      this.angularPConnectData.unsubscribeFn();
+    }
+  }
+
+  get type(): string {
+    if (this.bReadonly$ && this.showAsFormattedText$) {
+      return 'operator';
+    }
+    if (this.displayAs$ === DROPDOWN_LIST) {
+      return 'dropdown';
+    }
+    if (this.displayAs$ === SEARCH_BOX) {
+      return 'searchbox';
+    }
+  }
+
+  // Callback passed when subscribing to store change
+  onStateChange() {
+    this.checkAndUpdate();
+  }
+
+  checkAndUpdate() {
+    // Should always check the bridge to see if the component should
+    // update itself (re-render)
+    const bUpdateSelf = this.angularPConnect.shouldComponentUpdate(this);
+
+    // ONLY call updateSelf when the component should update
+    if (bUpdateSelf) {
+      this.updateSelf();
+    }
+  }
+
+  updateSelf() {
+    let props = this.pConn$.getConfigProps();
+    this.testId = props['testId'];
+
+    const { label, displayAs, value, showAsFormattedText, helperText } = props;
+
+    this.label$ = label;
+    this.showAsFormattedText$ = showAsFormattedText;
+    this.displayAs$ = displayAs;
+    this.helperText = helperText;
+
+    let { readOnly, required, disabled } = props;
+    [this.bReadonly$, this.bRequired$, disabled] = [readOnly, required, disabled].map(
+      (prop) => prop === true || (typeof prop === 'string' && prop === 'true')
+    );
+
+    const isUserNameAvailable = (user) => {
+      return typeof user === 'object' && user !== null && user.userName;
+    };
+
+    this.userID$ = this.utils.getUserId(value);
+
+    if (this.userID$ && this.bReadonly$ && this.showAsFormattedText$) {
+      if (isUserNameAvailable(value)) {
+        this.userName$ = value.userName;
+      } else {
+        // if same user ref field is referred in view as editable & readonly formatted text
+        // referenced users won't be available, so get user details from dx api
+        const { getOperatorDetails } = this.PCore$.getUserApi();
+        getOperatorDetails(this.userID$).then((resp) => {
+          if (resp.data && resp.data.pyOperatorInfo && resp.data.pyOperatorInfo.pyUserName) {
+            this.userName$ = resp.data.pyOperatorInfo.pyUserName;
+          }
+        });
+      }
+    } else if (displayAs === DROPDOWN_LIST || displayAs === SEARCH_BOX) {
+      const queryPayload = {
+        dataViewName: OPERATORS_DP
+      };
+      this.PCore$.getRestClient()
+        .invokeRestApi('getListData', { queryPayload })
+        .then((resp) => {
+          const ddDataSource = resp.data.data.map((listItem) => ({
+            key: listItem.pyUserIdentifier,
+            value: listItem.pyUserName
+          }));
+          this.options$ = ddDataSource;
+        })
+        .catch((err) => {
+          console.log(err);
+        });
+    }
+  }
+
+  fieldOnChange(event: any) {
+    if (event?.value === 'Select') {
+      event.value = '';
+    }
+    this.angularPConnectData.actions.onChange(this, event);
+  }
+
+  fieldOnBlur(event: any) {
+    let key = '';
+    if (event?.target?.value) {
+      const index = this.options$?.findIndex((element) => element.value === event.target.value);
+      key = index > -1 ? (key = this.options$[index].key) : event.target.value;
+    }
+
+    const eve = {
+      value: key
+    };
+    // PConnect wants to use eventHandler for onBlur
+    this.angularPConnectData.actions.onChange(this, eve);
+  }
+
+  getErrorMessage() {
+    let errMessage: string = '';
+
+    // look for validation messages for json, pre-defined or just an error pushed from workitem (400)
+    if (this.fieldControl.hasError('message')) {
+      errMessage = this.angularPConnectData.validateMessage;
+      return errMessage;
+    } else if (this.fieldControl.hasError('required')) {
+      errMessage = 'You must enter a value';
+    } else if (this.fieldControl.errors) {
+      errMessage = this.fieldControl.errors.toString();
+    }
+
+    return errMessage;
+  }
+}

package/tests/assets/components/SDK-Angular/createAll/override-sdk/infra/_infra.md

@@ -0,0 +1,6 @@
+# The **override-sdk/infra** directory
+
+The **src/components/override-sdk/infra** directory contains the code for **infrastructure** components for which you want to override the default implementation for use with the **Angular SDK**.
+
+When run the **npm run  create** command to override the default implementation of an **infrastructure** component, the generated code that you can use as a
+starting point for your component development will be placed in type-specific and component-specific folders in **src/components/override-sdk/infra**.

package/tests/assets/components/SDK-Angular/createAll/override-sdk/infra/action-buttons/action-buttons.component.html

@@ -0,0 +1,12 @@
+<mat-grid-list cols="2" rowHeight="6.25rem">
+  <mat-grid-tile>
+    <button *ngFor="let aButton of arSecondaryButtons$" mat-raised-button color="secondary" (click)="buttonClick(aButton.jsAction, 'secondary')">
+      {{ aButton.name }}
+    </button>
+  </mat-grid-tile>
+  <mat-grid-tile>
+    <button *ngFor="let aButton of arMainButtons$" mat-raised-button color="primary" (click)="buttonClick(aButton.jsAction, 'primary')">
+      {{ aButton.name }}
+    </button>
+  </mat-grid-tile>
+</mat-grid-list>

package/tests/assets/components/SDK-Angular/createAll/override-sdk/infra/action-buttons/action-buttons.component.scss

@@ -0,0 +1 @@
+@import '@pega/angular-sdk-library/_shared/styles.scss';

package/tests/assets/components/SDK-Angular/createAll/override-sdk/infra/action-buttons/action-buttons.component.spec.ts

@@ -0,0 +1,25 @@
+import { ComponentFixture, TestBed, waitForAsync } from '@angular/core/testing';
+
+import { ActionButtonsComponent } from './action-buttons.component';
+
+describe('ActionButtonsComponent', () => {
+  let component: ActionButtonsComponent;
+  let fixture: ComponentFixture<ActionButtonsComponent>;
+
+  beforeEach(waitForAsync(() => {
+    TestBed.configureTestingModule({
+      declarations: [ ActionButtonsComponent ]
+    })
+    .compileComponents();
+  }));
+
+  beforeEach(() => {
+    fixture = TestBed.createComponent(ActionButtonsComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+});

package/tests/assets/components/SDK-Angular/createAll/override-sdk/infra/action-buttons/action-buttons.component.ts

@@ -0,0 +1,26 @@
+import { Component, OnInit, Input, Output, EventEmitter } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { MatButtonModule } from '@angular/material/button';
+import { MatGridListModule } from '@angular/material/grid-list';
+
+@Component({
+  selector: 'app-action-buttons',
+  templateUrl: './action-buttons.component.html',
+  styleUrls: ['./action-buttons.component.scss'],
+  standalone: true,
+  imports: [CommonModule, MatGridListModule, MatButtonModule]
+})
+export class ActionButtonsComponent implements OnInit {
+  @Input() arMainButtons$: Array<any>;
+  @Input() arSecondaryButtons$: Array<any>;
+
+  @Output() actionButtonClick: EventEmitter<any> = new EventEmitter();
+
+  constructor() {}
+
+  ngOnInit(): void {}
+
+  buttonClick(sAction, sButtonType) {
+    this.actionButtonClick.emit({ action: sAction, buttonType: sButtonType });
+  }
+}

package/tests/assets/components/SDK-Angular/createAll/override-sdk/infra/assignment/assignment.component.html

@@ -0,0 +1,28 @@
+<div>
+  <div><component-mapper name="AlertBanner" [props]="{ banners }" [parent]="this"></component-mapper></div>
+  <div *ngIf="bHasNavigation$" class="psdk-stepper">
+    <component-mapper
+      name="MultiStep"
+      [props]="{
+        pConn$: newPConn$,
+        formGroup$,
+        arChildren$,
+        arMainButtons$,
+        arSecondaryButtons$,
+        bIsVertical$,
+        arCurrentStepIndicies$,
+        arNavigationSteps$
+      }"
+      [parent]="this"
+      [outputEvents]="{ actionButtonClick: onActionButtonClick }"
+    ></component-mapper>
+  </div>
+  <div *ngIf="!bHasNavigation$">
+    <component-mapper
+      name="AssignmentCard"
+      [props]="{ pConn$: newPConn$, formGroup$, arChildren$, arMainButtons$, arSecondaryButtons$, updateToken$ }"
+      [parent]="this"
+      [outputEvents]="{ actionButtonClick: onActionButtonClick }"
+    ></component-mapper>
+  </div>
+</div>

package/tests/assets/components/SDK-Angular/createAll/override-sdk/infra/assignment/assignment.component.spec.ts

@@ -0,0 +1,25 @@
+import { ComponentFixture, TestBed, waitForAsync } from '@angular/core/testing';
+
+import { AssignmentComponent } from './assignment.component';
+
+describe('AssignmentComponent', () => {
+  let component: AssignmentComponent;
+  let fixture: ComponentFixture<AssignmentComponent>;
+
+  beforeEach(waitForAsync(() => {
+    TestBed.configureTestingModule({
+      declarations: [ AssignmentComponent ]
+    })
+    .compileComponents();
+  }));
+
+  beforeEach(() => {
+    fixture = TestBed.createComponent(AssignmentComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+});