Настройка регистрации исторических данных
Полная регистрация исторических данных может привести к существенным проблемам с производительностью. Поэтому при развертывании компоновочных блоков полная регистрация исторических данных отключена. Регистрация исторических данных ограничена только теми действиями, которые необходимы для других функций. В качестве предустановленного параметра только исторические данные, которые регистрируются в журнале, являются статусом выполнения определений работы при их создании и обновлении.
Можно настроить набор ограниченных действий, регистрируемых при выключении полной регистрации.
 |
При выборе включить полную регистрацию помните, что это может привести к значительным проблемам с производительностью.
|
Настройки ограниченного набора действий
Для настройки ограниченного набора действий, которые будут вноситься в журнал при отключении комплексного ведения журнала исторических данных, выполните следующие этапы.
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, на базе которого создан компоновочный блок.Для этого примера нажмите для строки со значением managerThingName PTC.DBConnection.HistoricalDataManager.
для строки со значением managerThingName PTC.DBConnection.HistoricalDataManager.d. В окне правки задайте в поле manageThingName, чтобы создать наименование вещи диспетчера для компоновочного блока, созданного на шаге 1.e.
e. Щелкните Задать, чтобы задать новое значение.
f. Щелкните Сохранить для сохранения изменений в вещи PTC.Base.Manager.
4. В ThingWorx Composer перейдите к шаблону вещи диспетчера исторических данных для нового компоновочного блока, созданного на этапе 1.d, в данном примере это MyCompany.DBConnection.HistoricalDataManager_TT.
5. В разделе Сервисы найдите и переопределите службу GetHistoricalDataLogConfig.
6. В редакторе сценария введите запись в область пользовательских настроек для каждого дополнительного события, которое необходимо вносить в журнал.
 | Не изменяйте и не удаляйте записи конфигурации по умолчанию, регистрирующие значение для поля ExecutionStatus при создании или обновлении определений работы (PTC.SCA.SCO.WorkDefinition), если неизвестно, как это может повлиять на другие функции. |
Для записей используется следующий формат:
addLoggingConfiguration("<Data_Shape>", "<field>", "<action>");
Для каждого <действие> допустимыми значениями <поле> являются:
◦ 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, на базе которого создан компоновочный блок.Для этого примера нажмите для строки со значением managerThingName PTC.DBConnection.HistoricalDataManager.
для строки со значением managerThingName PTC.DBConnection.HistoricalDataManager.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. Нажмите Готово, затем нажмите Сохранить, чтобы сохранить обновленную службу.