SendFax.exe является утилитой командной строки и предназначена для автоматического создания факса и размещения его в папке Исходящие в Fax Voip T.38 Консоль. Может быть использована в различных сценариях, например в bat-файлах или в пользовательских приложениях. Помогает автоматизировать процесс отправки факсов.

Вы можете найти SendFax.exe в папке установки Fax Voip T.38 Консоль. Это приложение использует библиотеки Fax Voip T.38 Консоль, и поэтому должно находиться в папке, где установлена Fax Voip T.38 Консоль. Не следует перемещать SendFax.exe в другую папку.

Для конструирования командной строки и тестирования SendFax.exe, откройте Панель управления Fax Voip T.38 Консоль, в дереве нажмите Факс, а затем нажмите SendFax.exe, см. главу Настройка и запуск SendFax.exe из панели управления Fax Voip T.38 Консоль настоящего справочного руководства.

Пример использования в bat-файле можно найти в следующем файле:

*{CommonAppDataFolder}\FaxVoip Console\SendFax\Sample\SendFax_test.bat

использование (графический режим): SendFax.exe [параметры]

использование (режим консоли): SendFax_c.exe [параметры]

Получатели факса:

Чтобы отправить факс одному получателю, используйте параметры /FaxNumber и /RecipientName. Для отправки факса нескольким получателям, используйте параметр /RecipientList.

/FaxNumber=value

Номер факса получателя.

/RecipientName=value

Имя получателя. Отображается на титульной странице.

/RecipientList=value

Полный путь к текстовому файлу, в котором содержится список получателей факса. Каждая строка соответствует одному получателю. Можно задать не только номер факса, но и имя получателя, например, 74957721234<Иван Петров>.

Отправляемые документы:

Для отправки единственного документа, используйте параметр /FileName. Чтобы отправить несколько документов, используйте параметр /FileList. Чтобы отправить факс, состоящий только из титульной страницы, пропустите эти параметры и укажите '/CoverPage=true'.

/FileName=value

Полный путь к документу, который будет отправлен в качестве факса.

/FileList=value

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

Параметры титульной страницы:

/CoverPage=value

Переопределяет параметр 'Прикреплять титульную страницу к факсу', см. главу Титульные страницы.

/CoverPage=true

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

/CoverPage=false

Не прикреплять титульную страницу к факсу.

/CoverInfo=value

Полный путь к пользовательскому ini-файлу с информацией для титульной страницы. Переопределяет значения по умолчанию, см. главы Титульные страницы и Сведения об отправителе.

Структура ini-файла следующая:

[Template]

Переопределяет шаблон титульной страницы. При отсутствии раздела, используется шаблон по умолчанию.

UseServerCoverPage=

1 - стандартный шаблон; 0 - пользовательский шаблон

CoverPageName=

Имя титульной страницы (confident, fyi, generic, urgent) или путь к файлу шаблона.

[Sender]

Переопределяет сведения об отправителе. При отсутствии раздела, используются сведения об отправителе по умолчанию.

SdrName=

Имя отправителя.

SdrFaxNumber=

Номер факса отправителя.

SdrCompany=

Название организации отправителя.

SdrDepartment=

Имя отдела отправителя.

SdrTitle=

Должность отправителя.

SdrOfficeLocation=

Номер офиса (комнаты) отправителя.

SdrHomePhone=

Номер домашнего телефона отправителя.

SdrOfficePhone=

Номер рабочего телефона отправителя.

SdrAddress=

Адрес отправителя. Для переноса строк используйте символ '\n'.

[Content]

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

CoverPageSubject=

Тема факса.

CoverPageNote=

Примечание к титульной странице. Для переноса строк используйте символ '\n'.

Параметры факса:

/FaxStationID=value

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

/FaxHeader=value

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

/FaxProtocol=value

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

/FaxProtocol=t38

Отправлять факс как T.38.

/FaxProtocol=audio

Отправлять факс как G.711 аудио.

/FaxProtocol=isdn

Отправлять факс через ISDN CAPI 2.0.

Время отправки факса:

/Schedule=value

Отправить факс не раньше указанной даты и времени. Формат даты и времени должен соответствовать настройкам вашей операционной системы, например 25.04.2022 22:15:30 Если этот параметр не используется либо дата/время не могут быть распознаны, будут использованы текущие значения даты и времени.

/Submission=value

Дата и время постановки факса в очередь. Может быть полезно например для облегчения сортировки в Fax Voip T.38 Консоль при добавлении большого количества факсов. Формат даты и времени должен соответствовать настройкам вашей операционной системы, например 25.04.2022 22:15:30 Если этот параметр не используется либо дата/время не могут быть распознаны, будут использованы текущие значения даты и времени.

Уведомление на e-mail:

Если задана хотя бы одна из опций /EmailTo, /EmailCC или /EmailBCC, то адреса по умолчанию, заданные в настройках уведомлений о доставке на e-mail, будут переопределены. Можно задать не только адрес электронной почты, но также имя получателя. Несколько адресов следует разделять точкой с запятой. Пример: /EmailTo=Andreas<andreas73@gmail.com>;sales@mycompany.com

/EmailNotify=value

Переопределяет значение по умолчанию заданное в настройках уведомлений о доставке на e-mail.

/EmailNotify=true

Отправить уведомление о доставке по эл. почте.

/EmailNotify=false

Не отправлять уведомление о доставке по эл. почте.

/EmailTo=value

Адрес электронной почты, на который Fax Voip T.38 Консоль должна отправить уведомление о доставке факса.

/EmailCC=value

Адрес электронной почты, на который следует отправить копию (Cc) уведомления о доставке факса.

/EmailBCC=value

Адрес электронной почты, на который следует отправить скрытую копию (Bcc) уведомления о доставке факса.

/EmailAttach=value

Переопределяет значение по умолчанию заданное в настройках уведомлений о доставке на e-mail.

/EmailAttach=true

Вложить копию отправленного факса.

/EmailAttach=false

Не вкладывать копию отправленного факса.

/EmailFormat=value

Переопределяет значение по умолчанию заданное в настройках уведомлений о доставке на e-mail.

/EmailFormat=TIFF

Вложить факс в формате TIFF.

/EmailFormat=PDF

Вложить факс в формате PDF.

/EmailFormat=SFF

Вложить факс в формате SFF.

Параметры TIFF:

Применяются только при использовании прямой конвертации в факс. Параметры /Resolution и /Compression также применяются к факсам, состоящим только из титульной страницы.

/Resolution=value

Переопределяет значение по умолчанию заданное в Параметрах конвертации в факс.

/Resolution=204x196

Отправлять факс в высоком разрешении (Fine).

/Resolution=204x98

Отправлять факс в обычном разрешении (Normal).

/Compression=value

Переопределяет значение по умолчанию заданное в Параметрах конвертации в факс.

/Compression=LZW

/Compression=2

Создавать TIFF в формате сжатия LZW.

/Compression=CCITTFAX3

/Compression=3

Создавать TIFF в формате сжатия CCITTFAX3.

/Compression=CCITTFAX4

/Compression=4

Создавать TIFF в формате сжатия CCITTFAX4.

/Compression=PACKBITS

/Compression=5

Создавать TIFF в формате сжатия PACKBITS.

/Compression=NONE

/Compression=6

Создавать TIFF без компрессии.

/AutoRotate=value

Переопределяет значение по умолчанию заданное в Параметрах конвертации в факс.

/AutoRotate=true

Применить алгоритм автоматического выбора ориентации.

/AutoRotate=false

Не использовать автоматический выбор ориентации.

/A4Page=value

Переопределяет значение по умолчанию заданное в Параметрах конвертации в факс.

/A4Page=true

Установить ширину и высоту страницы в формате A4.

/A4Page=false

Не контролировать высоту страницы.

/HALFTONE=value

Переопределяет значение по умолчанию заданное в Параметрах конвертации в факс.

/HALFTONE=true

Использовать полутона при конвертации в факс.

/HALFTONE=false

Не использовать полутона при конвертации.

Параметры конвертации (принудительные режимы):

/ForceDirectConvert

Создавать факс с использованием Прямой Конвертации. Настройки заданные в Параметрах конвертации в факс игнорируются. Может применяться только со следующими типами файлов: pdf, tif(tiff), sff, qfx, bmp, jpg(jpeg), gif, png, ico, wmf(emf).

/ForcePrint

Создавать факс путем печати на принтер Fax Voip. Настройки заданные в Параметрах конвертации в факс игнорируются. При неудаче, утилита попытается создать факс с использованием функции Прямой Конвертации.

/UseOriginalTIFF

Применимо к случаю, когда единственный оригинальный документ имеет формат TIFF, совместимый с Fax Voip T.38 Консоль. Чтобы создать такой файл, можно использовать опцию 'Сохранить как' при печати на принтер Fax Voip. Если использовать этот параметр с несовместимым TIFF файлом, вы получите ошибку во время попытки передать факс.

Параметры консоли:

Для работы в режиме консоли запускайте приложение SendFax_c.exe.

/DoNotCloseConsole

Не закрывать консоль после выполнения. Будет отображено сообщение 'Для продолжения нажмите любую клавишу . . .'

/Console

Используя этот параметр, можно запустить приложение SendFax.exe (версия с графическим интерфейсом) в режиме консоли. Обратите внимание, что вызывающее приложение не ожидает завершения работы консоли в этом случае. Вместо этого запускайте приложение SendFax_c.exe.

Журналы и отладка:

/DebugLog

Включить журнал отладки, содержащий подробную информацию о работе SendFax.exe.

Путь к файлу журнала: *{CommonAppDataFolder}\FaxVoip Console\log\SendFax_Debug.txt

/Log

Включить простой журнал, содержащий краткую информацию о работе SendFax.exe.

Путь к файлу журнала: *{CommonAppDataFolder}\FaxVoip Console\log\SendFax_Log.txt

Примеры:

 SendFax.exe /FaxNumber=13607451257 /RecipientName=Andre Hedges /CoverPage=true

/CoverInfo=C:\ProgramData\FaxVoip Console\SendFax\Sample\coverpage_test.ini /DebugLog /Log

 SendFax_c.exe "/FaxNumber=14251234567 /RecipientName=Bob Linkermann /CoverPage=true

/FileName=C:\ProgramData\FaxVoip Console\SendFax\Sample\testPDF.pdf

/EmailNotify=true /EmailTo=Andreas<andreas73@gmail.com> /DoNotCloseConsole /DebugLog /Log"

 SendFax_c.exe /RecipientList=C:\ProgramData\FaxVoip Console\SendFax\Sample\Recipients_test.txt

/FileList=C:\ProgramData\FaxVoip Console\SendFax\Sample\FileList_test.txt

/FaxStationID=1(425)987-6543 /FaxHeader=This is my company /DoNotCloseConsole /DebugLog /Log

 SendFax_c.exe /FaxNumber=1234567 /FileName=C:\ProgramData\FaxVoip Console\SendFax\Sample\testJPEG.jpg

/FaxProtocol=t38 /Resolution=204x196 /AutoRotate=true /A4Page=false /HALFTONE=true /ForceDirectConvert

/DoNotCloseConsole /DebugLog /Log

Примечания

• Во избежание ошибок при обработке командной строки, рекомендуется использовать двойные кавычки (см. пример выше).
• *{CommonAppDataFolder} - системная папка содержащая данные приложений, общая для всех пользователей компьютера. Путь к этой папке обычно C:\ProgramData.