Завершив внедрение ТестЛинк в компании, где я сейчас работаю, решил рассказать про шаги, которые мне пришлось выполнить перед тем как начать создавать аккаунты пользователей (т.е. дать им доступ к системе). Хотелось, чтобы тестировщики увидели инструмент, создающий ощущение законченности и надежности.
Все шаги, кроме первичной установки, делал я сам. А это означает, что настройка TestLink — не ракетные технологии и подвластна любому менеджеру (и не только).
Ниже вы узнаете о следующем:
1) Что запросить у того человека, который будет устанавливать TestLink.
2) Что желательно настроить (самому или кого-то попросить) после установки TestLink.
3) Как сделать перевод не переведенных элементов UI и использовать его в TestLink.
4) Как перенести тесты из XLS в TestLink.
В этой статье я не рассказал про следующие вещи, которые необходимо или желательно сделать при внедрении TestLink:
1) интеграция с bug (issue) tracking системами.
У себя я настроил интеграцию с Redmine именно со стороны TestLink (так как включение не протестированных нами плагинов в корпоративный Redmine было бы очень рискованно и долго).
2) создание своих шаблонов для отчетов (не делал пока).
3) использование TestLink в рамках бизнес-процессов вашей компании.
4) обучение работе с TestLink.
ВНИМАНИЕ:
Перед редактированием любых файлов конфигурации ТестЛинк необходимо сделать следующее:
1) Открыть файл в режиме редактирования.
2) Изменить режим кодировки файла на UTF-8. Этот шаг необходимо выполнять после КАЖДОГО открытия файла на редактирование!
3) Теперь можно проводить редактирование и сохранять результат.
ТестЛинк взяли последней версии, 9.1.11. Взяли сборку от Bitnami, bitnami.com/stack/testlink/installer
Программа бесплатная. Сайт программы: testlink.org/
Для установки надо попросить администратора скачать и установить это ПО. Или установите сами.
1) Номер версии для установки
2) ТестЛинку для работы нужны БД MySQL и веб-сервер. Часто входят в дистрибутивы ТестЛинк.
3) Необходимо настроить резервное копирование БД. Если вам сделают резервное копирование еще и всех файлов TestLink — отлично. Так безопасней вносить изменения в настройки.
4) Необходимо сделать так, чтобы ТестЛинк включили в автозагрузку сервера, на котором он установлен. Это нужно чтобы при перезагрузке сервера ТестЛинк сразу начинал работать.
5) Попросить сразу в файле config.inc.php ( он расположен в каталоге /opt/testlink-1.9.11-0/apps/testlink/htdocs программы ТестЛинк ) сделать следующие изменения (если нужно нормально поддерживать русский язык):
$tlCfg->default_language = 'ru_RU';
$tlCfg->charset = 'UTF-8';
При любом редактировании файлов настройки ТестЛинк убедитесь в том, что изменяете при включенной кодировке UTF-8.
Кроме того, необходимо у администратора запросить настройку почтовой системы ТестЛинк. Т.е. настроить ТестЛинк на работу с почтой вашей компании. Он просто настроит SMTP в файле конфига.
Эти шаги делались уже для тонкой настройки, т.е. не сис.админом, а мною, т.е. менеджером.
Для настроек необходимо заходить на сервер ТестЛинк через протокол SSH.
Если у вас стоит Windows, очень удобно использовать вот эту программу: winscp.net/eng/docs/lang:ru — это популярный Putty с графическим удобным интерфейсом).
Настроить следующие поля в файле config.inc.php ( он расположен в каталоге /opt/testlink-1.9.11-0/apps/testlink/htdocs программы ТестЛинк ):
$tlCfg->exec_cfg->history_on = TRUE;
$tlCfg->exec_cfg->show_history_all_builds = TRUE;
$tlCfg->exec_cfg->show_history_all_platforms = TRUE;
$tlCfg->exec_cfg->steps_exec = true; — начиная с ТестЛинк 1.9.11 это значение стоит по-умолчанию
$tlCfg->exec_cfg->steps_exec_notes_default = 'latest'; — это изменение позволяет в заметках каждого шага теста, при новом прогоне теста, показывать заметки из предыдущего (последнего) прогона теста.
часть /* [GENERATED DOCUMENTATION] */:
$tlCfg->document_generator->company_name = 'название компании';
$tlCfg->document_generator->company_copyright = date(Y).' название компании';
$tlCfg->document_generator->tc_version_enabled = TRUE;
При импорте тестов или групп тестов из XML, в случае если такое имя уже есть в системе, TestLink сформирует новое имя на основе существующего. К имени будет добавлен номер такого теста в круглых скобках. Если изменения не делать, то имя будет формироваться так, как показано в закоментированных строках, т.е. на основе даты и времени.
//$tlCfg->testcase_cfg->duplicated_name_algorithm->type = 'stringPrefix';
//$tlCfg->testcase_cfg->duplicated_name_algorithm->text = strftime("%Y%m%d-%H:%M:%S", time());
$tlCfg->testcase_cfg->duplicated_name_algorithm->type = 'counterSuffix';
$tlCfg->testcase_cfg->duplicated_name_algorithm->text = " (%s)";
Файлы ТестЛинка с графикой хранятся тут: /opt/testlink-1.9.11-0/apps/testlink/htdocs/gui/themes/default/images.
Вставляем в каталог с изображениями два файла с такими же параметрами как файлы tl-logo-transparent-25.png и tl-logo-transparent-12.5.png.
Редактируем в файле config.inc.php следующие поля:
$tlCfg->logo_login = 'файл с вашим лого.png'; — размер файла 231*56 пикселей, transparent
$tlCfg->logo_navbar = 'файл с вашим лого.png'; — размер файла 116*28 пикселей, transparent
Теперь на странице логина, в строке главного меню ТестЛинк, в отчетах будет стоять логин вашей компании.
В файле config.inc.php можно сделать перевод для текста, используемого в описании тестов, создающихся автоматически для требований.
Нужно сделать перевод для текста, предоставляемого этими полями:
$tlCfg->req_cfg->testcase_summary_prefix
$tlCfg->req_cfg->testcase_summary_prefix_with_title_and_version
В самом TestLink можно редактировать роли, т.е. создавать новые и менять возможности, предоставляемые для каждой из ролей.
Вообще, настройка ролей достойна отдельной статьи.
Но, например, проследите чтобы была включена для практически всех ролей опция Show Test Cases Assigned to me.
В поставку ТестЛинк входит локализация на русский язык.
Проблема в том, что примерно 40% элементов пользовательского интерфейса там не переведены на русский язык или для которых хотелось бы перевод поменять.
Поэтому можно выполнить дополнительную работу по переводу. К сожалению, не все элементы интерфейса запрограммированы так, чтобы перевод для них был в одном файле.
Поэтому, даже после полного перевода текста из файла custom_strings.txt останутся элементы, не переведенные на русский язык.
Что нужно сделать чтобы перевести на русский (и любой другой) язык части UI:
1) Перейти в каталог /opt/testlink-1.9.11-0/apps/testlink/htdocs/locale/ru_RU (если у нас используется русский язык для UI) на сервере с ТестЛинк
2) Скопировать к себе на ПК файлы custom_strings.txt.example и strings.txt
3) Скопировать из strings.txt в custom_strings.txt.example данные
4) Сделать нужный перевод в файле custom_strings.txt.example — ВНИМАНИЕ!!! ПЕРЕД НАЧАЛОМ РЕДАКТИРОВАНИЯ НУЖНО СДЕЛАТЬ ПРОВЕРКУ, ПРИВЕДЕННУЮ СРАЗУ ПОСЛЕ ЭТОЙ ПОСЛЕДОВАТЕЛЬНОСТИ ШАГОВ!
5) Переименовать custom_strings.txt.example в custom_strings.txt
6) Скопировать файл custom_strings.txt в каталог /opt/testlink-1.9.11-0/apps/testlink/htdocs/locale/ru_RU на сервере с ТестЛинк
Перед редактированием любых файлов конфигурации ТестЛинк необходимо сделать следующее:
1) Открыть файл в режиме редактирования.
2) Изменить режим кодировки файла на UTF-8. Этот шаг необходимо выполнять после КАЖДОГО открытия файла на редактирование!
3) Теперь можно проводить редактирование и сохранять результат.
Новые версии Excel плохо поддерживают (никак!) тот формат XML, который понимает ТестЛинк.
Поэтому для портирования используется внешнее ПО, распространяемое бесплатно.
Программа называется EX-converter.
Это свободное ПО. Вот его страничка: sourceforge.net/projects/ex-converter/
Программа работает под MS Windows.
Зайдите в TestLink. Слева внизу будет элемент Documentation. Выбирайте нужные документы и читайте (на английском). Там есть, среди прочего, руководство пользователя и руководство по настройке TestLink.
testlink.org
bitnami.com/stack/testlink/installer
winscp.net/eng/docs/lang:ru
Все шаги, кроме первичной установки, делал я сам. А это означает, что настройка TestLink — не ракетные технологии и подвластна любому менеджеру (и не только).
Ниже вы узнаете о следующем:
1) Что запросить у того человека, который будет устанавливать TestLink.
2) Что желательно настроить (самому или кого-то попросить) после установки TestLink.
3) Как сделать перевод не переведенных элементов UI и использовать его в TestLink.
4) Как перенести тесты из XLS в TestLink.
В этой статье я не рассказал про следующие вещи, которые необходимо или желательно сделать при внедрении TestLink:
1) интеграция с bug (issue) tracking системами.
У себя я настроил интеграцию с Redmine именно со стороны TestLink (так как включение не протестированных нами плагинов в корпоративный Redmine было бы очень рискованно и долго).
2) создание своих шаблонов для отчетов (не делал пока).
3) использование TestLink в рамках бизнес-процессов вашей компании.
4) обучение работе с TestLink.
ВНИМАНИЕ:
Перед редактированием любых файлов конфигурации ТестЛинк необходимо сделать следующее:
1) Открыть файл в режиме редактирования.
2) Изменить режим кодировки файла на UTF-8. Этот шаг необходимо выполнять после КАЖДОГО открытия файла на редактирование!
3) Теперь можно проводить редактирование и сохранять результат.
Установка TestLink
ТестЛинк взяли последней версии, 9.1.11. Взяли сборку от Bitnami, bitnami.com/stack/testlink/installer
Программа бесплатная. Сайт программы: testlink.org/
Для установки надо попросить администратора скачать и установить это ПО. Или установите сами.
Что нужно указать при запросе администратору:
1) Номер версии для установки
2) ТестЛинку для работы нужны БД MySQL и веб-сервер. Часто входят в дистрибутивы ТестЛинк.
3) Необходимо настроить резервное копирование БД. Если вам сделают резервное копирование еще и всех файлов TestLink — отлично. Так безопасней вносить изменения в настройки.
4) Необходимо сделать так, чтобы ТестЛинк включили в автозагрузку сервера, на котором он установлен. Это нужно чтобы при перезагрузке сервера ТестЛинк сразу начинал работать.
5) Попросить сразу в файле config.inc.php ( он расположен в каталоге /opt/testlink-1.9.11-0/apps/testlink/htdocs программы ТестЛинк ) сделать следующие изменения (если нужно нормально поддерживать русский язык):
$tlCfg->default_language = 'ru_RU';
$tlCfg->charset = 'UTF-8';
При любом редактировании файлов настройки ТестЛинк убедитесь в том, что изменяете при включенной кодировке UTF-8.
Кроме того, необходимо у администратора запросить настройку почтовой системы ТестЛинк. Т.е. настроить ТестЛинк на работу с почтой вашей компании. Он просто настроит SMTP в файле конфига.
Настройка ТестЛинк сразу после установки
Эти шаги делались уже для тонкой настройки, т.е. не сис.админом, а мною, т.е. менеджером.
Отступление про инструментарий
Для настроек необходимо заходить на сервер ТестЛинк через протокол SSH.
Если у вас стоит Windows, очень удобно использовать вот эту программу: winscp.net/eng/docs/lang:ru — это популярный Putty с графическим удобным интерфейсом).
Основные настройки
Настроить следующие поля в файле config.inc.php ( он расположен в каталоге /opt/testlink-1.9.11-0/apps/testlink/htdocs программы ТестЛинк ):
Показ истории и шагов тестов при прогоне тестов
$tlCfg->exec_cfg->history_on = TRUE;
$tlCfg->exec_cfg->show_history_all_builds = TRUE;
$tlCfg->exec_cfg->show_history_all_platforms = TRUE;
$tlCfg->exec_cfg->steps_exec = true; — начиная с ТестЛинк 1.9.11 это значение стоит по-умолчанию
$tlCfg->exec_cfg->steps_exec_notes_default = 'latest'; — это изменение позволяет в заметках каждого шага теста, при новом прогоне теста, показывать заметки из предыдущего (последнего) прогона теста.
Данные вашей компании в отчетах
часть /* [GENERATED DOCUMENTATION] */:
$tlCfg->document_generator->company_name = 'название компании';
$tlCfg->document_generator->company_copyright = date(Y).' название компании';
$tlCfg->document_generator->tc_version_enabled = TRUE;
Настройка авто-коррекции имени теста (при импорте из XML)
При импорте тестов или групп тестов из XML, в случае если такое имя уже есть в системе, TestLink сформирует новое имя на основе существующего. К имени будет добавлен номер такого теста в круглых скобках. Если изменения не делать, то имя будет формироваться так, как показано в закоментированных строках, т.е. на основе даты и времени.
//$tlCfg->testcase_cfg->duplicated_name_algorithm->type = 'stringPrefix';
//$tlCfg->testcase_cfg->duplicated_name_algorithm->text = strftime("%Y%m%d-%H:%M:%S", time());
$tlCfg->testcase_cfg->duplicated_name_algorithm->type = 'counterSuffix';
$tlCfg->testcase_cfg->duplicated_name_algorithm->text = " (%s)";
Лого вашей компании
Файлы ТестЛинка с графикой хранятся тут: /opt/testlink-1.9.11-0/apps/testlink/htdocs/gui/themes/default/images.
Вставляем в каталог с изображениями два файла с такими же параметрами как файлы tl-logo-transparent-25.png и tl-logo-transparent-12.5.png.
Редактируем в файле config.inc.php следующие поля:
$tlCfg->logo_login = 'файл с вашим лого.png'; — размер файла 231*56 пикселей, transparent
$tlCfg->logo_navbar = 'файл с вашим лого.png'; — размер файла 116*28 пикселей, transparent
Теперь на странице логина, в строке главного меню ТестЛинк, в отчетах будет стоять логин вашей компании.
Перевод некоторых частей UI
В файле config.inc.php можно сделать перевод для текста, используемого в описании тестов, создающихся автоматически для требований.
Нужно сделать перевод для текста, предоставляемого этими полями:
$tlCfg->req_cfg->testcase_summary_prefix
$tlCfg->req_cfg->testcase_summary_prefix_with_title_and_version
Роли
В самом TestLink можно редактировать роли, т.е. создавать новые и менять возможности, предоставляемые для каждой из ролей.
Вообще, настройка ролей достойна отдельной статьи.
Но, например, проследите чтобы была включена для практически всех ролей опция Show Test Cases Assigned to me.
Подробно про локализацию на русский
В поставку ТестЛинк входит локализация на русский язык.
Проблема в том, что примерно 40% элементов пользовательского интерфейса там не переведены на русский язык или для которых хотелось бы перевод поменять.
Поэтому можно выполнить дополнительную работу по переводу. К сожалению, не все элементы интерфейса запрограммированы так, чтобы перевод для них был в одном файле.
Поэтому, даже после полного перевода текста из файла custom_strings.txt останутся элементы, не переведенные на русский язык.
Что нужно сделать чтобы перевести на русский (и любой другой) язык части UI:
1) Перейти в каталог /opt/testlink-1.9.11-0/apps/testlink/htdocs/locale/ru_RU (если у нас используется русский язык для UI) на сервере с ТестЛинк
2) Скопировать к себе на ПК файлы custom_strings.txt.example и strings.txt
3) Скопировать из strings.txt в custom_strings.txt.example данные
4) Сделать нужный перевод в файле custom_strings.txt.example — ВНИМАНИЕ!!! ПЕРЕД НАЧАЛОМ РЕДАКТИРОВАНИЯ НУЖНО СДЕЛАТЬ ПРОВЕРКУ, ПРИВЕДЕННУЮ СРАЗУ ПОСЛЕ ЭТОЙ ПОСЛЕДОВАТЕЛЬНОСТИ ШАГОВ!
5) Переименовать custom_strings.txt.example в custom_strings.txt
6) Скопировать файл custom_strings.txt в каталог /opt/testlink-1.9.11-0/apps/testlink/htdocs/locale/ru_RU на сервере с ТестЛинк
Перед редактированием любых файлов конфигурации ТестЛинк необходимо сделать следующее:
1) Открыть файл в режиме редактирования.
2) Изменить режим кодировки файла на UTF-8. Этот шаг необходимо выполнять после КАЖДОГО открытия файла на редактирование!
3) Теперь можно проводить редактирование и сохранять результат.
Портирование тестов из Excel в ТestLink
Новые версии Excel плохо поддерживают (никак!) тот формат XML, который понимает ТестЛинк.
Поэтому для портирования используется внешнее ПО, распространяемое бесплатно.
Программа называется EX-converter.
Это свободное ПО. Вот его страничка: sourceforge.net/projects/ex-converter/
Программа работает под MS Windows.
Читайте документацию
Зайдите в TestLink. Слева внизу будет элемент Documentation. Выбирайте нужные документы и читайте (на английском). Там есть, среди прочего, руководство пользователя и руководство по настройке TestLink.
Еще раз ссылки на полезное
testlink.org
bitnami.com/stack/testlink/installer
winscp.net/eng/docs/lang:ru