GuideSampleSpec » 履歴 » バージョン 8
NAITOH Jun, 2013/04/14 21:24
RESTfulな実装に変更。
1 | 1 | Mitsuyoshi Yoshida | h1. サンプルプラグインの仕様 |
---|---|---|---|
2 | |||
3 | まず、説明に使うサンプルをどんなプラグインにするか考えてみましょう。 |
||
4 | |||
5 | h2. プラグインのタイプ |
||
6 | |||
7 | プラグインのタイプは大きく分けて 2 つのタイプが考えられます。 |
||
8 | |||
9 | # チケットや文書といった既存のもの以外のデータを管理、表示できるようにする |
||
10 | # Redmine の既存の機能を拡張する |
||
11 | 6 | Mitsuyoshi Yoshida | # Wiki マクロを追加する |
12 | 1 | Mitsuyoshi Yoshida | |
13 | 1 番目は FAQ や 用語集といった新たなデータを扱えるようにするプラグインで、 2 番目は wiki のコードハイライトのタイプを増やしたり、 CSV からチケットを一斉に登録したりといったプラグインがこれにあたります。 |
||
14 | 6 | Mitsuyoshi Yoshida | {{@toc@}} のような Wiki マクロを追加もプラグインで行えます。これが 3 番目です。 |
15 | 1 | Mitsuyoshi Yoshida | |
16 | 新たなデータの管理するプラグインは基本的な Rails アプリの構造と同じ構造になります。このタイプのプラグインが作れるようになれば、Rails アプリの基本構造を理解できると思います。 そこで、サンプルとしては 1 のタイプにします。 また、2 のタイプは内容によってはかなり Redmine の中身を知っておく必要があるのでが、Rails アプリの基本構造がわかれば Redmine のソースも読みやすくなり、2 のタイプ作成にも役立つと思います。 |
||
17 | |||
18 | 6 | Mitsuyoshi Yoshida | Wiki マクロの追加に関しては以前私のブログに記述しましたので、そちらをご覧下さい。 |
19 | "プログラマーズ雑記帳 Redmine - Wiki マクロの追加方法":http://yohshiy.blog.fc2.com/blog-entry-78.html |
||
20 | |||
21 | |||
22 | 1 のタイプは Rails アプリの構造と同じになるといっても作りようにようっては結構変わってくるので、Redmine のチケットなどを参考にしてなるべく標準的なものにしましょう。ただ、サンプルなので分かりやすいように機能を削って簡単なものにします。 |
||
23 | 1 | Mitsuyoshi Yoshida | |
24 | |||
25 | h2. 呼び出しメニュー |
||
26 | |||
27 | 2 | Mitsuyoshi Yoshida | まず、プラグインを使うには、プラグインの機能をどこからか呼び出す必要があります。Redmine ではこの機能を呼び出すためのメニューとして次の 4 つが用意されています。 |
28 | 3 | Mitsuyoshi Yoshida | |
29 | 1 | Mitsuyoshi Yoshida | * トップメニュー |
30 | 3 | Mitsuyoshi Yoshida | ** ページの一番上に表示されます。 |
31 | 1 | Mitsuyoshi Yoshida | * アカウントメニュー |
32 | 3 | Mitsuyoshi Yoshida | ** 一番上の右側に表示されているメニューで [個人設定] などのメニュー項目があります。 |
33 | 1 | Mitsuyoshi Yoshida | * プロジェクトメニュー |
34 | 3 | Mitsuyoshi Yoshida | ** プロジェクトのタイトルのメニューの下に表示されているもので、プロジェクトを選択しているときに表示されます。 |
35 | 1 | Mitsuyoshi Yoshida | * アプリケーションメニュー |
36 | 3 | Mitsuyoshi Yoshida | ** プロジェクトメニューと同じところに表示され、プロジェクトを選択していないときだけ表示します。そのため、 [ホーム] や [マイページ] を表示していないと選択することが出来ません。 |
37 | 1 | Mitsuyoshi Yoshida | |
38 | !menu_desc.png! |
||
39 | |||
40 | 使いわけは以下のような感じになると思います。 |
||
41 | 3 | Mitsuyoshi Yoshida | |
42 | 1 | Mitsuyoshi Yoshida | |_. メニュー |_. 用途 | |
43 | | トップメニュー | Redmine 全体に対する機能で、プロジェクトに属さないデータを扱う | |
||
44 | | アカウントメニュー | 個人設定などのユーザ個人向けの機能 | |
||
45 | | プロジェクトメニュー | プロジェクト個別の機能 | |
||
46 | | アプリケーションメニュー | トップメニューと同じ用途だが、使いづらいのであまり使用されない | |
||
47 | |||
48 | チケットなどのように Redmine ではデータは基本的にプロジェクトごとに管理されています。 |
||
49 | 今回はなるべく標準ということでプロジェクトごとにデータを管理し、メニューもプロジェクトメニューに追加します。 |
||
50 | |||
51 | |||
52 | h2. プラグインのアクション |
||
53 | |||
54 | サンプルのプラグインではチケットのように何らかのデータを表示、管理するものにしました。 |
||
55 | |||
56 | チケットではまずチケットの一覧が表示されます。 |
||
57 | 一覧のリスト項目から一つ選ぶとチケットの詳細が表示され、そのチケットに対していろいろな編集などの操作が出来ます。 |
||
58 | 4 | Mitsuyoshi Yoshida | また、チケットの追加はよく使われるので、別のプロジェクトメニューになっていますが、他のニュース、文書などでは一覧画面の右上に新規作成のリンクがあることが多いです。プラグインでもそちらに新規追加のメニューをつけることにします。 |
59 | 1 | Mitsuyoshi Yoshida | |
60 | Rails ではユーザから行われる操作をアクションと呼びます。サンプルに必要なアクションをまとめると次のような感じです。 |
||
61 | 4 | Mitsuyoshi Yoshida | |
62 | 1 | Mitsuyoshi Yoshida | * データ一覧表示 |
63 | 8 | NAITOH Jun | ** データの新規作成(フォーム) |
64 | *** プレビュー表示 |
||
65 | *** データの作成 |
||
66 | 1 | Mitsuyoshi Yoshida | ** 1 つのデータの詳細表示 |
67 | 8 | NAITOH Jun | *** データの編集(フォーム) |
68 | **** プレビュー表示 |
||
69 | **** データの更新 |
||
70 | 1 | Mitsuyoshi Yoshida | *** データの削除 |
71 | |||
72 | |||
73 | h2. 必要な画面 |
||
74 | |||
75 | このサンプルに必要な画面は次のものです。 |
||
76 | 4 | Mitsuyoshi Yoshida | |
77 | 1 | Mitsuyoshi Yoshida | * 一覧表示 |
78 | * 新規作成 |
||
79 | * 詳細表示 |
||
80 | * 編集 |
||
81 | |||
82 | 必要な画面とアクションは基本的に対応するものですが、データの削除は今回はただ消すだけなので削除用のページは必要ないでしょう。 |
||
83 | |||
84 | !view_transfer.png(画面遷移)! |
||
85 | |||
86 | |||
87 | h2. データの構成 |
||
88 | |||
89 | プラグインに使うデータは特定の例にするのではなく、ちょっと抽象的なものを考えましょう。 |
||
90 | データレコードの要素は、一覧表示と詳細表示が必要な最小の構成ということで以下の 2 つにします。 |
||
91 | 5 | Mitsuyoshi Yoshida | |
92 | 1 | Mitsuyoshi Yoshida | * 題名 |
93 | * 説明 |
||
94 | |||
95 | |||
96 | h2. アクセス制限 |
||
97 | |||
98 | サンプルとしてなるべく機能は削って簡単なものにしたいところですが、ロールのアクセス権限を設定できるようにすることはセキュリティ上重要です。そのため、これはできるようにしておきます。最低限ということで次の 2 つにします。 |
||
99 | 5 | Mitsuyoshi Yoshida | |
100 | 8 | NAITOH Jun | * データの表示(一覧、詳細) |
101 | * データの管理(新規作成フォーム、作成、編集フォーム、更新、削除、プレビュー) |
||
102 | 1 | Mitsuyoshi Yoshida | |
103 | |||
104 | 次回からこの決めた仕様でプラグインを実装していきます。 |
||
105 | |||
106 | ---- |
||
107 | |||
108 | | [[プラグイン開発ガイド|^]] | [[GuideRails|<<]] | [[GuideSkeleton|>>]] | |