Продукция фирмы


Как создавать собственные модули.

Внимание! На этой странице содержится только предварительная информация о модулях, которая поможет Вам лучше понять их назначение. Для получение детального описания и руководства по программированию модулей Вам необходимо отправить заявку в фирму 1С.

Что такое встраиваемые модули 1С:Документооборота ?

Это обычная 16-ти разрядная программа формата Windows-DLL, имеющая строго оговоренный интерфейс общения "Рабочее место (клиент)" - встраиваемый_модуль. Модуль может вызывать, дополнять или полностью замещать некоторые функции , предоставлять свои обработчики событий.

Встраиваемые модули находятся в директории PLUGINS и автоматически подгружаются при старте.

Важно заметить, что встраиваемые модули могут быть написаны практически на любом языке программирования, главное, чтобы компилятор мог заздать исполняемый модуль формата 16-ти разрядная Windows DLL!

Внутрение события компоненты "Рабочее место".

Под внутренним событием понимается одно из событий при отправке, получении, обработке документов и проч. Разработчику встраиваемых модулей отданы все основные события, обрабатывая которые он может тем или иным способом влиять на ход их обработки.

Функции компоненты "Рабочее место".

Под функцией понимается конкретное действие, которое выполняет Документооборот: создание запись документа, приемка и отправка, поиск документов или папок, получение и изменение информации в полях документов, удаление, перемещение, переименование папок или документов и так далее. Всего в версии 1.51 предоставлено более 70 функций и событий. Эти функции можно вызывать из внешних модулей, передавая им различные параметры.

Типы встраиваемых модулей.

При регистрации во время начальной загрузки компоненты "Рабочее место" модуль указывает свой тип из числа возможных:

  • выполняемый на старте или на закрытии системы
  • обрабатывающий какое-либо события (или несколько одновременно)
  • добавляющий новую функцию в меню программы

Краткое описание предоставляемых функций

В нижеприведенных таблицах перечисляются функции, которые можно вызывать из внешних модулей и события, которые могут перехвачены или заменены функциями внешнего модуля. Используйте эту информацию для оценки соответствия предоставлемого интерфейса Вашим потребностям.

Для получения более подробной информации о программировании внешних модулей с примерами их создания необходимо обратиться в фирму 1С, отдел Документооборота. 

Основные функции
CREATEDOCFROMFORM Создание документа на основе файла
 CREATENEWDOCUMENT Вызов диалога создание нового документа на основе шаблона 
CREATENEWFOLDER Создание новой папки 
DELETEALL Удаление содержимого папки 
DELETEBYHANDLE Удаление папки или документа 
FINDDOCUMENT  Поиск документа 
FINDFOLDER  Поиск папки
GETCONFIG  Получить информацию о внутренних настройках системы
GETCURRENT  Получить текущий документ или папку 
GETDOCFIELD  Получить содержимое полей документа 
GETDOCUMENTCOUNT  Получить количество документов в папке 
GETDOCUMENTHANDLE  Получить идентификатор документа 
GETITEMSTATUS  Получить состояние элемента в дереве папок 
GETITEMTYPE  Получить тип элемента в дереве папок 
GETMAILADDRESS  Получить свой почтовый адрес 
GETNAME  Получить имя папки или документа 
GETSUBFOLDERCOUNT  Получить количество вложенных подпапок 
GETSUBFOLDERHANDLE  Получить идентификатор подпапки 
GETUSERNAME  Получить почтовое имя пользователя 
MOVETO  Перемещение элемента из папки в папку 
OPENFOLDER  Открыть / закрыть папку 
PRINTDOCUMENT  Печать докумета 
RECEIVE  Инициировать приемку документов 
SAVEDOCUMENT  Записать текущий документ 
SELECT  Отметить текущий элемент
SEND  Отправить текущий / выбранные документы 
SETCURRENT  Сделать элемент текущим 
SETDOCFIELD  Установить содержимое поля документа 
SETHOOK  Установить обработчик событий системы 
SETNAME  Установить имя документа 
UNHOOK  Снять обработчик событий системы 

 

Специальные функции
DIRECT  Получение управления из меню основного приложения 
SHUTDOWN  Получение управления при закрытии основного приложения 
STARTUP  Получение управления при старте основного приложения 
ABOUT  Функция вызова About модуля

 

Функции-события
HOOK_CLEARFOLDER_POST  Обработчик события очистки папки (после очистки) 
HOOK_CLEARFOLDER_PRE  Обработчик события очистки папки (до очистки) 
HOOK_CREATEDOCUMENT  Обработчик события создания документа 
HOOK_CREATEFOLDER  Обработчик события создания папки 
HOOK_DELETE  Обработчик события удаления элемента. Вызывается перед  удалением 
HOOK_RECEIVEDOCUMENT  Обработчик события приемка документа. Вызывается сразу  после приемки нового документа 
HOOK_RENAME_POST  Обработчик события переименовка документа (после  переименовки) 
HOOK_RENAME_PRE Обработчик события переименовка документа (перед  переименовкой) документов или папок
HOOK_SEARCH  Обработчик события поиска  . Вызывается  перед открытием диалога поиска. 
HOOK_SENDDOCUMENT_POST  Обработчик события отправки документа ( после отправки ) 
HOOK_SENDDOCUMENT_PRE  Обработчик события отправки документа ( перед отправкой ) 

 

Функции получения информации об ошибках 
GETLASTERROR  Взять ошибку после выполнения функции 
GETLASTERRORSTRING  Взять текстовое содержание ошибки 
LASTERROR  Функция внутри модуля, вызывается автоматически при  возникновении ошибки 

 

Вспомогательные функции для разработки модулей
BEEP  Выдача звукового сигнала на динамик (например в целях отладки)
INPUTBOX Открытие диалога системы 1С:Документооборот для ввода пользователем строки
MESSAGEBOX Вывод на экран текстового сообщения в диалоге системы 1С:Документооборот
SETSTATUSBARSTRING Вывод текстовой строки-комментария в строке состояния главного окна программы Рабочее место

 


Фирма 1С. Страничка модифицировалась: 11 авг 1999