Microsoft Power Platform/Dynamics 365 CE - Generate TypeScript Overload Signatures

Automatically creates TypeScript type definitions compatible with @types/xrm by extracting form attributes and controls from Dynamics 365/Power Platform model-driven applications.

当前为 2025-03-17 提交的版本,查看 最新版本

  1. // ==UserScript==
  2. // @name Microsoft Power Platform/Dynamics 365 CE - Generate TypeScript Overload Signatures
  3. // @namespace https://github.com/gncnpk/xrm-generate-ts-overloads
  4. // @author Gavin Canon-Phratsachack (https://github.com/gncnpk)
  5. // @version 1.7
  6. // @license GPL-3.0
  7. // @description Automatically creates TypeScript type definitions compatible with @types/xrm by extracting form attributes and controls from Dynamics 365/Power Platform model-driven applications.
  8. // @match https://*.dynamics.com/main.aspx?appid=*&pagetype=entityrecord&etn=*&id=*
  9. // @grant none
  10. // ==/UserScript==
  11. (function() {
  12. 'use strict';
  13. // Create a button element and style it to be fixed in the bottom-right corner.
  14. const btn = document.createElement('button');
  15. btn.textContent = 'Generate TypeScript Signatures';
  16. btn.style.position = 'fixed';
  17. btn.style.bottom = '20px';
  18. btn.style.right = '20px';
  19. btn.style.padding = '10px';
  20. btn.style.backgroundColor = '#007ACC';
  21. btn.style.color = '#fff';
  22. btn.style.border = 'none';
  23. btn.style.borderRadius = '5px';
  24. btn.style.cursor = 'pointer';
  25. btn.style.zIndex = 10000;
  26. document.body.appendChild(btn);
  27. btn.addEventListener('click', () => {
  28. // Mapping objects for Xrm attribute and control types.
  29. var attributeTypeMapping = {
  30. "boolean": "Xrm.Attributes.BooleanAttribute",
  31. "datetime": "Xrm.Attributes.DateAttribute",
  32. "decimal": "Xrm.Attributes.NumberAttribute",
  33. "double": "Xrm.Attributes.NumberAttribute",
  34. "integer": "Xrm.Attributes.NumberAttribute",
  35. "lookup": "Xrm.Attributes.LookupAttribute",
  36. "memo": "Xrm.Attributes.StringAttribute",
  37. "money": "Xrm.Attributes.NumberAttribute",
  38. "multiselectoptionset": "Xrm.Attributes.MultiselectOptionSetAttribute",
  39. "optionset": "Xrm.Attributes.OptionSetAttribute",
  40. "string": "Xrm.Attributes.StringAttribute"
  41. };
  42. var controlTypeMapping = {
  43. "standard": "Xrm.Controls.StandardControl",
  44. "iframe": "Xrm.Controls.IframeControl",
  45. "lookup": "Xrm.Controls.LookupControl",
  46. "optionset": "Xrm.Controls.OptionSetControl",
  47. "customsubgrid:MscrmControls.Grid.GridControl": "Xrm.Controls.GridControl",
  48. "subgrid": "Xrm.Controls.GridControl",
  49. "timelinewall": "Xrm.Controls.TimelineWall",
  50. "quickform": "Xrm.Controls.QuickFormControl"
  51. };
  52.  
  53. var specificControlTypeMapping = {
  54. "boolean": "Xrm.Controls.BooleanControl",
  55. "datetime": "Xrm.Controls.DateControl",
  56. "decimal": "Xrm.Controls.NumberControl",
  57. "double": "Xrm.Controls.NumberControl",
  58. "integer": "Xrm.Controls.NumberControl",
  59. "lookup": "Xrm.Controls.LookupControl",
  60. "memo": "Xrm.Controls.StringControl",
  61. "money": "Xrm.Controls.NumberControl",
  62. "multiselectoptionset": "Xrm.Controls.MultiselectOptionSetControl",
  63. "optionset": "Xrm.Controls.OptionSetControl",
  64. "string": "Xrm.Controls.StringControl"
  65. }
  66. // Object to hold the type information.
  67. const typeInfoTemplate = { attributes: {}, controls: {}, possibleTypes: {}, enums: {} }
  68. const entityTypeInfos = {};
  69. // Loop through all controls on the form.
  70. if (typeof Xrm !== 'undefined' && Xrm.Page && typeof Xrm.Page.getControl === 'function') {
  71. let entity = Xrm.Page.data.entity.getEntityName();
  72. let typeInfo = entityTypeInfos[entity] = entityTypeInfos[entity] ?? typeInfoTemplate;
  73. Xrm.Page.getControl().forEach((ctrl) => {
  74. const ctrlType = ctrl.getControlType();
  75. const mappedType = controlTypeMapping[ctrlType];
  76. if (mappedType) {
  77. typeInfo.controls[ctrl.getName()] = mappedType;
  78. typeInfo.possibleTypes[ctrl.getName()] = [];
  79. typeInfo.possibleTypes[ctrl.getName()].push(mappedType);
  80. }
  81. });
  82. } else {
  83. alert("Xrm.Page is not available on this page.");
  84. return;
  85. }
  86.  
  87. // Loop through all enums on the form.
  88. if (typeof Xrm.Page.getAttribute === 'function') {
  89. let entity = Xrm.Page.data.entity.getEntityName();
  90. let typeInfo = entityTypeInfos[entity] = entityTypeInfos[entity] ?? typeInfoTemplate;
  91. Xrm.Page.getAttribute().forEach((attr) => {
  92. if (attr.getAttributeType() === "optionset" && attr.controls.get().length > 0) {
  93. const enumValues = attr.getOptions();
  94. if (enumValues) {
  95. typeInfo.enums[attr.controls.get(0).getLabel().replace(/\s+/g, '')] = enumValues;
  96. }
  97. }
  98. });
  99. }
  100.  
  101. // Loop through all Quick View controls on the form.
  102. if (typeof Xrm.Page.ui.quickForms.get === 'function') {
  103. let entity = Xrm.Page.data.entity.getEntityName();
  104. let typeInfo = entityTypeInfos[entity] = entityTypeInfos[entity] ?? typeInfoTemplate;
  105. Xrm.Page.ui.quickForms.get().forEach((ctrl) => {
  106. const ctrlType = ctrl.getControlType();
  107. const mappedType = controlTypeMapping[ctrlType];
  108. if (mappedType) {
  109. typeInfo.possibleTypes[ctrl.getName()] = typeInfo.possibleTypes[ctrl.getName()] ?? [];
  110. typeInfo.possibleTypes[ctrl.getName()].push(mappedType);
  111. }
  112. });
  113. }
  114.  
  115. // Loop through all tabs and sections on the form.
  116. if (typeof Xrm.Page.ui.tabs.get === 'function') {
  117. let entity = Xrm.Page.data.entity.getEntityName();
  118. let typeInfo = entityTypeInfos[entity] = entityTypeInfos[entity] ?? typeInfoTemplate;
  119. Xrm.Page.ui.tabs.get().forEach((tab) => {
  120. typeInfo.possibleTypes[tab.getName()] = typeInfo.possibleTypes[tab.getName()] ?? [];
  121. typeInfo.possibleTypes[tab.getName()].push("Xrm.Controls.Tab");
  122. tab.sections.forEach((section) => {
  123. typeInfo.possibleTypes[section.getName()] = typeInfo.possibleTypes[section.getName()] ?? [];
  124. typeInfo.possibleTypes[section.getName()].push("Xrm.Controls.Section");
  125. });
  126. });
  127. }
  128.  
  129. // Loop through all attributes on the form.
  130. if (typeof Xrm.Page.getAttribute === 'function') {
  131. let entity = Xrm.Page.data.entity.getEntityName();
  132. let typeInfo = entityTypeInfos[entity] = entityTypeInfos[entity] ?? typeInfoTemplate;
  133. Xrm.Page.getAttribute().forEach((attr) => {
  134. const attrType = attr.getAttributeType();
  135. const mappedType = attributeTypeMapping[attrType];
  136. const mappedControlType = specificControlTypeMapping[attrType];
  137. if (mappedType) {
  138. typeInfo.attributes[attr.getName()] = mappedType;
  139. typeInfo.controls[attr.getName()] = mappedControlType;
  140. typeInfo.possibleTypes[attr.getName()] = [];
  141. typeInfo.possibleTypes[attr.getName()].push(mappedType);
  142. typeInfo.possibleTypes[attr.getName()].push(mappedControlType);
  143. }
  144. });
  145. }
  146. // Build the TypeScript overload string.
  147. let outputTS = `// This file is generated automatically.
  148. // It extends the Xrm.FormContext interface with overloads for getAttribute and getControl.
  149. // Do not modify this file manually.
  150. `
  151. for(const [entityName, typeInfo] of Object.entries(entityTypeInfos)) {
  152. for(const [enumName, enumValues] of Object.entries(typeInfo.enums)) {
  153. let enumTemplate = [];
  154. for(const enumValue of enumValues) {
  155. enumTemplate.push(` ${enumValue.text.replace(/\W/g, '')} = ${enumValue.value}`);
  156. }
  157. outputTS += `
  158. /**
  159. * Entity: ${entityName}
  160. */`
  161. outputTS += `
  162. const enum ${enumName} {
  163. ${enumTemplate.join(",\n")}
  164. }
  165. `
  166. }
  167. }
  168. outputTS += `
  169. declare namespace Xrm {
  170. namespace Collection {
  171. interface ItemCollection<T> {
  172. `
  173. for(const [entityName, typeInfo] of Object.entries(entityTypeInfos)) {
  174. for (const [possibleTypeName, possibleTypesArray] of Object.entries(typeInfo.possibleTypes)) {
  175. let possibleTypeTemplate = "";
  176. for (const possibleType of possibleTypesArray) {
  177. possibleTypeTemplate += ` TSubType extends ${possibleType} ? ${possibleType} :`;
  178. }
  179. outputTS += `
  180. /**
  181. * Entity: ${entityName}
  182. */
  183. `
  184. outputTS += ` get<TSubType extends T>(itemName: "${possibleTypeName}"):${possibleTypeTemplate} never;\n`;
  185. }
  186. }
  187. outputTS += `
  188. }
  189. }`
  190. outputTS += `
  191. interface FormContext {
  192. `;
  193. for(const [entityName, typeInfo] of Object.entries(entityTypeInfos)) {
  194. for (const [attributeName, attributeType] of Object.entries(typeInfo.attributes)) {
  195. outputTS += `
  196. /**
  197. * Entity: ${entityName}
  198. */
  199. `
  200. outputTS += ` getAttribute(attributeName: "${attributeName}"): ${attributeType};\n`;
  201. }
  202. for (const [controlName, controlType] of Object.entries(typeInfo.controls)) {
  203. outputTS += `
  204. /**
  205. * Entity: ${entityName}
  206. */
  207. `
  208. outputTS += ` getControl(controlName: "${controlName}"): ${controlType};\n`;
  209. }
  210. }
  211. outputTS += ` }
  212. }
  213. `;
  214. // Create a new window with a textarea showing the output.
  215. // The textarea is set to readonly to prevent editing.
  216. const w = window.open('', '_blank', 'width=600,height=400,menubar=no,toolbar=no,location=no,resizable=yes');
  217. if (w) {
  218. w.document.write('<html><head><title>TypeScript Overload Signatures</title></head><body>');
  219. w.document.write('<textarea readonly style="width:100%; height:90%;">' + outputTS + '</textarea>');
  220. w.document.write('</body></html>');
  221. w.document.close();
  222. } else {
  223. // Fallback to prompt if popups are blocked.
  224. prompt("Copy the TypeScript definition:", outputTS);
  225. }
  226. });
  227. })();