Использование параметров

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

Параметры позволяют динамически изменять выходные данные запросов в зависимости от их значения и использовать для:

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

Вы можете легко управлять параметрами в окне "Управление параметрами ". Чтобы открыть окно "Управление параметрами", выберите параметр "Управление параметрами" в разделе "Управление параметрами" на вкладке "Главная".

Создание параметра

Power Query предоставляет два простых способа создания параметров:

• В существующем запросе: щелкните правой кнопкой мыши запрос, значение которого является простой неструктурированной константой, например датой, текстом или номером, а затем выберите "Преобразовать в параметр".

  

  Вы также можете преобразовать параметр в запрос, щелкнув правой кнопкой мыши этот параметр, а затем выбрав "Преобразовать в запрос".

  

• С помощью окна "Управление параметрами": выберите параметр "Создать параметр " в раскрывающемся меню "Управление параметрами " на вкладке "Главная ". Или запустите окно "Управление параметрами " и нажмите кнопку "Создать" в верхней части, чтобы создать параметр. Заполните эту форму и нажмите кнопку "ОК ", чтобы создать новый параметр.

  

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

Свойства параметра

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

• Имя. Укажите имя этого параметра, которое позволяет легко распознавать и различать его от других параметров, которые можно создать.

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

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

• Тип: указывает тип данных параметра. Рекомендуется всегда настраивать тип данных параметра. Чтобы узнать больше о важности типов данных, перейдите к типам данных.

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

  • Любое значение: текущее значение может быть любым введенным вручную значением.

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

    

    Примечание.

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

  • Запрос: использует запрос списка (запрос, выходные данные которого — список) для предоставления списка предлагаемых значений, которые можно позже выбрать для текущего значения.

    

• Текущее значение: значение, хранящееся в этом параметре.

Где использовать параметры

Параметр можно использовать различными способами, но чаще используется в двух сценариях:

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

В следующих разделах вы увидите пример для этих двух сценариев.

Аргумент шага

Чтобы включить эту функцию, сначала перейдите на вкладку "Вид " в редакторе Power Query и выберите параметр Always Allow в группе параметров .

Например, в следующей таблице "Заказы" содержатся поля OrderID, Units и Margin.

В этом примере создайте новый параметр с именем "Минимальное поле " с типом десятичного числа и текущим значением 0,2.

Перейдите к запросу "Заказы " и в поле "Поле " выберите параметр "Больше, чем фильтр".

В окне "Фильтры строк" есть кнопка с типом данных для выбранного поля. Выберите параметр "Параметр" в раскрывающемся меню для этой кнопки. В области выбора поля прямо рядом с кнопкой типа данных выберите параметр, который требуется передать этому аргументу. В этом случае это параметр "Минимальное поле ".

После нажатия кнопки "ОК" таблица фильтруется с помощью текущего значения параметра.

Если изменить текущее значение параметра минимального поля на значение 0,3, запрос заказов обновляется немедленно и отображает только строки, в которых поле превышает 30 %.

Совет

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

Аргумент пользовательской функции

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

Вы можете назвать эту новую функцию, однако вы хотите. Для демонстрационных целей имя этой новой функции — MyFunction. После нажатия кнопки "ОК" в области "Запросы" создается новая группа с помощью имени новой функции. В этой группе вы найдете параметры, используемые для функции, запрос, используемый для создания функции, и саму функцию.

Чтобы проверить эту новую функцию, введите значение, например 0,4, в поле под меткой минимального поля . Затем нажмите кнопку "Вызвать ". При этом создается новый запрос с именем вызываемой функции, эффективно передавая значение 0,4, которое будет использоваться в качестве аргумента для функции, и предоставляя только строки, в которых поле превышает 40 %.

Дополнительные сведения о создании пользовательских функций см. в разделе "Создание пользовательской функции".

Параметры с несколькими значениями или списками

Новый тип параметра, доступный только в Power Query Online, является многозначным или списком параметров. В этом разделе описывается создание нового параметра списка и его использование в запросах.

После предыдущего примера измените текущее значение минимального поля с 0.3 на 0.1. Новая цель — создать параметр списка, который может содержать номера заказов, интересующих вас в анализе. Чтобы создать новый параметр, перейдите в диалоговое окно "Управление параметрами " и выберите "Создать ", чтобы создать новый параметр. Заполните этот новый параметр следующими сведениями:

• Имя: интересные заказы
• Описание: набор номеров заказов, интересных для конкретного анализа
• Обязательный: True
• Тип: Список

После определения этих полей появится новая сетка, в которой можно ввести значения, которые нужно сохранить для параметра. В этом случае эти значения : 125, 777 и 999.

Примечание.

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

Совет

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

Используя новые параметры списка интересных заказов, вернитесь к запросу "Заказы". Выберите меню автофильтровки поля OrderID . Выберите фильтры>чисел в.

После выбора этого параметра появится диалоговое окно " Фильтр строк ". Здесь можно выбрать параметр списка в раскрывающемся меню.

Примечание.

Параметры списка могут работать с параметрами "В" или "Нет". В этом случае можно фильтровать только по значениям из списка. Не выполняется именно наоборот, и пытается отфильтровать столбец, чтобы получить все значения, которые не равны значениям, хранящимся в параметре.

После нажатия кнопки "ОК" вы вернетесь к запросу. Там запрос был отфильтрован с помощью созданного параметра списка с результатом того, что хранились только строки , в которых OrderID был равен 125, 777 или 999 .