mobile forms

Добавить в мобильное приложение возможномть вставлять настраиваемый список форм. В зависимости от пароля может быть доступен разный список форм.

PimCore

Создать классы

Необходимо с Ex забрать следующие два класса:

Настроить datahub

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

Создать объекты

Внутри роута /APP в дата объектах необходимо создать минимум один экземпляр формы и логина. К примеру:

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

Важно: имя интеграции app-asset захардкожено в мобильное приложение, его менять не нужно, так же как и пароль в нем менять ни в коем случае не нужно.

Путь /APP прописан в Security схеме уже, его не нужно менять.

Mobile

Мы бы хотели добавить возможность логина и выбора формы.

В экране профиля добавляем кнопку Login.

При нажатии на нее мы показываем форму ввода пароля, и кнопку Login.

При успешном вводе пароля мы показываем список из доступных форм.

При выборе элемента из списка мы открываем урл связанный с элементом в вебвью.

API

Консоль для тестирования graphql запросов

Для проверки логина мы используем следующий запрос: get login:

query GetMobileLoginListing($filter: String!) {
  getMobileLoginListing(
    filter: $filter
  ) {
    edges {
      node {
        id
        classname
        creationDate
        name
        password
        role
      }
    }
    totalCount
  }
}
{
    "filter": "{\"password\": \"knjknds\"}"
  }

Пример ответа сервера:

{
  "data": {
    "getMobileLoginListing": {
      "edges": [
        {
          "node": {
            "id": "55016",
            "classname": "MobileLogin",
            "creationDate": 1726153153,
            "name": "salesmans",
            "password": "knjknds",
            "role": "sales"
          }
        }
      ],
      "totalCount": 1
    }
  }
}

Для проверки успешности логина мы проверяем значение поля totalCount. Если оно больше или равно единице — то логин успешен. Если поле отсутствует или равно нулю — ошибка аутентификации. При успешном логине мы должны забрать значение поля role, оно является фильтром для второго запроса — получить список форм.

get forms:

query($filter: String) {
  getMobileFormElementListing(
    filter: $filter
  ) {
    edges {
      node {
        id
        classname
        creationDate
        name
        role
        url
      }
    }
    totalCount
  }
}

{
    "filter": "{\"role\": \"sales\"}"
}

Response example:

{
  "data": {
    "getMobileFormElementListing": {
      "edges": [
        {
          "node": {
            "id": "55015",
            "classname": "MobileFormElement",
            "creationDate": 1726153101,
            "name": "rfq form",
            "role": "sales",
            "url": "https://human.de/contacts"
          }
        }
      ],
      "totalCount": 1
    }
  }
}

Каждый элемент массива edges это наш элемент в списке форм для показа.

name - это имя формы в списке
url - это урл который необходимо открыть в вебвью.

Запрос на получение ассетов, сейчас нам не нужен, но чтобы не потерялся

query GetUpdatedAssets($filter: String) {
    getAssetListing(filter: $filter, sortBy: "modificationDate", published: true) {
    totalCount # Total count of items
    edges {
      node {
        ... on asset {
          # fragment used to get valid list of fields (e.g. id, fullpath)
          id # Pimcore asset ID
          filename
          fullpath # relative URL path to file (e.g. for fullpath="/APP/file.pdf" and feature env, url should be https://cp-ft.hmn-dev.de/APP/file.pdf)
          type
          modificationDate
        }
      }
    }
  }
}

{"filter": "{\"type\": \"document\", \"modificationDate\": {\"$gt\": \"1704844800\"}}"}