TCS API Explorer – модуль исследования объектов TechnologiCS API.

 

Для его вызова используется кнопка «TCS API Explorer»  на панели управления.

 

 

При запуске TCS API Explorer для исследования открывает объект модуля TechnologiCS API, из которого был открыт редактор.

 

Основная задача TCS API Explorer – получение информации о свойствах исследуемого модуля. В процесс работы часто возникает потребность узнать название того или иного модуля, посмотреть значение его свойства или тип, попробовать промоделировать ситуацию получения ряда свойств (актуально для свойств типа ptModule).

 

В главном окне модуля находится ряд закладок, соответствующих основным интерфейсам TCS (именно с методами этих интерфейсов идет основная работа). На закладке «FullView» отображаются те же закладки (в основном), только в данном случае их можно видеть одновременно.

 

На закладке «IModule» перечислены методы интерфейса IModule (см. IModule в разделе TechnologiCS API), и так же их значение для данного модуля.

 

 

Важное значение в данном случае имеет галочка IsChildModule (метод IModule2).

 

 

Он означает, что для данного объекта нет соответствующего интерфейса и создан по умолчанию интерфейс от ChildModules.

 

Остановимся подробнее на следующей закладке, так как она представляет наибольший интерес.

 

На закладке «IPModule» перечислены методы интерфейса IPModule. На панели инструментов перечислены вызовы некоторых процедур интерфейса. Например, методы BeginUpdate, EndUpdate, SaveChages, CancelChages. Если мы посмотрим описание интерфейса IPModule, мы найдем эти методы у него. Нажимая данные кнопки, мы фактически производим вызов данного метода у текущего модуля, а на закладке Log – запомненную последовательность вызовов. При нажатии на кнопку CreateNew мы получим форму ввода, в которой можем заполнить доступные для добавления свойства  и получить код для добавления записи в текущий модуль (при этом используются заполненные вами значения).

 

На данной закладке можно так же узнать позволяет ли модуль добавление данных (IPModule\IPModule).

 

 

Посмотреть список его свойств (IPModule\Properties).

 

 

 И их характеристики (IProp, IProp2).

 

 

При нажатии на кнопку Properties обновляется список свойств (это просто служебная  функция, она не вызовет никаких отражений в логе). Двойным щелчком мыши можно скопировать имя свойства в лог. Выделив свойство, его можно изучить на закладках IProp и IProp2. Если свойство имеет тип ptModule, то, нажав кнопку AsIDispatch, мы попадем в новое окно TCS API Explorer, где будем исследовать уже полученное свойство. По завершению работы  с ним мы можем так же сохранить всю работу с ним в текущем логе.

 

Не следует забывать, что здесь мы работаем с текущим модулем, и все воздействия идут на него,  так что если вы неправильно вызовите последовательности действия, то все это отразится на активном модуле и вполне возможно единственным способом заставить его работать после этого будет команда закрыть окно.

 

На закладке «IDModule» мы видим список методов интерфейса IDModule (навигация по набору данных).

 

 

На закладке «IGModule» перечислены методы IGModule - интерфейс отображения набора данных в виде сетки (грида).

 

 

Наиболее интересным здесь будет метод (кнопка) IGModule\IGModule\Filter которая даст пример установки требуемого нам фильтра.

 

 

На закладке «Application» приведены основные методы объекта IOCS_Application (ITCS_Application).

 

 

Здесь можно увидеть и исследовать справочники и их свойства. Нажав на кнопку «Explore This Module» мы попадем в TCS API Explorer для выделенного модуля (справочника) и сможем исследовать его свойства.

 

Итак, основная цель TCS API Explorer - получить список свойств активного модуля и примеры использования отдельных сложных методов для использования их при написании собственных программ.

 

 

При работе пользователя с модулем исследования объектов его действия протоколируются, и данный протокол может быть занесен в буфер обмена для последующей вставки в текст модуля.

 

16 Макросы и скриптовые модули