Свойства спецификации активации

Свойства спецификации активации содержат информацию о конфигурации обработки входящих событий для конечной точки сообщений. Их можно задать с помощью мастера поиска служб предприятия или административной консоли WebSphere Process Server.

Ниже перечислены свойства спецификации активации, которые можно указать в ходе настройки адаптера.

Свойства спецификации активации для WebSphere Adapter for FTP.

Свойство Тип Описание Локали- зуемое Обяза- тельное Значение по умолчанию
DataSourceJNDIName String Имя источника данных JNDI, используемого хранилищем событий для получения соединения с базой данных JDBC. Источник данных должен быть создан на сервере WebSphere Process Server. Имя базы данных, указанное во время создания источника данных, должно уже существовать. Да Да Нет
EventTableName String Имя таблицы, используемой адаптером для хранения событий. В случае применения нескольких спецификаций активации данное значение должно быть уникальным для каждой спецификации активации. Одно и то же имя таблицы не должно использоваться другими экземплярами одного адаптера или другими адаптерами. Если таблица не существует в базе данных, она автоматически создается адаптером. Да Да Нет
DatabaseSchemaName String Имя схемы базы данных, используемое хранилищем событий. Да Нет Нет
DatabaseUsername String Имя пользователя, используемое для получения соединения с базой данных JDBC от источника данных. Да Нет Нет
DatabasePassword String Пароль, используемый для получения соединения с базой данных JDBC от источника данных. Да Нет Нет
CreateTable Boolean Если указано значение true, создается таблица событий и связанные индексы. Для определения неполадок, связанных с созданием таблицы, укажите значение false. Таблицы и индексы можно будет создать вручную. Нет Нет true
EventDirectory String URL сервера FTP, с которого извлекаются файлы событий для входящих операций.

Формат URL: ftp://[ИД-пользователя:пароль@]
серверFTP[:порт]
[УдаленныйКаталогСобытий]

Кроме того, можно указать следующую информацию:
  • Идентификационные данные пользователя с правами доступа на подключение к серверу FTP и выполнение операций FTP. Если идентификационные данные не указаны в свойстве EventDirectory, их следует указать в свойствах Username и Password.
  • Порт FTP. Если номер порта не указан в свойстве EventDirectory, применяется порт FTP по умолчанию.
  • Удаленный каталог событий. Если значение не задано в свойстве EventDirectory, адаптер ресурса считывает файлы событий из каталога сервера FTP, с которым установлено.
Да Да Нет
EventFileMask String Фильтр файлов событий. Фильтр файлов - это выражение, состоящее из алфавитно-цифровых символов, а также символов подстановки * и ?. Да Да *.*
SortEventFiles String Порядок сортировки опрашиваемых файлов событий. Допустимые значения:
  • Filename – сортировка по имени файла по возрастанию
  • Timestamp – сортировка по дате последних изменений по возрастанию
  • <Пусто> - нет сорти- ровки
Сортировка файлов событий выполняется только в том случае, если в свойстве DeliveryType спецификации активации указано значение ORDERED. Сортировка имен файлов выполняется в соответствии с локалью сервера FTP. Для отслеживания локалей и соответствующих им правил применяется пакет ICU4J.
Нет Нет <blank> (= нет сорти- ровки)
FTPArchiveDirectory String Относительный путь к каталогу архива на сервере FTP. Каталог должен существовать. Предусмотрено несколько опций для применения этого атрибута при задании параметров архивирования:
  • Если значение этого свойства задано, а значение свойства FTPRenameExt - нет, адаптер добавляет к имени файла событий системное время и перемещает его в каталог архива на сервере FTP, указанный в этом свойстве.
  • Если значение задано как для этого свойства, так и для свойства FTPRenameExt, адаптер изменяет имя обработанного файла событий на системное время и значение свойства FTPRenameExt и перемещает его в каталог архива на сервере FTP, указанный в этом свойстве.
  • Если этого свойства и свойства FTPRenameExt значения не заданы, адаптер удаляет обработанный файл без добавления в архив.
  • Если значение свойства FTPRenameExt задано, а значение этого свойства - нет, адаптер добавляет к имени обработанного файла событий системное время и значение параметра FTPRenameExt.
Да Нет Нет
FTPRenameExtension String Расширение файла или суффикс, который использует адаптер ресурса для изменения имени удаленного файла FTP после его опроса коннектором. Изменение имени файла исключает возможность повторного опроса того же файла в следующем цикле опроса. Адаптер ресурса можно настроить для переименования обработанных файлов событий и перемещения их в каталог архива. Да Нет Нет
UserName String Имя пользователя с правами доступа на подключение к серверу FTP и выполнение операций FTP. Если URL из свойства EventDirectory содержит имя пользователя, значение этого свойства указывать не обязательно. Да Нет Нет
Password String Пароль пользователя с правами доступа на подключение к серверу FTP и выполнение операций FTP. Если URL из свойства EventDirectory содержит пароль, значение этого свойства указывать не обязательно. Да Нет Нет
FTPGetQuantity Integer Определяет число файлов, загружаемых с удаленного сервера FTP в ходе каждого опроса. Нет Да 10
FTPPollFrequency Integer Задает частоту, с которой адаптер опрашивает сервер FTP. Значение представляет собой число стандартных циклов опроса. Например, если в свойстве PollPeriod указано значение 10000, а в свойстве FTPPollFrequency - 6, то адаптер опрашивает локальный каталог событий каждые 10 секунд, а удаленный каталог событий - каждые 60 секунд. Адаптер выполняет опрос FTP только в том случае, если это свойство задано. Нулевое значение свойства PollPeriod в расчетах рассматривается как 1. Нулевой результат расчета запрещает адаптеру опрос FTP. Нет Да 5
EISEncoding String Кодировка сервера FTP. Это свойство позволяет указать кодировку управляющего соединения с сервером FTP.
  • Если значение свойства EISEncoding не указано как на уровне адаптера, так и на уровне спецификации активации, то кодировка управляющего соединения с сервером FTP не указывается.
  • Если значение свойства EISEncoding указано только на уровне адаптера, оно применяется для управляющего соединения с сервером FTP. Такая возможность удобна при работе с несколькими спецификациями активации с одной кодировкой. В этом случае значение, указанное на уровне адаптера, применяется всеми управляющими соединениями.
  • Если значение свойства EISEncoding указано только в спецификации активации, оно применяется для управляющего соединения с сервером FTP. Поскольку значение указано на уровне спецификации активации, оно применимо только в пределах связанной спецификации активации.
  • Если значение свойства EISEncoding указано как на уровне адаптера, так и на уровне спецификации активации, то применяется значение на уровне спецификации активации.

Для данного атрибута можно задать произвольную кодировку, поддерживаемую Java.

Нет Нет Нет
LocalEventDirectory String Локальный каталог, в который адаптер ресурса загружает файлы событий с сайта FTP. Для обработки событий это свойство должно быть задано. Да Да Нет
LocalArchiveDirectory String Полный путь к локальному архивному каталогу. Должен быть указан существующий и допустимый каталог. Да Нет Нет
FailedArchiveExt String Расширение файла, применяемое для архивирования бизнес-объектов из файла событий, которые не были успешно обработаны. Данное свойство используется только в том случае, если локальный каталог архива допустим и существует. Да Нет fail
OriginalArchiveExt String Расширение файла, применяемое для архивирования исходного файла событий. В архив добавляется резервная копия файла событий на случай ошибок в ходе обработки его бизнес-объектов. Данное свойство используется только в том случае, если локальный каталог архива допустим и существует. Да Нет original
SuccessArchiveExt String Расширение файла, используемое для архивирования всех успешно обработанных бизнес-объектов. Данное свойство используется только в том случае, если локальный каталог архива допустим и существует. Да Нет success
IncludeEndBODelimiter Boolean Если указано значение true, то вместе с бизнес-объектом для дальнейшей обработки отправляется ограничитель. Данное свойство допустимо только в том случае, если файлы событий разбиваются в соответствии с ограничителем. Нет Нет false
DataConnectionMode String Режим информационного соединения, используемый сервером FTP для передачи файлов. Допустимые значения: active и passive. Нет Нет active
FileTransferType Integer Тип передачи файлов, используемый во время входящих операций. Допустимые значения: ASCII и binary. Нет Нет binary
CustomParserClassName String Полное имя класса пользовательского анализатора, используемого для анализа вывода ls –l. Применяется только в случае нестандартного вывода ls –l. Нет Нет Нет
FilePassByReference Boolean Указывает, что в конечную точку не передается содержимое файла событий.

Если указано значение true, к имени файла добавляется системное время и он отправляется в LocalArchiveDirectory. Системное время позволяет избежать ошибок, связанных с совпадающими именами файлов. Значение true допустимо только в том случае, если свойство LocalArchiveDirectory задано и указанный в нем каталог существует. Это свойство применяется только во входящих сценариях сквозной обработки. Если оно задано, файл не разбивается на фрагменты.

Нет Нет false
SplittingFunctionClass
Name
String Полное имя класса, применяемого для разбиения файлов. Требуются два значения:
  • Класс com.ibm.j2ca.extension.
    utils.filesplit.SplitByDelimiter, обеспечивающий разбиение файлов событий в соответствии с ограничителем.
  • Класс com.ibm.j2ca.extension.
    utils.filesplit.SplitBySize, обеспечивающий разбиение файлов событий в соответствии с размером файла.
Ограничитель или размер файла указываются в свойстве SplitCriteria. Если для свойства EventContentType указано нулевое значение, автоматически выбирается имя класса, выполняющего разбиение по размеру файла.
Нет Нет com.ibm.
j2ca.
extension.
utils.
filesplit.
SplitBySize
FileContentEncoding String Кодировка, применяемая для чтения файлов событий с учетом ограничителя EndBODelimiter, а также в ходе преобразований между типами string и byte[]. Если значение не указано, адаптер выполняет попытку чтения без конкретной кодировки. Допустима произвольная кодировка, поддерживаемая Java. Нет Нет Нет
SplitCriteria String Значение этого свойства зависит от значения свойства SplittingFunctionClassName.
  • Если свойство SplittingFunctionClassName указывает, что файлы разбиваются с учетом ограничителя, то SplitCriteria содержит ограничитель, применяемый для разделения бизнес-объектов в файле событий.
  • Если свойство SplittingFunctionClassName указывает, что файлы разбиваются с учетом размера, то свойство SplitCriteria содержит допустимый размер в байтах.
    • Если размер файла событий превышает это значение, то перед отправкой адаптер разбивает его на фрагменты.
    • Если размер файла события меньше этого значения, файл отправляется целиком. Если в свойстве SplitCriteria указано нулевое значение, разбиение не выполняется.
Если в ходе сквозной обработки входящих событий для свойства FilePassByReference указано значение true, файл событий не разбивается.
Да Нет 0
SocksProxyHost String Имя хоста системы, используемой в качестве сервера Proxy, обеспечивающего маршрутизацию запросов между адаптером и сервером FTP. Да Нет Нет
SocksProxyPort String Номер порта сервера Proxy, через который запросы адаптера направляются к серверу FTP. Нет Нет Нет
SocksProxyUserName String Имя пользователя, используемое для идентификации на сервере Proxy. Да Нет Нет
SocksProxyPassword String Пароль, используемый для идентификации на сервере Proxy. Да Нет Нет
FTPScriptFileExecuted
BeforeInbound
String Полное имя файла сценария в локальной системе адаптера, выполняемого перед каждым циклом опроса входящих событий. Да Нет Нет
FTPScriptFile
ExecutedAfterInbound
String Полное имя файла сценария в локальной системе адаптера, выполняемого перед каждым циклом опроса исходящих запросов. Да Нет Нет
DefaultObjectName String Имя оболочки объекта данных, используемого средой преобразования данных перед доставкой события в конечную точку. Например, FTPFileBG или CustomerWrapperBG. Нет Нет Нет
EventContentType String Тип содержимого/MIME входящего файла событий, отправляемого среде преобразования данных для вызова подходящего обработчика данных в ходе преобразования строки бизнес-объекта в бизнес-объект. Для операций сквозной обработки указывается значение NULL. Нет Нет Нет
Ссылки, связанные с данной
Свойства адаптера ресурсов
Свойства спецификации соединения
Свойства фабрики управляемых соединений (J2C)
Свойства спецификации взаимодействия

Условия использования |


(c) Copyright IBM Corporation 2005, 2006.
Справочная система Information Center создана с использованием технологии Eclipse (http://www.eclipse.org)