tuain-ng-forms-lib 13.0.11 → 13.0.13

package/lib/classes/forms/form.d.ts

@@ -73,7 +73,7 @@ export declare class FormStructureAndData {
     setFieldRequired(code: string, required: boolean): any;
     setFieldErrorMessage(code: string, message: string): any;
     setFieldOptions(code: string, optionsArray: any[], idAttribute: string, nameAttribute: string): any;
-    getFieldSet(filter: any, inputCodes: string[] | string | null, secCode?: string, subCode?: string): string[];
+    getFieldSet(filter: any, inputCodes: string[] | string | null, secCode?: string | null, subCode?: string | null): string[];
     applyOnFields(processFunc: any, inputCodes?: string[] | string | null, secCode?: string, subCode?: string): number;
     enableFields(codes?: string[] | string | null, secCode?: string, subCode?: string): number;
     showFields(codes?: string[] | string | null, secCode?: string, subCode?: string): number;

package/lib/components/forms/basic-form.d.ts

@@ -30,13 +30,16 @@ export declare class BasicFormComponent {
     private _tableActionsFinish;
     private _tableGetDataStart;
     private _tableGetDataFinish;
+    private _actionServerError;
+    private _fieldServerError;
+    private _tableServerError;
     protected inputDataFields: any;
     protected extraData: any;
     protected _eventEmiter: LibEventManagerService;
     protected enabledSections: RecordFormSection[];
     formConfig: any;
-    name: string;
-    formSubject: string;
+    name: string | null;
+    formSubject: string | null;
     _errorType: string;
     errorCode: string;
     errorMessage: string;
@@ -50,7 +53,7 @@ export declare class BasicFormComponent {
     setTitle(title: string): void;
     cleanData(): void;
     getCurrentState(): string;
-    supportState(state: string): boolean;
+    supportState(state: string | null): boolean;
     changeState(state: any): boolean;
     getStates(): any[];
     getImmutableElement(name: string): any;
@@ -63,14 +66,14 @@ export declare class BasicFormComponent {
     getFieldValue(code: string): any;
     getFieldOptionText(code: string): any;
     getFieldsValues(codes: string[]): any;
-    getFieldOptions(code: string): FieldOption[];
+    getFieldOptions(code: string): FieldOption[] | null;
     setFieldValue(code: string, value: any): any;
     setFieldRequired(code: string, required: boolean): any;
     setFieldErrorMessage(code: string, errorMessage: string): any;
     setFieldError(code: string, errorCode: string, message: string, type?: string): any;
     setFieldIntrinsicErrorMessage(code: string, message: string): any;
     setFieldOptions(code: any, optionsArray: any, idAttribute: any, nameAttribute: any): any;
-    getFieldSet(filterFunc?: any, codes?: string[] | string | null, secCode?: string, subCode?: string): string[];
+    getFieldSet(filterFunc?: any, codes?: string[] | string | null, secCode?: string | null, subCode?: string | null): string[];
     applyOnFields(processFunc: any, codes?: string[] | string | null, secCode?: string, subCode?: string): number;
     applyProcessToAllFields(processFunc: any): number;
     cleanFields(codes?: string[] | string | null, secCode?: string, subCode?: string): number;
@@ -96,7 +99,7 @@ export declare class BasicFormComponent {
     hideFields(codes?: string[] | string | null, secCode?: string, subCode?: string): number;
     getActionsByAttribute(name: string, value: any): FormAction[];
     getHeaderActions(): FormAction[];
-    getAction(actionCode: string): FormAction;
+    getAction(actionCode: string): FormAction | null;
     showActions(actionArray: any): void;
     hideActions(actionArray: any): void;
     enableActions(actionArray: any): void;
@@ -105,21 +108,21 @@ export declare class BasicFormComponent {
     hideAction(code: string): void;
     enableAction(code: string): void;
     disableAction(code: string): void;
-    getSections(): RecordFormSection[];
+    getSections(): RecordFormSection[] | null;
     activateSection(code: any): void;
-    getSectionsTitles(): string[];
-    getSection(code: string): RecordFormSection;
+    getSectionsTitles(): string[] | null;
+    getSection(code: string): RecordFormSection | null;
     showSection(code: string): void;
     hideSection(code: string): void;
     showSections(codes: string[] | string): void;
     hideSections(codes: string[] | string): void;
-    getSubSection(code: string, subCode: string): RecordFormSubSection;
+    getSubSection(code: string, subCode: string): RecordFormSubSection | null;
     showSubSection(code: string, subCode: string): void;
     hideSubSection(code: string, subCode: string): void;
     showSubSections(code: string, subCodes: string[] | string): void;
     hideSubSections(code: string, subCodes: string[] | string): void;
-    getSectionActions(code: string): FormAction[];
-    getSectionActionNames(code: string): string[];
+    getSectionActions(code: string): FormAction[] | null;
+    getSectionActionNames(code: string): string[] | null;
     getTables(): RecordTable[];
     showTables(codes: string[] | string): void;
     hideTables(codes: string[] | string): void;
@@ -137,13 +140,13 @@ export declare class BasicFormComponent {
     get formCode(): string;
     set formCode(name: string);
     get inServerProcess(): boolean;
-    get form(): FormStructureAndData;
-    get state(): string;
+    get form(): FormStructureAndData | null;
+    get state(): string | null;
     get currentState(): string;
     set currentState(state: string);
     get immutableData(): any;
     get extraInfo(): any;
-    get visibleSections(): RecordFormSection[];
+    get visibleSections(): RecordFormSection[] | null;
     get formRoute(): string;
     set formRoute(route: string);
     get subject(): string;
@@ -162,19 +165,19 @@ export declare class BasicFormComponent {
     /**
      * @deprecated Use getField
      */
-    getFieldObject(code: string): FieldDescriptor;
+    getFieldObject(code: string): FieldDescriptor | null;
     /**
      * @deprecated Use getAction
      */
-    getActionObject(code: string): FormAction;
+    getActionObject(code: string): FormAction | null;
     /**
      * @deprecated Use getTable
      */
-    getTableObject(code: string): RecordTable;
+    getTableObject(code: string): RecordTable | null;
     /**
      * @deprecated Use getSection
      */
-    getSectionObject(code: string): RecordFormSection;
+    getSectionObject(code: string): RecordFormSection | null;
     /**
      * @deprecated Use changeState
      */
@@ -198,7 +201,7 @@ export declare class BasicFormComponent {
     goBack(): void;
     goBackForm(): void;
     getOriginDetail(): any;
-    setError(errorType: string, errorMessage: string, errorDetail: string): void;
+    setError(errorType: string | null, errorMessage: string | null, errorDetail: string | null): void;
     resetError(): void;
     getErrorType(): string;
     getErrorMessage(): string;
@@ -218,13 +221,22 @@ export declare class BasicFormComponent {
      */
     requestFormAction(actionCode: string, actionSubject?: any): Promise<any>;
     updateFormWithServerData(formContent: any): void;
+    /**
+     * Manejo de event handlers para errores Server del formulario
+     */
+    cleanActionServerError(): void;
+    cleanFieldServerError(): void;
+    cleanTableServerError(): void;
+    onActionServerError(callback: any, properties?: any): void;
+    onValidationServerError(callback: any, properties?: any): void;
+    onTableServerError(callback: any, properties?: any): void;
     /**
      * Manejo de event handlers para acciones sobre el formulario
      */
-    addSectionActivation(codes: string[] | string | null, callback: any, properties?: any): void;
-    addSectionInactivation(codes: string[] | string | null, callback: any, properties?: any): void;
-    addActionMethodStart(codes: string[] | string | null, callback: any, properties?: any): void;
-    addActionMethodFinish(codes: string[] | string | null, callback: any, properties?: any): void;
+    onSectionActivation(codes: string[] | string | null, callback: any, properties?: any): void;
+    onSectionInactivation(codes: string[] | string | null, callback: any, properties?: any): void;
+    onActionStart(codes: string[] | string | null, callback: any, properties?: any): void;
+    onActionFinish(codes: string[] | string | null, callback: any, properties?: any): void;
     launchSectionActivation(code: string): Promise<void>;
     launchSectionInactivation(code: string): Promise<void>;
     startAction(code: string): Promise<void>;
@@ -234,9 +246,9 @@ export declare class BasicFormComponent {
     /**
      * Manejadores de eventos para validaciones sobre campos
      */
-    addFieldInputValidation(codes: string[] | string | null, callback: any, properties?: any): void;
-    addFieldValidationStart(codes: string[] | string | null, callback: any, properties?: any): void;
-    addFieldValidationFinish(codes: string[] | string | null, callback: any, properties?: any): void;
+    onFieldInput(codes: string[] | string | null, callback: any, properties?: any): void;
+    onFieldValidationStart(codes: string[] | string | null, callback: any, properties?: any): void;
+    onFieldValidationFinish(codes: string[] | string | null, callback: any, properties?: any): void;
     startFieldInputValidation(fieldCode: string, intrinsicValidation?: boolean): Promise<boolean>;
     startFieldValidation(fieldCode: string, intrinsicValidation?: boolean): Promise<void>;
     startServerFieldValidation(inputField: string | FieldDescriptor): Promise<void>;
@@ -245,12 +257,12 @@ export declare class BasicFormComponent {
     /**
      * Manejadores de eventos para acciones sobre Tablas
      */
-    addTableActionStart(code: string, actionCode: string, callback: any, properties?: any): void;
-    addTableActionFinish(code: string, actionCode: string, callback: any, properties?: any): void;
-    addTableSelectionStart(code: string, callback: any, properties?: any): void;
-    addTableSelectionFinish(code: string, callback: any, properties?: any): void;
-    addTableGetDataStart(code: string, callback: any, properties?: any): void;
-    addTableGetDataFinish(code: string, callback: any, properties?: any): void;
+    onTableActionStart(code: string, actionCode: string, callback: any, properties?: any): void;
+    onTableActionFinish(code: string, actionCode: string, callback: any, properties?: any): void;
+    onTableSelectionStart(code: string, callback: any, properties?: any): void;
+    onTableSelectionFinish(code: string, callback: any, properties?: any): void;
+    onTableGetDataStart(code: string, callback: any, properties?: any): void;
+    onTableGetDataFinish(code: string, callback: any, properties?: any): void;
     startTableGlobalAction(tableActionEvent: any): Promise<void>;
     startTableServerGlobalAction(tableActionDetail: any): Promise<void>;
     finishTableGlobalAction(tableActionDetail: any, actionResult: any, serverError?: boolean): Promise<void>;
@@ -270,6 +282,22 @@ export declare class BasicFormComponent {
     checkSectionRequiredFields(sectionCode: string, reqFieldMessage?: string): boolean;
     validateSectionConsistency(sectionCode: string, reqFieldMessage?: string): boolean;
     copyTableRecordToFields(tableObj: any, mappingTable?: any): boolean;
+    /**
+     * Métodos Legacy de compatibilidad hacia atrás
+     */
+    addSectionActivation(codes: string[] | string | null, callback: any, properties?: any): void;
+    addSectionInactivation(codes: string[] | string | null, callback: any, properties?: any): void;
+    addActionMethodStart(codes: string[] | string | null, callback: any, properties?: any): void;
+    addActionMethodFinish(codes: string[] | string | null, callback: any, properties?: any): void;
+    addFieldInputValidation(codes: string[] | string | null, callback: any, properties?: any): void;
+    addFieldValidationStart(codes: string[] | string | null, callback: any, properties?: any): void;
+    addFieldValidationFinish(codes: string[] | string | null, callback: any, properties?: any): void;
+    addTableActionStart(code: string, actionCode: string, callback: any, properties?: any): void;
+    addTableActionFinish(code: string, actionCode: string, callback: any, properties?: any): void;
+    addTableSelectionStart(code: string, callback: any, properties?: any): void;
+    addTableSelectionFinish(code: string, callback: any, properties?: any): void;
+    addTableGetDataStart(code: string, callback: any, properties?: any): void;
+    addTableGetDataFinish(code: string, callback: any, properties?: any): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<BasicFormComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<BasicFormComponent, "ng-component", never, {}, {}, never, ["*"]>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tuain-ng-forms-lib",
-  "version": "13.0.11",
+  "version": "13.0.13",
   "description": "Componentes y Clases Angular para la gestión de formularios TUAIN",
   "author": "Mauricio Méndez, Imix Consulting",
   "license": "MIT",