SalesPlatform vtiger crm 540 Использование Шаблонов PDF

Материал из SalesPlatform Wiki
Перейти к: навигация, поиск

Главная страница руководства


Содержание

Краткий обзор

Шаблоны PDF системы SalesPlatform vtiger CRM являются гибким механизмом настройки печатных форм для Счетов, Предложений и Заказов на продажу.

Страница редактирования шаблона

Страница редактирования шаблона PDF содержит область свойств и область редактирования.

В области свойств необходимо указать следующие обязательные параметры шаблона:

В области редактирования вводится тело шаблона. Тело шаблона представляет собой разметку HTML, разделенную на блоки. Каждый блок ограничен двумя специальными тэгами - открывающим и закрывающим:

{название_блока}
...
{/название_блока}

Блоки шаблонов Счетов, Предложений, Заказов на продажу и Заказов на Закупку

Типичный шаблон Счета, Предложени, Заказа на продажу или Заказа на Закупку состоит из блоков header, table_head, table_row, summary, ending, footer:

{header}
...
{/header}
{table_head}
...
{/table_head}
{table_row}
...
{/table_row}
{summary}
...
{/summary}
{ending}
...
{/ending}
{footer}
...
{/footer}

Блок header

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

Блок table_head

Это обязательный блок, который выводится один раз перед таблицей товаров (услуг) печатного документа. Используется для задания шапки таблицы.

Блок table_row

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

Блок summary

Это обязательный блок, который выводится один раз непосредственно после таблицы товаров (услуг). Используется для вывода суммарной стоимости и налогов.

Блок ending

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

Блок footer

Это необязательный блок, который выводится внизу каждой страницы документа.

Блоки шаблонов Заявок и Сделок

Типичный шаблон Заявки или Сделки состоит из блоков header, content:

{header}
...
{/header}
{content}
...
{/content}

Блок header

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

Блок content

Это обязательный блок, который содержит основное тело формируемого документа PDF.

Подставляемые переменные

Шаблоны PDF позволяют вставлять в печатные документы переменные, которые при выдаче заменяются данными из соответствующей записи CRM. Подставляемые переменные имеют вид:

{$название_переменной}

Для каждого модуля есть свой набор общих переменных, которые включают все поля выводимой на печать записи CRM, а также все поля связанных записей (например, Контрагентов и Контактов). Кроме того, в блоках table_row и summary доступны специальные переменные, которые рассчитываются на основе списка товаров (услуг).

Данные собственной организации, доступные во всех модулях

Название переменной Значение
orgAddress Адрес
orgCity Город
orgState Область
orgCountry Страна
orgCode Индекс
orgBillingAddress Полный юр. адрес организации
orgPhone Тел.
orgFax Факс
orgWebsite Вебсайт
orgInn ИНН
orgKpp КПП
orgBankAccount Расч. счет
orgBankName Банк
orgBankId БИК
orgCorrAccount Корр. счет
orgDirector Руководитель
orgBookkeeper Гл. бухгалтер
orgEntrepreneur Инд. предприниматель
orgEntrepreneurreg Св-во о регистрации ИП
orgLogo Логотип организации
orgLogoPath Путь к логотипу организации
orgName Название организации

Переменные модуля Счета

Название переменной Значение
invoice_subject Тема
invoice_customerno Номер Клиента
invoice_invoicedate Дата
invoice_duedate Дата Оплаты
invoice_vtiger_purchaseorder Заказ на Закупку
invoice_txtAdjustment Исправление
invoice_salescommission Комиссия
invoice_exciseduty Акциз
invoice_hdnSubTotal Итого
invoice_hdnGrandTotal Всего
invoice_hdnTaxType Тип Налога
invoice_hdnDiscountPercent Процент Скидки
invoice_hdnDiscountAmount Сумма Скидки
invoice_hdnS_H_Amount Сумма доставки
invoice_invoicestatus Состояние
invoice_createdtime Создано
invoice_modifiedtime Изменено
invoice_conversion_rate Курс
invoice_bill_street Юридический адрес
invoice_ship_street Фактический адрес
invoice_bill_city Ю/А Город
invoice_ship_city Ф/А Город
invoice_bill_state Ю/А Область
invoice_ship_state Ф/А Область
invoice_bill_code Ю/А Индекс
invoice_ship_code Ф/А Индекс
invoice_bill_country Ю/А Страна
invoice_ship_country Ф/А Страна
invoice_bill_pobox Ю/А а/я
invoice_ship_pobox Ф/А а/я
invoice_description Описание
invoice_terms_conditions Сроки и Условия
invoice_no Счет №

Переменные модуля Предложения

Название переменной Значение
quote_no Предложение №
quote_subject Тема
quote_quotestage Стадия
quote_validtill Действительно до
quote_carrier Перевозчик
quote_hdnSubTotal Итого
quote_shipping Доставка
quote_txtAdjustment Корректировка
quote_hdnGrandTotal Итого
quote_hdnTaxType Тип Налога
quote_hdnDiscountPercent Процент Скидки
quote_hdnDiscountAmount Сумма Скидки
quote_hdnS_H_Amount Сумма доставки
quote_createdtime Создано
quote_modifiedtime Изменено
quote_conversion_rate Курс
quote_bill_street Юридический адрес
quote_ship_street Фактический адрес
quote_bill_city Ю/А Город
quote_ship_city Ф/А Город
quote_bill_state Ю/А Область
quote_ship_state Ф/А Область
quote_bill_code Ю/А Индекс
quote_ship_code Ф/А Индекс
quote_bill_country Ю/А Страна
quote_ship_country Ф/А Страна
quote_bill_pobox Ю/А а/я
quote_ship_pobox Ф/А а/я
quote_description Описание
quote_terms_conditions Сроки и Условия

Переменные модуля Заказы на продажу

Название переменной Значение
salesorder_no Заказ на Продажу №
salesorder_subject Наименование
salesorder_customerno Клиент №
salesorder_vtiger_purchaseorder Заказ на Закупку
salesorder_duedate Срок оплаты
salesorder_carrier Доставка
salesorder_pending В ожидании
salesorder_sostatus Статус
salesorder_txtAdjustment Согласование
salesorder_salescommission Комиссионные
salesorder_exciseduty Акцизный сбор
salesorder_hdnGrandTotal Всего
salesorder_hdnSubTotal Итого
salesorder_hdnTaxType Тип Налога
salesorder_hdnDiscountPercent Процент Скидки
salesorder_hdnDiscountAmount Сумма Скидки
salesorder_hdnS_H_Amount Сумма доставки
salesorder_createdtime Создан
salesorder_modifiedtime Изменен
salesorder_conversion_rate Курс
salesorder_bill_street Юридический адрес
salesorder_ship_street Фактический адрес
salesorder_bill_city Ю/А Город
salesorder_ship_city Ф/А Город
salesorder_bill_state Ю/А Область
salesorder_ship_state Ф/А Область
salesorder_bill_code Ю/А Индекс
salesorder_ship_code Ф/А Индекс
salesorder_bill_country Ю/А Страна
salesorder_ship_country Ф/А Страна
salesorder_bill_pobox Ю/А а/я
salesorder_ship_pobox Ф/А а/я
salesorder_description Описание
salesorder_terms_conditions Сроки и Условия
salesorder_enable_recurring Включить Периодичность
salesorder_recurring_frequency Периодичность
salesorder_start_period Начало
salesorder_end_period Конец
salesorder_payment_duration Продолжительность Оплаты
salesorder_invoicestatus Статус Счета

Переменные модуля Заказы на закупку

Название переменной Значение
purchaseorder_no Заказ на Закупку №
purchaseorder_subject Наименование
purchaseorder_tracking_no Отслеживаемый Номер
purchaseorder_requisition_no Заказ №
purchaseorder_duedate Срок оплаты
purchaseorder_carrier Доставка
purchaseorder_postatus Статус
purchaseorder_txtAdjustment Согласование
purchaseorder_salescommission Комиссия
purchaseorder_exciseduty Акциз
purchaseorder_hdnGrandTotal Всего
purchaseorder_hdnSubTotal Итого
purchaseorder_hdnTaxType Тип Налога
purchaseorder_hdnDiscountPercent Процент Скидки
purchaseorder_hdnDiscountAmount Сумма Скидки
purchaseorder_hdnS_H_Amount Сумма доставки
purchaseorder_createdtime Создан
purchaseorder_modifiedtime Изменен
purchaseorder_conversion_rate Курс
purchaseorder_bill_street Юридический адрес
purchaseorder_ship_street Фактический адрес
purchaseorder_bill_city Ю/А Город
purchaseorder_ship_city Ф/А Город
purchaseorder_bill_state Ю/А Область
purchaseorder_ship_state Ф/А Область
purchaseorder_bill_code Ю/А Индекс
purchaseorder_ship_code Ф/А Индекс
purchaseorder_bill_country Ю/А Страна
purchaseorder_ship_country Ф/А Страна
purchaseorder_bill_pobox Ю/А а/я
purchaseorder_ship_pobox Ф/А а/я
purchaseorder_description Описание
purchaseorder_terms_conditions Сроки и Условия

Переменные модуля Контрагенты

Название переменной Значение
account_accountname Контрагент
account_account_no Контрагент №
account_phone Тел.
account_website Веб сайт
account_fax Факс
account_tickersymbol Краткое Название
account_otherphone Доп.тел.
account_email1 Адрес Email
account_employees Кол-во сотрудников
account_email2 Доп.Email
account_ownership Форма
account_rating Рейтинг
account_industry Отрасль
account_siccode Код по классификатору
account_accounttype Тип
account_annual_revenue Годовой доход
account_emailoptout Не отправлять эл.почту
account_notify_owner Уведомлять ответственного
account_createdtime Создано
account_modifiedtime Изменено
account_inn ИНН
account_kpp КПП
account_bill_street Юридический адрес
account_ship_street Фактический адрес
account_bill_city Ю\А Город
account_ship_city Ф/А Город
account_bill_state Ю/А Область
account_ship_state Ф/А Область
account_bill_code Ю/А Индекс
account_ship_code Ф/А Индекс
account_bill_country Ю/А Страна
account_ship_country Ф/А Страна
account_bill_pobox Ю/А а/я
account_ship_pobox Ф/А а/я
account_description Описание

Переменные модуля Контакты

Название переменной Значение
contact_salutationtype Обращение
contact_firstname Имя
contact_contact_no Контакт №
contact_phone Рабочий тел.
contact_lastname Фамилия
contact_mobile Мобильный тел.
contact_homephone Домашний тел.
contact_leadsource Источник
contact_otherphone Другой тел.
contact_title Должность
contact_fax Факс
contact_department Отдел
contact_birthday День рождения
contact_email Адрес E-mail
contact_assistant Ассистент
contact_yahooid Yahoo Id
contact_assistantphone Тел.ассистента
contact_donotcall Не звонить
contact_emailoptout Не отпралять Email
contact_reference Рекомендации
contact_notify_owner Уведомлять ответственного
contact_createdtime Создано
contact_modifiedtime Изменено
contact_portal Пользователь портала
contact_support_start_date Дата начала обслуживания
contact_support_end_date Дата окончания обслуживания
contact_mailingstreet Улица
contact_otherstreet Доп.адрес: улица
contact_mailingcity Город
contact_othercity Доп.адрес: город
contact_mailingstate Область
contact_otherstate Доп.адрес: область
contact_mailingzip Индекс
contact_otherzip Доп.адрес: индекс
contact_mailingcountry Страна
contact_othercountry Доп.адрес: страна
contact_mailingpobox Абонентский Ящик
contact_otherpobox Другой а/я
contact_description Описание

Переменные модуля Поставщики

Название переменной Значение
vendor_vendorname Название Поставщика
vendor_email Email
vendor_glacct Счет в Главной Книге
vendor_vendor_no Поставщик №
vendor_phone Тел.
vendor_website Веб сайт
vendor_category Категория
vendor_createdtime Время Создания
vendor_modifiedtime Время Изменения
vendor_street Улица
vendor_city Город
vendor_state Область
vendor_postalcode Индекс
vendor_country Страна
vendor_pobox А/я
vendor_description Описание

Переменные модуля Сделки

Название переменной Значение
potential_potentialname Название Сделки
potential_owner Ответственный
potential_opportunity_type Тип
potential_leadsource Источник
potential_no Сделка №
potential_amount Сумма
potential_closingdate Ожидаемая Дата Закрытия
potential_nextstep Дальнейшие Действия
potential_sales_stage Стадия
potential_probability Вероятность
potential_createdtime Создано
potential_modifiedtime Изменено
potential_description Описание


Переменные модуля Заявки

Название переменной Значение
helpdesk_ticket_title Название
helpdesk_owner Ответственный
helpdesk_ticketpriorities Приоритет
helpdesk_ticketseverities Важность
helpdesk_days Дней
helpdesk_ticket_no Заявка №
helpdesk_ticketstatus Состояние
helpdesk_hours Часов
helpdesk_ticketcategories Категория
helpdesk_createdtime Создано
helpdesk_modifiedtime Изменено
helpdesk_solution Решение
helpdesk_description Описание

Переменные модуля Товары

Название переменной Значение
product_productname Товар
product_discontinued Активен
product_sales_start_date Дата начала продаж
product_sales_end_date Дата окончания продаж
product_productcategory Категория Товара
product_vendor_part_no Код Поставщика
product_productsheet Характеристики
product_customs_id Номер ГТД
product_product_no Товар №
product_productcode Код товара
product_manufacturer Производитель
product_start_date Начало Сопровождения
product_expiry_date Окончание Сопровождения
product_website Веб-сайт
product_mfr_part_no Код Производителя
product_serial_no Серийный Номер
product_glacct Счёт в гл.книге
product_manuf_country Страна происхождения
product_manuf_country_code Код страны
product_createdtime Создан
product_modifiedtime Изменен
product_unit_price Цена за Единицу
product_taxclass Класс Налога
product_commissionrate Комиссия
product_usageunit Единица Измерения
product_qtyinstock Кол-во на Складе
product_unit_code Код единицы измерения
product_qty_per_unit Кол-во/Ед.
product_reorderlevel Пороговый остаток для дозаказа
product_qtyindemand Минимальный Заказ
product_description Описание

Специальные переменные блока table_row

Название переменной Значение
productNumber Номер позиции товара (услуги) по порядку
productName Наименование товара (услуги)
productCode Код товара
productQuantity Количество товара
productQuantityInt Количество товара без знаков после запятой
productUnits Единицы измерения
productUnitsCode Код единицы измерения
productPrice Цена
productPriceWithTax Цена с налогом
productDiscount Скидка
productNetTotal Стоимость без налогов и скидок
productTax Налог
productTaxPercent  % налога
productTotal Стоимость
productDescription Описание товара (услуги)
productComment Комментарий
manufCountry Страна происхождения
manufCountryCode Код страны происхождения
customsId Номер ГТД
productImage Изображение товара
productImagePath Путь к изображению товара (для использования в теге IMG)

Специальные переменные блока summary

Название переменной Значение
summaryNetTotal Сумма без налогов и скидок
summaryDiscount Скидка
summaryTax Сумма налогов
summaryTaxLiteral Сумма налогов прописью
summaryTaxPercent Суммарный % налогов
summaryShipping Стоимость доставки
summaryShippingTax Налог на доставку
summaryShippingTaxPercent  % налога на доставку
summaryAdjustment Корректировка
summaryGrandTotal Всего
summaryGrandTotalLiteral Всего прописью

Некоторые тонкости

Стандартный формат вывода даты - длинный, например, 15 Августа 2011 г. Однако, добавив к названию любой переменной даты суффикс _short, получим дату в коротком формате (например, 15.08.11).

Текстовые значения некоторых переменных по-умолчанию выводятся на английском языке (например, стандартные списки). Получить перевод этих значений можно, добавив к названию переменной суффикс _translated.

Разрыв страницы реализуется при помощи тега со стилем page-break-before со значением always. Пример:

 <tr style="page-break-before: always"><td>
 <!-- Whitespace -->
 </td></tr>

Вставка изображения реализуется при помощи тега img. Изображение предварительно должно быть размещено в директории test/logo/. Пример добавления изображения печати с подписью:

 {ending}
 <img src="test/logo/stamp.png" align="left" width="450"/>
 {/ending}

Главная страница руководства

Личные инструменты
Пространства имён
Варианты
Действия
Навигация
Документация
Разработчикам
Присоединяйтесь!
Инструменты