String Tools

String Tools

Plug-ins

Format

Формирование значения строкового атрибута на основе строки формата.

Плагин позволяет установить значение строкового атрибута в соответствии со строкой формата на основе вычисляемых значений.

Настройка плагина производиться с помощью строки в формате JSON, определяемой при регистрации плагина. Строка имеет следующий формат:

{
    Attribute: "attribute_name",
    Format: "format_string",
    Args: [
        "attribute1",
        "attribute2",
        ...
        "attributeN"
    ]
}

• Attribute Определяет строковый атрибут, значение которого будет формироваться.
• Format Строка формата. Для вставки аргументов используются паттерны {x}, где x - порядковый номер атрибута. Нумерация начинается с 0. Пример строки формата: Code: {0}. Другой пример: {0} {1} {2}.
• Args Содержит дочерние элементы, которые определяют аргументы формата, подставляемые в паттерны {x}. Порядок расположения дочерних элементов определяет порядок их подстановки в строку формата. Так, первый элемент будет подставлен вместо паттерна {0}, второй - вместо {1} и т. д.

Пример настройки для формирования ФИО контакта:

Step
Message:    	        Create
Primary Entity:         contact
Name:                   PZone.StringTools.Plugins.Format: Формирование ФИО при создании контакта
Run in User's Context:  Calling User
Execution Order:        10
Stage:                  Pre-operation
Unsecure Configuration: {
                            Attribute: "fullname",
                            Format: "{0} {1} {2}",
                            Args: [
                                "lastname",
                                "firstname",
                                "middlename",
                            ]
                        }

Step
Message:    	        Update
Primary Entity:         contact
Filtering Attributes:   firstname, middlename, lastname
Name:                   PZone.Plugins.StringTools.Format: Формирование ФИО при обновлении контакта
Run in User's Context:  Calling User
Execution Order:        10
Stage:                  Pre-operation
Unsecure Configuration: {
                            Attribute: "fullname",
                            Format: "{0} {1} {2}",
                            Args: [
                                "lastname",
                                "firstname",
                                "middlename",
                            ]
                        }
    Image
    Image Type: Pre Image
    Name:       Image
    Alias:      Image
    Parameters: firstname, middlename, lastname