lib/RT/Extension/ImportCustomFieldValues.pm

   1 use strict;
   2 use warnings;
   3 package RT::Extension::ImportCustomFieldValues;
   4
   5 our $VERSION = '0.02';
   6
   7 RT->AddStyleSheets('importcustomfieldvalues.css');
   8
   9 =head1 NAME
  10
  11 RT-Extension-ImportCustomFieldValues - Allow to import customfield values from CSV file
  12
  13 =head1 RT VERSION
  14
  15 Works with RT 4.2 and 4.4.
  16
  17 =head1 INSTALLATION
  18
  19 =over
  20
  21 =item C<perl Makefile.PL>
  22
  23 =item C<make>
  24
  25 =item C<make install>
  26
  27 May need root permissions
  28
  29 =item Edit your F</opt/rt4/etc/RT_SiteConfig.pm>
  30
  31 If you are using RT 4.2 or greater, add this line:
  32
  33     Plugin('RT::Extension::ImportCustomFieldValues');
  34
  35 =item Clear your mason cache
  36
  37     rm -rf /opt/rt4/var/mason_data/obj
  38
  39 =item Restart your webserver
  40
  41 =back
  42
  43 =head1 DESCRIPTION
  44
  45 The ImportCustomFieldValues extension gives you an easy way to import values in a customfield of type "Select" from a CSV file.
  46
  47 =head1 DETAILS
  48
  49 The tool is available through Administration->CustomFields->[CustomField]->Import from CSV
  50
  51 CSV file must a consist of a text file with:
  52
  53 - File encoding: UTF-8
  54 - Fields separated by ";"
  55 - No headers
  56 - Using the following columns and order: SortOrder, Name, Description, Category
  57 - Column "Name" is mandatory, other columns may be empty but must exists
  58
  59 =head1 AUTHOR
  60
  61 Emmanuel Lacour E<lt>elacour@easter-eggs.comE<gt>
  62
  63 =head1 BUGS
  64
  65 All bugs should be reported via email to
  66
  67     L<bug-RT-Extension-ImportCustomFieldValues@rt.cpan.org|mailto:bug-RT-Extension-ImportCustomFieldValues@rt.cpan.org>
  68
  69 or via the web at
  70
  71     L<rt.cpan.org|http://rt.cpan.org/Public/Dist/Display.html?Name=RT-Extension-ImportCustomFieldValues>.
  72
  73 =head1 LICENSE AND COPYRIGHT
  74
  75 This software is Copyright (c) 2022 by Emmanuel Lacour.
  76
  77 This is free software, licensed under:
  78
  79   The GNU General Public License, Version 2, June 1991
  80
  81 =cut
  82
  83 1;
  84