В версии 5.7 изменились механизмы ввода и преобразования документов:
1. | Конфигурационный файл DctsCaptureService.exe.config заменен на CaptureService.exe.config. Значительно изменен состав настроек службы ввода. При переходе со старой версии службы ее требуется настраивать заново. |
2. | Удален сценарий настройки служб ввода Установки служб ввода Directum. Теперь настройка службы выполняется в конфигурационном файле CaptureService.exe.config, снабженном подробными комментариями. Также можно воспользоваться настройкой через центр администрирования служб. |
3. | Удалена неиспользуемая функциональность: модуль захвата с факса и модуль отправки на почту. |
4. | В связи с разработкой единого сценария Обработка захваченного документа службой ввода удалены устаревшие сценарии Обработка документа службами ввода (DCTSProcessCapturedEDocument) и Обработка первичного учетного документа службами ввода (DFADCTSProcessCapturedEDocument). После конвертации их рекомендуется закрыть. |
Если после конвертации не планируется перенастраивать службу ввода документов, сценарий Обработка документа службами ввода останется работоспособным. Для работы со сценарием Обработка первичного учетного документа службами ввода необходимо доработать результаты выполнения функции DFAConnectorGetRequisitesValuesFromERP. Теперь функция DFAConnectorGetRequisitesValuesFromERP возвращает массив из двух элементов: набор значений реквизитов типа IList и результат логирования типа IStringList. Доработайте вызов функции:
ResultFromERP = DFAConnectorGetRequisitesValuesFromERP(INTEGRATION_SYSTEM_CODE; BARCODE_ID; TRUE)
// Получить значения реквизитов
ReqsValues = ResultFromERP[0]
// Получить результаты логирования
LogsFromErp :IStringList = ResultFromERP[1]
if LogsFromErp.Count > 0
Log.AddStrings(LogsFromErp)
endif
5. | Для корректной работы службы ввода после конвертации заполните константу DCSDefaultEDocKind. Укажите вид, с которым по умолчанию будут создаваться документы при занесении в систему. В списке типов карточек документов, которые могут использоваться для документов данного вида, должен быть тип карточки Документы произвольной формы (ПЭА). |
6. | Добавлена статическая роль ОтветственныйЗаСлужбуВвода. Ее необходимо заполнить пользователем ответственным за обработку документов, загруженных службами ввода. |
7. | Службы преобразования больше нет. Вместо нее для преобразования документов в PDF-формат используется локальный СОМ-сервер FileConverter. Также с помощью FileConverter теперь выполняется распознавание штрихкодов. |
8. | Виртуальный принтер NovaPDF 8, необходимый для принтерных преобразований, теперь устанавливается по решению администратора (ранее установка была обязательной) и только на сервисные службы Directum. Принтерное преобразование поддерживается на службе Workflow и на службе обработки событий. |
9. | Для программного преобразования в PDF и извлечения штрихкодов используются новые функции FileConverter: |
• | FCConvertEDocumentToPDF; |
• | FCGetAvailablePDFTransformations; |
• | FCRecognizeBarcodeInEDocument; |
• | FCCanRecognizeBarcodeInFile; |
• | FCRecognizeBarcodeInFile. |
Функции извлечения штрихкодов FCRecognizeBarcodeInEDocument, FCCanRecognizeBarcodeInFile, FCRecognizeBarcodeInFile работают только при установке полной клиентской части.
Устаревшие функции DCTSCheckBasicFileByXMLElement, DCTSCheckRecognizeBarCodeByExtension, DCTSConvertEDocumentToPDF, DCTSConvertFileToPDF, DCTSGetConvertToPDFSupportedExtensions, DCTSGetDeviceTypeByDeviceInfoXMLFileText, DCTSRecognizeBarCodeInEDocument, DCTSRecognizeBarCodeInFile, Recognize2DBarcodeInDocument, Recognize2DBarcodeInFile использовать не рекомендуется. Если они использовались в собственной разработке, доработайте программный код с использованием новых функций.
После конвертации на версию 5.7 для корректной работы устаревших функций преобразования в DCTSConvertEDocumentToPDF, DCTSConvertFileToPDF, DCTSGetConvertToPDFSupportedExtensions добавляется необязательный параметр TransformationName. Значение параметра не указано, поэтому применяются настройки из записи справочника Настройки преобразования в PDF, используемой по умолчанию.
Для устаревших функций DCTSRecognizeBarCodeInEDocument, DCTSRecognizeBarCodeInFile, используемых для извлечения штрихкодов из файлов, после конвертации добавляется 5 необязательных параметров: BarcodeTypes, ProcessOnlyFirstPage, DetectEncoding, MaxPerformance, PdfRenderDpi. Для них используются значения по умолчанию.
Функции DCTSRecognizeBarCodeInEDocument, DCTSRecognizeBarCodeInFile, Recognize2DBarcodeInDocument, Recognize2DBarcodeInFile ранее возвращали список с информацией о найденных штрихкодах типа IList с 3 элементами:
• | с именем Type – типом штрихкода; |
• | с именем Page – номером страницы, на которой был обнаружен штрихкод; |
• | с именем BarcodeString– строкой со значением штрихкода. |
В новой версии функции возвращают список с 4 элементами: Type, Page, Checksum, BarcodeString. Помимо перечисленных элементов, список содержит элемент с именем Checksum – контрольная сумма.
Если в собственной разработке поиск значения элемента BarcodeString осуществлялся по индексу [i], то требуется доработка кода с учетом нового возвращаемого элемента.
10. | Из стандартной поставки исключены компоненты, ранее использовавшиеся службами ввода и преобразования: |
• | функции SetupDCTS, DCTSConvertFileToHTML; |
• | сценарии DCTSConvertFileToHTML, DCTSConfigurationSetup; |
• | константы DCTSConvertToHTMLWSDL, DCTSConvertToPDFWSDL, DCTSRecognizeBarCodesWSDL, DCTSDefaultEDocKind, DCTSExecutionTimeOut; |
• | вариант запуска компоненты Установки служб ввода и преобразования; |
• | установки системы, связанные с сервисами преобразования: TransformationListServiceConnectionTimeOut, TransformationListServiceURL, TransformationListServiceConnectionTimeOut, TransformationServiceURL. |
После конвертации их рекомендуется закрыть.