String Tools

String Tools

Plug-ins

Format

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

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

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

<Config>
    <Attribute>attribute_name</Attribute>
    <Format>format_string</Format>
    <Args>
        <Attribute>attribute1</Attribute>
        <Attribute>attribute2</Attribute>
        ...
        <Attribute>attributeN</Attribute>
    </Args>
</Config>

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

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

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: <Config>
                            <Attribute>fullname</Attribute>
                            <Format>{0} {1} {2}</Format>
                            <Args>
                                <Attribute>lastname</Attribute>
                                <Attribute>firstname</Attribute>
                                <Attribute>middlename</Attribute>
                            </Args>
                        </Config>

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