Массивы

Массивы

Массивы содержат переменные для вывода динамического содержимого на странице. Например, массив store содержит переменную с именем name , которую можно использовать для вывода названия склада.

Чтобы вывести переменную массива, оберните имя объекта в {{и }}, как показано ниже:

{{ store.name }} 

Для каждого документа справочник доступных массивов и переменных в них отличается.

Полный список объектов и переменных в них, доступный для того или иного документа МойСклад можно найти в справочнике "Язык Шаблонов" на странице создания или редактирования шаблонов.

Массивы в многомерных массивах

Для некоторых документов МоегоСклада вы можете обнаружить массивы, которые содержатся в многомерных массивах. О них стоит упомянуть отдельно.

На скриншоте выше приведен справочник Языка Шаблонов для документа "Заказ покупателя". Массивы attributes, purchaseOrders, demand, payments, invoicesOut, positions многомерные.

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

Например, если нужно отправить название первой отгрузки для данного заказа покупателя, объект Liquid будет следующего содержания:

Заказ {{ name }} отгружен! 
Номер отгрузки {{ demands[0].name }}
Номер отгрузки {{ demands.first.name }}

Говоря простым языком, в массиве demands (Отгрузки) содержится несколько других массивов demand (Отгрузка), у каждого из которых есть переменная name.

Индекс [0] и first говорят, что нужно выбрать переменную name для первой отгрузки.

Заказ 00005 отгружен! 
Номер отгрузки 00001
Номер отгрузки 00001

Если нужно выбрать вторую отгрузку, надо использовать индекс [1], третью [2], четвертую [3] и т.д.

Следующий код шаблона, если у заказа есть две отгрузки:

Заказ {{name }} отгружен! 
Номер первой отгрузки {{ demands[0].name }}
Номер второй отгрузки {{ demands[1].name }}

Соответсвенно выведет:

Заказ 00005 отгружен! 
Номер первой отгрузки 00001
Номер второй отгрузки 00002

Если количество отгрузок неизвестно, можно вывести все, используя логику Liquid - тег итератора {% for %}:

Заказ {{name }} отгружен!
{% for demand in demands %}
    Номер отгрузки {{demand.name}}
{% endfor %}

Соответственно выведет

Заказ 00005 отгружен! 
Номер отгрузки 00001
Номер отгрузки 00002

Если нужно выбрать определенную отгрузку (например, нужно отправить номер отгрузки, которая находится в статусе Выполнена) - нужно использовать логику Liquid - теги итератора {% for %} и проверки условия {% if %}

{% for demand in demands %}
    {% if demand.state.name == "Выполнена" %}
    Ваша отгрузка {{ demand.state.name }} выполнена.
    {% endif %}
{% endfor %} 

Подробнее про теги логики языка Liquid {% for %} {% if %} {% else %} и другие читайте по ссылке.