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

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

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

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

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

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

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

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

  

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

  

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

  

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

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

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

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

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

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

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

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

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

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

    

    Замечание

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

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

    

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

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

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

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

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

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

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

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

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

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

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

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

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

Подсказка

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

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

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

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

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

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

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

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

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

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

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

Замечание

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

Подсказка

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

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

Подсказка

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

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

Замечание

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

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