@sankhyalabs/core 0.0.0-bugfix-dev-KB-6165.0

package/src/utils/CriteriaModel.ts

@@ -0,0 +1,205 @@
+import { CriteriaParameter, InputCriteria } from './CriteriaParameter.js'
+
+interface OutputJSON {
+    expression: string | undefined;
+    parameters: Array<InputCriteria>;
+}
+
+/**
+ * `CriteriaParameter`: Utilizado para validar e manipular os critérios da requisição.
+ * 
+ */
+export class Criteria {
+
+    //Internal Properties
+    //================================================================
+    private _expression: string | undefined = undefined;
+    private _parameters: Array<CriteriaParameter> = [];
+
+    //Constructor
+    //================================================================
+    constructor(exp?: string, params?: Array<CriteriaParameter>) {
+        this._expression = exp ? exp : undefined;
+        this._parameters = params ? params : [];
+    }
+
+    //Getters and Setters
+    //================================================================
+
+    /**
+     * @ngdoc
+     * @Setter_______________
+     * @name sankhyalabs.core.src:Criteria#parameters
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Setter para "parameters". Trata-se de uma Array de parametros da classe Criteria.
+     * @param {Array<CriteriaParameter>} [parameters] Array de parametros da classe Criteria.
+     */
+    public set parameters(parameters: Array<CriteriaParameter>) {
+        this._parameters = parameters;
+    }
+
+    /**
+     * @ngdoc
+     * @Getter_______________
+     * @name sankhyalabs.core.src:Criteria#parameters
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Getter para parameters
+     * @returns {Array<CriteriaParameter>}
+     */
+    public get parameters(): Array<CriteriaParameter> {
+        return this._parameters;
+    }
+
+    /**
+     * @ngdoc
+     * @Setter_______________
+     * @name sankhyalabs.core.src:Criteria#expression
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Setter para "expression". Trata-se do expressão da classe Criteria.
+     * @param {string} [expression] Expressão da classe Criteria.
+     */
+    public set expression(expression: string | undefined) {
+        this._expression = expression;
+    }
+
+    /**
+     * @ngdoc
+     * @Getter_______________
+     * @name sankhyalabs.core.src:Criteria#expression
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Getter para expression
+     * @returns {string} expression em formato string.
+     */
+    public get expression(): string | undefined {
+        return this._expression;
+    }
+
+
+
+    //Methods
+    //================================================================
+
+    /**
+     * @ngdoc
+     * @name sankhyalabs.core.src:Criteria#getSize
+     * @methodOf sankhyalabs.core.src:Criteria
+     * @description Método que retorna o Número de caracteres da expressão da classe Criteria.
+     * @returns {number} Número de caracteres da expressão da classe Criteria.
+     */
+    public getSize = (): number => {
+        return this._expression === undefined ? 0 : this._expression.length;
+    };
+
+    /**
+     * @ngdoc
+     * @name sankhyalabs.core.src:Criteria#or
+     * @methodOf sankhyalabs.core.src:Criteria
+     * @description Concatena a expressão ' OR ' ao critério.
+     * @param {Criteria | string} [exp] Expressão a ser concatenada
+     * @param {Array<CriteriaParameter>} [param] Parâmetros a serem concatenados.
+     * @returns {Criteria} Retorna a própria instância do Criterio para encadeamento.
+     */
+    public or = (exp: Criteria | string, param?: Array<CriteriaParameter>): Criteria => {
+        if (this.getSize() > 0) {
+            this.append(' OR ');
+        }
+
+        this.append(exp, param);
+
+        return this;
+    };
+
+    /**
+     * @ngdoc
+     * @name sankhyalabs.core.src:Criteria#and
+     * @methodOf sankhyalabs.core.src:Criteria
+     * @description Concatena a expressão ' AND ' ao critério.
+     * @param {Criteria | string} [exp] Expressão a ser concatenada
+     * @param {Array<CriteriaParameter>} [param] Parâmetros a serem concatenados.
+     * @returns {Criteria} Retorna a própria instância do Criterio para encadeamento.
+     */
+    public and = (exp: Criteria | string, param?: Array<CriteriaParameter>): Criteria => {
+        if (this.getSize() > 0) {
+            this.append(' AND ');
+        }
+
+        this.append(exp, param);
+
+        return this;
+    }
+
+
+    /**
+     * @ngdoc
+     * @name sankhyalabs.core.src:Criteria#toJSON
+     * @methodOf sankhyalabs.core.src:Criteria
+     * @description Retorna um JSON que representa o objeto Criteria.
+     * @returns {Object} Retorna um JSON que representa o objeto Criteria.
+     */
+    public toJSON = (): OutputJSON | undefined => {
+
+        const parametersArray: Array<InputCriteria> = [];
+        this.parameters.map(function (param) {
+            parametersArray.push(param.buildParam());
+        })
+
+        let result = undefined;
+        if (this.getSize() > 0) {
+            result = {
+                expression: this.expression,
+                parameters: parametersArray,
+            }
+        }
+
+        return result;
+    }
+
+
+    /**
+    * @ngdoc
+    * @name sankhyalabs.core.src:Criteria#append
+    * @methodOf sankhyalabs.core.src:Criteria
+    * @description Concatena uma expressão e parâmetros ao critério.
+    * @param {string} [exp=undefined] Expressão a ser concatenada
+    * @param {array} [param=undefined] Parâmetros a serem concatenados.
+    * @returns {Criteria} Retorna a própria instância do Criterio para encadeamento.
+    */
+    public append(exp: Criteria | string, param?: Array<CriteriaParameter>): Criteria {
+
+        if (exp instanceof Criteria) {
+            if (exp.getSize() > 0) {
+                param = exp.parameters
+                exp = '(' + exp.expression + ')';
+            } else {
+                return this;
+            }
+        }
+
+        if (this.expression === undefined) {
+            this.expression = exp;
+        } else {
+            this.expression += exp;
+        }
+
+        if (param) { this.addParameter(param); }
+
+
+        return this;
+    }
+
+    /**
+     * @ngdoc
+     * @name sankhyalabs.core.src:Criteria#addParameter
+     * @methodOf sankhyalabs.core.src:Criteria
+     * @description Concatena parâmetros ao critério.
+     *  - Se passado um array, o metodo iterará no array e adicionará cada um dos itens.
+     *  - É possível passar um Objeto CriteriaParameter, um número, string ou uma instancia de data, eles serão inferidos para o tipo certo.
+     * @param {CriteriaParameter} Parâmetro a ser adicionado.
+     */
+    private addParameter(param: Array<CriteriaParameter>): void {
+        for (const index in param) {
+            this.parameters.push(param[index]);
+        }
+    }
+
+}

package/src/utils/CriteriaParameter.ts

@@ -0,0 +1,108 @@
+/**
+ * Possible values of CriteriaType
+ */
+export enum CriteriaType {
+    TYPE_STRING = 'S',
+    TYPE_DATE = 'D',
+    TYPE_NUMBER = 'N',
+}
+
+/**
+ * Interface: return of method "buildParam" of CriteriaParameter class
+ */
+export interface InputCriteria {
+    type: CriteriaType;
+    value: any;
+}
+
+
+
+/**
+ * CriteriaParameter: 
+ */
+export class CriteriaParameter {
+
+    //Internal Properties
+    //================================================================
+
+    private _type: CriteriaType;
+    private _value: any;
+
+    //Constructor
+    //================================================================
+    constructor(type: CriteriaType, value: any) {
+        this._type = type;
+        this._value = value;
+    }
+
+    //Getters and Setters
+    //================================================================
+
+    /**
+     * @ngdoc
+     * @Getter_______________
+     * @name sankhyalabs.core.src:CriteriaParameter#value
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Setter para "value". Trata-se do valor do Parâmetro.
+     * @param {any} [value] Valor do Parâmetro.
+     * @returns {void}
+     */
+    public set value(value: any) {
+        this._value = value;
+    }
+
+    /**
+     * @ngdoc
+     * @Setter_______________
+     * @name sankhyalabs.core.src:CriteriaParameter#value
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Getter para "value". Trata-se do valor do Parâmetro.
+     * @returns {any} Retorna valor do Parâmetro da classe Criteria
+     */
+    public get value(): any {
+        return this._value;
+    }
+
+
+    /**
+     * @ngdoc
+     * @Getter_______________
+     * @name sankhyalabs.core.src:CriteriaParameter#type
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Setter para "type". Trata-se do tipo do valor do Parâmetro.
+     * @param {CriteriaType} [type] Tipo do valor do Parâmetro.
+     * @returns {void}
+     */
+    public set type(type: CriteriaType) {
+        this._type = type;
+    }
+
+    /**
+     * @ngdoc
+     * @Setter_______________
+     * @name sankhyalabs.core.src:CriteriaParameter#type
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Getter para "type". Trata-se do valor do Parâmetro.
+     * @returns {CriteriaType} Retorna o tipo do Parâmetro da classe Criteria
+     */
+    public get type(): CriteriaType {
+        return this._type;
+    }
+
+
+    /**
+     * @sankhyalabscore
+     * @name sankhyalabs.core.src:CriteriaParameter#buildParam
+     * @methodOf sankhyalabscore src.utils.CriteriaParameter
+     * @description Cria um JSON/Objeto de acordo com as propriedades internas "value" e "type" da classe CriteriaParameter
+     * @returns {InputCriteria} Retorna JSON/Objeto no formato InputCriteria.
+     */
+    public buildParam = (): InputCriteria => {
+        const paramObj = {
+            type: this._type,
+            value: this._value,
+        }
+        return paramObj;
+    }
+
+}

package/src/utils/DateUtils.ts

@@ -0,0 +1,195 @@
+import { number } from "yargs";
+
+/**
+ * `DateUtils`: Utilizado para formatação, padronização e cálculos de datas. 
+ */
+export default class DateUtils{
+    
+     /**
+     * Zerar o horário de uma data.
+     * 
+     * @param date - Data a ser manipulada.
+     * @param adjustDayLightSavingTime - Ajusta horário de verão na data recebida.
+     * @returns - Data sem as informações de horário.
+     * @example
+     * Informo: 2023-03-09 12:42:40      | Obtenho: 2023-03-09 00:00:00 
+     */
+    public static clearTime(date:Date, adjustDayLightSavingTime:boolean = true): Date {
+        const newDate: Date = new Date(date.getFullYear(), date.getMonth(), date.getDate(), 0, 0, 0, 0);
+        return adjustDayLightSavingTime ? DateUtils.adjustDLST(newDate) : newDate;
+    }
+
+    /**
+     * Converte data para uma string no formato pt-BR.
+     * 
+     * @param date - Data a ser convertida.
+     * @param options - Opções de formatação da data.
+     * @returns - Uma string com a data no formato pt-BR DD/MM/YYYY.
+     */
+    public static formatDate(date: Date, options?: Intl.DateTimeFormatOptions): string{
+        return date ? new Intl.DateTimeFormat("pt-BR", options ?? {}).format(date) : "";
+    }
+
+    /**
+     * Converte as horas de uma data para uma string pt-BR.
+     * 
+     * @param date - Data a ser convertida.
+     * @param showSeconds - define se devemos considerar os segundos.
+     * @returns - Uma string com as horas no formato HH:MM ou HH:MM:SS.
+     */
+    public static formatTime(date: Date, showSeconds: boolean = false): string{
+        const timeOptions:Intl.DateTimeFormatOptions = {hour: "2-digit", minute: "2-digit", second: showSeconds ? "2-digit" : undefined};
+        return new Intl.DateTimeFormat("pt-BR", timeOptions).format(date);
+    }
+
+    /**
+     * Converte a data e hora para uma string no formato pt-BR.
+     * 
+     * @param date - Data a ser convertida.
+     * @param showSeconds - define se devemos considerar os segundos.
+     * @returns - Uma string com as horas no formato DD/MM/YYYY HH:MM ou DD/MM/YYYY HH:MM:SS.
+     */
+    public static formatDateTime(date: Date, showSeconds: boolean = false): string{
+        return `${DateUtils.formatDate(date)} ${DateUtils.formatTime(date, showSeconds)}`;
+    }
+  
+    /**
+     * Converte String para Date.
+     * 
+     * @param strValue - Texto a ser convertido para data.
+     * @param adjustDayLightSavingTime - Se verdadeiro, ativa regra de horário de verão.
+     * @param monthYearMode - Quando ativado, retorna o primeiro dia do mês apenas para construir a data.
+     * @returns - Data sem as informações de horário.
+     */
+    public static strToDate(strValue:string, adjustDayLightSavingTime:boolean = true, monthYearMode:boolean = false): Date | undefined {
+        /** monthYearMode é um booleano para usar o formato MM/YYYY. 
+         * Quando ativado, é retornado o primeiro dia do mês apenas para construir a data. 
+         * Não há necessidade de verificar o horário de verão quando utilizado esse modo. */
+        
+        let parts;
+        
+        if (monthYearMode) {
+            parts = /^(1[0-2]|0[1-9]|[1-9])[^\d]?(\d{2}|\d{4})(?:\s(\d{1,2}):(\d{1,2}):?(\d{0,2}))?$/.exec(strValue);
+        }else {
+            parts = /^(3[01]|[1-2]\d|0[1-9]|[1-9])[^\d]?(1[0-2]|0[1-9]|[1-9])[^\d]?(\d{2}|\d{4})(?:\s(\d{1,2}):(\d{1,2}):?(\d{0,2}))?$/.exec(strValue);
+        }
+        if (!parts) {
+            return undefined;
+        }
+
+        const day:number   = monthYearMode ? 1 : Number(parts[1]);
+        const month:number = Number(parts[(monthYearMode ? 1 : 2)]);
+        let year:number  = Number(parts[(monthYearMode ? 2 : 3)]);
+        const hour:number  = Number(parts[(monthYearMode ? 3 : 4 )] || 0);
+        const min:number   = Number(parts[(monthYearMode ? 4 : 5 )] || 0);
+        const sec:number   = Number(parts[(monthYearMode ? 5 : 6 )] || 0);
+
+        if (year < 100) {
+            year += year < 30 ? 2000 : 1900;
+        }
+
+        let date: Date = new Date(year, month - 1, day, hour, min, sec, 0);
+
+        if (adjustDayLightSavingTime === true && !monthYearMode && hour == 0) {
+            date = DateUtils.adjustDLST(date);
+        }
+        
+        return date;
+    }
+
+    /**
+     * Obtém a data atual.
+     * 
+     * @param withTime - Caso true retorna a data com informações de horário.
+     * @returns - Data atual sem informação de horário. 
+     */
+    public static getToday(withTime: boolean = false): Date {
+        const today = new Date();
+
+        if (withTime) {
+            return today;
+        } else {
+            return DateUtils.clearTime(today);
+        }
+    }
+
+    /**
+     * Retorna se a data é válida.
+     * 
+     * @param value - Data a ser validada.
+     * @param hasTime - Determina se a data retornada deve conter informação de horário ou não. Por padrão não retorna a hora.
+     * @returns - Caso válida, retorna a própria data.
+     */
+    public static validateDate(value: Date, hasTime: boolean = false): Date | undefined {
+      return value instanceof Date && !isNaN(value.valueOf())
+        ? hasTime ? value : DateUtils.clearTime(value)
+        : undefined;
+    }
+
+    /**
+     * Realiza correção do horário de verão.
+     * 
+     * @param date - Data a ser ajustada.
+     * @returns - Data informada ajustada para horário de verão.
+     */
+    private static adjustDLST(date:Date): Date {
+        
+        if(date.getHours() == 23){
+            return new Date(date.getFullYear(), date.getMonth(), date.getDate() + 1, 1, 0, 0, 0);
+        }
+
+        return date;
+    }
+
+    /**
+     * Adiciona uma casa decimal a esquerda de uma unidade.
+     * 
+     * @param n - Número a ser ajustado
+     * @returns - O número informado, com uma casa decimal a esquerda. 
+     * @example
+     * Informo: 15     | Obtenho: 15
+     * @example
+     * Informo:  2     | Obtenho: "02"
+     */    
+    private static pad(n: number): string | number {
+        return n < 10 ? "0" + n : n;
+    }
+
+    /**
+     * Retorna timezone da data.
+     * 
+     * @param offset - Valor do timezone desejado.
+     * @returns Timezone da data.
+     */ 
+    private static timezoneOffset(offset: number): string {
+        let sign;
+
+        if (offset === 0) {
+            return "Z";
+        }
+        
+        sign = (offset > 0) ? "-" : "+";
+        offset = Math.abs(offset);
+
+        return sign + this.pad(Math.floor(offset / 60)) + ":" + this.pad(offset % 60);
+    }
+  
+    /**
+     * Converte a data para o formato RFC3339.
+     * 
+     * @param date - Data a ser convertida
+     * @returns - Data informada no formato RFC3339.
+     * * @example
+     * Informo: 2023-03-09 12:42:40     | Obtenho: 2023-03-09T12:42:47-03:00
+     */ 
+    public static formatRfc3339(date: Date): string {
+    
+        return date.getFullYear() + "-" +
+            this.pad(date.getMonth() + 1) + "-" +
+            this.pad(date.getDate()) + "T" +
+            this.pad(date.getHours()) + ":" +
+            this.pad(date.getMinutes()) + ":" +
+            this.pad(date.getSeconds()) + 
+            this.timezoneOffset(date.getTimezoneOffset());
+    }
+  }

package/src/utils/ElementIDUtils.ts

@@ -0,0 +1,184 @@
+
+import { StringUtils } from "./StringUtils.js";
+import DataUnit from "../dataunit/DataUnit.js";
+
+export interface IElementIDInfo {
+	id?: string,
+	dataUnit?: DataUnit
+}
+/**
+ * `ElementIDUtils`: O ElementIDUtils é um utilitário responsável por criar e adicionar identificadores únicos aos componentes através do atributo data-element-id. 
+ * A finalidade dele é otimizar a automação dos testes e melhorar a eficiência na manipulação dos componentes do Design System, garantindo seleções precisas e seguras.
+ */
+export class ElementIDUtils {
+  public static DATA_ELEMENT_ID_ATTRIBUTE_NAME: string = "data-element-id";
+  public static INTERNAL_INPUT_NAME: string = "embedded";
+  private static REGEX_DATAUNIT_NAME = /dd:\/\/(.+?)\//;
+
+  /**
+  * Cria e adiciona a propriedade `data-element-id` em um elemento.
+  * 
+  * @param element - Elemento HTML a ser modificado (HTMLElement).
+  * @param suffix - Sufixo/Texto para ser adicionado.
+  * @param iDInfo - ID para ser adicionado.
+  * @returns - O data-element-id gerado.
+  */ 
+  public static addIDInfo(element: HTMLElement, suffix?: string, iDInfo?: IElementIDInfo): string {
+    try{
+      let dataElementID = this.getDataElementID(element, suffix, iDInfo);
+      dataElementID = StringUtils.replaceAccentuatedChars(dataElementID, false);
+      dataElementID = this.addPrefix(iDInfo, dataElementID);
+      element.setAttribute(ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME, dataElementID);
+      return dataElementID;
+    }catch(e){
+      console.warn(`Erro ao gerar data-element-id: ${element.tagName}`, e);
+    }
+    return "";
+  }
+
+  public static addIDInfoIfNotExists(element: HTMLElement, suffix?: string, iDInfo?: IElementIDInfo): string {
+    try{
+      let dataElementID = element.getAttribute(ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME);
+
+      if(dataElementID == undefined){
+        dataElementID = ElementIDUtils.addIDInfo(element, suffix, iDInfo)
+      }
+
+      return dataElementID;
+    }catch(e){
+      console.warn(`Erro ao gerar data-element-id: ${element.tagName}`, e);
+    }
+    return "";
+  }
+
+  public static getInternalIDInfo(sufix: string){
+    return `${ElementIDUtils.INTERNAL_INPUT_NAME}_${sufix}`;
+  }
+
+  /**
+  * Obtém o `data-element-id` do elemento com adição do sufixo e ID.
+  * 
+  * @param element - Elemento HTML a ser modificado (HTMLElement).
+  * @param suffix - Sufixo/Texto para ser adicionado.
+  * @param iDInfo - ID para ser adicionado.
+  * @returns - Atributo `data-element-id` do elemento modificado com sufixo e/ou ID.
+  */ 
+  private static getDataElementID(element: HTMLElement, suffix?: string, iDInfo?: IElementIDInfo) {
+    let dataElementID = ElementIDUtils.getDataElementIDAttribute(element);
+    if(dataElementID != null){
+      return this.addSuffix(StringUtils.toCamelCase((dataElementID as string)), suffix, element);
+    }
+    
+    const validAttribute = this.getAttributeValid(element, iDInfo);
+    
+    if(validAttribute) return this.addSuffix(validAttribute, suffix, element);
+    if(suffix) return String(suffix);
+
+    let tagName = StringUtils.toCamelCase(element.tagName);
+    element.setAttribute(ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME, tagName);
+
+    return tagName;
+  }
+
+  /**
+  * Obtém ID válido para o elemento.
+  * 
+  * @param element - Elemento HTML a ser modificado (HTMLElement).
+  * @param iDInfo - ID para ser adicionado.
+  * @returns - ID para ser adicionado ao elemento conforme ordem de prioridade.
+  */ 
+  private static getAttributeValid(element: HTMLElement, iDInfo?: IElementIDInfo): string | null{
+    if(iDInfo?.id){
+      return this.formatDescription(iDInfo?.id);
+    } 
+    
+    if(element.hasAttribute("data-field-name")){
+      return StringUtils.toCamelCase(element.getAttribute("data-field-name") as string);
+    }
+    
+    if(element?.id){
+      return StringUtils.toCamelCase(element?.id);
+    }
+    
+    if(element.hasAttribute("name")){
+      return this.formatDescription(element.getAttribute("name"));
+    }
+    
+    if(element.hasAttribute("label")){
+      return this.formatDescription(element.getAttribute("label"));
+    }
+
+    if(element.hasAttribute("title")){
+      return this.formatDescription(element.getAttribute("title"));
+    }
+
+    return null;
+  }
+
+  /**
+  * Adiciona sufixo ao atributo `data-element-id` de um elemento, utilizado para montar a hierarquia dos ids dos componentes em tela.
+  * 
+  * @param dataElementID - ID para ser adicionado ao `data-element-id`.
+  * @param suffix - Sufixo/Texto para ser adicionado ao `data-element-id`.
+  * @param element - Elemento HTML a ser modificado (HTMLElement).
+  * @returns - `data-element-id` com sufixo.
+  * 
+  * @example
+  * Um ez-combo-box tem data-element-id = codparc_input_embedded_combo.
+  * Dentro desse ez-combo-box existe um ez-text-input. O data-element-id teria como sufixo o id 'codparc_input_embedded_combo' referente ao seu pai.
+  */ 
+  private static addSuffix(dataElementID: string | null, suffix: string | undefined, element: HTMLElement): string{
+    if(suffix){
+      return `${dataElementID}_${StringUtils.toCamelCase(suffix)}`;
+    }
+    if(StringUtils.isEmpty(dataElementID)){
+      return `${StringUtils.toCamelCase(element.tagName)}`; 
+    }
+    return `${dataElementID}_${StringUtils.toCamelCase(element.tagName)}`; 
+  }
+
+  /**
+  * Adiciona a propriedade name do DataUnit como prefixo do data-element-id do elemento.
+  * 
+  * @param iDInfo - ID para ser adicionado ao `data-element-id`.
+  * @param dataElementID - Sufixo/Texto para ser adicionado ao `data-element-id`.
+  * @returns - String contendo informação para ser usada no `data-element-id` do elemento.
+  */ 
+  private static addPrefix(iDInfo: IElementIDInfo | undefined, dataElementID: string): string {
+    let dataUnitName: string = iDInfo?.dataUnit?.name || "";
+    dataUnitName = this.parseDataUnitName(dataUnitName);
+    if (iDInfo?.dataUnit && !dataElementID?.startsWith(dataUnitName)) {
+      dataElementID = `${StringUtils.toCamelCase(dataUnitName)}_${dataElementID}`
+    }
+    return dataElementID;
+  }
+  
+  /**
+  * Remove caracteres especiais.
+  * 
+  * @param value - Texto que terá os caracteres especiais removidos.
+  * @returns - Retorna a string sem caracteres especiais e em camelCase.
+  */ 
+  private static formatDescription(value: string | null): string{
+    if(!value) return "";
+    value = StringUtils.replaceAccentuatedChars(value, false);
+    return StringUtils.toCamelCase((value.replace(/[^\w\sÀ-ÖØ-öø-ÿ]/gi, " ")).replace(/\s+/g, ' ').trim());
+  }
+
+  private static getDataElementIDAttribute(element: HTMLElement): string | null {
+    if((element as any)[ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME] || element.hasAttribute(ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME)) {
+      return (element as any)[ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME] || element.getAttribute(ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME);
+    } 
+    return null;
+  }
+
+  private static parseDataUnitName(uri:string):string{
+    if(StringUtils.isEmpty(uri)){
+      return uri;
+    }
+    
+    const matcher:RegExpExecArray|null = this.REGEX_DATAUNIT_NAME.exec(uri);      
+    return matcher?.[1] ?? uri;
+  }
+
+}