Можно ли задать псевдоним для параметра запроса?

Поддержка
1

Параметры запроса отлично подходят по очевидным причинам. Однако, когда вы предоставляете доступ к запросам в Data Explorer пользователям без технических навыков, они могут иногда путаться из-за названия (даже если это просто имя переменной с подчеркиванием).

Можно ли задать псевдоним параметру запроса, чтобы он отображался с более понятным названием под запросом?

2

Привет, @jordan-violet :wave: Думаю, можно сделать что-то вроде этого — это то, что вы имели в виду?

SELECT column_name AS alias_name
FROM table_name;
...

или так:

SELECT column_name(s)
FROM table_name AS alias_name
....
3

Нет, извините, входные параметры запроса. Вот так:

image
image1463×500 18.1 KB

4

Ой, извините, я неправильно понял ваш вопрос! Хм :thinking:

6

Я считаю, что вы можете редактировать запрос в Data Explorer и добавить описание того, как должен быть установлен параметр. Это отобразится при запуске отчета:

IMG_0281
IMG_02811431×739 83.1 KB

IMG_0282
IMG_0282947×579 54.7 KB

7

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

Кстати, было бы здорово, если бы можно было добавить ещё один шаг и предоставить возможность определять описание всплывающей подсказки или значка информации.

8

DE выглядит очень сырым… Создание другого интерфейса (будь то веб-страница, электронная таблица или приложение) — вероятно, хорошая идея.

Отличный пример — Grafana!

Grafana предоставляет живую демонстрацию отчётов о своём сообществе, извлекаемых из Data Explorer в реальном времени.

9

Да, мы используем Tableau в нашем бизнесе и экспортируем все данные из Discourse, чтобы их можно было применять там.

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

10

Кстати, мне очень нравится эта идея. Думаю, добавление «дружелюбной метки/заполнителя» было бы хорошим шагом. Однако не уверен, как это реализовать. :thinking:

11

Столько вариантов!

Одним из более простых решений было бы проверка наличия необязательной переменной label в текущем формате, который вы используете, например:

-- [params]
-- text :user_group
-- label: "Название учётной записи Salesforce для клиента, которого вы хотите найти в этом запросе."
-- text :topic_id

Признаюсь, я не работаю разработчиком на полную ставку уже более 5 лет, поэтому не могу претендовать на знание специфики текущей реализации или возможных сложностей следующего предложения… но было бы здорово, если бы вы реализовали Front Matter в начале SQL-запроса. Front Matter может быть в формате YAML, TOML или даже JSON и, безусловно, выглядит эстетичнее текущей реализации. На мой взгляд, визуально это также выглядит так, будто добавлять опции будет проще. Запрос с теоретической реализацией Front Matter мог бы выглядеть примерно так:

---
user_id:
  description: "Название учётной записи Salesforce для клиента, которого вы хотите найти в этом запросе."
  tooltip: "Получите это из учётной записи Salesforce пользователя, обычно это связано с его доменом электронной почты. Должно быть точное совпадение."
topic_id:
  description: "Это ID темы, которую вы хотите изучить."
event_attendance_type:
  default: 0
---

SELECT ue.user_id, u.name, u.title, ue.email
FROM discourse_post_event_invitees ei
JOIN posts p ON p.id = ei.post_id 
JOIN user_emails as ue ON ei.user_id = ue.user_id
JOIN users as u on ei.user_id = u.id
WHERE p.topic_id = :topic_id
AND ei.status = 0