Документация для разработчиков
Темная тема

Основная контентная область

BodyDto

Основная контентная область записи таймлайна

Поле Тип Описание Дополнительно
logo LogoDto Логотип записиОбязательное.
blocks ContentBlockDto[] Ассоциативный массив объектов, описывающих контентные блоки.Массив должен содержать хотя бы один элемент и не более 20 элементов.

LogoDto

Логотип записи таймлайна.

Поле Тип Описание Дополнительно
code string Код логотипа Обязательное. Список доступных кодов можно получить методом crm.timeline.logo.list.
action ActionDto Действие по нажатию на логотип.

ContentBlockDto

Контентные блоки основной контентной области записи таймлайна. Сочетая эти блоки можно гибко собирать различные интерфейсы.

Общая структура блока:

{
	"type": Тип блока,
	"properties": {
		... какие-то свойства, различные для каждого конкрентого блока
	}
}

Существует несколько различных типов контентных блоков:

  • Текст (type = text)

    Самый простой блок, который выводит некоторый форматированный текст.

    Свойства блока:

    Поле Тип Описание Дополнительно
    value textWithTranslation Текст, который будет показанОбязательное.
    multiline bool Обрабатывать ли переносы строк Если true, то символы \n будут заменены на <br>. По-умолчанию false.
    title textWithTranslation Аттрибут title
    bold bool Делать текст жирным?По-умолчанию false.
    size string Размер текстаМожет принимать значения xs, sm, md (последнее используется по-умолчанию).
    color string Цвет текстаМожет принимать значения base_50, base_60, base_70, base_90, green
    scope string Где показывать.

    Пример:

    {
    	"type": "text",
    	"properties": {
    		"value": "Здравствуйте!\nМы начинаем.",
    		"multiline": true,
    		"bold": true,
    		"color": "base_90"
    	}
    }

    Результат:   

  • Длинный многострочный текст (type = largeText)

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

    Поле Тип Описание Дополнительно
    value textWithTranslation Текст, который будет показанОбязательное.
    scope string Где показывать

    Пример:

    {
    	"type": "largeText",
    	"properties": {
    		"value": "Здравствуйте!\nМы начинаем.\nМы продолжаем.\nМы все еще работаем над этим.\nМы продолжаем.\nМы близки к результату.\nДо свидания."
    	}
    }

    Результат:   

  • Ссылка (type = link)

    Блок, который выводит ссылку.

    Поле Тип Описание Дополнительно
    text textWithTranslation Текст, который будет показан. HTML теги не поддерживаются.Обязательное.
    action ActionDto Действие по нажатию на ссылку.Обязательное.
    bold bool Делать текст жирным?По-умолчанию false.
    scope string Где показывать

    Пример:

    {
    	"type": "link",
    	"properties": {
    		"text": "Открыть сделку",
    		"action": {
    			"type": "redirect",
    			"uri": "/crm/deal/details/123/"
    		},
    		"bold": true
    	}
    }

    Результат:   

  • Блок с заголовком (type = withTitle)

    Блок позволяет вывести пару название-значение. В качестве значения может быть использован другой контент-блок.

    Поле Тип Описание Дополнительно
    title textWithTranslation Текст заголовкаОбязательное.
    block ContentBlockDto Контент-блок, являющийся значением. Поддерживаются блоки с типами text, link, deadline.Обязательное.
    inline bool Показывать ли название и значение в одну строку.По-умолчанию false.
    scope string Где показывать

    Примеры:

    {
    	"type": "withTitle",
    	"properties": {
    		"title": "Заголовок",
    		"block": {
    			"type": "text",
    			"properties": {
    				"value": "Какое-то значение"
    			}
    		}
    	}
    }

    Результат:   

    {
    	"type": "withTitle",
    	"properties": {
    		"title": "Заголовок 2",
    		"block": {
    			"type": "link",
    			"properties": {
    				"text": "Открыть сделку",
    				"action": {
    					"type": "redirect",
    					"uri": "/crm/deal/details/123/"
    				}
    			}
    		},
    		"inline": true
    	}
    }

    Результат:   

  • Несколько контент-блоков в одну строку (type = lineOfBlocks)

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

    Поле Тип Описание Дополнительно
    block ContentBlockDto[] Ассоциативный массив контент-блоков. Поддерживаются блоки с типами text, link, deadline.Обязательное.
    scope string Где показывать

    Пример:

    {
    	"type": "lineOfBlocks",
    	"properties": {
    		"blocks": {
    			"text": {
    				"type": "text",
    				"properties": {
    					"value": "Какой-то текст"
    				}
    			},
    			"link": {
    				"type": "link",
    				"properties": {
    					"text": "ссылка",
    					"action": {
    						"type": "redirect",
    						"uri": "/crm/deal/details/123/"
    					}
    				}
    			},
    			"boldText": {
    				"type": "text",
    				"properties": {
    					"value": "жирный текст",
    					"bold": true
    				}
    			}
    		}
    	}
    }

    Результат:   

  • Выбор крайнего срока (type = deadline)

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

    Поле Тип Описание Дополнительно
    readonly bool Разрешить ли изменять крайний срок .По умолчанию false. Если у пользователя нет доступа на изменение сущности, к которой относится дело, или если дело выполнено, то readonly = true вне зависимости от переданных настроек.
    scope string Где показывать

    Пример:

    {
    	"type": "deadline",
    	"properties": {
    		"readonly": false
    	}
    }
  • Результат:   



Пользовательские комментарии

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

Для этого нужно всего лишь авторизоваться на сайте

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024