CLConverter для AutoGRAPH.NET — различия между версиями

Материал из TK
Перейти к: навигация, поиск
 
(не показано 6 промежуточных версий 2 участников)
Строка 1: Строка 1:
−
Консольная утилита для автоматической конвертации карлистов от предыдущей версии AutoGRAPH (3.х или 4.х) в схему [[AutoGRAPH.NET]]. В числе возможностей:
 +
Консольная утилита для автоматической конвертации карлистов от предыдущей версии AutoGRAPH (3.х или 4.х) в схему [[AutoGRAPH.NET|AutoGRAPH.NET]]. В числе возможностей:
   
 
*поддержка различных режимов конвертации: один карлист в одну схему и множество карлистов в одну схему
  
*поддержка различных режимов конвертации: один карлист в одну схему и множество карлистов в одну схему
−
*автоматическая загрузка сконвертированной схемы в [[WebMap.NET]]
 +
*автоматическая загрузка сконвертированной схемы в [[WebMap.NET|WebMap.NET]]
 
*поддержка несколько шаблонов схем
  
*поддержка несколько шаблонов схем
   
 
== Установка ==
  
== Установка ==
   
−
CLConverter не требует установки, достаточно скачать последнюю версию [http://agi.tk-chel.ru/install/clconverter отсюда] и распаковать в локальный каталог.
 +
CLConverter не требует установки, достаточно скачать последнюю версию [http://agi.tk-chel.ru/install/webmap отсюда] и распаковать в локальный каталог.
   
 
== Описание ключей командной строки ==
  
== Описание ключей командной строки ==
Строка 51: Строка 51:
 
|-
  
|-
 
| style="width: 119px;" | web-url<br/>
  
| style="width: 119px;" | web-url<br/>
−
| style="width: 956px;" | ссылка на WebMap.NET в виде&nbsp;http://demo.tk-nav.com
 +
| style="width: 956px;" | ссылка на WebMap.NET в виде [http://demo.tk-nav.com http://demo.tk-nav.com]
  +
|-
  +
| style="width: 119px;" | ini-section-custom
  +
| style="width: 956px;" | название секции в ini-файле (карлисте), в которой будут располагаться все нижеследующие параметры
 
|-
  
|-
 
| style="width: 119px;" | web-user<br/>
  
| style="width: 119px;" | web-user<br/>
−
| style="width: 956px;" | логин пользователя
 +
| style="width: 956px;" | логин пользователя, под которым происходит выгрузка схему в веб (аккаунт должен иметь права "создавать/изменять организации")
 
|-
  
|-
 
| style="width: 119px;" | web-pass<br/>
  
| style="width: 119px;" | web-pass<br/>
Строка 60: Строка 63:
 
|-
  
|-
 
| style="width: 119px;" | user-role-id
  
| style="width: 119px;" | user-role-id
−
| style="width: 956px;" | ID роли, которая будет
 +
| style="width: 956px;" | ID роли, которая будет присвоена пользователю при создании (если указан логин и пароль)
−
|-
  
−
| style="width: 119px;" | ini-section-custom
  
−
| style="width: 956px;" | <br/>
  
 
|-
  
|-
 
| style="width: 119px;" | ini-user-login
  
| style="width: 119px;" | ini-user-login
  +
| style="width: 956px;" | если указан, то в данном параметра в карлисте хранится имя пользователя, который будет автоматически создан и дан ему доступ на эту организацию
−
| style="width: 956px;" | <br/>
  
 
|-
  
|-
 
| style="width: 119px;" | ini-user-pass
  
| style="width: 119px;" | ini-user-pass
  +
| style="width: 956px;" | если указан, то в данном параметра в карлисте хранится пароль пользователя, который будет автоматически создан и дан ему доступ на эту организацию
−
| style="width: 956px;" | <br/>
  
 
|-
  
|-
 
| style="width: 119px;" | ini-uid
  
| style="width: 119px;" | ini-uid
  +
| style="width: 956px;" | если указан, то этот параметр должен хранить GUID организации, с которой будет она будет создана в вебе. Для повторных выгрузок этот GUID однозначно идентифицирует организацию и повторно выгружает именно в неё. Если параметр отсутствует в карлисте - GUID автоматически формируется как хэш от имени карлиста (если имя карлиста не меняется - UID будет одинаковый при повторных выгрузках)
−
| style="width: 956px;" | <br/>
  
 
|}
  
|}
   
  +
== Структура CarsList.ini файла ==
−
== Примеры использования ==
  
  +
<pre>[SETUP]
  +
Name=Организация
  +
[CustomData] //Название CustomData в зависимости от настройки CLConverter.exe.config <add key="ini-section-custom" value="CustomData"/>
  +
UserLogin=Логин //Название UserLogin в зависимости от настройки CLConverter.exe.config <add key="ini-user-login" value="UserLogin"/>
  +
UserPass=Пароль //Название UserPass в зависимости от настройки CLConverter.exe.config <add key="ini-user-pass" value="UserPass"/>
  +
UID=Guid //Название UID в зависимости от настройки CLConverter.exe.config <add key="ini-uid" value="UID"/>
   
  +
Guid (формат 00000000-0000-0000-0000-000000000000) нужно генерировать самостоятельно специальной программой или online генератором (к примеру https://www.guidgenerator.com)</pre>
−
=== <pre>CLConverter -tpl=Template -source=C:\*.ini -target-dir=D:\AGSchema -delete</pre> ===
  
  +
  +
== Примеры использования ==
  +
<pre>CLConverter -tpl=Template -source=C:\*.ini -target-dir=D:\AGSchema -delete</pre>
   
 
использовать шаблон Template и сконвертировать все .ini файлы из каталога C:\ в каталог D:\AGSchema, после чего удалить исходные файлы
  
использовать шаблон Template и сконвертировать все .ini файлы из каталога C:\ в каталог D:\AGSchema, после чего удалить исходные файлы
  +
<pre>CLConverter -tpl=Template -source=C:\*.ini -target-web -target-schema=NewSchema1 -rename=.bak</pre>
   
  +
использовать шаблон Template и сконвертировать все .ini файлы из каталога C:\ в одну схему с именем NewSchema1, после чего загрузить её в [[WebMap.NET|WebMap.NET]]. У исходных файлов сменить расширение на&nbsp;.bak
−
=== <pre>CLConverter -tpl=Template -source=C:\*.ini -target-web -target-schema=NewSchema1 -rename=.bak</pre> ===
  
   
  +
_
−
использовать шаблон Template и сконвертировать все .ini файлы из каталога C:\ в одну схему с именем NewSchema1, после чего загрузить её в [[WebMap.NET]]. У исходных файлов сменить расширение на&nbsp;.bak
  

Текущая версия на 16:49, 16 мая 2018

Консольная утилита для автоматической конвертации карлистов от предыдущей версии AutoGRAPH (3.х или 4.х) в схему AutoGRAPH.NET. В числе возможностей:

  • поддержка различных режимов конвертации: один карлист в одну схему и множество карлистов в одну схему
  • автоматическая загрузка сконвертированной схемы в WebMap.NET
  • поддержка несколько шаблонов схем

Установка

CLConverter не требует установки, достаточно скачать последнюю версию отсюда и распаковать в локальный каталог.

Описание ключей командной строки

Ключ Описание
-tpl название шаблона. Все шаблоны хранятся в подкаталоге Templates
-source путь и маска файлов для конвертации. Пример: -source=C:\*.ini
-target-dir режим "конвертация в файлы схем" - путь к каталогу, в котором будут созданы файлы новой схемы может использоваться только один их этих ключей
-target-web режим "конвертация и загрузка в WebMap.NET"
-target-schema ключ указывается в виде -target-schema=ALL_IN_ONE - в этом случае будет создана одна схема с именем ALL_IN_ONE и в неё будут импортированы все найденные по маске source карлисты. Если данный ключ не указан - конвертация будет в виде "один карлист - одна схема"
-delete удалять исходные файлы после успешной конвертации может использоваться только один их этих ключей
-rename ключ указывается в виде -rename=.bak - в этом случае все успешно сконвертированные исходные файлы будут переменованы с расширением .bak

Файл CLConverter.exe.config

Данный файл используется для конфигурации CLConverter только в режиме -target-web

web-url
 ссылка на WebMap.NET в виде http://demo.tk-nav.com
ini-section-custom название секции в ini-файле (карлисте), в которой будут располагаться все нижеследующие параметры
web-user
 логин пользователя, под которым происходит выгрузка схему в веб (аккаунт должен иметь права "создавать/изменять организации")
web-pass
 пароль пользователя
user-role-id ID роли, которая будет присвоена пользователю при создании (если указан логин и пароль)
ini-user-login если указан, то в данном параметра в карлисте хранится имя пользователя, который будет автоматически создан и дан ему доступ на эту организацию
ini-user-pass если указан, то в данном параметра в карлисте хранится пароль пользователя, который будет автоматически создан и дан ему доступ на эту организацию
ini-uid если указан, то этот параметр должен хранить GUID организации, с которой будет она будет создана в вебе. Для повторных выгрузок этот GUID однозначно идентифицирует организацию и повторно выгружает именно в неё. Если параметр отсутствует в карлисте - GUID автоматически формируется как хэш от имени карлиста (если имя карлиста не меняется - UID будет одинаковый при повторных выгрузках)

Структура CarsList.ini файла

[SETUP]
Name=Организация
[CustomData]       //Название CustomData в зависимости от настройки CLConverter.exe.config <add key="ini-section-custom" value="CustomData"/>
UserLogin=Логин    //Название UserLogin в зависимости от настройки CLConverter.exe.config <add key="ini-user-login" value="UserLogin"/>
UserPass=Пароль    //Название UserPass в зависимости от настройки CLConverter.exe.config <add key="ini-user-pass" value="UserPass"/>
UID=Guid           //Название UID в зависимости от настройки CLConverter.exe.config <add key="ini-uid" value="UID"/>

Guid (формат 00000000-0000-0000-0000-000000000000) нужно генерировать самостоятельно специальной программой или online генератором (к примеру https://www.guidgenerator.com)

Примеры использования

CLConverter -tpl=Template -source=C:\*.ini -target-dir=D:\AGSchema -delete

использовать шаблон Template и сконвертировать все .ini файлы из каталога C:\ в каталог D:\AGSchema, после чего удалить исходные файлы 

CLConverter -tpl=Template -source=C:\*.ini -target-web -target-schema=NewSchema1 -rename=.bak

использовать шаблон Template и сконвертировать все .ini файлы из каталога C:\ в одну схему с именем NewSchema1, после чего загрузить её в WebMap.NET. У исходных файлов сменить расширение на .bak

_

Источник — «http://oldwiki.tk-chel.ru/index.php?title=CLConverter_для_AutoGRAPH.NET&oldid=56596»