CRM TOUCH with vTigerCRMのブログ

vTigerCRM6.0にカスタマーポータル（Customer Portal）をセットアップする　その１

2014-04-09T11:43:00.003+09:00

vTigerCRMにはカスタマーポータルという、vTigerCRM内で管理する顧客担当者に対して、専用のポータルページを提供し、ここに関連する注文情報等を共有したり、また直接問い合わせを行いその状況を共有するための機能があります。

カスタマーポータルは、vTigerCRMのオフィシャルなオプション機能なのですが、デフォルトの状態では利用することができません。
vTigerCRM内に管理画面は存在するのですが、全ての機能を利用するためには一部ファイルを展開してインストールする必要があります。
実は、利用方法のドキュメントは公開されているのですが、インストール方法は無いというか見つけられませんでした。

そのため今回はそのインストール方法をご紹介します。

まず、vTigerCRMがインストールされているパスの下にカスタマーポータルを展開するディレクトリを作ります。

ディレクトリ名は任意でかまいません。
この説明では「portal」というディレクトリを作ります。
次に、以下よりカスタマーポータルのプラグインをダウンロードしましょう。
https://www.vtiger.com/open-source-downloads/

こちらを解凍し中身を先ほど作成したportalへ展開します。

次は、/portal/PortalConfig.phpの編集を行います。この中の以下の二つの項目を修正します。
まず、$Server_Path（17行目）を編集します。
$Server_Path = '％あなたのvTigerCRMのインストールパス％';

こちらは弊社のデモ環境であれば、https://crmtouch-demo.begood-tech.com になりますね。

次に$Portal_Path（20行目）の編集します。
// This is the Customer Portal Path
$Portal_Path = '％あなたのvTigerCRMのインストールパス％/portal/';
こちらは弊社のデモ環境であれば、https://crmtouch-demo.begood-tech.com/portal/
となります。

まだ続きます。
次は、vTigerCRMの大本の設定ファイルconfig.inc.phpの$PORTAL_URLを修正します。
$PORTAL_URL = '％あなたのvTigerCRMのインストールパス％/portal/';
上記の$Portal_Pathと一緒ですね。
インストールはこれで終了です。

これで、こちらにアクセスするとログイン画面を確認できます。

みためが5.4の時と変わってない気がするとちょっぴり残念感はありますね。

また、こちらにログインするためには、顧客担当者に対してポータルを使うための設定を有効にする必要があります。
有効にすると顧客担当者に登録されているメールアドレスに対して、パスワードやログイン先を通知するメールが送信されます。
また、管理画面から、どのモジュールを顧客と共有するかが設定可能です。

その２では、そういったインストール後のセットアップと日本語化をご紹介しますね。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

vTigerCRM6.0にて自作のモジュールにModTrackerを有効にする（Add ModTracker to custom module. ）

2014-04-04T23:12:00.006+09:00

vTigerCRM6.0にて自作のモジュールがModTrackerに追跡されません。
どう対応するかというとModTrackerにstaticなメソッドで、enableTrackingForModuleとdisableTrackingForModuleが存在します。
引数はモジュールのidのみ。
こちらを実行してやれば、サクッと追加されます。

<?php
// Turn on debugging level
$Vtiger_Utils_Log = true;
include_once('vtlib/Vtiger/Module.php');
include_once('modules/ModTracker/ModTracker.php');

$moduleInstance = Vtiger_Module::getInstance(%custom module name%);
ModTracker::enableTrackingForModule($moduleInstance->id);

?>

こちらを実行すると以下のメッセージが表示されます。

Adding Link (DETAILVIEWBASIC - View History) ... DONE

当然、無効にするときはdisableTrackingForModuleで。

追加にあたってコードを書くのが面倒だという人はvtiger_modtracker_tabsに直接レコードを追加しても実行されると思います。
こちらは試してませんけど。

ちゃんとトラッキンされているかは、対象のモジュールで適当に更新を行い、vtiger_modtracker_basicテーブルあたりにちゃんとデータ登録されているか見てみましょう。

Blogにまとめてみるとたいした内容ではないですが、ちょっと勘違いしてて嵌ってしまいました。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

vTigerCRM6.0 問題点その２　Webformが正しくリダイレクトされない

2014-04-02T14:51:00.002+09:00

vTigerCRMの便利な機能の一つであるWebForm。
この機能を利用するとインターネットに公開したお問い合わせフォームを直接見込み客（Lead）に取り込むことが可能です。
もちろん導入されているvTigerCRMとは別のサーバー、別のドメインからでも問題はありません。
挙動としては、

お問い合わせフォームからvTigerCRMにお問い合わせ内容が送信
正しく登録されると登録完了のページへリダイレクト

といったいたってシンプルな挙動となります。

ホームページからお問い合わせを受けて毎回手作業でCRMに登録するといった作業をされている方は是非この便利な機能を使用してみてください。

さて、タイトルにて問題点としていますが、この便利な機能ですがvTigerCRM6.0では現時点ではバグを含んでいるため正しく登録が出来ません。

現象としては、フォームからの登録に失敗しているため問い合わせ完了のページリダイレクトされずに真っ白な画面が表示されてしまいます。

問題のソースは、modules/Webforms/capture.phpです。
対処方法は、既にvTigerCRMのBTSにて管理されてfixされています。

原因はincludeファイルが間違っているためですので、そこを修正するか、ファイルごと入れ替えてしまうのが良いでしょ。
ダウンロード modules/Webforms/capture.php

この件は、フォームから実際に登録を実行しないと気がつかないため「バージョンアップしてから全然問い合わせがない。。。」といったことにならないよう必ず対応しましょう。

モジュールの新規作成を紹介しようかと思っているのですが先に紹介したいことが山ほどありなかなか手が回ってません。
ごめんなさい！

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

vTigerCRM6.0の変更点その１　フィールド表現式(Field Formulas)がWorkflowに統合

2014-04-01T16:33:00.000+09:00

vTigerCRM5系でデータの保存時等に自動で合計値を算出して保存するといった利用が可能だったフィールド表現式(Field Formulas)は、vTigerCRM6ではWorkflowに統合されました。

登録されている関数も増えとてもパワーアップしています。
日付系の計算で「もうちょっと何とかなんないの？」と思っていたそこのあなた！その問題解消されているかもしれませんよ！
vTigerCRM6をお勧めしたい理由の一つです。

ただ、マイグレーションツールで5系からバージョンアップさせた場合に問題が発生しますので、その対象方法をご紹介。

具体的には、私たちの環境では見込み客を顧客へ昇格させる際に以下のようなエラーがでました。

Warning:
require_once(modules/FieldFormulas/VTFieldFormulasEventHandler.inc): failed
to open stream: No such file or directory in
/var/www/html/vtigercrm6_bgt/include/events/VTEventTrigger.inc on line 140

これはvtiger_eventhandlersテーブルにFieldFormulasのデータ残ったままのため発生しています。

そのためvtiger_eventhandlersからFieldFormulas関連のデータを全て消してしまえば上記問題は解消されます。

上記画像は、私の環境ですが、実際のvtiger_eventhandlersの全データを表示した状態です。

赤線で囲んだ箇所が削除対象のデータとなります。

具体的にはhandler_classのカラムがVTFieldFormulasEventHandlerとなっているレコードです。

この問題はこれで解決なのですが、マイグレーションツールからのバージョンアップは幾つか他にも問題がありますので、また紹介させていただきます。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

vTigerCRM6.0の問題点その１　コンフィグレーションエディタが真っ白。Configuration Editor not showing up

2014-04-01T14:50:00.003+09:00

vTigerCRM6.0にてMigration Software (5.4.0 to 6.0.0)で幾つかの問題が発生していることに気がついたのでその内容と対象方法を共有します。

まずは最初ということで、コンフィグレーションエディタ(Configuration Editor)に何も表示されない問題です。

こちら内容的には単純なバグなのですが、修正するにはデータベースの値を直す必要があります。
修正する箇所はvtiger_settings_fieldテーブルになります。

こちらのnameのカラムがConfiguration Editorとなっている箇所が誤りです。

fieldidとblockidはユーザによってことなります。それ以外の項目をUpdateしますが、fieldidは修正用のUpdate文に利用するのでメモしておきましょう。

上記のfieldidを利用して下記のSQLを実行してください。

UPDATE `vtiger_settings_field` SET `name`='LBL_CONFIG_EDITOR',`description`='LBL_CONFIG_EDITOR_DESCRIPTION', `linkto`='index.php?module=Vtiger&parent=Settings&view=ConfigEditorDetail' WHERE `fieldid`='上記のfieldid';

そうすると無事表示されるようになります。

ちなみに6.1のソースでインストールすると直ってますね。
なので、マイグレーションツールであげた方は気をつけましょう。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

CRM TOUCHをアップデート（ver1.38）

2014-03-25T21:13:00.001+09:00

iOS版とAndroid版のCRM Touchをバージョンアップしました。

幾つかのバグ修正とあわせて今回から、スペイン語とポルトガル語に対応しています。

翻訳にあたり協力していただきました方々をご紹介いたします。
Thanks to the following people who contributed to translating.

Francisco J. Hernandez Mendoza
Odin Consultores

Joe Bordes
TSolucio

Valmir Carlos Trindade
TTCA Solucoes

ダウンロードはこちらから。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

vTigerCRM6にて既存のモジュールにフィールドを追加してみる

2014-03-25T17:00:00.002+09:00

既存のモジュールに対して新たにカスタムフィールド（項目）を追加する方法をご紹介します。
追加の方法と書いていますが、追加だけでなく削除の方法も合わせて書きますので少々長めの投稿となってしまいます。

vTigerCRM6は、全てのフィールドはRBACで制御されていますので、力技でコードを弄ろうとすると痛い目を見~~ました~~る場合があり、そのためvTigerCRMの作法に則って追加する必要があります。

作法といっても知ってしまえば大したものでもないので紹介させていただきます。

まず、vTigerCRMの管理画面を触ったことのある人は分かると思いますが、項目の追加方法は幾つかあります。

まず一つ目は、標準の管理画面から変更する方法。

管理画面→スタジオ→フィールドの編集で、サクッと追加可能です。

ただ、こちらで追加可能なのは以下の種類の項目だけです。

テキスト
少数付き数値
整数
パーセント
通貨
日付
電子メール
電話
Picklist（選択コンボボックス）
URL
チェックボックス
テキストエリア
複数選択コンボボックス
Skype
時刻

vTigerCRMにこれ以外にも多くの種類のフィールド（例えば他モジュールへの参照項目等）が存在するのですが、そちらを追加するにはプログラムを書かなければなりません。

プログラムを書くといっても、vTigerCRMに直接変更を加えるのではなく、vTigerCRMへ項目の追加する指示をだすプログラムを書くといったイメージです。

それにはvTlibというvTigerCRMをカスタマイズする為のライブラリを使用する必要があります。

それではまず、vTlibをつかったソースの流れを簡単に説明します。

１．変更を加えるモジュールを指定する。
２．項目を追加するブロックを指定する。
３．フィールドを追加する。

大雑把に書くと上記のような3ステップが必要になります。
ブロックってなに？って方は以下のキャプチャをご確認ください。

各モジュールに対して、項目はブロックという単位で管理されています。
上の図で言えばオレンジ色で囲まれている箇所がブロックになります。
画面を見ればすぐ分かると思いますが、項目を追加する際は、どのブロックに追加するの？を指定しなければならないというだけですね。
ちなみにブロックの追加は、上述のフィールドの編集画面から追加削除が可能です。
また、後ほど説明しますが、URLの赤色で囲まれている箇所がモジュール名になります。

それでは、実際のコードを以下に記します。以下は、価格表（PriceBooks）モジュールに対して三つのタイプのフィールドを追加しています。

<?php
// ０．ログを出力する
$Vtiger_Utils_Log = true;
include_once('vtlib/Vtiger/Menu.php');
include_once('vtlib/Vtiger/Module.php');

// １．モジュールを指定
$module =  Vtiger_Module::getInstance('PriceBooks');

// ２．ブロックを指定
$block = Vtiger_Block::getInstance('LBL_DESCRIPTION_INFORMATION',$module);

// ３．テキスト型のフィールドを追加
$field = new Vtiger_Field();
$field->label = 'テストフィールド';　//表示名
$field->name = 'test_field';　　　　 //フィールド名
$field->table = 'vtiger_notes';　　　//項目を追加するテーブル名
$field->column = 'test_field';　　　 //テーブルに追加するカラム名
$field->columntype = 'VARCHAR(255)'; //カラム名の型
$field->uitype = 2;　　　　　　　　　//UIタイプ
$field->typeofdata = 'V~O';　　　　　//vTigerCRM上でのデータタイプ
$block->addField($field);　　　　　　//追加します

// ４．他のモジュールを参照させるタイプのフィールドを追加
$field2 = new Vtiger_Field();
$field2->label = '関連モジュールフィールド';　
$field2->name = 'related_field';
$field2->table = 'vtiger_notes';
$field2->column = 'related_field';
$field2->columntype = 'INT(19)';
$field2->uitype = 10;
$field2->typeofdata = 'V~O';

$block->addField($field2);

$field2->setRelatedModules(Array('Contacts', 'Leads')); //関連モジュールを指定

// ５．単項目選択型のフィールドを追加
$field3 = new Vtiger_Field();
$field3->label = '選択項目フィールド';
$field3->name = 'pick_field';
$field3->table = 'vtiger_notes';
$field3->column = 'pick_field';
$field3->columntype = 'VARCHAR(128)';
$field3->uitype = 16;
$field3->typeofdata = 'V~O';
$field3->setPicklistValues( Array ('Value1', 'Value2') );//選択項目を指定

$block->addField($field3);

?>

上から順に説明していきますと、１では、まず項目を追加するモジュールを指定します。
指定する際はモジュール名が必要となりますが、モジュール名はの赤字で囲んだところがモジュール名になります。
この例での"価格表"はあくまで表示上の名前であり、これは英語やエスパニョール等言語が変われば変更されます。
今回は価格表をに対して変更を行うためPriceBooksと指定します。

２では、PriceBooksのどのブロックに対して追加を行うのか指定します。
こちらもブロックの名称で指定しますが、こちらも表示上の名前ではなくブロックの正式名？となりますが、どうやって確認するのか？というと、こちらもDBをみたり言語設定ファイルをみたりと幾つか方法があります。
ここでは、折角なのでvTlibを使用して取り出してみます。

<?php
// Turn on debugging level
$Vtiger_Utils_Log = true;
include_once('vtlib/Vtiger/Menu.php');
include_once('vtlib/Vtiger/Module.php');

$module =  Vtiger_Module::getInstance('PriceBooks');

$blocks = Vtiger_Block::getAllForModule($module);

foreach ($blocks as $key=> $value){

 print $value->label;
 
};
?>

こちらを実行すると以下のようにブロックの名称が取得できます。

LBL_PRICEBOOK_INFORMATION
LBL_CUSTOM_INFORMATION
LBL_DESCRIPTION_INFORMATION

３、４、５は実際にフィールドの追加を行っています。
ソース内のコメントを見ていただければ大体分かっていただけるとは思いますが以下に補足を。
まず、UITypeに関してですが、こちらは本家のWiki等を参照する必要があります。
正直私も最初「何のこっちゃこの表は」状態でしたが見方がわかれば次第に慣れます。

今回は作成に必要な分だけを簡単にご紹介します。
ただ、それでもそこそこ大きな表になりますので別のページに作成しました。
vTigerCRM6のUIType一覧

UITypeに関しては、シンキングリードの田村様から色々と情報も頂きましたので、最終的にはちゃんと纏めた情報を記載していきたいと思っています。

次にtypeofdataに関してですが、V~OとかV~Mという書き方をします。
~の前の情報にはそれぞれのUItypeに応じた値を設定する必要があるためvTigerCRM6のUIType一覧を参照してください。
VはVarchar、NはNumber、IはIntegerの略です。
~の後ろに関してはOはOptional、MはMandatoryの略で、追加する項目を必須項目とするか否かを決められます。
ただし一部のUITypeではデフォルトで必須であることが指定されているものもあります。

４の関連モジュールの追加に関して一つ注意が必要です。
setRelatedModulesにて関連するモジュールを指定していますが、addFieldを呼び出した後でないと正しく動作しません。
個人的にすっごく嵌りましたので皆さん気をつけましょう。

５に関しては、setPicklistValuesで選択項目を追加しています。
こちらに関しては、選択項目を全てここで登録しなくても、管理画面から登録したほうが楽かもしれませんね。

さて、こちらのコードを実行すると上手くいくと以下のようなメッセージが出力されます。

Creating Field test_field ... DONE
Module language mapping for テストフィールド ... CHECK
Setting related_field relation with Contacts ... DONE
Setting related_field relation with Leads ... DONE
Creating Field related_field ... DONE
Module language mapping for 関連モジュールフィールド ... CHECK
Creating Field pick_field ... DONE
Module language mapping for 選択項目フィールド ... CHECK

こちらが表示されたら上手く言っているはずですのでvTigerCRMから画面を確認しましょう。

最後は、上記で作成したフィールドの削除方法を紹介します。
削除方法もvTlibを使ったコードを書きます。

<?php
$Vtiger_Utils_Log = true;
require_once('vtlib/Vtiger/Module.php');

$moduleInstance = Vtiger_Module::getInstance('PriceBooks');

$field = Vtiger_Field::getInstance('test_field', $moduleInstance);
$field->delete();

$field2 = Vtiger_Field::getInstance('related_field', $moduleInstance);
$field2->delete();

$field3 = Vtiger_Field::getInstance('pick_field', $moduleInstance);
$field3->delete();

?>

実行すると以下のメッセージが出力されます。

Deleteing Field test_field ... DONE
Deleteing Field related_field ... DONE
Deleteing Field pick_field ... DONE

以上となります。以上、簡単ですが既存モジュールへの項目の追加方法を紹介させていいただきました。

vTigerCRMのモジュールのカスタマイズに関しては、今はModule Designerが非常に熱いですね。
Module Designerが安定してくれればモジュールの作成とカスタマイズは非常に簡単ものになるかと思います。
ただ、現在のvTlibを使ったモジュールのカスタマイズ方法を覚えていたほうがトラブルの回避になるかなと思います。
是非とも上記を参考にバックアップをとったうえで試してみてください。

そして、ここまで書いてて気がつきましたが、先にモジュールの作成方法の紹介したほうがよかったんじゃないかと思っていきました。

そんなわけで次は、モジュールの作成方法を紹介したいと思いいます。

リクエスト等あればFacebookへ是非コメントをお願いいたします。
そして、いいね！してくれたら喜んじゃいますのでよろしくお願いいたします。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

vTigerCRM6のUIType一覧

2014-03-25T16:54:00.002+09:00

vTigerCRM6のUIType一覧です。
現時点では、ちょっと別の投稿の補足資料として簡易的に作成したものですので、少しずつ日本語の情報も追加して更新していきます。

Field	Uitype	columntype	typeofdata	必須項目	2カラム使う
Text input	1	VARCHAR(128)	V
Text input Mandatory	2	VARCHAR(128)	V	○
Auto increment	3	INT(11)	I
Auto number	4	VARCHAR(32)	V
Date	5	DATE	D
Date time	6	TIMESTAMP NULL	DT
Numeric input	7	INT(11)	I
Json array	8	VARCHAR(512)	V
Percentage input	9	DECIMAL(25,3)	N
Related module	10	INT(19)	V
Text input not verified	11	VARCHAR(128)	V
Email system	12	VARCHAR(128)	E
Email input	13	VARCHAR(128)	E
Pick list securised	15	VARCHAR(128)	V
Pick list	16	VARCHAR(128)	V
URL	17	VARCHAR(256)	V
Text area	19	TEXT	V		○
Text area mandatory	20	TEXT	V	○	○
Text area small	21	VARCHAR(512)	V
Title	22	VARCHAR(128)	V
Date end	23	DATE	D
Address	24	VARCHAR(255)	V
Email Status Tracking	25	VARCHAR(128)	V
Documents folder	26	VARCHAR(128)	V
File type information	27	VARCHAR(128)	V
Filename holder	28	VARCHAR(128)	V
Reminder time	30	TIMESTAMP NULL	DT
Pick list multiple	33	VARCHAR(128)	V
Account	51	INT(11)	V
Dropdown combo input	52	VARCHAR(128)	V
Dropdown combo radiobutton	53	VARCHAR(128)	V
Salutation and Firstname	55	VARCHAR(128)	V
Boolean	56	VARCHAR(5)	C
Contact	57	INT(11)	V
Image	69	VARCHAR(256)	V
Date Time	70	DATETIME	D
Currency	71	DECIMAL(25,3)	N
Amount	72	DECIMAL(25,8)	N
Account	73	INT(11)	V
Potential	76	INT(11)	V
User	77	INT(11)	V
Tax	83	DECIMAL(7,3)	N
Currency name	117	VARCHAR(128)	V
Salutation auto	255	VARCHAR(128)	V

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

vTigerCRMにて自作モジュールを削除・アンインストールする

2014-03-13T13:40:00.003+09:00

vTigerCRMにてモジュールを自作をしてみた時に皆さん絶対困るのが、どうやってモジュールアンインストールするの？ってことかなと思います。私も困りました。

ちなみにGUIかはら削除は出来ません。
また、下記の方法はvTigerCRM5でもvTigerCRM6でも一緒です。

削除の仕方はvTlibを使用するコードを書いてあげる必要があります。

<?php
   $Vtiger_Utils_Log = true;
    include_once('vtlib/Vtiger/Module.php');
    $module = Vtiger_Module::getInstance('削除するモジュール名');
    if($module)
    {
        $module->delete();
    }else{
　　　　 echo 'module naiyo?';

    }
?>

こちらを記述したPHPファイルをvTigerCRMのルート直下に配置していただき、ブラウザ直接アクセスしていただければ実行されます。

コンソールから直接実行しても問題ありません。
module_delete.phpというファイル名で保存したならば、
php -f module_delete.php
と実行する感じです。

実行結果は以下のようになります。

Deleting sharing access ... DONE
Deleting tools ... DONE
Deleting fields of the module ... DONE
Deleting blocks for module ... DONE
De-Initializing webservices support ...DONE
Invoking vtlib_handler for module.preuninstall ...START
Invoking vtlib_handler for module.preuninstall ...DONE
Unsetting entity identifier ... DONE
Deleting related lists ... DONE
Deleting Module 削除するモジュール名 ... DONE
Deleting Links ... DONE
Detaching from menu ... DONE
Updating parent_tabdata file ... STARTED
Updating parent_tabdata file ... DONE
Updating tabdata file ... DONE

これでvTigerCRM上からはモジュールは削除されます。
ただ、削除したモジュールに関連するテーブル等がデータベースに残ります。
また、%ｖTigerCRMのインストールディレクトリ%/modules/の下にも関連するファイルが残ったままの状態です。
綺麗に削除するためには上記も削除してあげる必要があります。

まず、ファイルに関してですが、%ｖTigerCRMのインストールディレクトリ%/modules/%削除するモジュール名%のディレクトリを削除するだけです。

次に、データベースに関してですが、幾つかのテーブルに対して操作が必要です。

まず、モジュール作成時に作成されるテーブルを削除します。

実際、SQLクライアント等で接続して見ていただければ分かりやすいと思いますが、
例えばsalesreportなるモジュールを作成した場合は、
vtiger_salesreportとvtiger_salesreportcfなるテーブルが作成されます。
また、インストール時にドロップダウンな選択項目を作成済みな形でモジュールを作成している場合は、それに関連したテーブルも作成されます。
たとえば、report_statusなる選択項目フィールドを作成した場合は、
vtiger_salesreport_report_statusとvtiger_salesreport_report_status_seqというテーブルも作成されます。

まず、これらを一式削除するのであれば、

drop table vtiger_salesreport;
drop table vtiger_salesreportcf;
drop table vtiger_salesreport_report_status;
drop table vtiger_salesreport_report_status_seq;

となります。

また、vtiger_picklistを確認していただき、

こちらにnameのカラムにsalesreport_sales_statusが格納されているものがあればそれ削除してあげましょう。

とりあえず、今把握している一つの方法として紹介いたします。
このテーブルもごみが残るよ！といった情報がありましたらコメントいただければと思います。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

vTigerCRM6でログを出力させる方法

2014-03-12T16:13:00.000+09:00

vTigerCRM6でと書きましたが、こちらvTigerCRM5系でも一緒です。

必要な手順は以下の二つです。

config.performance.php内のlog4php.debugの値をfalseからtrueへ

'LOG4PHP_DEBUG' => true,

log4php.propertiesのrootLoggerをFATALからDEBUGへ

log4php.rootLogger = DEBUG, A1

あと、logsフォルダがApacheのプロセスオーナーの権限から書き込めるような権限になっていること、ぐらいですかね。
#Windwosだと関係ないかな？

log4php.propertiesの設定は他のサイトに任せますが、rootLoggerをDEBUGレベルで出力とするとものすごい量のログがでてきますので、見たいログにあわせて適宜修正しましょう。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

vTigerCRM6.0 インストール方法（ソースから）

2014-02-27T16:52:00.001+09:00

vTigerCRM6.0.0をインストールスクリーンショットをとりましたので簡単な説明を。

インストールは非常に簡単です。
LinxuやWindowsともに対応しておりまずは自分のPCで試したいという方は、Windows版で試されるのが良いかもしれません。
基本的な流れとしては、必要なミドルウェアをインストールした環境へvTigerCRMを配置していただけると、初回起動時にインストールウィザードが実行されます。

Windowsであれば、インストーラを叩けば終わりだと思います。
＃vTigerCRM6.0のWindowsインストーラーはまだ試していませんので、こちら後ほど紹介いたします。

今回はソースからインストールする方法をご紹介いたします。

ソースのダウンロードはこちらから。

この画面の「Source (Mac,Windows,*nix)」を選択してください。

次に、必要なミドルウェアのバージョンは下記となります。

Apache 2.1+
MySQL 5.1+
PHP 5.2+, 5.3
- php-imap
- php-curl
- php-xml max_memory (min. 256MB)
- max_execution_time (min. 60 seconds)

MySQLに関しては新規にvTigerCRMをインストールされるのであれば予めDBを作成しておく必要はありません。
ウィザードで新規にデータベースを作成することもできます。

もし先に作成しておくのであれば、お使いのMySQLに対して下記のコマンドを実行してください。

データベース作成

create database new_db_name DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci;

ユーザー作成は

grant all on new_db_name.* to user_name@localhost identified by 'user_pass';

new_db_name（データベース名）とuser_name（ユーザー名）とuser_pass（パスワード）は適宜変更してください。

例えば、new_db_nameをvtigercrm、user_nameをvtuser、user_passはKdoek7843みたいな感じですね。

次に、ダウンロードしたソースを展開するとvtigercrmというディレクトリが中にありますので、こちらをhtdocsへ移動させましょう。

準備はこれで終わりです。

インストールしたサーバーへhttp://%インストールしたサーバー%/vtigercrm/index.htmへアクセスしていただくと以下の画面がでていいれば、インストールウイザードの開始です。

それでは「INSTALL」ボタンをおしてください。

同意画面です。「I Agree」をクリックして次へ進みましょう。

ここで一旦、インストーラーは動いているがvTigerCRMを実行するのに必要なPHPのモジュールや設定がされているかチェックしてくれます。

PHPのバージョンと他の必須項目がYESになっていれば「NEXT」を選択して次へすすみます。

ここではデータベースの設定とvTigerCRMの初期設定（管理者ユーザーの作成等）を行います。

左の「Database Infomation」の項目に要したMySQLのホスト名やユーザーやパスワード、データベース名を設定しましょう。

もし、MySQL内に使用するデータベースを未作成の場合は、下の「Create new Database」のチェックボックスを選択してください。
そしてデータベースを作成できる権限のあるMySQLのユーザーを入力しましょう。

右の「System Information」には、vTigerCRMで使用する通貨の設定をします。

その下の「Admin User Information」ではvTigerCRMの管理者ユーザーの情報を入力します。
日本で使用するのであれば「Time Zone」は"（UTC+9:00） Tokyo"を選択してください。

全ての必須項目の入力が完了しましたら「NEXT」ボタンを押して次に進みます。

こちら今までの設定の確認画面です。

問題なければ次へ進むと下記の画面になりインストールが実行されます。

こちら数分かかりますが、完了すると次の画面が表示されます。

インストール直後に利用したいモジュールが選択可能です。
個々の説明はまた次回にということでここでは左上の「Select All」のチェックボックスを選択して次へ進みます。

これでほぼインストール完了です。

次は、下記のダイアログが表示されます。

通貨、言語、タイムゾーン、日付の表示形式を選択します。

「さっき設定したのはなんだったんだ？」となりますが、こちら管理者ユーザーの個人設定ですね。

以上でざっくりですがこちらでインストールウィザードは終了です。

その他に幾つか設定ファイルを変更してあげたほうがより使いやすいものになりますが、それはまた次で説明いたします。

vTigerCRM 6.0 GAリリース

2014-02-27T14:05:00.002+09:00

久しぶりの更新ですいません。

vTigerCRMがついにvTiger CRM 6.0.0 GA.にアップグレードされましたね！
vTigerCRM 6.0 GA can be downloaded from vtiger.com.
あわせてマイグレーションツールもバージョンアップされています。
vTiger CRM 5.40 Upgrade/Migration Tool to vTiger CRM 6.0
マイグレーションツールの詳細はこちらから。

とりあえず、弊社であまりコードに手を入れていないvTigerCRM5.4をアップグレードしたところ問題なくアップグレードできました。

是非この機会にお試しを！

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

Android用のCRM TOUCHをアップデート（ver1.34)

2014-01-15T20:14:00.001+09:00

Android版のバージョン1.34をリリースしました。
対応内容は以下のとおりです。
1. vTigerCRM6RCをサポート。
2. コメントモジュールにて新規のメッセージ作成と返信時にエラーが発生する不具合を修正。

以上です。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

vTigerCRM6のデモをβからRCへ更新しました。

2013-12-25T14:51:00.002+09:00

さて、とうとうやってきましたvTigerCRM6RC版。
早速、公開しているvTigerCRM6のデモサイトを更新しました。

大きく何かが追加されたというよりは細かいバグが大量に修正されていますね。
MobileAPI等は現在検証中です。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

iOS用のCRM TOUCHをアップデート（ver1.32）

2013-12-13T16:25:00.001+09:00

iOS版の1.32をリリースしました。
対応内容は以下となります。
１．iOS7に対応しました。
２．リストUIを刷新。
３．地図モジュールの追加。
４．その他バグ修正

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

Android用のCRM TOUCHをアップデート（ver1.33）

2013-12-11T22:40:00.001+09:00

Android版のバージョン1.33をリリースしました。
対応内容は以下のとおりです。
1. Leads モジュールの同期時の不具合.
2. Map機能のメニューが正しく表示されない場合がある不具合。

以上です。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

Vtiger 6.0.0 RC - Now Available!

2013-12-10T22:39:00.001+09:00

本日（2013/12/10）というか、つい先ほどvTigerCRM 6のRCがリリースされました！
Dear Developers

We are very happy to announce the availability of Vtiger 6.0 RC today.
Besides the RC release, we are excited to also unveil our new community
documentation site - community.vtiger.com/help - hosting useful resources

for developers and administrators.

For download links, please visit:
https://www.vtiger.com/open-source-downloads/

おめでとうー！よーし試してみるぞー！

あと、vTigerCRMにTwiilioを絡ませようとかたくらんでたのですが、もうやってくれる方がいそうです。。。

えーい、ならアプリで対応してみようかなー。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

The Official CRM TOUCH Blog

2013-12-10T22:33:00.002+09:00

CRM TOUCHですが、アプリ専用の英語のブログを立ち上げました。
こちらにアプリの使い方やニュースリリース等を投稿していく予定です。

頑張って英語で書いてきますのでよろしくです。
The Official CRM TOUCH Blog

ちなみにですが、こちらもBloggerを使用しているのですが、カスタムドメインを設定して自社のサブドメインで運用してみます。
Bloggerの見ている国の人に合わせてリダイレクトしてしまう挙動で苦しめられるくらいならこの方が楽かも。
FacebookのOGPの設定とかGAとかなかなか一筋縄ではいかない場合が多いので。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

vTigerCRM5.4へのモジュールのインストールの仕方

2013-12-03T13:13:00.000+09:00

今回はvTigerCRM5.4のモジュールのインストール方法をご紹介します。

本来はマニュアル作成の一環としたかったのですがちょうど本件のお問い合わせがありましたので急遽TIPSとして投稿することにしました。
＃後ほどちゃんとマニュアル形式に追記。修正する予定です。

このTIPSですが、皆さんがインストールする機会がおおそうな言語モジュールをサンプルにして書いてみましたが、その他の拡張モジュールをインストールする場合も基本的には一緒です。

言語モジュールに関してですが、vTigerCRMはオフィシャル的には、「言語モジュール」をインストールするだけで言語の表記をきりかえる仕組みとなっています。

ただ、あくまで表記だけのため、
日本語が正しく処理されるようローカライズするためには、
・言語モジュール（日本語翻訳ファイル）
・日本語の処理用の修正パッチ
の二つが必要になると弊社では考えています。
＃それ以外にも、フィルターの指定の仕方によってはDBのマスタを修正する必要もあります。

弊社でもvTigerCRM5.4での日本語化を実施した際に、
単純に表記を日本語に直すだけではなく幾つか内部の処理を修正するパッチも作成して適用しました。
今回はあくまで、モジュールのインストール方法のみの紹介です。

それでは、まず管理者権限でログインしてください。
①画面右上の「CRM Setting」アイコンをクリックして「Settings」ページを表示します。

②「Settings」ページより「Studio ＞ Module Manager」を選択してください。「Module Manager」ページへ遷移します。

③「Module Manager」ページから「Custom Modules」タブを選択してください。

④「Custom Modules」タブ内の「Import New」ボタンを選択してください。「Module Manager ＞ Import」ページへ遷移します。

⑤「Module Manager ＞ Import」ページ内にてインストールするモジュールファイル(zip)を選択してください。

⑥モジュールファイルの選択が完了しましたら「Import」ボタンを押してください。インストール作業が開始されます。

⑦ライセンスの内容に問題がなければ「 I accept the license agreement. 」チェックボックスをオンにします。

⑧「Do you want to proceed with the import?」の「Yes」ボタンをクリックしてください。

⑨インストールログが画面に表示されます。インストールに問題が無ければ、画面右下に「Finish」ボタンが表示されますのでそれをクリックします。

これでインストールは完了です。

あとは個人の設定画面からインストールした言語を選択したください。

以上になります。

ちなみにですが、モジュールに関してはUIからアンインストール方法はありません。

vTlibを直接叩くコードを実行すれば削除は可能なのでそのうち紹介します。

また、PHPに直接あてるパッチの適用もまた今度ということで。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

Titanium mobile にてTableViewRowが右にずれる場合がある。ちなみiOS7だけ

2013-11-25T18:11:00.000+09:00

CRM TOUCHはTitanium Mobileで開発しています。

基本はワンソースでiOSとAndroidで動かすってのを守っているのですが、結構な確立でiOS SDKが更新されたりすると、いろいろ地雷を踏む傾向にあります。

で、今回はというとiOS７向けに改修している最中に出くわしたこの現象。
Titaniium SDK 3.1.3GA。そしてiOS7（実機とシュミレーター）で再現。

折角なのでスクショとっておきました。
どんな感じかというと、まず、普通にTabelViewに対してRowがappendしてある状態。
このサンプルだと２行だけです。

そして、TabelViewを引っ張って（もしくは押し上げて）画面から手を離してもとにもどすとあら不思議。

先頭の行が勝手に右にずれます。５回やると３回ぐらいずれます。

このパターン、引っ張ったりしなくても初期表示の段階でずれている場合もあります。。。

Titanium Mobile でわりと苦労してきたのはAndroidでiOSは出来る子だと思っていただけにショックがでかいです、けどめげません。

classnameが悪さしてんのか？とかいろいろ調べてみましたが発生するTableと発生しないTableが存在したため違いを比較してなんとか原因がわかりました。
この現象、rowの挿入を１行ずつappendRow()している場合では発生し、table.setData()でまとめてセットしているものでは発生しません。

なんだそりゃ、、、
ただ、描画のパフォーマンスを考慮してまとめてセットした方が良いと昨今言われていますので、良いタイミングだったと前向きに考え一気に修正してしまいます。

ListViewが早く安定してくれるといいんだけど、いつになったら乗り換えられるのかしら。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

vTigerCRM 6のRC版に関して

2013-11-22T11:34:00.002+09:00

少し情報連携が遅れましたがvTigerCRMのオフィシャルブログから。

“Testing In Progress”
なにやら彼らの哲学的な導入部から始まる投稿です。

ユーザーが自分たちの具体的な業務を効率化するために、CRMという抽象的なパッケージをいかに適用するか。

その過程で、彼らが想像もしていなかったような要望を寄せられることも非常に多かったでしょう。

そのなかで彼らのポリシーを貫きながら、協力してくれるデベロッパーコミュニティとの良好な関係を維持してきた苦労が垣間見えますね。

頭が下がります。

ちょいと余計なことを書いてしまいましたが、vTigerCRM 6のRC版は12月10日にリリース予定とのことです。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

vTigerCRM5.4をPHP5.2以外で動かす

2013-11-21T11:45:00.003+09:00

vTigerCRM5.4をPHP5.2以外で動かす場合のメモです。
vTigerCRM5.4は稼動環境は以下のようになっています。

Database: MySQL Version >=5.1.x.
PHP: PHP Version >=5.2.x.

脆弱性の問題等もあるのでできればPHP5.2以外で動かしたいという場合は、php5.3で使用するためのパッチが有志より公開されています。

Patch to make Vtiger 5.4 work on php 5.3

こちら、vTigerCRM本体だけでなくCustomerPortalのパッチも合わせて提供されています。

パッチ自体はオフィシャルの物ではなく、オフィシャルなDeveloperのMLから発生したものですが、問題なく使えていますね。

以前どこかで、PHP5.4用のパッチも見た気がしたのですが、どこだったかな？
思い出したらこちらで紹介いたします。

2.2. セキュリティ構成の基本仕様

2013-10-30T18:16:00.002+09:00

vTigerCRMのマニュアルを更新しました。
前回の続きで、「2.2 セキュリティ構成の基本仕様」となります。

vTigerCRMの日本語訳に関しては、人それぞれによって翻訳が異なる可能性があります。

我々は、RBAC周りに関しては、以前に日本のユーザー会で公開されていた日本語翻訳設定を参考にし、以下としています。

User：ユーザー
Roles：役割
Profiles：プロファイル
Groups：グループ
Sharing Access：共有アクセス

個人的にRolesはロールでも良いかなーと思いますが、そんな感じで変更されている方も多いでしょう。
なので、確認が必要な場合は、一旦、言語設定を英語に切り替えてご確認ください。
＃ユーザー会が再度盛り上がればよいですね。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

2.1. vTigerCRMにおけるセキュリティの概念

2013-10-30T18:02:00.000+09:00

vTigerCRMの日本語マニュアルを更新しました。
今回は、「2.1. vTigerCRMにおけるセキュリティの概念」です。

vTigerCRMの権限周りの作りこみは良く出来ていると思います。
vTigerCRMはRole Based Access Controlを採用していますが、導入時に「なんだか面倒だな？」と適当に運用を開始してしまい後々で困ることおおいRBAC。

vTigerCRMのRBACの構造を理解すればさほど大変な作業ではありませんので、これから導入される方は是非一読をお勧めします。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

2. ｖTigerCRMの導入準備

2013-10-30T17:52:00.001+09:00

vTigerCRMのマニュアルを更新しました。
一発目は「2 ｖTigerCRMの導入準備」を公開しています。

ちなみに目次の先頭から公開していくわけではありません。
纏めやすい箇所から公開していく予定です。

CRM TOUCHのサイトはこちら
vTigerCRMの日本語の情報に関してはこちら

CRM TOUCH with vTigerCRMのブログ

vTigerCRM6.0にカスタマーポータル（Customer Portal）をセットアップする その１

vTigerCRM6.0にて自作のモジュールにModTrackerを有効にする（Add ModTracker to custom module. ）

vTigerCRM6.0 問題点その２ Webformが正しくリダイレクトされない

vTigerCRM6.0の変更点その１ フィールド表現式(Field Formulas)がWorkflowに統合

vTigerCRM6.0の問題点その１ コンフィグレーションエディタが真っ白。Configuration Editor not showing up

CRM TOUCHをアップデート（ver1.38）

vTigerCRM6にて既存のモジュールにフィールドを追加してみる

まず一つ目は、標準の管理画面から変更する方法。

vTigerCRM6のUIType一覧

vTigerCRMにて自作モジュールを削除・アンインストールする

vTigerCRM6でログを出力させる方法

vTigerCRM6.0 インストール方法（ソースから）

vTigerCRM 6.0 GAリリース

Android用のCRM TOUCHをアップデート（ver1.34)

vTigerCRM6のデモをβからRCへ更新しました。

iOS用のCRM TOUCHをアップデート（ver1.32）

Android用のCRM TOUCHをアップデート（ver1.33）

Vtiger 6.0.0 RC - Now Available!

The Official CRM TOUCH Blog

vTigerCRM5.4へのモジュールのインストールの仕方

Titanium mobile にてTableViewRowが右にずれる場合がある。ちなみiOS7だけ

vTigerCRM 6のRC版に関して

vTigerCRM5.4をPHP5.2以外で動かす

2.2. セキュリティ構成の基本仕様

2.1. vTigerCRMにおけるセキュリティの概念

2. ｖTigerCRMの導入準備

vTigerCRM6.0にカスタマーポータル（Customer Portal）をセットアップする　その１

vTigerCRM6.0 問題点その２　Webformが正しくリダイレクトされない

vTigerCRM6.0の変更点その１　フィールド表現式(Field Formulas)がWorkflowに統合

vTigerCRM6.0の問題点その１　コンフィグレーションエディタが真っ白。Configuration Editor not showing up