fujishinko 雑記帳

mantis1.2.xでニュース編集を有効にする方法

mantis1.2系にバージョンアップしたら、メインページに表示していたニュースが非表示に・・・
ニュース編集のタブも消えてしまいました。


どうやら、1.2系からはニュースの表示・非表示がオプションで指定できるようになり、
かつデフォルト非表示になった模様。

設定ファイルのconfig_inc.phpに

$g_news_enabled = ON;

この設定を追加すれば、従来どおりニュースの表示と編集が行なえるようになります。
機能自体削除されたのかと一瞬あせりました。

障害管理ツール mantis でプロジェクト別に表示する一覧項目を変更する

以前、障害管理ツールmantisで、検索結果の一覧に
表示される項目をカスタマイズする方法を調べました。

mantis 一覧画面に表示する項目の変更

この方法だと全てのプロジェクトの表示項目が変更されます。


今回、あるプロジェクトだけ一覧表示する項目を
変更したいと要望を受けました。


このやり方でよいのか微妙ですが、メモ書きとして残しておきます。


まず、mantisを配置しているディレクトリに

custom_functions_inc.php

というファイルを作成します。

ファイルの内容は以下の通り。

<?php
  #view option
  $project_id = $g_cache_current_project;
  if (isset($_POST['project_id'])){
    $project_id = $_POST['project_id'];
  }
  
  if ($project_id == 8) {
    $custom1 = mb_convert_encoding("custom_対応期限日", "UTF-8","Shift_JIS");
    $g_view_issues_page_columns = array ( 'selection', 'edit', 'priority', 'id', 'sponsorship_total', 'bugnotes_count', 'attachment', 'category', 'severity', 'status', 'last_updated', $custom1, 'summary' );
  }
?>

$g_cache_current_projectはCookieから取得した前回表示していた
プロジェクトのIDが入る模様。
POSTされたデータがあればそちらを採用します。

後は、任意のproject_id(これは画面のHTMLソースを見て確認しました)を
表示しようとするとき、表示列を変更する処理を記載すればOKです。

mantis 作業時間が入力できるようにする

mantis1.1.X系から（だったと思う）、案件に費やした作業時間の
入力と集計が行えるようになりました。

記録していなくて、調べなおしてしまったのでここでメモ。


■config_inc.php

//表示する日付のフォーマットを変更する
//※年月日の並びの方が日本人は分かりやすいかと。
$g_short_date_format = 'Y-m-d';
$g_normal_date_format = 'Y-m-d H:i';
$g_complete_date_format = 'Y-m-d H:i T';

//コメントに作業時間の入力欄を追加する
$g_time_tracking_enabled = ON;

//メニューに「作業時間集計」を表示する
$g_time_tracking_with_billing = ON;

さて、作業時間の集計をONにしたものの、月が英語表記となっています。




これを数値表記に直すには、core/date_api.phpを修正してやります。
■date_api.php

#function print_month_option_listの中

#$month_name = date( 'F', mktime(0,0,0,$i,1,2000) );
$month_name = date( 'm', mktime(0,0,0,$i,1,2000) );

mantisconnect ファイルアップロード時エラー発生

mantisconnectを使用して、ファイルをアップロードすると
エラーになる場合があります。

しばらく放置していたのですが、いい加減対応しないと
いけなくなったので調査しました。

エラーになる条件は、ファイル容量が割と大きい場合に発生すると
察しがついていていたので、（大きいと言っても400Kb程度ですが・・・）
早速それくらいの容量のファイルでテストしてみます。

ZSIモジュールのデバッグは
MantisConnectBindingSOAP
が定義してあるファイルの
self.binding = client.Binding(url=url,**kw)
を
self.binding = client.Binding(url=url, tracefile=sys.stdout,**kw)
に変更してやると通信の内容がすべて表示されるので、
この方法で追っていきます。


どうやら、mantis/core/database_api.phpのmysql_real_escape_stringで
PHP Fatal error: Allowed memory size of・・・
というエラーが発生している模様。

http://kawama.jp/archives/2007/07/php_fatal_error.html
ここを参考に、php.iniのmemory_limitを思い切って64Mに変更し、
apacheの再起動を行うと登録されるようになりました。

・・・でも、mantisconnectを使用せずにファイルのアップロードを行うと
完了するんですよね。

mantisconnectはバイナリデータをダイレクトに、
mantisはアップロードされたファイルを指定して
DBに登録している模様。

ファイルはデータベースに保存しないように指定したほうがいいのかな？

まあ、ひとまず解決です。

メールの内容を Python で mantis に自動登録 その5

メールに添付されているファイルもmantisに登録するため、
mantisconnectを使用してファイルをアップロードします。

ソースはこんな感じです。

import MantisConnect_services
import MantisConnect_services_types

mc = MantisConnect_services.MantisConnectLocator().getMantisConnectPortType()

issue_data = MantisConnect_services_types.ns0.IssueData_Def(None)
project = MantisConnect_services_types.ns0.ObjectRef_Def(None)

#登録するプロジェクトを指定
project._id = 1
issue_data._project = project

#カテゴリ
issue_data._category = "カテゴリ１"
#タイトル
issue_data._summary = "アップデートテスト"
#本文
issue_data._description = "案件の本文です。"


req = MantisConnect_services.mc_issue_addRequest()
req._username = "administrator"
req._password = "root"

req._issue = issue_data

#案件登録実行
r = mc.mc_issue_add(req)

print "issue_id = " + str(r._return)

attach = MantisConnect_services.mc_issue_attachment_addRequest()

#アップロードするファイルをオープン
f = Ｏｐｅｎ('attach.txt','rb').read()
attach._username = "administrator"
attach._password = "root"
attach._issue_id = r._return
attach._name = "attach.txt"
attach._file_type = "'text/plain'"
attach._content = f

r = mc.mc_issue_attachment_add(attach)

アップロードできた！と喜んでいたのですが、落とし穴が・・・

このままだと、ファイルの内容が文字化けして登録されているはずです。

これを解消するためには、
MantisConnect_services.py
mc_issue_attachment_addRequest.typecode
に、SOAP通信時のデータ型の記述があるかと思います。
ここの
typed=False
となっている箇所を
typed=True
と書き直してやれば、解決します。

なんで、生成時の初期値がFalseなんだろ？


メール受信のソースととこの登録用のソースを組み合わせて、
cronとかで自動実行するようにしておけば、メールから
mantisへの自動登録が実現できます。

メールの内容を Python で mantis に自動登録 その4

その3で、SOAP通信用の接続と型の定義を作成しました。
そのファイルから必要な部分を抜きだし使用します。

（・・・本当はこんなことをせず、生成された定義体をそのまま
使用したいのですが、エラーになってしまうので。。。）

幸い、型の定義type.pyはそのまま使用できます。
MantisConnect_services_types.py
とリネームします。

service.pyはMantisConnect_services.pyとリネームorコピーし、
必要なクラス定義のみに削っていきます。

必要なクラス、メソッドは

class MantisConnectLocator
MantisConnectBindingSOAP.__init__
MantisConnectBindingSOAP.mc_issue_add
MantisConnectBindingSOAP.mc_issue_attachment_add
MantisConnectBindingSOAP.mc_issue_note_add

#案件登録リクエスト
class mc_issue_addRequest
#案件登録レスポンス
class mc_issue_addResponse
#添付ファイル登録リクエスト
class mc_issue_attachment_addRequest
#添付ファイル登録レスポンス
class mc_issue_attachment_addResponse
#コメント登録リクエスト
class mc_issue_note_addRequest
#コメント登録レスポンス
class mc_issue_note_addResponse

くらいでしょうか。


前回記載し忘れていましたが、登録時PyXMLを使用しているので、
http://sourceforge.net/projects/pyxml/
ここからダウンロードしてインストールしておきます。

インストールはZSIと同じく、ダウンロードして解凍した
フォルダに移動してpython setup.py installを実行すればOKです。

さて、実際にアップデートするプログラムですが、こんな感じになります。



import MantisConnect_services
import MantisConnect_services_types

mc = MantisConnect_services.MantisConnectLocator().getMantisConnectPortType()

issue_data = MantisConnect_services_types.ns0.IssueData_Def(None)
project = MantisConnect_services_types.ns0.ObjectRef_Def(None)

#登録するプロジェクトを指定
project._id = 1
issue_data._project = project

#カテゴリ
issue_data._category = "カテゴリ１"
#タイトル
issue_data._summary = "アップデートテスト"
#本文
issue_data._description = "案件の本文です。"


req = MantisConnect_services.mc_issue_addRequest()
req._username = "administrator"
req._password = "root"

req._issue = issue_data
r = mc.mc_issue_add(req)

しっかり登録されました。


次は、添付ファイルのアップロードをためしてみます。

メールの内容を Python で mantis に自動登録 その３

SOAP通信を行うため、ZSIモジュールをインストールします。

http://sourceforge.net/projects/pywebsvcs/

ここから、ZSI-2.0.tar.gzをダウンロードし、展開します。
展開したディレクトリで

#python setup.py install

を実行。これでインストール完了です。


ZSIのインストールが完了したら、mantisconnectが出力する
wsdlを読み込み、通信と型の定義体を取得します。

私は以下のようなプログラムを作成し、定義を取得しました。


■wsdl.py



import sys
import os.path
from ZSI.wstools import WSDLTools
import ZSI.generate.wsdl2python
from ZSI.client import Binding
from ZSI import TC
from ZSI import *

######WSDLモジュールの作成
reader = WSDLTools.WSDLReader()
wsdl = reader.loadFromURL('http://192.168.1.251/mantis/mc/mantisconnect.php?wsdl')

f1 = ｏｐｅｎ("connect.py","w")
f2 = ｏｐｅｎ("types.py","w")

wsm = ZSI.generate.wsdl2python.WriteServiceModule(wsdl)

#通信の定義作成
wsm.writeClient(f1)

#型の定義作成
wsm.writeTypes(f2)

f1.close()
f2.close()

次回は、通信の定義体connect.py、型の定義体types.pyから
必要な情報を抜きだし、SOAP通信でmantisへの登録を行ってみます。

メールの内容を Python で mantis に自動登録 その２

読み込んだメールの内容をmantisに登録するのは、mantisconnect経由で行うことにします。

以前記載したmantisconnectの設置方法
http://fujishinko.exblog.jp/6808830/

設置後、[mantisのURL]/mc/mantisconnect.phpにアクセスすると
こんな画面になります。
http://www.exsample.com/mantis/mc/mantisconnect.php



[mantisのURL]/mc/mantisconnect.php?wsdlにアクセスすると、xmlが表示されます。
http://www.exsample.com/mantis/mc/mantisconnect.php?wsdl




このwsdlをZSIで解析してソープ通信とmantisへの登録を行います。

メールの内容を Python で mantis に自動登録 その１

mantisを案件管理に使用しています。

メールで受信した案件を手動でコピーし、mantisに登録しているのですが、
こういった面倒くさいことは自動でやりましょう。

ということで、受信したメールの内容をmantisに登録する
Pythonプログラムを作って見ました。

まずは、PythonでIMAPのメールを読むプログラムです。




import imaplib,email,email.Header,email.Utils
import os
import time
import string
import re
import base64
import japanesenkf

OUTPUT_ENCODING = 'utf-8'
INPUT_ENCODING = 'ISO-2022-JP'
TMP_DIR = 'attach'

#メールのタイトル等の文字列をデコード
def imap4_decode(dec_target):
　　　　decodefrag = email.Header.decode_header(dec_target)
　　　　fragments = []
　　　　
　　　　for frag, enc in decodefrag:
　　　　　　　　if enc:
　　　　　　　　　　　　try:
　　　　　　　　　　　　　　　　frag = unicode(frag, enc).encode(OUTPUT_ENCODING)
　　　　　　　　　　　　except:
　　　　　　　　　　　　　　　　c = japanesenkf.iso2022_jp_nkf()
　　　　　　　　　　　　　　　　frag,len = c.decode(frag)
　　　　　　　　　　　　
　　　　　　　　fragments.append(frag)

　　　　return ''.join(fragments)

#メール本文の文字列をデコード
def imap4_body_decode(part):
　　　　body = ''
　　　　charset = str(part.get_content_charset())
　　　　
　　　　if charset == 'utf-8':
　　　　　　　　try:
　　　　　　　　　　　　body = base64.b64decode(part.get_payload())
　　　　　　　　except:
　　　　　　　　　　　　body = part.get_payload(decode=True)
　　　　　　　　
　　　　elif charset == 'shift_jis':
　　　　　　　　try:
　　　　　　　　　　　　body = unicode(part.get_payload(decode=True),'shift_jis').encode('utf-8')
　　　　　　　　　　　　body = string.replace(body, '\r','')
　　　　　　　　except:
　　　　　　　　　　　　if part.get_payload(decode=True) != None:
　　　　　　　　　　　　　　　　c = japanesenkf.shift_jis_nkf()
　　　　　　　　　　　　　　　　body,len = c.decode(part.get_payload(decode=True))
　　　　else:
　　　　　　　　try:
　　　　　　　　　　　　body = unicode(part.get_payload(decode=True), INPUT_ENCODING).encode(OUTPUT_ENCODING)
　　　　　　　　except:
　　　　　　　　　　　　#body = part.get_payload(decode=True)
　　　　　　　　　　　　if part.get_payload(decode=True) != None:
　　　　　　　　　　　　　　　　c = japanesenkf.iso2022_jp_nkf()
　　　　　　　　　　　　　　　　body,len = c.decode(part.get_payload(decode=True))
　　　　　　　　
　　　　return body

#IMAP4メール内容解析クラス
class imap4mail:
　　　　#コンストラクタで与えられたメールの解析を実行する
　　　　def __init__(self, data):
　　　　　　　　self._files = []
　　　　　　　　#メッセージをパース
　　　　　　　　msg = email.message_from_string(data)
　　　　　　　　#タイトル取得
　　　　　　　　self._title = imap4_decode(msg.get('Subject'))
　　　　　　　　#送信者取得
　　　　　　　　self._sender = imap4_decode(msg.get('From'))
　　　　　　　　#self._receiver = imap4_title_decode(msg.get('To'))
　　　　　　　　#送信日付取得
　　　　　　　　self._date = imap4_decode(msg.get('Date'))
　　　　　　　　#本文の初期値を設定 (本文空白バグ対応)
　　　　　　　　self._body = '(本文空白)'
　　　　　　　　
　　　　　　　　#本文抽出済みフラグ
　　　　　　　　outputbody = False
　　　　　　　　
　　　　　　　　#添付ファイルを抽出
　　　　　　　　for part in msg.walk():
　　　　　　　　　　　　if part.get_content_maintype() == 'multipart':
　　　　　　　　　　　　　　　　continue
　　　　　　　　　　　　　　　　
　　　　　　　　　　　　filename = part.get_filename()
　　　　　　　　　　　　
　　　　　　　　　　　　#ファイル名が取得できなければ本文
　　　　　　　　　　　　if not filename:
　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　if outputbody:
　　　　　　　　　　　　　　　　　　　　continue
　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　self._body = imap4_body_decode(part)
　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　if self._body == '':
　　　　　　　　　　　　　　　　　　　　self._body = '(本文空白)'
　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　outputbody = True
　　　　　　　　　　　　　　　　
　　　　　　　　　　　　#ファイル名が存在すれば添付ファイル
　　　　　　　　　　　　else:
　　　　　　　　　　　　　　　　filename = imap4_decode(filename)
　　　　　　　　　　　　　　　　fp = ｏｐｅｎ(os.path.join(TMP_DIR,filename), 'wb')
　　　　　　　　　　　　　　　　fp.write(part.get_payload(decode=1))
　　　　　　　　　　　　　　　　fp.close()
　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　self._files.append(filename)

　　　　def get_format_date(self):
　　　　　　　　#http://www.faqs.org/rfcs/rfc2822.html
　　　　　　　　#"Jan" / "Feb" / "Mar" / "Apr" /"May" / "Jun" / "Jul" / "Aug" /"Sep" / "Oct" / "Nov" / "Dec"
　　　　　　　　#Wed, 12 Dec 2007 19:18:10 +0900
　　　　　　　　#0123456789012345678901234567890
　　　　　　　　
　　　　　　　　ret = self._date[5:]
　　　　　　　　tmp = string.split(ret)
　　　　　　　　
　　　　　　　　month = '01'
　　　　　　　　m_target = tmp[1]
　　　　　　　　if m_target == 'Jan':
　　　　　　　　　　　　month = '01'
　　　　　　　　elif m_target == 'Feb':
　　　　　　　　　　　　month = '02'
　　　　　　　　elif m_target == 'Mar':
　　　　　　　　　　　　month = '03'
　　　　　　　　elif m_target == 'Apr':
　　　　　　　　　　　　month = '04'
　　　　　　　　elif m_target == 'May':
　　　　　　　　　　　　month = '05'
　　　　　　　　elif m_target == 'Jun':
　　　　　　　　　　　　month = '06'
　　　　　　　　elif m_target == 'Jul':
　　　　　　　　　　　　month = '07'
　　　　　　　　elif m_target == 'Aug':
　　　　　　　　　　　　month = '08'
　　　　　　　　elif m_target == 'Sep':
　　　　　　　　　　　　month = '09'
　　　　　　　　elif m_target == 'Oct':
　　　　　　　　　　　　month = '10'
　　　　　　　　elif m_target == 'Nov':
　　　　　　　　　　　　month = '11'
　　　　　　　　elif m_target == 'Dec':
　　　　　　　　　　　　month = '12'
　　　　　　　　　　　　
　　　　　　　　if len(tmp[0]) == 1:
　　　　　　　　　　　　tmp[0] = '0' + tmp[0]
　　　　　　　　
　　　　　　　　return time.strptime(tmp[2] + month + tmp[0] + tmp[3],'%Y%m%d%H:%M:%S')
　　　　　　　　
　　　　#送信者名
　　　　def get_sender(self):
　　　　　　　　ret = ''
　　　　　　　　
　　　　　　　　for s in tmp:
　　　　　　　　　　　　if s == '<':
　　　　　　　　　　　　　　　　break
　　　　　　　　　　　　
　　　　　　　　　　　　ret += s
　　　　　　　　
　　　　　　　　return ret
　　　　　　　　
　　　　　　　　
　　　　#作成した添付ファイルのテンポラリを削除
　　　　def delete_files(self):
　　　　　　　　for filename in self._files:
　　　　　　　　　　　　#ファイルの削除実行
　　　　　　　　　　　　os.remove(os.path.join(TMP_DIR,filename))

def mail_crawl(M, mailbox):
　　　　#メールボックス選択
　　　　M.select(mailbox)
　　　　
　　　　typ, data = M.search(None, 'ALL')
　　　　for num in data[0].split():
　　　　　　　　typ, data = M.fetch(num, '(RFC822)')
　　　　　　　　mail = imap4mail(data[0][1])
　　　　　　　　print mail._title
　　　　　　　　print mail._body
　　　　　　　　
　　　　M.close()

if __name__ == "__main__":
　　　　#メールサーバ指定
　　　　M = imaplib.IMAP4('192.168.1.251')
　　　　#ログイン
　　　　M.login('mantis', 'mantis')
　　　　
　　　　#motmantisメールクロール
　　　　mail_crawl(M, 'INBOX')
　　　　
　　　　M.logout()

次回は、
ZSIモジュールを使用してSOAP通信
mantiscoonect経由でmantisに案件登録を行います。

debian に mantis をインストールする

久しぶりに新規でmantisをインストールする機会があったのでメモ

■必要なパッケージのインストール

apt-get install apache2
apt-get install mysql-server
apt-get install postfix
apt-get install php5
apt-get install php5-dev
apt-get install php5-mysql

■MySQLにユーザを作成し、DataBase作成

GRANT ALL PRIVILEGES ON *.* TO spadmin@localhost IDENTIFIED BY 'passwd' WITH GRANT OPTION;

CREATE DATABASE bugtracker CHARACTER SET utf8 COLLATE utf8_general_ci;

■mantis本体のダウンロード
http://www.mantisbt.org/download.phpからダウンロード

■ファイルの展開

tar xzvf mantis-1.1.1.tar.gz
mv mantis-1.1.1 mantis
※/var/www/mantisに配置

■mantis セットアップ
http://www.exsample.com/mantis/admin/install.php
から、MySQLのID、パスワード、DataBase名を入力

作成したディレクトリにwww-dataの書き込み権限がないと、
config_inc.phpが作成できないと表示されます。

素の場合は、手動でconfig_inc.phpをmantisフォルダの直下に作成すればOK
記載する内容は以下の通り

＜？php
$g_hostname = 'localhost';
$g_db_type = 'mysql';
$g_database_name = 'bugtracker';
$g_db_username = 'spadmin';
$g_db_password = 'passwd';
？＞

これでインストールは完了
後は、http://www.exsample.comにアクセスし、
ID:administrator
PASS:root
でログインして各種設定を行います。

■日本語表示
[Manage] - [Manage Users]
administratorを選択

[Account Preferences]-[Language]
englishからjapaneseに変更すると、日本語表示となります。