INSTALL notes for Multiple CustomerIDs drop-down patch (OTRS 2.2.2)

1. I included original files from OTRS 2.2.2, so you can check further if you're having the good one on your install :

-rw-rw-r--  1 apache apache 24716 Jul 31 04:31 AdminCustomerUser_original.pm
-rw-rw-r--  1 apache apache 11029 Jul 31 04:31 CustomerUser_original.pm
-rw-rw-r--  1 apache apache 25236 Jul 31 04:31 DB_original.pm



2. If all files are OK, you will have to patch these 3 files with patch utility :

> patch -p 0 -o AdminCustomerUser_patched.pm AdminCustomerUser_original.pm AdminCustomerUser.pm.patch
> patch -p 0 -o CustomerUser_patched.pm CustomerUser_original.pm CustomerUser.pm.patch
> patch -p 0 -o DB_patched.pm DB_original.pm DB.pm.patch

you should get a message telling you : patching file <FILENAME>.pm
without any errors



3. I also included *normal* patched files to let you checked that your files were properly patched :

-rw-------  1 root root 24817 Aug 28 11:19 AdminCustomerUser_AFTER_PATCH.pm
-rw-------  1 root root 12372 Aug 28 11:07 CustomerUser_AFTER_PATCH.pm
-rw-------  1 root root 29726 Aug 28 11:06 DB_AFTER_PATCH.pm



4. After files are patched successfully, you will need to add new parameters about Customers Map to your Config.pm :

Enable or Add if it doesn't exist this line to activate drop down menus in AdminCustomerUser (Agent Panel / Customer User)

#        # use customer company support (reference to company, See CustomerCompany settings)
        CustomerCompanySupport => 1,

here is a sample for the Map:

            [ 'UserEmail',      'Email',      'email',       0, 1, 'var', '', 0 ],
            [ 'UserPhone',      'Phone',      'phone',       1, 0, 'var', '', 0 ],

                ...
            [ 'UserCustomerID', 'CustomerID', 'customer_id', 0, 1, 'var', '', 0 ],
            [ 'UserCustomerIDs', 'CustomerIDs 2', 'customer_ids', 1, 0, 'var', '', 0 ],
            [ 'UserCustomerIDsNo3', 'CustomerIDs 3', 'customer_ids_no3', 1, 0, 'var', '', 0 ],
            [ 'UserCustomerIDsNo4', 'CustomerIDs 4', 'customer_ids_no4', 1, 0, 'var', '', 0 ],
            [ 'UserCustomerIDsNo5', 'CustomerIDs 5', 'customer_ids_no5', 1, 0, 'var', '', 0 ],
                ...

            [ 'UserComment',     'Comment',   'comments',    1, 0, 'var', '', 0 ],
            [ 'ValidID',         'Valid',     'valid_id',    0, 1, 'int', '', 0 ],



5. Then, you need to create fields corresponding to the new Customers Map into your DB
For the above config sample, you need to add fields customer_ids_no3 / customer_ids_no4 / customer_ids_no5 and also customer_ids if you were not using it before. 



6. As a last step, I recommend you to restart your webserver. Then make a test.



NB : This patch was tested successfully for OTRS 2.2.2. It will probably need to be modified/adapt for future versions and also old versions.


08/28/2007
Laurent MINOST
Professional Email : lminost@denyall.com
Personal Email : otrs@lolomin.net
