Действия Firestore

Действие Firestore позволяет создавать, обновлять или удалять запись из коллекции Firestore.

Необходимые условия

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

Типы действий базы данных Firestore

Ниже приведены типы действий базы данных Firestore:

1. Создание документа: Создает новую запись в указанной коллекции Firestore.
2. Чтение документа: Извлекает данные документа с использованием ссылки.
3. Обновление документа: Обновляет указанное значение поля существующего документа.
4. Удаление документа: Удаляет записи в указанной коллекции Firestore.
5. Запрос коллекции: Извлекает записи из коллекции Firestore.

Создание документа [Действие]

Перейдите на страницу проекта в FlutterFlow и выполните следующие шаги, чтобы определить Действие для любого виджета.

1. Выберите Виджет (например, Кнопку), на котором хотите добавить действие.
2. Выберите Действия из панели свойств (правое меню) и нажмите Открыть. Это откроет Редактор потока действий в новом всплывающем окне.
3. Нажмите на + Добавить действие.
4. Справа найдите и выберите действие Firestore > Создать документ.
5. Установите Коллекцию на имя вашей коллекции.
6. В разделе Установить поля нажмите кнопку + Добавить поле.
7. Откройте Поле, чтобы передать его значение из виджета:
   • Установите Источник значения на Из переменной.
   • Нажмите на НЕ УСТАНОВЛЕНО и выберите Состояние виджета > Название текстового поля.
8. Точно так же добавьте поле для других элементов пользовательского интерфейса.
9. По умолчанию документы добавляются с автоматически сгенерированным ID. Однако, если вы предпочитаете использовать свой собственный ID для документа, вы можете включить переключатель Пользовательский ID.

Чтение документа [Действие]

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

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

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

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

Вот как настроены коллекции:

Чтобы определить это действие для любого виджета, выполните следующие шаги:

1. Выберите Виджет (например, Кнопку), на котором хотите добавить действие.
2. Выберите Действия из панели свойств (правое меню) и нажмите Открыть. Это откроет Редактор потока действий в новом всплывающем окне.
3. Нажмите на + Добавить действие.
4. Справа найдите и выберите действие Firestore > Чтение документа.
5. Теперь Выберите ссылку для чтения данных.
6. Укажите Имя переменной вывода действия. Это значение будет использоваться для хранения данных документа.

7. Теперь вы можете использовать Имя переменной вывода действия из предыдущего шага, чтобы извлечь данные. Например, чтобы отобразить данные на текстовом виджете, выберите Текстовый виджет > Панель свойств > Текст > Установить меню переменной > [имя_переменной_вывода_действия] > выберите поле для отображения.

Обновление документа [Действие]

Перейдите на страницу проекта в FlutterFlow и выполните следующие шаги, чтобы определить Действие для любого виджета.

1. Выберите Виджет (например, Кнопку), на котором хотите добавить действие.

2. Выберите Действия из панели свойств (правое меню) и нажмите Открыть. Это откроет Редактор потока действий в новом всплывающем окне.

3. Нажмите на + Добавить действие.

4. Справа найдите и выберите действие Firestore > Обновление документа.

5. Чтобы обновить конкретный документ в коллекции Firebase, вам нужно указать ссылку на этот документ. Ссылка действует как указатель на точный документ, который вы хотите обновить.

6. В разделе Установить поля нажмите кнопку + Добавить поле.

7. Откройте Поле, чтобы передать его значение из виджета:

   1. Установите Источник значения на Из переменной.
   2. Нажмите на НЕ УСТАНОВЛЕНО и выберите Состояние виджета > Название текстового поля.

8. Точно так же добавьте поле для других элементов пользовательского интерфейса.

Удаление документа [Действие]

Перейдите на страницу проекта в FlutterFlow и выполните следующие шаги, чтобы определить Действие для любого виджета.

1. Выберите Виджет (например, Кнопку), на котором хотите добавить действие.
2. Выберите Действия из панели свойств (правое меню) и нажмите Открыть. Это откроет Редактор потока действий в новом всплывающем окне.
3. Нажмите на + Добавить действие.
4. Справа найдите и выберите действие Firestore > Удаление документа.
5. Чтобы удалить конкретный документ в коллекции Firebase, вам нужно указать ссылку на этот документ. Ссылка действует как указатель на точный документ, который вы хотите удалить.

Запрос коллекции [Действие]

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

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

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

1. Выберите Виджет (например, Кнопку), на котором вы хотите определить действие.
2. Выберите Действия из панели свойств (правое меню) и нажмите Открыть. Это откроет Редактор потока действий в новом всплывающем окне.
3. Нажмите на + Добавить действие.
4. Справа найдите и выберите действие Firestore > Запрос коллекции.
5. Выберите Коллекцию, которую вы хотите опросить.
6. Выберите тип запроса среди следующих:
   • Список документов: Используйте эту опцию, когда вам нужно опросить полный список документов из коллекции. Это полезно для извлечения нескольких документов, которые могут быть упорядочены или отфильтрованы по определенным критериям, таким как ключевое слово.
   • Один документ: Выберите эту опцию, когда хотите извлечь конкретный отдельный документ из коллекции, обычно идентифицируемый по его уникальному ID.
   • Количество: Выберите эту опцию, чтобы определить количество документов, удовлетворяющих определенным критериям, не извлекая сами документы. Это полезно для получения быстрой сводки, например общего числа записей, удовлетворяющих фильтру.
7. Вы можете также Фильтровать и Сортировать результат запроса.
8. Укажите Имя переменной вывода действия. Это значение будет использоваться для хранения результата запроса.

9. Теперь вы можете использовать Имя переменной вывода действия из предыдущего шага, чтобы создать дочерние элементы из переменной на Списке.
10. Наконец, вы можете отобразить данные в виджете Текст. Для этого выберите Текстовый виджет > Панель свойств > Текст > Установить из переменной > [имя_переменной_дочерних_элементов] элемент > выберите поле, которое вы хотите отобразить.

Фильтрация запроса коллекции

Иногда вам может понадобиться фильтровать список на основе условия. Например, вы можете хотеть показать только