T-Kernel Traceability Service の利用ガイド
本稿は、T-Kernel Traceability Serviceの利用方法を記したものです。
1. 機能概要
T-Kernel Traceability Service(以下「本サービス」と呼ぶ)は、T-License 2.0に基づきソースコードの変遷を記録するためのシステムです。誰でも、T-License 2.0に基づき、本サービスにソースコードを登録し、閲覧することができます。
以下、本サービスに登録されたソースコード一式を「ディストリビューション」と呼びます.本サービスに登録されたディストリビューションには、ucodeが付与されます。このucodeを利用して、ディストリビューションを指定したり、その変遷履歴をみたりできます。
1.1 本サービスが提供する機能
本サービスには、大きく分けて以下の8機能があります。
1.2 典型的な利用方法
本サービスの典型的な利用方法と、その手順を説明します。
文章中にあるリンクをクリックすると、画面の詳細説明ページに遷移します。
- 入手したディストリビューションに、本サービスのURLやucodeQRを含む画像が付いていた場合
携帯電話またはPCでそのディストリビューションに関する情報(ディストリビューションのバージョン/提供者/リリースノート/そのディストリビューションの元になったディストリビューションに関する情報)が得られます。携帯電話PCそれぞれでの閲覧方法は以下の通りです。- 携帯電話の場合
- ucodeQRを携帯電話で読み取り、表示されたURLに接続してください。
- そのディストリビューションの詳細情報が表示されます。
- PCの場合
- 本サービスにPCで接続し、トップ画面中央の検索画面の「ディストリビューション番号」欄に、ucodeQRの下に付いているディストリビューション番号(8桁の英数字)を入力して「検索」ボタンを押してください。
- 入力された番号をもつディストリビューションが表示されます。
- その画面の左側にあるディストリビューション番号(8桁の英数字)をクリックすると、そのディストリビューションの詳細を見られます。
- 携帯電話の場合
- 最近登録されたディストリビューションを知りたい場合
- 登録されたディストリビューションから検索したい場合
- 本サービスにPCで接続してください。
- トップ画面中央の「ディストリビューション番号」欄に、検索条件を入力し、「検索」ボタンを押してください。
- 条件を満たすディストリビューション番号が一覧表示されます。
- 一覧画面の左側にあるディストリビューション番号(8桁の英数字)をクリックすると、そのディストリビューションの詳細を見られます。
- ディストリビューションを登録したい場合
- 本サービスにPCで接続してください。
- 本サービスのアカウントをお持ちですか?
- トップ画面右上の「ログイン」リンクをクリックして、本サービスにログインしてください。
- ログイン後の画面の中央に「登録済のディストリビューション」が一覧表示されます(未登録の場合は表題だけ出ます)。この表にある「新規登録」リンクをクリックしてください。
- これ以降の手順の詳細は8. ディストリビューション登録に記載してあります。
- 以前に登録したディストリビューションに関する情報を変更したい場合
- 本サービスにPCで接続してください。
- トップ画面右上の「ログイン」リンクをクリックして、本サービスにログインしてください。
- ログイン後の画面の中央に「登録済のディストリビューション」が一覧表示されます。
- 変更したいディストリビューションの右側にある「編集」リンクをクリックしてください。
- これ以降の手順の詳細は9. ディストリビューション編集に記載してあります。
2. トップ画面
以下、本サービスのトップページからの遷移を通して、各機能を説明します。
本サービスのURLは以下の通りです。
https://trace.tron.org/tk/
本サービスに接続すると、下記のような画面が表示されます。
画面には、最近登録されたディストリビューションが一覧表示されています。
- 一覧表内のディストリビューション番号をクリックすると、そのディストリビューションの詳細情報が見られます。
- 登録されているディストリビューションを知りたい方は、画面中央の検索欄にディストリビューション番号/ディストリビューション名/登録者/登録日を入力し、「検索」ボタンを押してください。画面がディストリビューションを検索に遷移し、登録されているディストリビューションを見られます。複数の検索条件を入力した場合、AND検索されます。つまり、すべての条件を満たすディストリビューション番号が表示されます。
- ディストリビューションを登録したい方は、画面右上のログインを押して、本サービスにログインしてください。
- まだ本サービスのログインアカウントを持っていない場合は、まずアカウント登録を行ってください。
- ログインパスワードをお忘れの方は、画面右上のログインを押して表示される画面から、パスワードの再発行を申請してください。
これ以降、ログインするまで、画面左上のロゴをクリックするとこの画面に戻ります。
3. アカウント登録画面
トップ画面の「アカウント作成」リンクをクリックすると、下記のような画面が表示されます。
利用許諾契約を一読し、同意いただけるならば以下の情報を入力し、「アカウント発行」ボタンを押してください。
- ニックネーム(日本語・英語)
- メールアドレス
すでに本サービスに登録されているニックネームやメールアドレスを登録することはできません。
登録が完了すると、tktrace@tron.orgより以下のようなアカウント通知メールが届きます。
このメールに記載されているパスワードとメールアドレスを利用して、本サービスに[ログイン]してください。
4. ログイン画面
トップ画面の「ログイン」リンクをクリックすると、下記のような画面が表示されます。
4.1 ログイン
ログイン画面に表示されている「メールアドレス」「パスワード」欄に、発行済メールアドレスとパスワードを入力し、「ログイン」ボタンを押すと、ユーザログインできます。ログインに成功すると、ユーザメイン画面に遷移します。
5. ユーザメイン画面
ログインに成功すると、ユーザメイン画面が表示されます。
これ以降、ログアウト するまで、画面左上のロゴをクリックするとこの画面に戻ります。
ユーザメイン画面は、ログインユーザの初期画面です.ここには、最近リリースされたディストリビューションと、ユーザが登録したディストリビューションが表示されています。
- 一覧表内のディストリビューション番号をクリックすると、そのディストリビューションの詳細情報が見られます。
- ディストリビューション番号/ディストリビューション名/登録者/登録日をキーとして、ディストリビューションを検索することもできます。
- 自分が登録したディストリビューションは、一覧表内の「編集」リンクをクリックすることにより編集できます。
- 新しいディストリビューションを登録するには、「登録済みのディストリビューション」の一番下にある「新規登録」リンクを押してください。
- 画面右上「アカウント管理」リンクを押すと、アカウント情報の編集ができます。
- 本サービスの利用を終了するときは、画面右上「ログアウト」リンクを押して、ログアウトしてください。
6. ディストリビューション検索
トップ画面またはユーザメイン画面に表示されている「ディストリビューションの検索」に条件を入力し、「検索」ボタンを押すと、ディストリビューションを検索します。検索条件は以下の4種類です。複数指定した場合は、AND検索になり、指定した条件の全てを満たすディストリビューション情報を表示します。
†すべてのディストリビューションを見られたい方は、条件をなにも入力せずに「検索」ボタンを押してください。
- ディストリビューションucodeまたはディストリビューション番号:
ディストリビューションに付与されているucodeをキーに検索を行います.ディストリビューション番号とは、ucodeの入力を簡便化するための、本サービスでのみ有効な番号であり、ucodeの下8桁です。 - ディストリビューション名:
ディストリビューションの名称をキーとして、部分一致検索を行います。 - 登録者:
ディストリビューションを登録したユーザのニックネームをキーとして、部分一致検索を行います。 - 登録日:
ディストリビューションが登録された日付をキーに検索します。
検索結果画面は以下の通りです。
結果一覧に表示されているディストリビューション番号をクリックすると、ディストリビューションの詳細が見られます。
条件を変えて再度検索することもできます。
もとの画面に戻るには、画面左上のロゴをクリックしてください。
7. ディストリビューション詳細表示
各ページに表示されている、ディストリビューション番号をクリックすると、そのディストリビューションの詳細情報を見られます。
このページでは、ディストリビューションの名称、入手先、リリースノートなどの情報と、そのディストリビューションの元になった(生成元の)ディストリビューションや、このディストリビューションを元に作成されたディストリビューションを見ることができます。
このページの右側に表示されている絵は、「ディストリビューションマーク」といいます。PNG形式の絵になっているので、ディストリビューションを配布するときに利用してください。この絵の中にあるucodeQR(ucodeをQRコードの形式で表現したもの)を携帯電話で読み取りますと、携帯電話でもディストリビューション情報を見られます。
「閉じる」ボタンを押すと、この画面を閉じます。JavaScriptを有効にしていない場合は、ブラウザの機能を使ってこのウィンドウまたはタブを閉じてください。
8. ディストリビューション登録
ユーザメイン画面に表示されている「新規登録」リンクを押すと、ディストリビューション登録画面になります。
ここでは、以下の手順でディストリビューションを登録していきます。
8.1 ディストリビューション情報入力
この画面では、登録するディストリビューションの情報を入力します.入力項目は以下の通りです。
- ディストリビューション名(必須):
登録するディストリビューションの名前です。 - 入手先URL(必須):
ディストリビューションを入手するための情報が記載されたURLです。有償のディストリビューションである場合は、カタログページなどにリンクしてください。アクセス制限のかかったページにリンクすることもできますが、推奨しません。 - バージョン:
ディストリビューションのバージョンです。 - リリースノート:
そのディストリビューションの内容やバージョン変遷などが書かれた文書です。webで公開している場合は、「URL」を選択して公開先URLを入力してください。本サービスにリリースノートを登録したい場合は、「テキスト」を選択してその下側の欄に文章を入力してください。 - 備考(コメント):
そのディストリビューションに関して、上記に含まれない補足情報があれば、入力してください。
入力の際、下記にご留意ください。
- 必須項目は必ず入力してください。(入力されない場合、警告メッセージが表示され先に進みません)
- 日本語欄に入力した情報は、利用者が日本語ページを閲覧しているときに、英語欄に入力した情報は、利用者が英語ページを閲覧しているときに表示されます。
- 必須でない項目については、その項目を公開するか否か選んでください。その情報を公開する場合は、欄の右側にあるチェックボックスをONにしてください。
- 登録するデータに、HTMLタグを含めることはできません。
画面右下の「確認」ボタンを押すと、ディストリビューション情報確認画面に遷移します。
8.2 ディストリビューション情報確認
この画面では、先ほど入力したディストリビューション情報を確認します。
入手先URLや、リリースノートの参照先URLを入力した場合、それらがリンクとなって表示されます。
内容を確認し、問題なければ「登録」ボタンを押してください。ディストリビューションの履歴情報登録画面に遷移します。
問題があれば「修正」ボタンを押してください。ディストリビューション情報入力画面に戻ります。
8.3 ディストリビューションの履歴情報登録
この画面では、登録するディストリビューションの元になったディストリビューションを登録します。
まず、画面下側「ディストリビューションの検索」欄を利用して、このディストリビューションの元になったディストリビューションを検索してください。検索方法はディストリビューション検索画面と同じです。
検索結果は、画面中央に表示されます。
検索結果の中から、登録するディストリビューションの元になったディストリビューションを選択し、欄の右側「履歴に追加」チェックボックスをONにしてください。また、そのディストリビューションのどこを修正したのかを、「修正項目」欄に入力することができます。修正項目がwebで公開されている場合は、そのURLを入力してください。
元になったディストリビューションは、複数選択することができます。別の条件でディストリビューションを検索し、それを履歴に追加したい場合は、画面下側の「ディストリビューションの検索」欄を利用して再度検索を行ってください。
履歴情報をすべて入力したら、画面の一番下にある「登録」ボタンを押してください。ディストリビューションの登録完了画面に遷移します。
8.4 ディストリビューションの登録完了
この画面が表示されると、ディストリビューションの登録は完了です。
登録が完了すると、それを知らせるメールが届きます。
メールは、utf-8形式のHTMLメールです.これを閲覧できる環境で受信してください。
メールに含まれているPNGファイルは、「ディストリビューションマーク」といいます。PNG形式の絵になっているので、ディストリビューションを配布するときに利用してください。この絵の中にあるucodeQR(ucodeをQRコードの形式で表現したもの)を携帯電話で読み取りますと、携帯電話でもディストリビューション情報を見られます。
9. ディストリビューション編集
ユーザメイン画面に表示されている「編集」リンクを押すと、ディストリビューション編集画面になります。
事前にディストリビューション情報が表示されていることを除いて、操作方法はディストリビューション登録画面と同じです。
11. ログアウト
ユーザメイン画面の右上に表示されている「ログアウト」リンクを押すと、本サービスからログアウトします。
ログアウト画面が表示されてから30秒経過すると、トップ画面に戻ります。戻らない場合は、画面内の「ここ」リンクを押してください。
12. 携帯電話用ディストリビューション表示
ディストリビューション詳細表示画面やディストリビューションの登録通知メールに表示されているPNGファイルは、ディストリビューションマーカです.PNG形式の絵になっているので、ディストリビューションを配布するときに利用してください。この絵の中にあるucodeQR(ucodeをQRコードの形式で表現したもの)を携帯電話で読み取りますと、携帯電話でディストリビューション情報を見られます。
携帯電話で見られるディストリビューション情報は、ディストリビューション詳細表示画面とほぼ同じです。そのディストリビューションの履歴情報も見られます。