Helper

Библиотека Форсайт.Helper – типовая система комплексных back-end сервисов для облегченного программирования типовых операций в программном продукте "Форсайт. Аналитическая платформа" (BI платформа).

Далее предлагается два варианта установки Helper:

1. Установка Helper, без подключения к Git.
2. Установка Helper с подключением к Git для получения обновлений библиотеки Helper.

Установка Helper без подключения к системе контроля версий Git

Установка производится на платформу: Форсайт.Аналитическая платформа(ФАП).

1. Скачиваем Форсайт.Helper.pefx файл: Скачать
2. ФАП --> Навигатор --> Обновить объекты репозитория
3. Выбираем в папке с скачанным репозиторием файл "Форсайт.Helper.pefx"
4. Далее --> Готово

Установка Helper с подключением к системе контроля версий Git

Рекомендации перед началом установки

Для работы с библиотекой Helper понадобится:

• Форсайт.Аналитическая платформа(ФАП)
• Клиент системы управления версиями Git (в примере будет использоваться Git Bash)
• Аккаунт Github

1. Заходим в папку, в которую будет выкачиваться репозиторий ПКМ --> Git Bash Here или в Git Bash командой:

cd <Полный адрес до папки>

2. Клонируем репозиторий командой:

git clone https://<Имя_пользователя_Github>:<Токен>@github.com/ForesightPlatform/Helper.git

Для подключения требуется наличие аксесс токена профиля Github, если его нет, то:
1. Заходим на свой аккаунт Github и жмем по иконке своего профиля справа сверху --> Settings --> Developer settings (Снизу в левой колонке) --> Personal access tokens
2. Добавляем токен и настраиваем его.
3. Копируем полученный токен.

3. Загружаем объекты Helper в ФАП

3.1 ФАП --> Навигатор --> Обновить объекты репозитория
3.2 Выбираем в папке с скачанным репозиторием файл "Форсайт.Helper.pefx"
3.3 Далее --> Готово

4. Подключаем файлы Helper из ФАП к системе контроля версий Git

Следуйте инструкции по подключению.
Важно: Нужно скачать ту версию библиотеки Lib2git,NativeString, на которую ведет ссылка!

5. Проверка правильности подключения

В ФАП выбираем появившийся объект "Помощники". После Выполнения предыдущего пункта в верхнем меню ФАП появится раздел "Система управления версиями (VCS)". В нём жмём на кнопку "Последняя версия". При успешном подключении на экране ничего не произойдет. Если ошибок не возникло, значит все сделано правильно. В ином случае смотрите раздел "Возможные ошибки".

Получение обновлений

Для получения обновления Helper нужно выбрать в ФАП объект "Помощники" и нажать кнопку "Последняя версия".

Возможные ошибки

• Ошибка:
  В ФАП - Не удалось выполнить Fetch
  или
  В Git Bash - fatal: unable to access 'https://github.com/ForesightPlatform/Helper.git/ ': Failed to connect to github.com port 443 after 21124 ms: Timed out
  Может возникать при незаданных настройках прокси сервера. Команда для проверки, какой прокси-сервер настроен в данный момент:

  git config --global --get http.proxy  
  

  Команда для задания прокси-сервера:

  git config --global http.proxy http://<Адрес_прокси-сервера>:<Порт>  
  

  В ФАП также стоит проверить настройку:
  ФАП-->Сервис-->Параметры-->Подключение должно быть выбрано либо "Автоматически определять настройки", либо задано вручную.

• Ошибка: config value 'user.name' was not found Может возникать, если ранее не использовался Git. Чтобы устранить ошибку, нужно задать настройки профиля в Git:

  git config --global user.name "<Имя_пользователя>" 
  git config --global user.email "<Ваш_email>" 
  

---