@talxis/base-controls 1.2605.1 → 1.2606.2

package/dist/components/TaskGrid/extensions/dataverse/DataverseTaskGridDescriptor.js

@@ -0,0 +1,184 @@
+import { RecordBuilder, FetchXmlBuilder } from '@talxis/client-libraries';
+import { DataverseSavedQueryStrategy } from './DataverseSavedQueryStrategy.js';
+import { DataverseTaskStrategy } from './DataverseTaskStrategy.js';
+import { DataverseGridCustomizerStrategy } from './DataverseGridCustomizerStrategy.js';
+import { EntityDefinition } from '@talxis/client-metadata';
+import { DataverseCustomColumnsStrategy } from './DataverseCustomColumnsStrategy.js';
+
+const isSingleRecord = (record) => {
+    return !!record && typeof record.getRecordId === "function";
+};
+/**
+ * Ready-to-use {@link ITaskGridDescriptor} implementation for the Dataverse / Talxis platform.
+ *
+ * Wires together all required strategies — task CRUD, saved queries, grid customization — from
+ * a single constructor parameter object. Pass an instance to `TaskGridDatasetControlFactory.createInstance`.
+ *
+ * @example
+ * ```ts
+ * const descriptor = new DataverseTaskGridDescriptor({
+ *   baseFetchXml: myFetchXml,
+ *   fieldMapping: { parentId: 'talxis_parenttaskid', subject: 'subject', stackRank: 'talxis_stackrank' },
+ *   systemQueries: [myDefaultView],
+ * });
+ * const control = await TaskGridDatasetControlFactory.createInstance({ taskGridDescriptor: descriptor, ... });
+ * ```
+ */
+class DataverseTaskGridDescriptor {
+    /** @param params — see {@link IDataverseTaskGridDescriptorParams} for full documentation of each option. */
+    constructor(params) {
+        this._systemQueries = [];
+        this._onInitialize = params.onInitialize;
+        this._height = params.height;
+    }
+    /** Resolves the project entity reference (fetches display name when not supplied). Called once by the factory before any strategy is created. */
+    async onLoadDependencies() {
+        const params = await this._onInitialize();
+        this._params = params;
+        this._systemQueries = params.systemQueries;
+        this._fieldMapping = params.fieldMapping;
+        this._userId = params.userId;
+        this._fetchXml = params.baseFetchXml;
+        this._rootTaskId = params.rootTaskId;
+        this._editFormId = params.editFormId;
+        this._createFormId = params.createFormId;
+        this._bulkEditFormId = params.bulkEditFormId;
+        this._gridParameters = params.gridParameters;
+        this._taskEntityName = this._getTaskEntityNameFromFetchXml(params.baseFetchXml);
+        this._projectRecord = await this._getProjectRecord();
+        this._sourceRecord = await this._getSourceRecord();
+    }
+    /** Returns the field mapping with `stateCode` hard-coded to `"statecode"` (standard Dataverse attribute name). */
+    onGetFieldMapping() {
+        return {
+            ...this._fieldMapping,
+            //dataverse uses this for all entities
+            stateCode: 'statecode',
+        };
+    }
+    //needs to be seperate from onGetGridParameters since it is also required for skeleton rendering before the instance is created
+    onGetHeight() {
+        return this._height;
+    }
+    /** Returns a {@link DataverseSavedQueryStrategy} when `enableUserQueries` is `true`, otherwise a read-only stub that exposes only the system queries. */
+    onCreateSavedQueryStrategy() {
+        if (this._gridParameters?.enableUserQueries) {
+            return new DataverseSavedQueryStrategy({
+                onGetSystemQueries: async () => this._systemQueries,
+                ownerId: this._userId,
+                entityName: this._taskEntityName,
+                recordId: this._projectRecord?.getRecordId()
+            });
+        }
+        return {
+            onGetSystemQueries: async () => this._systemQueries,
+            onGetUserQueries: async () => [],
+            onDeleteUserQueries: function (queryIds) {
+                throw new Error("Function not implemented.");
+            },
+            onUpdateUserQuery: function (currentQuery) {
+                throw new Error("Function not implemented.");
+            },
+            onCreateUserQuery: function (newQuery, currentQuery) {
+                throw new Error("Function not implemented.");
+            }
+        };
+    }
+    onCreateCustomColumnsStrategy() {
+        return new DataverseCustomColumnsStrategy({
+            entityName: this._taskEntityName,
+            recordId: this._projectRecord?.getRecordId(),
+        });
+    }
+    /** Returns a {@link DataverseTaskStrategy} configured with the descriptor's FetchXML, form IDs, and project reference. */
+    onCreateTaskStrategy(deps) {
+        return new DataverseTaskStrategy({
+            fetchXml: this._fetchXml,
+            projectRecord: this._projectRecord,
+            sourceRecord: this._sourceRecord,
+            rootTaskId: this._rootTaskId,
+            bulkEditFormId: this._bulkEditFormId,
+            createFormId: this._createFormId,
+            editFormId: this._editFormId,
+            isCascadeDeleteEnabled: this._params.enableCascadeDelete ?? false,
+            isDeletingTasksWithChildrenEnabled: this._params.enableDeletingTasksWithChildren ?? false,
+        }, deps);
+    }
+    /** Returns a {@link DataverseSavedQueryStrategy} pre-configured as a data provider for the user-query creation/update dialog, with `talxis_name` and `talxis_description` columns. */
+    onCreateUserQueryDataProvider() {
+        const provider = new DataverseSavedQueryStrategy({
+            recordId: this._projectRecord?.getRecordId(),
+            entityName: this._taskEntityName,
+            ownerId: this._userId,
+            onGetSystemQueries: async () => {
+                return [];
+            }
+        });
+        provider.setColumns([{
+                name: 'talxis_name',
+                visualSizeFactor: 200
+            }, {
+                name: 'talxis_description',
+                visualSizeFactor: 300
+            }]);
+        return provider;
+    }
+    /** Returns the feature flags supplied at construction time, or an empty object (all features enabled) when omitted. */
+    onGetGridParameters() {
+        return this._gridParameters ?? {};
+    }
+    /** Returns a {@link DataverseGridCustomizerStrategy} that adds lookup-many cell renderers for columns whose name ends with the lookup-many suffix. */
+    onCreateGridCustomizerStrategy() {
+        return new DataverseGridCustomizerStrategy();
+    }
+    async _getProjectRecord() {
+        const projectRecord = this._params.projectRecord;
+        if (!projectRecord)
+            return undefined;
+        if (isSingleRecord(projectRecord)) {
+            return projectRecord;
+        }
+        const projectId = projectRecord.id;
+        const projectEntityName = projectRecord.entityName;
+        const metadata = await EntityDefinition.fromEntityName(projectEntityName);
+        //@ts-ignore - typings
+        const attributes = (await window.Xrm.Utility.getEntityMetadata(projectEntityName, metadata.Attributes.map(attr => attr.LogicalName))).Attributes.get().filter(attr => attr.IsValidForGrid);
+        const projectData = await window.Xrm.WebApi.retrieveRecord(projectEntityName, projectId, `?$select=${metadata.PrimaryNameAttribute}`);
+        const builder = new RecordBuilder({
+            data: projectData,
+            entityMetadata: metadata,
+            attributes: attributes
+        });
+        return builder.getRecord();
+    }
+    async _getSourceRecord() {
+        const sourceRecord = this._params.sourceRecord;
+        if (!sourceRecord) {
+            return undefined;
+        }
+        const sourceRecordId = isSingleRecord(sourceRecord) ? sourceRecord.getRecordId() : sourceRecord.id;
+        if (this._projectRecord && this._projectRecord.getRecordId() === sourceRecordId) {
+            return this._projectRecord;
+        }
+        if (isSingleRecord(sourceRecord)) {
+            return sourceRecord;
+        }
+        const result = await window.Xrm.WebApi.retrieveRecord(sourceRecord.entityName, sourceRecord.id);
+        const entityMetadata = await EntityDefinition.fromEntityName(sourceRecord.entityName);
+        //@ts-ignore - typings
+        const attributes = (await window.Xrm.Utility.getEntityMetadata(sourceRecord.entityName, entityMetadata.Attributes.map(attr => attr.LogicalName))).Attributes.get().filter(attr => attr.IsValidForGrid);
+        const builder = new RecordBuilder({
+            data: result,
+            entityMetadata: entityMetadata,
+            attributes: attributes
+        });
+        return builder.getRecord();
+    }
+    _getTaskEntityNameFromFetchXml(fetchXml) {
+        const fetchXmlBuilder = FetchXmlBuilder.fetch.fromXml(fetchXml);
+        return fetchXmlBuilder.entity.name;
+    }
+}
+
+export { DataverseTaskGridDescriptor };
+//# sourceMappingURL=DataverseTaskGridDescriptor.js.map

package/dist/components/TaskGrid/extensions/dataverse/DataverseTaskGridDescriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataverseTaskGridDescriptor.js","sources":["../../../../../src/components/TaskGrid/extensions/dataverse/DataverseTaskGridDescriptor.ts"],"sourcesContent":["import { FetchXmlBuilder, IDataProvider, IRawRecord, IRecord, ISingleRecord, RecordBuilder } from \"@talxis/client-libraries\";\nimport { ICustomColumnsStrategy, IDeletedUserQueriesResult, ISavedQuery, ISavedQueryStrategy, ITaskDataProviderStrategy } from \"../../providers\";\nimport { IFieldMapping as IFieldMappingBase, ITaskGridDescriptor, ITaskGridParameters, ITaskStrategyDeps } from \"../../interfaces\";\nimport { IGridCustomizerStrategy } from \"../../components/grid\";\nimport { DataverseSavedQueryStrategy } from \"./DataverseSavedQueryStrategy\";\nimport { DataverseTaskStrategy } from \"./DataverseTaskStrategy\";\nimport { DataverseGridCustomizerStrategy } from \"./DataverseGridCustomizerStrategy\";\nimport { EntityDefinition } from \"@talxis/client-metadata\";\nimport { DataverseCustomColumnsStrategy } from \"./DataverseCustomColumnsStrategy\";\n\n\n/** Dataverse-specific field mapping. Extends the base with an optional project lookup column. */\nexport interface IFieldMapping extends Omit<IFieldMappingBase, 'stateCode'> {\n    /** Logical name of the lookup attribute that points to the parent project record. Required when `projectRecord` is set on the descriptor. */\n    projectId?: string;\n}\n\n/** Lightweight entity reference shape used when only logical name + id are available. */\nexport interface IEntityRecordReference {\n    entityName: string;\n    id: string;\n}\n\n/** Input accepted for source/project: either a fully hydrated record or an entity reference. */\nexport type RecordInput = IEntityRecordReference | ISingleRecord;\n\nconst isSingleRecord = (record: RecordInput | undefined): record is ISingleRecord => {\n    return !!record && typeof (record as ISingleRecord).getRecordId === \"function\";\n};\n\n/** Constructor parameters for {@link DataverseTaskGridDescriptor}. */\nexport interface IDataverseTaskGridDescriptorParams {\n    /** FetchXML that drives the initial data load. May use Liquid template variables (e.g. `{{ projectId }}`). */\n    baseFetchXml: string;\n    /** Maps logical entity attribute names to the roles expected by TaskGrid (e.g. `statecode` → `stateCode`). */\n    fieldMapping: IFieldMapping;\n    /** System (non-deletable) views exposed in the view switcher. At least one is required. */\n    systemQueries: ISavedQuery[];\n    /** Optional source record. If provided, it's data will be propagated into liquid fetch XML templates. */\n    sourceRecord?: RecordInput;\n\n    projectRecord?: RecordInput;\n\n    height?: string;\n    /** Fine-grained feature flags forwarded to the grid. See {@link ITaskGridParameters}. */\n    gridParameters?: ITaskGridParameters;\n    /** When set, the hierarchy is rooted at this task ID instead of showing all top-level tasks. */\n    rootTaskId?: string;\n    /** ID of the currently logged-in user. Used to scope user queries to the current owner. */\n    userId?: string;\n    /** Form ID to open when editing a single existing task. */\n    editFormId?: string;\n    /** Form ID to open when creating a new task via the dialog flow (non-inline). */\n    createFormId?: string;\n    /** Form ID to open for bulk-editing multiple selected tasks. */\n    bulkEditFormId?: string;\n    /** Set to `true` to enable cascade delete when deleting tasks with children. Defaults to `false`. */\n    enableCascadeDelete?: boolean;\n    /** Set to `true` to allow deletion of tasks that have child tasks. When `false`, such tasks are excluded from deletion and an error is returned. Defaults to `false`. */\n    enableDeletingTasksWithChildren?: boolean;\n}\n\n/**\n * Ready-to-use {@link ITaskGridDescriptor} implementation for the Dataverse / Talxis platform.\n *\n * Wires together all required strategies — task CRUD, saved queries, grid customization — from\n * a single constructor parameter object. Pass an instance to `TaskGridDatasetControlFactory.createInstance`.\n *\n * @example\n * ```ts\n * const descriptor = new DataverseTaskGridDescriptor({\n *   baseFetchXml: myFetchXml,\n *   fieldMapping: { parentId: 'talxis_parenttaskid', subject: 'subject', stackRank: 'talxis_stackrank' },\n *   systemQueries: [myDefaultView],\n * });\n * const control = await TaskGridDatasetControlFactory.createInstance({ taskGridDescriptor: descriptor, ... });\n * ```\n */\nexport class DataverseTaskGridDescriptor implements ITaskGridDescriptor {\n    private _fetchXml!: string;\n    private _fieldMapping!: IFieldMapping;\n    private _systemQueries: ISavedQuery[] = [];\n    private _taskEntityName!: string;\n    private _editFormId?: string;\n    private _createFormId?: string;\n    private _bulkEditFormId?: string;\n    private _userId?: string;\n    private _rootTaskId?: string;\n    private _projectRecord?: ISingleRecord;\n    private _sourceRecord?: ISingleRecord;\n    private _params!: IDataverseTaskGridDescriptorParams;\n    private _gridParameters?: ITaskGridParameters;\n    private _height?: string;\n    private _onInitialize: () => Promise<IDataverseTaskGridDescriptorParams>;\n\n    /** @param params — see {@link IDataverseTaskGridDescriptorParams} for full documentation of each option. */\n    constructor(params: { onInitialize: () => Promise<IDataverseTaskGridDescriptorParams>; height?: string }) {\n        this._onInitialize = params.onInitialize;\n        this._height = params.height;\n    }\n\n    /** Resolves the project entity reference (fetches display name when not supplied). Called once by the factory before any strategy is created. */\n    public async onLoadDependencies(): Promise<void> {\n        const params = await this._onInitialize();\n        this._params = params;\n        this._systemQueries = params.systemQueries;\n        this._fieldMapping = params.fieldMapping;\n        this._userId = params.userId;\n        this._fetchXml = params.baseFetchXml;\n        this._rootTaskId = params.rootTaskId;\n        this._editFormId = params.editFormId;\n        this._createFormId = params.createFormId;\n        this._bulkEditFormId = params.bulkEditFormId;\n        this._gridParameters = params.gridParameters;\n        this._taskEntityName = this._getTaskEntityNameFromFetchXml(params.baseFetchXml);\n        this._projectRecord = await this._getProjectRecord();\n        this._sourceRecord = await this._getSourceRecord();\n    }\n\n    /** Returns the field mapping with `stateCode` hard-coded to `\"statecode\"` (standard Dataverse attribute name). */\n    public onGetFieldMapping(): IFieldMappingBase {\n        return {\n            ...this._fieldMapping,\n            //dataverse uses this for all entities\n            stateCode: 'statecode',\n        }\n    }\n\n    //needs to be seperate from onGetGridParameters since it is also required for skeleton rendering before the instance is created\n    public onGetHeight(): string | undefined {\n        return this._height;\n    }\n\n    /** Returns a {@link DataverseSavedQueryStrategy} when `enableUserQueries` is `true`, otherwise a read-only stub that exposes only the system queries. */\n    public onCreateSavedQueryStrategy(): ISavedQueryStrategy {\n        if (this._gridParameters?.enableUserQueries) {\n            return new DataverseSavedQueryStrategy({\n                onGetSystemQueries: async () => this._systemQueries,\n                ownerId: this._userId,\n                entityName: this._taskEntityName,\n                recordId: this._projectRecord?.getRecordId()\n            });\n        }\n        return {\n            onGetSystemQueries: async () => this._systemQueries,\n            onGetUserQueries: async () => [],\n            onDeleteUserQueries: function (queryIds: string[]): Promise<IDeletedUserQueriesResult> {\n                throw new Error(\"Function not implemented.\");\n            },\n            onUpdateUserQuery: function (currentQuery: ISavedQuery): Promise<string | null> {\n                throw new Error(\"Function not implemented.\");\n            },\n            onCreateUserQuery: function (newQuery: { name: string; description?: string; }, currentQuery: ISavedQuery): Promise<string | null> {\n                throw new Error(\"Function not implemented.\");\n            }\n        }\n    }\n\n    public onCreateCustomColumnsStrategy(): ICustomColumnsStrategy | undefined {\n        return new DataverseCustomColumnsStrategy({\n            entityName: this._taskEntityName,\n            recordId: this._projectRecord?.getRecordId(),\n        })\n    }\n\n    /** Returns a {@link DataverseTaskStrategy} configured with the descriptor's FetchXML, form IDs, and project reference. */\n    public onCreateTaskStrategy(deps: ITaskStrategyDeps): ITaskDataProviderStrategy {\n        return new DataverseTaskStrategy({\n            fetchXml: this._fetchXml,\n            projectRecord: this._projectRecord,\n            sourceRecord: this._sourceRecord,\n            rootTaskId: this._rootTaskId,\n            bulkEditFormId: this._bulkEditFormId,\n            createFormId: this._createFormId,\n            editFormId: this._editFormId,\n            isCascadeDeleteEnabled: this._params.enableCascadeDelete ?? false,\n            isDeletingTasksWithChildrenEnabled: this._params.enableDeletingTasksWithChildren ?? false,\n        }, deps);\n    }\n    /** Returns a {@link DataverseSavedQueryStrategy} pre-configured as a data provider for the user-query creation/update dialog, with `talxis_name` and `talxis_description` columns. */\n    public onCreateUserQueryDataProvider(): IDataProvider {\n        const provider = new DataverseSavedQueryStrategy({\n            recordId: this._projectRecord?.getRecordId(),\n            entityName: this._taskEntityName,\n            ownerId: this._userId,\n            onGetSystemQueries: async () => {\n                return []\n            }\n        })\n        provider.setColumns([{\n            name: 'talxis_name',\n            visualSizeFactor: 200\n        }, {\n            name: 'talxis_description',\n            visualSizeFactor: 300\n        }]);\n        return provider;\n    }\n\n    /** Returns the feature flags supplied at construction time, or an empty object (all features enabled) when omitted. */\n    public onGetGridParameters(): ITaskGridParameters {\n        return this._gridParameters ?? {};\n    }\n\n    /** Returns a {@link DataverseGridCustomizerStrategy} that adds lookup-many cell renderers for columns whose name ends with the lookup-many suffix. */\n    public onCreateGridCustomizerStrategy(): IGridCustomizerStrategy {\n        return new DataverseGridCustomizerStrategy();\n    }\n\n    private async _getProjectRecord(): Promise<ISingleRecord | undefined> {\n        const projectRecord = this._params.projectRecord;\n        if (!projectRecord) return undefined;\n        if (isSingleRecord(projectRecord)) {\n            return projectRecord;\n        }\n\n        const projectId = projectRecord.id;\n        const projectEntityName = projectRecord.entityName;\n        const metadata = await EntityDefinition.fromEntityName(projectEntityName);\n        //@ts-ignore - typings\n        const attributes = (await window.Xrm.Utility.getEntityMetadata(projectEntityName, metadata.Attributes.map(attr => attr.LogicalName))).Attributes.get().filter(attr => attr.IsValidForGrid);\n        const projectData = await window.Xrm.WebApi.retrieveRecord(projectEntityName, projectId, `?$select=${metadata.PrimaryNameAttribute}`);\n        const builder = new RecordBuilder({\n            data: projectData,\n            entityMetadata: metadata,\n            attributes: attributes\n        });\n        return builder.getRecord();\n    }\n\n    private async _getSourceRecord(): Promise<ISingleRecord | undefined> {\n        const sourceRecord = this._params.sourceRecord;\n        if (!sourceRecord) {\n            return undefined;\n        }\n        const sourceRecordId = isSingleRecord(sourceRecord) ? sourceRecord.getRecordId() : sourceRecord.id;\n        if (this._projectRecord && this._projectRecord.getRecordId() === sourceRecordId) {\n            return this._projectRecord;\n        }\n\n        if (isSingleRecord(sourceRecord)) {\n            return sourceRecord;\n        }\n        const result = await window.Xrm.WebApi.retrieveRecord(sourceRecord.entityName, sourceRecord.id);\n        const entityMetadata = await EntityDefinition.fromEntityName(sourceRecord.entityName);\n        //@ts-ignore - typings\n        const attributes = (await window.Xrm.Utility.getEntityMetadata(sourceRecord.entityName, entityMetadata.Attributes.map(attr => attr.LogicalName))).Attributes.get().filter(attr => attr.IsValidForGrid);\n\n        const builder = new RecordBuilder({\n            data: result,\n            entityMetadata: entityMetadata,\n            attributes: attributes\n        });\n\n        return builder.getRecord();\n    }\n\n    private _getTaskEntityNameFromFetchXml(fetchXml: string): string {\n        const fetchXmlBuilder = FetchXmlBuilder.fetch.fromXml(fetchXml);\n        return fetchXmlBuilder.entity.name;\n    }\n\n}"],"names":[],"mappings":";;;;;;;AA0BA,MAAM,cAAc,GAAG,CAAC,MAA+B,KAA6B;IAChF,OAAO,CAAC,CAAC,MAAM,IAAI,OAAQ,MAAwB,CAAC,WAAW,KAAK,UAAU,CAAC;AACnF,CAAC,CAAC;AAkCF;;;;;;;;;;;;;;;AAeG;MACU,2BAA2B,CAAA;;AAkBpC,IAAA,WAAA,CAAY,MAA4F,EAAA;QAfhG,IAAc,CAAA,cAAA,GAAkB,EAAE,CAAC;AAgBvC,QAAA,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,YAAY,CAAC;AACzC,QAAA,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;KAChC;;AAGM,IAAA,MAAM,kBAAkB,GAAA;AAC3B,QAAA,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;AAC1C,QAAA,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;AACtB,QAAA,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC;AAC3C,QAAA,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,YAAY,CAAC;AACzC,QAAA,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;AAC7B,QAAA,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC;AACrC,QAAA,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC;AACrC,QAAA,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC;AACrC,QAAA,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,YAAY,CAAC;AACzC,QAAA,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,cAAc,CAAC;AAC7C,QAAA,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,8BAA8B,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAChF,IAAI,CAAC,cAAc,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACrD,IAAI,CAAC,aAAa,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;KACtD;;IAGM,iBAAiB,GAAA;QACpB,OAAO;YACH,GAAG,IAAI,CAAC,aAAa;;AAErB,YAAA,SAAS,EAAE,WAAW;SACzB,CAAA;KACJ;;IAGM,WAAW,GAAA;QACd,OAAO,IAAI,CAAC,OAAO,CAAC;KACvB;;IAGM,0BAA0B,GAAA;AAC7B,QAAA,IAAI,IAAI,CAAC,eAAe,EAAE,iBAAiB,EAAE;YACzC,OAAO,IAAI,2BAA2B,CAAC;AACnC,gBAAA,kBAAkB,EAAE,YAAY,IAAI,CAAC,cAAc;gBACnD,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,UAAU,EAAE,IAAI,CAAC,eAAe;AAChC,gBAAA,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,EAAE;AAC/C,aAAA,CAAC,CAAC;AACN,SAAA;QACD,OAAO;AACH,YAAA,kBAAkB,EAAE,YAAY,IAAI,CAAC,cAAc;AACnD,YAAA,gBAAgB,EAAE,YAAY,EAAE;YAChC,mBAAmB,EAAE,UAAU,QAAkB,EAAA;AAC7C,gBAAA,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;aAChD;YACD,iBAAiB,EAAE,UAAU,YAAyB,EAAA;AAClD,gBAAA,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;aAChD;AACD,YAAA,iBAAiB,EAAE,UAAU,QAAiD,EAAE,YAAyB,EAAA;AACrG,gBAAA,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;aAChD;SACJ,CAAA;KACJ;IAEM,6BAA6B,GAAA;QAChC,OAAO,IAAI,8BAA8B,CAAC;YACtC,UAAU,EAAE,IAAI,CAAC,eAAe;AAChC,YAAA,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,EAAE;AAC/C,SAAA,CAAC,CAAA;KACL;;AAGM,IAAA,oBAAoB,CAAC,IAAuB,EAAA;QAC/C,OAAO,IAAI,qBAAqB,CAAC;YAC7B,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,aAAa,EAAE,IAAI,CAAC,cAAc;YAClC,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,cAAc,EAAE,IAAI,CAAC,eAAe;YACpC,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,UAAU,EAAE,IAAI,CAAC,WAAW;AAC5B,YAAA,sBAAsB,EAAE,IAAI,CAAC,OAAO,CAAC,mBAAmB,IAAI,KAAK;AACjE,YAAA,kCAAkC,EAAE,IAAI,CAAC,OAAO,CAAC,+BAA+B,IAAI,KAAK;SAC5F,EAAE,IAAI,CAAC,CAAC;KACZ;;IAEM,6BAA6B,GAAA;AAChC,QAAA,MAAM,QAAQ,GAAG,IAAI,2BAA2B,CAAC;AAC7C,YAAA,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,EAAE;YAC5C,UAAU,EAAE,IAAI,CAAC,eAAe;YAChC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,kBAAkB,EAAE,YAAW;AAC3B,gBAAA,OAAO,EAAE,CAAA;aACZ;AACJ,SAAA,CAAC,CAAA;QACF,QAAQ,CAAC,UAAU,CAAC,CAAC;AACjB,gBAAA,IAAI,EAAE,aAAa;AACnB,gBAAA,gBAAgB,EAAE,GAAG;aACxB,EAAE;AACC,gBAAA,IAAI,EAAE,oBAAoB;AAC1B,gBAAA,gBAAgB,EAAE,GAAG;AACxB,aAAA,CAAC,CAAC,CAAC;AACJ,QAAA,OAAO,QAAQ,CAAC;KACnB;;IAGM,mBAAmB,GAAA;AACtB,QAAA,OAAO,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC;KACrC;;IAGM,8BAA8B,GAAA;QACjC,OAAO,IAAI,+BAA+B,EAAE,CAAC;KAChD;AAEO,IAAA,MAAM,iBAAiB,GAAA;AAC3B,QAAA,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;AACjD,QAAA,IAAI,CAAC,aAAa;AAAE,YAAA,OAAO,SAAS,CAAC;AACrC,QAAA,IAAI,cAAc,CAAC,aAAa,CAAC,EAAE;AAC/B,YAAA,OAAO,aAAa,CAAC;AACxB,SAAA;AAED,QAAA,MAAM,SAAS,GAAG,aAAa,CAAC,EAAE,CAAC;AACnC,QAAA,MAAM,iBAAiB,GAAG,aAAa,CAAC,UAAU,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;;QAE1E,MAAM,UAAU,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,iBAAiB,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3L,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,iBAAiB,EAAE,SAAS,EAAE,CAAA,SAAA,EAAY,QAAQ,CAAC,oBAAoB,CAAE,CAAA,CAAC,CAAC;AACtI,QAAA,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC;AAC9B,YAAA,IAAI,EAAE,WAAW;AACjB,YAAA,cAAc,EAAE,QAAQ;AACxB,YAAA,UAAU,EAAE,UAAU;AACzB,SAAA,CAAC,CAAC;AACH,QAAA,OAAO,OAAO,CAAC,SAAS,EAAE,CAAC;KAC9B;AAEO,IAAA,MAAM,gBAAgB,GAAA;AAC1B,QAAA,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;QAC/C,IAAI,CAAC,YAAY,EAAE;AACf,YAAA,OAAO,SAAS,CAAC;AACpB,SAAA;AACD,QAAA,MAAM,cAAc,GAAG,cAAc,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC,WAAW,EAAE,GAAG,YAAY,CAAC,EAAE,CAAC;AACnG,QAAA,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,KAAK,cAAc,EAAE;YAC7E,OAAO,IAAI,CAAC,cAAc,CAAC;AAC9B,SAAA;AAED,QAAA,IAAI,cAAc,CAAC,YAAY,CAAC,EAAE;AAC9B,YAAA,OAAO,YAAY,CAAC;AACvB,SAAA;AACD,QAAA,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;QAChG,MAAM,cAAc,GAAG,MAAM,gBAAgB,CAAC,cAAc,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;;QAEtF,MAAM,UAAU,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,YAAY,CAAC,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC;AAEvM,QAAA,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC;AAC9B,YAAA,IAAI,EAAE,MAAM;AACZ,YAAA,cAAc,EAAE,cAAc;AAC9B,YAAA,UAAU,EAAE,UAAU;AACzB,SAAA,CAAC,CAAC;AAEH,QAAA,OAAO,OAAO,CAAC,SAAS,EAAE,CAAC;KAC9B;AAEO,IAAA,8BAA8B,CAAC,QAAgB,EAAA;QACnD,MAAM,eAAe,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAChE,QAAA,OAAO,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC;KACtC;AAEJ;;;;"}

package/dist/components/TaskGrid/extensions/dataverse/DataverseTaskStrategy.d.ts

@@ -0,0 +1,124 @@
+/// <reference types="@types/powerapps-component-framework" />
+/// <reference types="@types/xrm" />
+import { IRecord, IRawRecord, IAvailableColumnOptions, IAvailableRelatedColumn, IRecordSaveOperationResult, IColumn, ISingleRecord } from "@talxis/client-libraries";
+import { ITaskDataProviderStrategy, ITaskDataProvider, IDeleteTasksResult, IOpenDatasetItemsResult } from "../../providers";
+import { ITaskStrategyDeps } from "../..";
+interface IFormParameters {
+    pageInput: Xrm.Navigation.PageInputEntityRecord;
+    navigationOptions: Xrm.Navigation.NavigationOptions;
+}
+/** Constructor parameters for {@link DataverseTaskStrategy}. */
+export interface IDataverseTaskStrategyParams {
+    /** FetchXML used to load tasks. May contain Liquid template variables (e.g. `{{ projectId }}`). */
+    fetchXml: string;
+    /** When `false`, the edit form is opened in read-only mode. Defaults to `true`. */
+    isEditingEnabled?: boolean;
+    /** When `true`, deleting a task will also delete its child tasks. Defaults to `false`. */
+    isCascadeDeleteEnabled?: boolean;
+    /** When `true`, deleting tasks with children is enabled. Defaults to `false`. */
+    isDeletingTasksWithChildrenEnabled?: boolean;
+    /** Form ID to open when editing a single existing task. */
+    editFormId?: string;
+    /** Form ID to open when creating a new task via dialog (non-inline). */
+    createFormId?: string;
+    /** Form ID to open when bulk-editing multiple selected tasks. */
+    bulkEditFormId?: string;
+    /** Project record reference. When provided, new tasks are pre-linked to this project. */
+    projectRecord?: ISingleRecord;
+    sourceRecord?: ISingleRecord;
+    /** When set, the task hierarchy is rooted at this task ID. */
+    rootTaskId?: string;
+    /**
+     * Optional hook to intercept and override the `Xrm.Navigation.navigateTo` parameters for
+     * any form operation (`create`, `edit`, `bulkEdit`, `open`).
+     * Return the modified `pageInput` and `navigationOptions` to customize the dialog.
+     */
+    form?: {
+        onGetFormParameters?: (operation: 'create' | 'edit' | 'bulkEdit' | 'open', defaultParameters: IFormParameters) => IFormParameters;
+    };
+}
+/** Extends {@link ITaskDataProviderStrategy} with a Dataverse-specific accessor for the project reference. */
+export interface IDataverseTaskStrategy extends ITaskDataProviderStrategy {
+    /** Returns the resolved project entity reference, or `null` if no project was provided at construction time. */
+    getProjectRecord(): ISingleRecord | null;
+    getSourceRecord(): ISingleRecord | null;
+}
+/**
+ * Ready-to-use {@link ITaskDataProviderStrategy} implementation for the Dataverse / Talxis platform.
+ *
+ * Handles all task CRUD operations, drag-and-drop reordering (via LexoRank), template-based creation,
+ * and lookup-many column rendering — all backed by the Xrm WebApi and FetchXML.
+ *
+ * Normally instantiated automatically by {@link DataverseTaskGridDescriptor}. Construct directly only
+ * when you need to pass a custom `formStrategy` or override specific behaviour.
+ */
+export declare class DataverseTaskStrategy implements IDataverseTaskStrategy {
+    private _fetchXml;
+    private _entitySetName;
+    private _entityName;
+    private _projectReference?;
+    private _projectRecord?;
+    private _projectMetadata?;
+    private _rootTaskId?;
+    private _taskTree;
+    private _provider;
+    private _editFormId?;
+    private _createFormId?;
+    private _bulkEditFormId?;
+    private _fetchXmlDataProvider;
+    private _isInlineCreateEnabled;
+    private _isEditingEnabled;
+    private _isDeletingTasksWithChildrenEnabled;
+    private _isCascadeDeleteEnabled;
+    private _lookupManyColumns;
+    private _customColumns;
+    private _sourceRecord?;
+    private _customColumnsDataProvider?;
+    private _lookupManyHandlers;
+    private _getFormParameters;
+    /** @param params — see {@link IDataverseTaskStrategyParams} for full documentation of each option. */
+    constructor(params: IDataverseTaskStrategyParams, deps: ITaskStrategyDeps);
+    onGetRawRecords(ids: string[], select?: string): Promise<IRawRecord[]>;
+    getProjectRecord(): ISingleRecord | null;
+    getSourceRecord(): ISingleRecord | null;
+    private _harmonizenizeCustomColumnsData;
+    private _harmonizeLookupManyData;
+    private _convertLookupManyToEntityReference;
+    private _getRawRecordsByIds;
+    onInitialize(provider: ITaskDataProvider): Promise<{
+        columns: IColumn[];
+        rawData: IRawRecord[];
+        metadata: any;
+    }>;
+    private _getLookupManyColumns;
+    private _getCustomColumns;
+    private _restoreVirtualColumnMetadata;
+    private _injectLookupManyFilterOperators;
+    private _getFieldMapping;
+    private _getFetchXml;
+    onGetAvailableColumns(options?: IAvailableColumnOptions): Promise<IColumn[]>;
+    onGetAvailableRelatedColumns(): Promise<IAvailableRelatedColumn[]>;
+    onCreateTask(parentTaskId?: string): Promise<IRawRecord | null>;
+    onDeleteTasks(taskIds: string[]): Promise<IDeleteTasksResult | null>;
+    onCreateTemplateFromTask(taskId: string): Promise<IRawRecord | null>;
+    onCreateTasksFromTemplate(templateId: string, parentTaskId?: string): Promise<IRawRecord[] | null>;
+    onOpenDatasetItems(entityReferences: ComponentFramework.EntityReference[], isTaskEntity: boolean): Promise<IOpenDatasetItemsResult | null>;
+    onMoveTask(movingTaskId: string, movingToTaskId: string, position: "above" | "below" | "child"): Promise<IRawRecord[] | null>;
+    /**
+     * Saves a single dirty field on a task record.
+     * Lookup-many fields are persisted through their dedicated {@link LookupManyHandler}; all other fields use the standard FetchXML provider save path.
+     * TaskGrid uses auto-save, so exactly one dirty field is expected per call.
+     */
+    onRecordSave(record: IRecord): Promise<IRecordSaveOperationResult>;
+    /** Returns `true` when the task's `stateCode` attribute equals `0` (active). */
+    onIsRecordActive(recordId: string): boolean;
+    /** Returns the root task ID used to scope the displayed hierarchy. */
+    onGetRootTaskId?(): string | undefined;
+    private _getNavigationalPropertyName;
+    private _getFormNavigationOptions;
+    private _getLookupManyHandlerForColumn;
+    private _editSingleTask;
+    private _editMultipleTasks;
+    private _updateStackRank;
+}
+export {};