Операторы и идентификаторы

Операторы в Microsoft Power Fx описаны ниже. Некоторые из этих операторов зависят от языка, используемого на компьютере автора. Дополнительные сведения см. в статье Глобальные приложения.

Операторы in и exactin

Чтобы найти строку в источнике данных, например в коллекции или импортированной таблице, используйте операторы in и exactin. Оператор in определяет совпадения независимо от регистра, а оператор exactin определяет только те совпадения, которые начинаются с буквы в том же регистре. Приведем пример:

1. Создайте или импортируйте коллекцию с именем Inventory, затем покажите ее в коллекции, как это описано в первой процедуре раздела Отображение изображений и текстов в коллекции.

2. Задайте для свойства Items коллекции следующую формулу:
   Фильтр(Инвентарь, "E" в ProductName)

   В коллекции отображаются все товары, за исключением Callisto, так как имя этого товара является единственным, которое не содержит указанную букву.

3. Задайте для свойства Items коллекции следующую формулу:
   Фильтр (Инвентарь, "E" exactin ProductName)

   В коллекции отображается только имя Europa, так как оно единственное, которое содержит указанную букву в указанном регистре.

Операторы ThisItem, ThisRecord и As

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

Оператор ThisItem

Например, в следующем элементе управления Gallery свойство Items установлено на источник данных Employees (например, сущность Employees, включенная в пример Northwind Traders):

Employees

Первый элемент в коллекции — это шаблон, который копируется для каждого сотрудника. В шаблоне формула для изображения использует ThisItem для ссылки на текущий элемент:

ThisItem.Picture

Аналогично, формула для имени также использует ThisItem:

ThisItem.'First Name' & " " & ThisItem.'Last Name'

Оператор ThisRecord

ThisRecord используется в функциях, имеющих область действия записи. Например, мы можем использовать функцию Filter со свойством Items нашей коллекции, чтобы показывать только имена, которые начинаются с M:

Filter( Employees, StartsWith( ThisRecord.Employee.'First Name', "M" ) )

ThisRecord является необязательным и подразумевается при непосредственном использовании полей, например, в этом случае мы могли бы написать:

Filter( Employees, StartsWith( 'First Name', "M" ) )

Хотя необязательно, использование ThisRecord может упростить понимание формул и может потребоваться в неоднозначных ситуациях, когда имя поля также может быть именем отношения. ThisRecord является необязательным, тогда как ThisItem всегда требуется.

Используйте ThisRecord для ссылки на всю запись с помощью функций Patch, Collect и других функций области записи. Например, следующая формула устанавливает состояние для всех неактивных сотрудников на активный:

With( { InactiveEmployees: Filter( Employees, Status = 'Status (Employees)'.Inactive ) },
      ForAll( InactiveEmployees, 
              Patch( Employees, ThisRecord, { Status: 'Status (Employees)'.Active } ) ) )

Оператор As

Используйте оператор As для присвоения имени записи в коллекции или функции области записи, отменяя значение по умолчанию ThisItem или ThisRecord. Присвоение имени записи может облегчить понимание ваших формул и может потребоваться во вложенных ситуациях для доступа к записям в других областях.

Например, вы можете изменить свойство Items нашей коллекции для использования As, чтобы определить, что мы работаем с сотрудником:

Employees As Employee

Формулы для изображения и имени скорректированы, чтобы использовать это имя для текущей записи:

Employee.Picture

Employee.'First Name' & " " & Employee.'Last Name'

As также может использоваться с функциями области действия записи для замены имени по умолчанию ThisRecord. Мы можем применить это к нашему предыдущему примеру, чтобы прояснить запись, с которой мы работаем:

With( { InactiveEmployees: Filter( Employees, Status = 'Status (Employees)'.Inactive ) },
      ForAll( InactiveEmployees As Employee, 
              Patch( Employees, Employee, { Status: 'Status (Employees)'.Active } ) ) )

При вложении коллекций и функций области записи, ThisItem и ThisRecord всегда относится к внутренней области, оставляя записи во внешних областях недоступными. Используйте As, чтобы сделать доступными все области записи, дав каждой уникальное имя.

Например, эта формула создает узор шахматной доски в виде текстовой строки путем вложения двух функций ForAll:

Concat( 
    ForAll( Sequence(8) As Rank,
        Concat( 
            ForAll( Sequence(8) As File, 
                    If( Mod(Rank.Value + File.Value, 2) = 1, " X ", " . " ) 
            ),
            Value 
        ) & Char(10) 
    ), 
    Value 
)

При задании в элементе управления Label для свойства Text следующей формулы отображается:

Давайте разберем, что здесь происходит:

• Мы начинаем с перебора безымянной таблицы из 8 пронумерованных записей из функции Sequence. Этот цикл предназначен для каждой строки доски, который обычно называют Rank, поэтому мы даем ему это имя.
• Для каждой строки мы перебираем другую безымянную таблицу из 8 столбцов и даем общее имя File.
• Если Rank.Value + File.Value нечетное число, квадрат получает X, иначе точку. Эта часть формулы упоминается в обоих циклах ForAll, что стало возможным благодаря использованию оператора As.
• Concat используется дважды, сначала для объединения столбцов, а затем строк, с добавлением Char(10) для создания новой строки.

Аналогичный пример возможен с вложенными элементами управления Gallery вместо функций ForAll. Начнем с вертикальной коллекции для Rank. Этот элемент управления коллекции будет иметь для Items формулу:

Sequence(8) as Rank

В этой коллекции мы разместим горизонтальную коллекцию для File, которая будет повторяться для каждой строки Rank со свойством Items:

Sequence(8) as File

И, наконец, в этой коллекции мы добавим элемент управления Label, который будет воспроизведен для каждого элемента File и для каждого элемента Rank. Мы изменим его размер, чтобы заполнить все пространство, и используем свойство Fill, чтобы задать цвет по этой формуле:

If( Mod( Rank.Value + File.Value, 2 ) = 1, Green, Beige )

Операторы Self и Parent

Существует три способа ссылки на элемент управления и его свойства в формуле:

Self и родительский элемент являются операторами, а не свойствами самих элементов управления. Ссылка на Parent.Parent, Self.Parent или Parent.Self не поддерживается.

Имена идентификаторов

Имена переменных, источников данных, столбцов и других объектов могут содержать любые символы Юникода.

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

Вот несколько примеров имен столбцов, которые вы можете встретить в таблице, и их представление в формуле:

Двойные кавычки используются для обозначения текстовых строк.

Отображаемые имена и логические имена

Некоторые источники данных, такие как SharePoint и Microsoft Dataverse, имеют два разных имени для ссылки на одну и ту же таблицу или столбец данных:

• Логическое имя - имя, которое гарантированно уникально, не изменяется после создания, обычно не допускает пробелов или других специальных символов и не локализуется на другие языки. В результате имя может быть загадочным. Эти имена используются профессиональными разработчиками. Например, cra3a_customfield. Это имя также может упоминаться как имя схемы или просто имя.

• отображаемое имя - Имя, удобное для пользователя и предназначенное для просмотра конечными пользователями. Это имя может быть не уникальным, может меняться с течением времени, может содержать пробелы и любые символы Юникода и может быть локализовано на разные языки. В соответствии с примером выше, отображаемое имя может быть Настраиваемое поле с пробелом между словами.

Поскольку отображаемые имена легче понять, Power Fx предложит их как варианты выбора, а не будет предлагать логические имена. Хотя логические имена не предлагаются, они все равно могут использоваться, если они вводятся косвенно.

Например, представьте, что вы добавили Пользовательское поле к сущности в Dataverse. Система присваивает вам логическое имя, которое вы можете изменять только при создании поля. Результат будет выглядеть примерно так:

При создании ссылки на поле сущности Accounts (Организации) будет предложено использовать 'Custom Field', так как это отображаемое имя. Необходимо использовать одинарные кавычки, потому что в этом имени есть пробел:

После выбора предложения в строке формул отображается 'Custom Field' (Пользовательское поле), и данные извлекаются:

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

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

Устранение неоднозначности имен

Поскольку отображаемые имена не являются уникальными, одно и то же отображаемое имя может появляться более одного раза в одной и той же сущности. Когда это происходит, логическое имя будет добавлено в конец отображаемого имени в скобках для одного или нескольких конфликтующих имен. Основываясь на приведенном выше примере, если было второе поле с тем же отображаемым именем Custom Field (Пользовательское поле) с логическим именем cra3a_customfieldalt, тогда предложения покажут:

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

Оператор устранения неоднозначности

Некоторые функции создают области записей для доступа к полям таблицы при обработке каждой записи, например Filter, AddColumns и Sum. Имена полей, добавленные с помощью области записи, переопределяют такие же имена из любого другого места в приложении. В этом случае с помощью оператора устранения неоднозначности @ можно по-прежнему получать доступ к значениям за пределами области записи.

• Для доступа к значениям из вложенных областей записей используйте оператор @, указав имя нужной таблицы в формате:
  Таблица[@ИмяПоля]
• Чтобы получить доступ к глобальным значениям, таким как источники данных, коллекции и переменные контекста, используйте шаблон [@ObjectName] (без обозначения таблицы).

Дополнительные сведения и примеры см. в разделе Области записей.