@tekstack/client-data-model 1.0.0 → 1.0.2

package/README.md

@@ -15,6 +15,8 @@ From this folder:
 npm install
 npm run build
 npm pack
+npm login
+npm publish --access public
 ```
 
 `npm run build` will:

package/out/commonFunctions/TekStackSettings.d.ts

@@ -0,0 +1,30 @@
+export interface IQuickBooksSettings {
+    tekstack_QuickBooksBaseAPI: string;
+    tekstack_QuickBooksClientId: string;
+    tekstack_QuickBooksCompanyId: string;
+}
+export declare class TekStackSettings {
+    /**
+     * Returns the values of the tekstack_usebdrteam field in TekStack Settings and saves it in session storage so we don't have to keep calling the API.
+     */
+    static useBDRTeam(): Promise<Boolean>;
+    /**
+     * Returns the values of the tekstack_createteamschannels field in TekStack Settings and saves it in session storage so we don't have to keep calling the API.
+     */
+    static createTeamsChannels(): Promise<Boolean>;
+    /**
+     * Returns the values of the tekstack_AccountEditFormId settings and saves it in session storage so we don't have to keep calling the API.
+     */
+    static AccountEditFormId(): Promise<string>;
+    /**
+     * Returns the values of the tekstack_categorizetimeentry field in TekStack Settings and saves it in session storage so we don't have to keep calling the API.
+     */
+    static showTimeCategories(): Promise<Boolean>;
+    /**
+     * Gets the QuickBooks settings from the tekstack_tekstackconfigurations table and saves it in session storage so we don't have to keep calling the API. If there is an error parsing the settings from session storage, it will clear the session storage and retrieve the settings again.
+      * This is necessary because the client ID and secret are stored in an encoded format, and if there is an error parsing the settings, it could be due to a change in the encoding format or an issue with the stored value. By clearing the session storage and retrieving the settings again, we can ensure that we have the correct values.
+     * @returns
+     */
+    static quickBooksSettings(): Promise<IQuickBooksSettings | null>;
+}
+//# sourceMappingURL=TekStackSettings.d.ts.map

package/out/commonFunctions/TekStackSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TekStackSettings.d.ts","sourceRoot":"","sources":["../../src/commonFunctions/TekStackSettings.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,mBAAmB;IAClC,0BAA0B,EAAE,MAAM,CAAC;IACnC,2BAA2B,EAAE,MAAM,CAAC;IACpC,4BAA4B,EAAE,MAAM,CAAC;CACtC;AAGD,qBAAa,gBAAgB;IAE3B;;OAEG;WACU,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAgC3C;;OAEG;WACU,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IA6BpD;;OAEG;WACU,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAYjD;;OAEG;WACU,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IA6BnD;;;;OAIG;WACU,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,GAAC,IAAI,CAAC;CA6CrE"}

package/out/commonFunctions/TekStackSettings.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TekStackSettings = void 0;
+const dataverse_ify_1 = require("dataverse-ify");
+const __1 = require("../");
+const tekstack_AccountEditFormId = "tekstack_AccountEditFormId";
+class TekStackSettings {
+    /**
+     * Returns the values of the tekstack_usebdrteam field in TekStack Settings and saves it in session storage so we don't have to keep calling the API.
+     */
+    static async useBDRTeam() {
+        if (!sessionStorage.getItem("tekstack_usebdrteam" /* tcA.tekstack_usebdrteam */)) {
+            const query = `?$select=${"tekstack_usebdrteam" /* tcA.tekstack_usebdrteam */}`;
+            // we need to call this method first
+            (0, dataverse_ify_1.setMetadataCache)(__1.metadataCache);
+            const dataverseClient = new dataverse_ify_1.XrmContextDataverseClient(Xrm.WebApi);
+            // UPDATE THIS TO RETRIEVE THE PARENT TABLE AND FIELDS, THEN SET THE FIELDS ON THIS TABLE
+            const settings = await dataverseClient.retrieveMultiple(query, { logicalName: __1.tekstack_tekstackconfigurationsMetadata.logicalName });
+            if (settings.entities.length === 1
+                && settings.entities[0]["tekstack_usebdrteam" /* tcA.tekstack_usebdrteam */] === true) {
+                sessionStorage.setItem("tekstack_usebdrteam" /* tcA.tekstack_usebdrteam */, "true");
+                return true;
+            }
+            else {
+                sessionStorage.setItem("tekstack_usebdrteam" /* tcA.tekstack_usebdrteam */, "false");
+                return false;
+            }
+        }
+        else {
+            // use the value from session storage
+            if (sessionStorage.getItem("tekstack_usebdrteam" /* tcA.tekstack_usebdrteam */) === "true") {
+                return true;
+            }
+            else {
+                return false;
+            }
+        }
+    }
+    /**
+     * Returns the values of the tekstack_createteamschannels field in TekStack Settings and saves it in session storage so we don't have to keep calling the API.
+     */
+    static async createTeamsChannels() {
+        if (!sessionStorage.getItem("tekstack_createteamschannels" /* tcA.tekstack_createteamschannels */)) {
+            const query = `?$select=${"tekstack_createteamschannels" /* tcA.tekstack_createteamschannels */}`;
+            // we need to call this method first
+            (0, dataverse_ify_1.setMetadataCache)(__1.metadataCache);
+            const dataverseClient = new dataverse_ify_1.XrmContextDataverseClient(Xrm.WebApi);
+            const settings = await dataverseClient.retrieveMultiple(query, { logicalName: __1.tekstack_tekstackconfigurationsMetadata.logicalName });
+            if (settings.entities.length === 1
+                && settings.entities[0]["tekstack_createteamschannels" /* tcA.tekstack_createteamschannels */] === true) {
+                sessionStorage.setItem("tekstack_createteamschannels" /* tcA.tekstack_createteamschannels */, "true");
+                return true;
+            }
+            else {
+                sessionStorage.setItem("tekstack_createteamschannels" /* tcA.tekstack_createteamschannels */, "false");
+                return false;
+            }
+        }
+        else {
+            // use the value from session storage
+            if (sessionStorage.getItem("tekstack_createteamschannels" /* tcA.tekstack_createteamschannels */) === "true") {
+                return true;
+            }
+            else {
+                return false;
+            }
+        }
+    }
+    /**
+     * Returns the values of the tekstack_AccountEditFormId settings and saves it in session storage so we don't have to keep calling the API.
+     */
+    static async AccountEditFormId() {
+        var _a, _b;
+        if (!sessionStorage.getItem(tekstack_AccountEditFormId)) {
+            const accountEditFormId = Xrm.Utility.getGlobalContext().getCurrentAppSetting(tekstack_AccountEditFormId).toString();
+            sessionStorage.setItem(tekstack_AccountEditFormId, accountEditFormId);
+            return accountEditFormId;
+        }
+        else {
+            // use the value from session storage
+            return (_b = (_a = sessionStorage.getItem(tekstack_AccountEditFormId)) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : "";
+        }
+    }
+    /**
+     * Returns the values of the tekstack_categorizetimeentry field in TekStack Settings and saves it in session storage so we don't have to keep calling the API.
+     */
+    static async showTimeCategories() {
+        if (!sessionStorage.getItem("tekstack_categorizetimeentry" /* tcA.tekstack_categorizetimeentry */)) {
+            const query = `?$select=${"tekstack_categorizetimeentry" /* tcA.tekstack_categorizetimeentry */}`;
+            // we need to call this method first
+            (0, dataverse_ify_1.setMetadataCache)(__1.metadataCache);
+            const dataverseClient = new dataverse_ify_1.XrmContextDataverseClient(Xrm.WebApi);
+            const settings = await dataverseClient.retrieveMultiple(query, { logicalName: __1.tekstack_tekstackconfigurationsMetadata.logicalName });
+            if (settings.entities.length === 1
+                && settings.entities[0]["tekstack_categorizetimeentry" /* tcA.tekstack_categorizetimeentry */] === true) {
+                sessionStorage.setItem("tekstack_categorizetimeentry" /* tcA.tekstack_categorizetimeentry */, "true");
+                return true;
+            }
+            else {
+                sessionStorage.setItem("tekstack_categorizetimeentry" /* tcA.tekstack_categorizetimeentry */, "false");
+                return false;
+            }
+        }
+        else {
+            // use the value from session storage
+            if (sessionStorage.getItem("tekstack_categorizetimeentry" /* tcA.tekstack_categorizetimeentry */) === "true") {
+                return true;
+            }
+            else {
+                return false;
+            }
+        }
+    }
+    /**
+     * Gets the QuickBooks settings from the tekstack_tekstackconfigurations table and saves it in session storage so we don't have to keep calling the API. If there is an error parsing the settings from session storage, it will clear the session storage and retrieve the settings again.
+      * This is necessary because the client ID and secret are stored in an encoded format, and if there is an error parsing the settings, it could be due to a change in the encoding format or an issue with the stored value. By clearing the session storage and retrieving the settings again, we can ensure that we have the correct values.
+     * @returns
+     */
+    static async quickBooksSettings() {
+        var _a;
+        if (sessionStorage.getItem("QuickBooksSettings")) {
+            try {
+                JSON.parse((_a = sessionStorage.getItem("QuickBooksSettings")) !== null && _a !== void 0 ? _a : "");
+            }
+            catch (e) {
+                // if there was an error parsing the settings, clear the session storage and retrieve the settings again
+                sessionStorage.removeItem("QuickBooksSettings");
+                return await this.quickBooksSettings();
+            }
+        }
+        const query = `?$select=${"tekstack_quickbooksbaseapi" /* tcA.tekstack_QuickBooksBaseAPI */},${"tekstack_quickbooksclientid" /* tcA.tekstack_QuickBooksClientId */},${"tekstack_quickbookscompanyid" /* tcA.tekstack_QuickBooksCompanyId */},${"tekstack_quickbookssecret" /* tcA.tekstack_QuickBooksSecret */}`;
+        // we need to call this method first
+        (0, dataverse_ify_1.setMetadataCache)(__1.metadataCache);
+        const dataverseClient = new dataverse_ify_1.XrmContextDataverseClient(Xrm.WebApi);
+        const settings = await dataverseClient.retrieveMultiple(query, { logicalName: __1.tekstack_tekstackconfigurationsMetadata.logicalName });
+        if (settings.entities.length === 1) {
+            const baseAPI = settings.entities[0]["tekstack_quickbooksbaseapi" /* tcA.tekstack_QuickBooksBaseAPI */];
+            const clientId = settings.entities[0]["tekstack_quickbooksclientid" /* tcA.tekstack_QuickBooksClientId */];
+            const secret = settings.entities[0]["tekstack_quickbookssecret" /* tcA.tekstack_QuickBooksSecret */];
+            const companyId = settings.entities[0]["tekstack_quickbookscompanyid" /* tcA.tekstack_QuickBooksCompanyId */];
+            if (baseAPI && clientId && companyId && secret) {
+                const bytes = new TextEncoder().encode(clientId + ":" + secret);
+                let binary = "";
+                for (const b of bytes)
+                    binary += String.fromCharCode(b);
+                const encoded = btoa(binary);
+                const settings = {
+                    tekstack_QuickBooksBaseAPI: baseAPI,
+                    tekstack_QuickBooksClientId: encoded,
+                    tekstack_QuickBooksCompanyId: companyId
+                };
+                const settingsString = JSON.stringify(settings);
+                sessionStorage.setItem("QuickBooksSettings", settingsString);
+                return settings;
+            }
+        }
+        return null;
+    }
+}
+exports.TekStackSettings = TekStackSettings;
+//# sourceMappingURL=TekStackSettings.js.map

package/out/commonFunctions/TekStackSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TekStackSettings.js","sourceRoot":"","sources":["../../src/commonFunctions/TekStackSettings.ts"],"names":[],"mappings":"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"}

package/out/commonFunctions/Utilities.d.ts

@@ -0,0 +1,93 @@
+export declare class Utilities {
+    /**
+     * Hides the form selector and the form header
+     * @param formContext
+     */
+    static hideFormSelector(formContext: Xrm.FormContext): void;
+    /**
+     * Hides the form selector but show the form header
+     * @param formContext
+     */
+    static hideFormSelectorShowHeader(formContext: Xrm.FormContext): void;
+    /**
+     * Shows the form selector
+     * @param formContext
+     */
+    static showFormSelector(formContext: Xrm.FormContext): void;
+    /**
+     * Initializes the create form by hiding the header section and tab navigator.
+     */
+    static initializeCreateForm(formContext: Xrm.FormContext): Promise<void>;
+    /**
+     * The guid id of the current form with no braces
+     * @param formContext
+     * @returns
+     */
+    static formId(formContext: Xrm.FormContext): string;
+    static openEditForm(eventContext: Xrm.Events.EventContext, savemode: number, formType: number, widthEditForm: number, guidEditForm: string, idrecord: string, recordentity: string, recordname: string, parentField: string): void;
+    static openEditForm2(eventContext: Xrm.Events.EventContext, savemode: number, formType: number, guidEditForm: string): void;
+    static toLookup(reference: import("dataverse-ify").EntityReference | undefined): Xrm.LookupValue[] | null;
+    static openAlertDialog(title: string, text: string, confirmButtonLabel: string, height: number, width: number): Promise<void>;
+    static retrieveEntity(entityLogicalName: string, id: string, columns: string): Promise<any>;
+    static convertToOdataField(field: string): string;
+    static convertToOdataName(field: string): string;
+    /**
+     * Returns the id of the current item with no braces
+     * @param formContext
+     * @returns
+     */
+    static myId(formContext: Xrm.FormContext): string;
+    /**
+     * Returns the id of the lookup field with no braces or null if not set
+     * @param lookupName the name of the lookup field
+     * @param formContext the form context
+     * @returns the id of the lookup field with no braces or null if not set
+     */
+    static getId(lookupName: string, formContext: Xrm.FormContext): string | null;
+    /**
+     * Returns the name of the lookup field or null if not set
+     * @param lookupName the name of the lookup field
+     * @param formContext the form context
+     * @returns the name of the lookup field or null if not set
+     */
+    static getName(lookupName: string, formContext: Xrm.FormContext): string | null;
+    /**
+     * Returns the parent using the id_record and record_entity fields passed in form parameters
+     * @param formContext the form context
+     * @returns a lookup to the parent record or null if the parameters are not set
+     */
+    static getParent(formContext: Xrm.FormContext): Xrm.LookupValue[] | null;
+    static stripBraces(idWithBraces: string): string;
+    /**
+     *
+     * @returns the current user's id with no braces
+     */
+    static myUserId(): string;
+    /**
+     * Returns the values of the useBDRTeam field in TekStack Settings and saves it in session storage so we don't have to keep calling the API.
+     * If the form is the specified type and this is the initial load, closes the form and opens the specified form.
+     * Used to redirect to the create form from the edit form and vice versa, if we are not in the matching mode.
+     * @param eventContext
+     * @param type
+     * @param formId
+     */
+    static redirectIfFormType(eventContext: Xrm.Events.EventContext, type: XrmEnum.FormType, formId: string): Promise<void>;
+    /**
+     * Returns the load type of the form. Only available in the form load event.
+     * @param eventContext
+     * @returns
+     */
+    static getLoadType(eventContext: Xrm.Events.EventContext): Promise<XrmEnum.FormDataLoadState>;
+    /**
+     * Switches the form to the specified form id, if it exists
+     * @param formId
+     * @param formContext
+     */
+    static switchForms(formId: string, formContext: Xrm.FormContext): Promise<void>;
+    /**
+     * Locks the form for editing by disabling all controls
+     * @param formContext
+     */
+    static lockFormForEditing(formContext: Xrm.FormContext): Promise<void>;
+}
+//# sourceMappingURL=Utilities.d.ts.map

package/out/commonFunctions/Utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utilities.d.ts","sourceRoot":"","sources":["../../src/commonFunctions/Utilities.ts"],"names":[],"mappings":"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"}

package/out/commonFunctions/Utilities.js

@@ -0,0 +1,351 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Utilities = void 0;
+const createFormConstants_1 = require("../constants/createFormConstants");
+class Utilities {
+    /**
+     * Hides the form selector and the form header
+     * @param formContext
+     */
+    static hideFormSelector(formContext) {
+        /*formContext.ui.formSelector.items.get().forEach((item: Xrm.Controls.FormItem) => {
+          item.setVisible(false);
+        });*/
+        formContext.ui.headerSection.setBodyVisible(false);
+    }
+    /**
+     * Hides the form selector but show the form header
+     * @param formContext
+     */
+    static hideFormSelectorShowHeader(formContext) {
+        formContext.ui.formSelector.items.get().forEach((item) => {
+            item.setVisible(false);
+        });
+    }
+    /**
+     * Shows the form selector
+     * @param formContext
+     */
+    static showFormSelector(formContext) {
+        formContext.ui.formSelector.items.get().forEach((item) => {
+            item.setVisible(true);
+        });
+    }
+    /**
+     * Initializes the create form by hiding the header section and tab navigator.
+     */
+    static async initializeCreateForm(formContext) {
+        formContext.ui.headerSection.setBodyVisible(false);
+        formContext.ui.headerSection.setTabNavigatorVisible(false);
+    }
+    /**
+     * The guid id of the current form with no braces
+     * @param formContext
+     * @returns
+     */
+    static formId(formContext) {
+        return this.stripBraces(formContext.ui.formSelector.getCurrentItem().getId());
+    }
+    static openEditForm(eventContext, savemode, formType, widthEditForm, guidEditForm, idrecord, recordentity, recordname, parentField) {
+        var _a;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const ec = eventContext;
+        const saveEventArgs = ec.getEventArgs();
+        if (!saveEventArgs.getIsSaveSuccess()) {
+            //there was a save error
+            const saveError = saveEventArgs.getSaveErrorInfo();
+            console.log(saveError);
+            return;
+        }
+        const formContext = eventContext.getFormContext();
+        // savemode 1: save
+        // savemode 2: save and close
+        // see https://learn.microsoft.com/en-us/power-apps/developer/model-driven-apps/clientapi/reference/save-event-arguments/getsavemode
+        if (savemode === 1 /* XrmEnum.SaveMode.Save */ && formType === 1 /* XrmEnum.FormType.Create */) {
+            this.switchForms(guidEditForm, formContext);
+            formContext.ui.headerSection.setTabNavigatorVisible(true);
+            /*if (widthEditForm !== undefined) {
+              if (formContext.data.entity.getId() !== "") {
+                formContext.ui.close();
+      
+                const pageInput: Xrm.Navigation.PageInputEntityRecord = {
+                  pageType: "entityrecord",
+                  entityName: formContext.data.entity.getEntityName(),
+                  entityId: Utilities.myId(formContext),
+                  formId: guidEditForm,
+                  isOfflineSyncError: false,
+                };
+                const navigationOptions: Xrm.Navigation.NavigationOptions = {
+                  target: 2,
+                  height: { value: 100, unit: "%" },
+                  width: { value: widthEditForm, unit: "%" },
+                  position: 2,
+                };
+                Xrm.Navigation.navigateTo(pageInput, navigationOptions);
+              }
+            }*/
+        }
+        // save and new from custom button (see onSaveAndNew)
+        else if (savemode === 13 || savemode === 59 /* XrmEnum.SaveMode.SaveAndNew */) {
+            formContext.ui.close();
+            const formParameters = {};
+            if (idrecord !== undefined && idrecord !== "") {
+                formParameters["id_record"] = idrecord;
+                formParameters["record_entity"] = recordentity;
+                formParameters["record_name"] = recordname;
+            }
+            else {
+                const parentLookup = (_a = formContext.getAttribute(parentField)) === null || _a === void 0 ? void 0 : _a.getValue();
+                formParameters["id_record"] = parentLookup && parentLookup.length > 0
+                    ? parentLookup[0].id
+                    : undefined;
+                formParameters["record_name"] = parentLookup && parentLookup.length > 0
+                    ? parentLookup[0].name
+                    : undefined;
+                formParameters["record_entity"] = parentLookup && parentLookup.length > 0
+                    ? parentLookup[0].entityType
+                    : undefined;
+            }
+            //open create form
+            const pageInput = {
+                pageType: "entityrecord",
+                entityName: formContext.data.entity.getEntityName(),
+                data: formParameters,
+                formId: formContext.ui.formSelector.getCurrentItem().getId(),
+                isOfflineSyncError: false,
+            };
+            const navigationOptions = {
+                target: 2,
+                height: { value: 100, unit: "%" },
+                width: { value: widthEditForm, unit: "%" },
+                position: 2,
+            };
+            Xrm.Navigation.navigateTo(pageInput, navigationOptions);
+        }
+    }
+    static openEditForm2(eventContext, savemode, formType, guidEditForm) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const ec = eventContext;
+        const saveEventArgs = ec.getEventArgs();
+        if (!saveEventArgs.getIsSaveSuccess()) {
+            //there was a save error
+            const saveError = saveEventArgs.getSaveErrorInfo();
+            console.log(saveError);
+            return;
+        }
+        const formContext = eventContext.getFormContext();
+        // savemode 1: save
+        // savemode 2: save and close
+        // see https://learn.microsoft.com/en-us/power-apps/developer/model-driven-apps/clientapi/reference/save-event-arguments/getsavemode
+        if (savemode === 1 /* XrmEnum.SaveMode.Save */ && formType === 1 /* XrmEnum.FormType.Create */) {
+            this.switchForms(guidEditForm, formContext);
+            formContext.ui.headerSection.setTabNavigatorVisible(true);
+        }
+    }
+    static toLookup(reference) {
+        if (reference === undefined ||
+            reference.id === undefined ||
+            reference.name === undefined ||
+            reference.entityType === undefined) {
+            return null;
+        }
+        else {
+            const lookup = [
+                {
+                    id: reference.id.toString(),
+                    name: reference.name,
+                    entityType: reference.entityType,
+                },
+            ];
+            return lookup;
+        }
+    }
+    static openAlertDialog(title, text, confirmButtonLabel, height, width) {
+        return new Promise((resolve, reject) => {
+            Xrm.Navigation.openAlertDialog({ confirmButtonLabel: confirmButtonLabel, text: text, title: title }, { height: height, width: width }).then((result) => {
+                resolve(result);
+            }, (error) => {
+                console.log(error.message);
+                reject(error);
+            });
+        });
+    }
+    static async retrieveEntity(entityLogicalName, id, columns) {
+        return new Promise((resolve) => {
+            Xrm.WebApi.online.retrieveRecord(entityLogicalName, id, "?$select=" + columns).then(function success(result) {
+                resolve(result);
+            }, function (error) {
+                const alertStrings = {
+                    confirmButtonLabel: "OK",
+                    text: "There was an error retrieving the entity: " + error.message,
+                    title: "Error",
+                };
+                const alertOptions = { height: 120, width: 260 };
+                Xrm.Navigation.openAlertDialog(alertStrings, alertOptions);
+            });
+        });
+    }
+    static convertToOdataField(field) {
+        return "_" + field + "_value";
+    }
+    static convertToOdataName(field) {
+        return "_" + field + "_value@OData.Community.Display.V1.FormattedValue";
+    }
+    /**
+     * Returns the id of the current item with no braces
+     * @param formContext
+     * @returns
+     */
+    static myId(formContext) {
+        return Utilities.stripBraces(formContext.data.entity.getId());
+    }
+    /**
+     * Returns the id of the lookup field with no braces or null if not set
+     * @param lookupName the name of the lookup field
+     * @param formContext the form context
+     * @returns the id of the lookup field with no braces or null if not set
+     */
+    static getId(lookupName, formContext) {
+        var _a;
+        const value = (_a = formContext.getAttribute(lookupName)) === null || _a === void 0 ? void 0 : _a.getValue();
+        if (value !== null && value !== undefined && value.length === 1 && value[0].id !== undefined) {
+            var id = value[0].id;
+            return this.stripBraces(id);
+        }
+        return null;
+    }
+    /**
+     * Returns the name of the lookup field or null if not set
+     * @param lookupName the name of the lookup field
+     * @param formContext the form context
+     * @returns the name of the lookup field or null if not set
+     */
+    static getName(lookupName, formContext) {
+        var _a;
+        const value = (_a = formContext.getAttribute(lookupName)) === null || _a === void 0 ? void 0 : _a.getValue();
+        if (value !== null && value !== undefined && value.length === 1 && value[0].name !== undefined) {
+            return value[0].name;
+        }
+        return null;
+    }
+    /**
+     * Returns the parent using the id_record and record_entity fields passed in form parameters
+     * @param formContext the form context
+     * @returns a lookup to the parent record or null if the parameters are not set
+     */
+    static getParent(formContext) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+        if (((_a = formContext.data.attributes.get(createFormConstants_1.id_record)) === null || _a === void 0 ? void 0 : _a.getValue()) !== null &&
+            ((_b = formContext.data.attributes.get(createFormConstants_1.record_entity)) === null || _b === void 0 ? void 0 : _b.getValue()) !== null) {
+            const idrecord = (_d = (_c = formContext.data.attributes.get(createFormConstants_1.id_record)) === null || _c === void 0 ? void 0 : _c.getValue()) === null || _d === void 0 ? void 0 : _d.toString();
+            const recordentity = (_f = (_e = formContext.data.attributes.get(createFormConstants_1.record_entity)) === null || _e === void 0 ? void 0 : _e.getValue()) === null || _f === void 0 ? void 0 : _f.toString();
+            const recordname = (_j = (_h = (_g = formContext.data.attributes.get(createFormConstants_1.record_name)) === null || _g === void 0 ? void 0 : _g.getValue()) === null || _h === void 0 ? void 0 : _h.toString()) !== null && _j !== void 0 ? _j : "Unknown " + recordentity;
+            if (idrecord === undefined || recordentity === undefined) {
+                return null;
+            }
+            else {
+                const parent = [
+                    {
+                        name: recordname,
+                        entityType: recordentity,
+                        id: idrecord,
+                    },
+                ];
+                return parent;
+            }
+        }
+        return null;
+    }
+    static stripBraces(idWithBraces) {
+        return idWithBraces.replace('{', '').replace('}', '');
+    }
+    /**
+     *
+     * @returns the current user's id with no braces
+     */
+    static myUserId() {
+        return Xrm.Utility.getGlobalContext().userSettings.userId.replace(/[{}]/g, "");
+    }
+    /**
+     * Returns the values of the useBDRTeam field in TekStack Settings and saves it in session storage so we don't have to keep calling the API.
+     * If the form is the specified type and this is the initial load, closes the form and opens the specified form.
+     * Used to redirect to the create form from the edit form and vice versa, if we are not in the matching mode.
+     * @param eventContext
+     * @param type
+     * @param formId
+     */
+    static async redirectIfFormType(eventContext, type, formId) {
+        var _a;
+        const formContext = eventContext.getFormContext();
+        const formType = formContext.ui.getFormType();
+        let loadState = 1 /* XrmEnum.FormDataLoadState.InitialLoad */;
+        try {
+            const ec = eventContext;
+            // only available in the form load event
+            loadState = (_a = ec.getEventArgs()) === null || _a === void 0 ? void 0 : _a.getDataLoadState();
+        }
+        catch { }
+        if (formType === type && loadState === 1 /* XrmEnum.FormDataLoadState.InitialLoad */) {
+            this.switchForms(formId, formContext);
+            /*formContext.ui.close();
+            const pageInput: Xrm.Navigation.PageInputEntityRecord = {
+              pageType: "entityrecord",
+              entityName: formContext.data.entity.getEntityName(),
+              entityId: Utilities.myId(formContext),
+              formId: formId,
+              isOfflineSyncError: false,
+            };
+            const navigationOptions: Xrm.Navigation.NavigationOptions = {
+              target: 2,
+              height: { value: 100, unit: "%" },
+              width: { value: 60, unit: "%" },
+              position: 2,
+            };
+            Xrm.Navigation.navigateTo(pageInput, navigationOptions);*/
+        }
+    }
+    /**
+     * Returns the load type of the form. Only available in the form load event.
+     * @param eventContext
+     * @returns
+     */
+    static async getLoadType(eventContext) {
+        var _a;
+        let loadState = 1 /* XrmEnum.FormDataLoadState.InitialLoad */;
+        try {
+            const ec = eventContext;
+            // only available in the form load event
+            loadState = (_a = ec.getEventArgs()) === null || _a === void 0 ? void 0 : _a.getDataLoadState();
+        }
+        catch { }
+        return loadState;
+    }
+    /**
+     * Switches the form to the specified form id, if it exists
+     * @param formId
+     * @param formContext
+     */
+    static async switchForms(formId, formContext) {
+        const items = formContext.ui.formSelector.items.get();
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            if (item.getId().toLowerCase() === formId.toLowerCase()) {
+                item.navigate();
+                break;
+            }
+        }
+    }
+    /**
+     * Locks the form for editing by disabling all controls
+     * @param formContext
+     */
+    static async lockFormForEditing(formContext) {
+        if (formContext.ui.getFormType() === 2 /* XrmEnum.FormType.Update */) {
+            formContext.ui.controls.forEach(function (control) {
+                control.setDisabled(true);
+            });
+        }
+    }
+}
+exports.Utilities = Utilities;
+//# sourceMappingURL=Utilities.js.map