配置要记录的历史数据
对历史数据进行全面记录可能会导致性能严重下降。因此，在部署构建基块时，全面记录历史数据将被禁用。系统将仅记录其他功能所需操作的历史数据。预设情况下，唯一记录的历史数据是工作定义在创建和更新后的执行状况。
 |
如果选取启用全面记录，则可能导致性能严重下降。
|
配置有限的操作集
要配置在禁用全面记录历史数据后所能记录的有限操作集，请完成以下步骤：
1. 创建一个新的构建基块，该构建基块从 PTC.DBConnection 构建基块扩展而来。
要创建新的构建基块，请完成以下步骤：
a. 创建一个新项目。为您的项目指定唯一的前缀，例如您的公司名称。对于 PTC 提供的实体，保留 PTC 前缀。在本示例中，创建一个名为 MyCompany.DBConnection 的项目。对于为此构建基块创建的各个新事物、事物模板或其他实体，将新项目添加为 ThingWorx Composer 实体“常规信息”页面上的“项目”值。
b. 在您的项目中创建一个新事物模板，该事物模板使用 PTC.DefaultConfiguration.EntryPoint_TT 作为其“基本事物模板”。在本示例中，将此新事物模板命名为 MyCompany.DBConnection.EntryPoint_TT。
c. 在您的项目中创建一个新事物，该事物使用在步骤 1.b 中创建的事物模板作为其“基本事物模板”。在本示例中，将此新事物命名为 MyCompany.DBConnection.EntryPoint。
d. 在您的项目中创建一个新事物模板，该事物模板使用您的构建基块所扩展自的 PTC 构建基块中的管理器事物模板作为其“基本事物模板”。在本示例中，将此新事物模板命名为 MyCompany.DBConnection.HistoricalDataManager_TT，并使用 PTC.DBConnection.HistoricalDataManager_TT 作为其“基本事物模板”。
e. 在您的项目中创建一个新事物，该事物使用在步骤 1.d 中创建的事物模板作为其“基本事物模板”。在本示例中，将此新事物命名为 MyCompany.DBConnection.Manager，并使用 MyCompany.DBConnection.HistoricalDataManager_TT 作为其“基本事物模板”。
|
|
PTC.DBConnection 构建基块包含多个管理器事物模板和事物。此过程中要覆盖的服务位于 PTC.DBConnection.HistoricalDataManager_TT 中。请确保您正在将此管理器事物模板而非 PTC.DBConnection 构建基块中的其他管理器事物模板之一，用作您在此步骤中创建的新事物模板的“基本事物模板”。
|
2. 将原始构建基块中管理器事物的所有配置添加到新构建基块中的管理器事物。
a. 导航至在步骤 1.e 中创建的管理器事物，在本示例中为 MyCompany.DBConnection.HistoricalDataManager。
b. 在“配置”下，添加在原始构建基块的管理器事物 (在本示例中为 PTC.DBConnection.HistoricalDataManager) “配置”页面中找到的配置。
3. 将新构建基块的管理器事物注册为要使用的管理器，以取代此构建基块所扩展自的 PTC 构建基块中的管理器。
a. 导航至 PTC.Base.Manager 事物。
b. 在“配置”下，找到 DefaultGlobalManagerConfiguration 配置表。
c. 单击 
，该图标所对应的行中包含 managerThingName 值，该值与所关注构建基块扩展自的 PTC 构建基块的管理器相匹配。
，该图标所对应的行中包含 managerThingName 值，该值与所关注构建基块扩展自的 PTC 构建基块的管理器相匹配。在本示例中，单击 ，该图标所对应的行中包含 PTC.DBConnection.HistoricalDataManager 的 managerThingName 值。
，该图标所对应的行中包含 PTC.DBConnection.HistoricalDataManager 的 managerThingName 值。d. 在编辑窗口中，将 manageThingName 字段设置为步骤 1.e 中所创建之构建基块的管理器事物的名称。
e. 单击“设置”以设置新值。
f. 单击“保存”以保存对 PTC.Base.Manager 事物所做的更改。
4. 在 ThingWorx Composer 中，导航至您在步骤 1.d 中所创建的新构建基块的历史数据管理器事物模板，在此示例中为 MyCompany.DBConnection.HistoricalDataManager_TT。
5. 在“服务”下，查找并覆盖 GetHistoricalDataLogConfig 服务。
6. 在脚本编辑器中，为每个要记录的其他事件于指定的自定义配置区域内添加一个条目。
 | 在不了解对其他功能所产生影响的情况下创建或更新工作定义 (PTC.SCA.SCO.WorkDefinition) 时，请勿更改或移除记录 ExecutionStatus 字段值的默认配置条目。 |
各条目采用以下格式：
addLoggingConfiguration("<Data_Shape>", "<field>", "<action>");
对于每个 <action>，可能的 <field> 值为：
◦ CREATE - 字段的名称、ALL 或无内容
◦ UPDATE - 字段的名称或 ALL
◦ DELETE - 无内容
下表提供了可记录的不同事件的示例条目：
要记录的事件 | 示例条目 |
|---|---|
创建实体 (将行添加至数据库表) | addLoggingConfiguration("PTC.SCA.SCO.WorkDefinition", "CREATE"); |
创建实体和每个字段的初始值 (将行添加至数据库表以及添加行时具有值的每个字段) | addLoggingConfiguration("PTC.SCA.SCO.WorkDefinition", "ALL", "CREATE"); |
创建实体时特定字段的初始值 (指定字段在将行添加至数据库表时具有某一值) | addLoggingConfiguration("PTC.SCA.SCO.JobOrder", "ID", "CREATE"); |
更新特定字段的值 (更改数据库表中的指定字段值) | addLoggingConfiguration("PTC.SCA.SCO.JobOrder", "PlannedEndTime", "UPDATE"); |
更新所有字段的值 (更改数据库表中的任何字段值) | addLoggingConfiguration("PTC.SCA.SCO.JobOrder", "ALL", "UPDATE"); |
删除实体 (将行从数据库表中移除) | addLoggingConfiguration("PTC.SCA.SCO.JobOrder", "DELETE"); |
7. 相继单击“完成”和“保存”来保存更新的服务。
启用全面记录历史数据
要启用全面记录历史数据功能，请完成以下步骤：
| | 如果先前已完成在步骤 1 到步骤 3 中的操作，则不需要重复这些操作。请直接执行步骤 4。 |
1. 创建一个新的构建基块，该构建基块从 PTC.DBConnection 构建基块扩展而来。
要创建新的构建基块，请完成以下步骤：
a. 创建一个新项目。为您的项目指定唯一的前缀，例如您的公司名称。对于 PTC 提供的实体，保留 PTC 前缀。在本示例中，创建一个名为 MyCompany.DBConnection 的项目。对于为此构建基块创建的各个新事物、事物模板或其他实体，将新项目添加为 ThingWorx Composer 实体“常规信息”页面上的“项目”值。
b. 在您的项目中创建一个新事物模板，该事物模板使用 PTC.DefaultConfiguration.EntryPoint_TT 作为其“基本事物模板”。在本示例中，将此新事物模板命名为 MyCompany.DBConnection.EntryPoint_TT。
c. 在您的项目中创建一个新事物，该事物使用在步骤 1.b 中创建的事物模板作为其“基本事物模板”。在本示例中，将此新事物命名为 MyCompany.DBConnection.EntryPoint。
d. 在您的项目中创建一个新事物模板，该事物模板使用您的构建基块所扩展自的 PTC 构建基块中的管理器事物模板作为其“基本事物模板”。在本示例中，将此新事物模板命名为 MyCompany.DBConnection.HistoricalDataManager_TT，并使用 PTC.DBConnection.HistoricalDataManager_TT 作为其“基本事物模板”。
| | PTC.DBConnection 构建基块包含多个管理器事物模板和事物。此过程中要覆盖的服务位于 PTC.DBConnection.HistoricalDataManager_TT 中。请确保您正在将此管理器事物模板而非 PTC.DBConnection 构建基块中的其他管理器事物模板之一，用作您在此步骤中创建的新事物模板的“基本事物模板”。 |
e. 在您的项目中创建一个新事物，该事物使用在步骤 1.d 中创建的事物模板作为其“基本事物模板”。在本示例中，将此新事物命名为 MyCompany.DBConnection.HistoricalDataManager，并使用 MyCompany.DBConnection.HistoricalDataManager_TT 作为其“基本事物模板”。
2. 将原始构建基块中管理器事物的所有配置添加到新构建基块中的管理器事物。
a. 导航至在步骤 1.e 中创建的管理器事物，在本示例中为 MyCompany.DBConnection.HistoricalDataManager。
b. 在“配置”下，添加在原始构建基块的管理器事物 (在本示例中为 PTC.DBConnection.HistoricalDataManager) “配置”页面中找到的配置。
3. 将新构建基块的管理器事物注册为要使用的管理器，以取代此构建基块所扩展自的 PTC 构建基块中的管理器。
a. 导航至 PTC.Base.Manager 事物。
b. 在“配置”下，找到 DefaultGlobalManagerConfiguration 配置表。
c. 单击 ，该图标所对应的行中包含 managerThingName 值，该值与所关注构建基块扩展自的 PTC 构建基块的管理器相匹配。
，该图标所对应的行中包含 managerThingName 值，该值与所关注构建基块扩展自的 PTC 构建基块的管理器相匹配。在本示例中，单击 ，该图标所对应的行中包含 PTC.DBConnection.HistoricalDataManager 的 managerThingName 值。
，该图标所对应的行中包含 PTC.DBConnection.HistoricalDataManager 的 managerThingName 值。d. 在编辑窗口中，将 manageThingName 字段设置为步骤 1.e 中所创建之构建基块的管理器事物的名称。
e. 单击“设置”以设置新值。
f. 单击“保存”以保存对 PTC.Base.Manager 事物所做的更改。
4. 在 ThingWorx Composer 中，导航至您在步骤 1.d 中所创建的新构建基块的历史数据管理器事物模板，在此示例中为 MyCompany.DBConnection.HistoricalDataManager_TT。
5. 在“服务”下，查找并覆盖 LogHistoricalData 服务。
6. 在脚本编辑器中，将 false 设置更改为 true：
var result = true;
7. 相继单击“完成”和“保存”来保存更新的服务。