Extractor

Библиотека Форсайт.Extractor – Библиотека для создания таблиц фактов и справочников из различных внешних источников: csv, xls, ods, программный массив и др. При создании новая структура данных полностью повторяет первоисточник. Дополнительно содержится ряд сервисов для модификации структуры справочников: иерархии, кодов и т.п.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для получения обновления Extractor нужно выбрать в ФАП объект "Загрузчик" и нажать кнопку "Последняя версия".

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

• Ошибка:
  В ФАП - Не удалось выполнить Fetch
  или
  В Git Bash - fatal: unable to access 'https://github.com/ForesightPlatform/Extractors.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>" 
  

---