上传脚本

  • 4 分钟

若要在窗体上使用客户端脚本，必须首先将脚本作为脚本 Web 资源上传。 您可以使用脚本 Web 资源维护以 JavaScript 或 TypeScript 编写的客户端脚本函数库，您可以从模型驱动应用窗体或从命令栏定义中使用这些资源。 如果您使用 TypeScript，必须先将其转译为 JavaScript，然后才能将其作为 Web 资源上传。

若要上传脚本 Web 资源，请从窗体编辑器中创建新的窗体库。

“添加库”对话框的屏幕截图。

将出现“添加 JavaScript 库”弹出窗口。 选择右上角的 + 新建 Web 资源。 在新建 Web 资源窗格中，请务必选择 JavaScript (JS) 作为类型。

显示已选择“脚本类型”的“添加 Web 资源”对话框的屏幕截图。

为了使表列数据可包含在脚本的逻辑中，请确保您已将窗体配置为显示列。 请注意，如果稍后有人从窗体中删除该列，则会导致您的脚本中断，因为引用的列不再可用。 可以将列添加为依赖项，确保列数据始终可供您的脚本逻辑使用。 下图显示将 Idea 表中的 Idea Score 列添加为依赖项。

将客户表中的客户编号列添加为依赖项的屏幕截图。

Web 资源依赖项

除了数据依赖项之外，您还可以在其他 Web 资源上配置依赖项。 此依赖项可节省时间并简化加载逻辑，因为当您注册窗体事件、功能区命令或功能区启用规则的脚本时，窗体不需要显式加载多个依赖的 Web 资源。 使用依赖项配置，您可注册主脚本，并让依赖项配置加载您的代码需要的其他资源。

请务必注意，Web 资源依赖项不会对 Web 资源的加载顺序进行任何控制。 所有 Web 资源均异步地并行加载。 如果您有一个 JavaScript Web 资源，在另一个 JavaScript Web 资源加载和初始化后，才能进行初始化，则您将需要以其他方式管理该依赖项。

使用客户端脚本库

配置为脚本 Web 资源后，客户端脚本库可以与功能区命令和窗体事件关联。 要将脚本与窗体关联，请在工具栏中选择窗体库，然后选择添加库。

添加库的窗体库屏幕截图。

从添加库对话框中，您可以关联现有的已上传脚本 Web 资源或创建新资源。

显示您可以关联现有的已上传脚本 Web 资源或创建新资源的‘添加库’对话框的屏幕截图。

无论您在窗体上注册多少个事件处理程序，每个脚本只需要针对每个窗体执行一次脚本库与窗体的关联。

在生成客户端脚本逻辑时，如果您需要在初始上传后进行更改，您将返回到解决方案中的脚本 Web 资源并上传文件的新版本。 上传后，您必须发布此脚本 Web 资源，以便应用使用最新的更改。