FU: single-dbh
[kivitendo-erp.git] / SL / FU.pm
1 # Follow-Ups
2
3 package FU;
4
5 use List::Util qw(first);
6
7 use SL::Common;
8 use SL::DBUtils;
9 use SL::DB;
10 use SL::Notes;
11
12 use strict;
13
14 sub save {
15   my ($self, %params) = @_;
16   $main::lxdebug->enter_sub();
17
18   my $rc = SL::DB->client->with_transaction(\&_save, $self, %params);
19
20   $::lxdebug->leave_sub;
21   return $rc;
22 }
23
24 sub _save {
25   my $self     = shift;
26   my %params   = @_;
27
28   my $myconfig = \%main::myconfig;
29   my $form     = $main::form;
30
31   my $dbh      = $params{dbh} || SL::DB->client->dbh;
32   my ($query, @values);
33
34   if (!$params{id}) {
35     ($params{id}) = selectrow_query($form, $dbh, qq|SELECT nextval('follow_up_id')|);
36
37     $query = qq|INSERT INTO follow_ups (created_by, done, note_id, follow_up_date, created_for_user, id)
38                 VALUES ((SELECT id FROM employee WHERE login = ?), ?, ?, ?, ?, ?)|;
39
40     push @values, $::myconfig{login};
41
42   } else {
43     $query = qq|UPDATE follow_ups SET done = ?, note_id = ?, follow_up_date = ?, created_for_user = ? WHERE id = ?|;
44   }
45
46   $params{note_id} = Notes->save('id'           => $params{note_id},
47                                  'trans_id'     => $params{id},
48                                  'trans_module' => 'fu',
49                                  'subject'      => $params{subject},
50                                  'body'         => $params{body},
51                                  'dbh'          => $dbh,);
52
53   $params{done} = 1 if (!defined $params{done});
54
55   do_query($form, $dbh, $query, @values, $params{done} ? 't' : 'f', conv_i($params{note_id}), $params{follow_up_date}, conv_i($params{created_for_user}), conv_i($params{id}));
56
57   do_query($form, $dbh, qq|DELETE FROM follow_up_links WHERE follow_up_id = ?|, conv_i($params{id}));
58
59   $query = qq|INSERT INTO follow_up_links (follow_up_id, trans_id, trans_type, trans_info) VALUES (?, ?, ?, ?)|;
60   my $sth   = prepare_query($form, $dbh, $query);
61
62   foreach my $link (@{ $params{LINKS} }) {
63     do_statement($form, $sth, $query, conv_i($params{id}), conv_i($link->{trans_id}), $link->{trans_type}, $link->{trans_info});
64   }
65
66   $sth->finish();
67
68   return 1;
69 }
70
71 sub finish {
72   $main::lxdebug->enter_sub();
73
74   my $self     = shift;
75   my %params   = @_;
76
77   Common::check_params(\%params, 'id');
78
79   my $myconfig = \%main::myconfig;
80   my $form     = $main::form;
81
82   SL::DB->client->with_transaction(sub {
83     do_query($form, SL::DB->client->dbh, qq|UPDATE follow_ups SET done = TRUE WHERE id = ?|, conv_i($params{id}));
84   });
85
86   $main::lxdebug->leave_sub();
87 }
88
89 sub delete {
90   $main::lxdebug->enter_sub();
91
92   my $self     = shift;
93   my %params   = @_;
94
95   Common::check_params(\%params, 'id');
96
97   my $myconfig = \%main::myconfig;
98   my $form     = $main::form;
99
100   SL::DB->client->with_transaction(sub {
101     my $dbh      = SL::DB->client->dbh;
102
103     my $id       = conv_i($params{id});
104
105     do_query($form, $dbh, qq|DELETE FROM follow_up_links WHERE follow_up_id = ?|,                         $id);
106     do_query($form, $dbh, qq|DELETE FROM follow_ups      WHERE id = ?|,                                   $id);
107     do_query($form, $dbh, qq|DELETE FROM notes           WHERE (trans_id = ?) AND (trans_module = 'fu')|, $id);
108   });
109
110   $main::lxdebug->leave_sub();
111 }
112
113 sub retrieve {
114   $main::lxdebug->enter_sub();
115
116   my $self     = shift;
117   my %params   = @_;
118
119   Common::check_params(\%params, 'id');
120
121   my $myconfig = \%main::myconfig;
122   my $form     = $main::form;
123
124   my $dbh      = $form->get_standard_dbh($myconfig);
125   my ($query, @values);
126
127   my ($employee_id) = selectrow_query($form, $dbh, qq|SELECT id FROM employee WHERE login = ?|, $::myconfig{login});
128   $query            = qq|SELECT fu.*, n.subject, n.body, n.created_by
129                          FROM follow_ups fu
130                          LEFT JOIN notes n ON (fu.note_id = n.id)
131                          WHERE (fu.id = ?)
132                            AND (   (fu.created_by = ?) OR (fu.created_for_user = ?)
133                                 OR (fu.created_by IN (SELECT DISTINCT what FROM follow_up_access WHERE who = ?)))|;
134   my $ref           = selectfirst_hashref_query($form, $dbh, $query, conv_i($params{id}), $employee_id, $employee_id, $employee_id);
135
136   if (!$ref) {
137     $main::lxdebug->leave_sub();
138     return undef;
139   }
140
141   $ref->{LINKS} = $self->retrieve_links(%{ $ref });
142
143   $main::lxdebug->leave_sub();
144
145   return $ref;
146 }
147
148 sub retrieve_links {
149   $main::lxdebug->enter_sub();
150
151   my $self     = shift;
152   my %params   = @_;
153
154   Common::check_params(\%params, qw(id));
155
156   my $myconfig = \%main::myconfig;
157   my $form     = $main::form;
158
159   my $dbh      = $form->get_standard_dbh($myconfig);
160
161   my $query    = qq|SELECT ful.trans_id, ful.trans_type, ful.trans_info, fu.note_id
162                     FROM follow_up_links ful
163                     LEFT JOIN follow_ups fu ON (ful.follow_up_id = fu.id)
164                     WHERE ful.follow_up_id = ?
165                     ORDER BY ful.itime|;
166
167   my $links    = selectall_hashref_query($form, $dbh, $query, conv_i($params{id}));
168
169   foreach my $link_ref (@{ $links }) {
170     my $link_details = FU->link_details(%{ $link_ref });
171     map { $link_ref->{$_} = $link_details->{$_} } keys %{ $link_details} if ($link_details);
172   }
173
174   $main::lxdebug->leave_sub();
175
176   return $links;
177 }
178
179 sub follow_ups {
180   $main::lxdebug->enter_sub();
181
182   my $self     = shift;
183   my %params   = @_;
184
185   my $myconfig = \%main::myconfig;
186   my $form     = $main::form;
187
188   my $dbh      = $form->get_standard_dbh($myconfig);
189   my ($query, $where, $where_user);
190
191   my ($employee_id) = selectrow_query($form, $dbh, qq|SELECT id FROM employee WHERE login = ?|, $::myconfig{login});
192   my @values        = ();
193   my @values_user   = ();
194
195   if ($params{trans_id}) {
196     $where .= qq| AND EXISTS (SELECT * FROM follow_up_links ful
197                               WHERE (ful.follow_up_id = fu.id) AND (ful.trans_id = ?))|;
198     push @values, conv_i($params{trans_id});
199   }
200
201   if ($params{due_only}) {
202     $where .= qq| AND (fu.follow_up_date <= current_date)|;
203   }
204
205   if ($params{done} ne $params{not_done}) {
206     my $not  = $params{not_done} ? 'NOT' : '';
207     $where  .= qq| AND $not COALESCE(fu.done, FALSE)|;
208   }
209
210   if ($params{not_id}) {
211     $where .= qq| AND (fu.id <> ?)|;
212     push @values, conv_i($params{not_id});
213   }
214
215   foreach my $item (qw(subject body)) {
216     next unless ($params{$item});
217     $where .= qq| AND (n.${item} ILIKE ?)|;
218     push @values, like($params{$item});
219   }
220
221   if ($params{reference}) {
222     $where .= qq| AND EXISTS (SELECT ful.follow_up_id
223                               FROM follow_up_links ful
224                               WHERE (ful.follow_up_id = fu.id)
225                                 AND (ful.trans_info ILIKE ?)
226                               LIMIT 1)|;
227     push @values, like($params{reference});
228   }
229
230   if ($params{follow_up_date_from}) {
231     $where .= qq| AND (fu.follow_up_date >= ?)|;
232     push @values, conv_date($params{follow_up_date_from});
233   }
234   if ($params{follow_up_date_to}) {
235     $where .= qq| AND (fu.follow_up_date <= ?)|;
236     push @values, conv_date($params{follow_up_date_to});
237   }
238
239   if ($params{itime_from}) {
240     $where .= qq| AND (date_trunc('DAY', fu.itime) >= ?)|;
241     push @values, conv_date($params{itime_from});
242   }
243   if ($params{itime_to}) {
244     $where .= qq| AND (date_trunc('DAY', fu.itime) <= ?)|;
245     push @values, conv_date($params{itime_to});
246   }
247
248   if ($params{all_users}) {
249     $where_user = qq|OR (fu.created_by IN (SELECT DISTINCT what FROM follow_up_access WHERE who = ?))|;
250     push @values_user, $employee_id;
251   }
252
253   my $order_by = '';
254
255   if ($form->{sort} ne 'title') {
256     my %sort_columns = (
257       'follow_up_date' => [ qw(fu.follow_up_date fu.id) ],
258       'created_on'     => [ qw(created_on fu.id) ],
259       'subject'        => [ qw(lower(n.subject)) ],
260       );
261
262     my $sortdir = !defined $form->{sortdir} ? 'ASC' : $form->{sortdir} ? 'ASC' : 'DESC';
263     my $sortkey = $sort_columns{$form->{sort}} ? $form->{sort} : 'follow_up_date';
264     $order_by   = 'ORDER BY ' . join(', ', map { "$_ $sortdir" } @{ $sort_columns{$sortkey} });
265   }
266
267   $query  = qq|SELECT fu.*, n.subject, n.body, n.created_by,
268                  fu.follow_up_date <= current_date AS due,
269                  fu.itime::DATE                    AS created_on,
270                  COALESCE(eby.name,  eby.login)    AS created_by_name,
271                  COALESCE(efor.name, efor.login)   AS created_for_user_name
272                FROM follow_ups fu
273                LEFT JOIN notes    n    ON (fu.note_id          = n.id)
274                LEFT JOIN employee eby  ON (n.created_by        = eby.id)
275                LEFT JOIN employee efor ON (fu.created_for_user = efor.id)
276                WHERE ((fu.created_by = ?) OR (fu.created_for_user = ?)
277                       $where_user)
278                  $where
279                $order_by|;
280
281   my $follow_ups = selectall_hashref_query($form, $dbh, $query, $employee_id, $employee_id, @values_user, @values);
282
283   if (!scalar @{ $follow_ups }) {
284     $main::lxdebug->leave_sub();
285     return $follow_ups;
286   }
287
288   foreach my $fu (@{ $follow_ups }) {
289     $fu->{LINKS} = $self->retrieve_links(%{ $fu });
290   }
291
292   if ($form->{sort} eq 'title') {
293     my $dir_factor = !defined $form->{sortdir} ? 1 : $form->{sortdir} ? 1 : -1;
294     $follow_ups    = [ map  { $_->[1] }
295                        sort { ($a->[0] cmp $b->[0]) * $dir_factor }
296                        map  { my $fu = $follow_ups->[$_]; [ @{ $fu->{LINKS} } ? lc($fu->{LINKS}->[0]->{title}) : '', $fu ] }
297                        (0 .. scalar(@{ $follow_ups }) - 1) ];
298   }
299
300   $main::lxdebug->leave_sub();
301
302   return $follow_ups;
303 }
304
305 sub link_details {
306   $main::lxdebug->enter_sub();
307
308   my $self     = shift;
309   my %params   = @_;
310
311   Common::check_params(\%params, qw(trans_id trans_type));
312
313   my $myconfig = \%main::myconfig;
314   my $form     = $main::form;
315   my $locale   = $main::locale;
316
317   my $q_id     = $form->quote($params{trans_id});
318   my $link;
319
320   if ($params{trans_type} eq 'customer') {
321     $link = {
322       'url'   => 'controller.pl?action=CustomerVendor/edit&db=customer&id=' . $form->quote($params{trans_id}) . '&note_id=' . $form->quote($params{note_id}),
323       'title' => $locale->text('Customer') . " '$params{trans_info}'",
324     };
325
326   } elsif ($params{trans_type} eq 'vendor') {
327     $link = {
328       'url'   => 'controller.pl?action=CustomerVendor/edit&db=vendor&id=' . $params{trans_id} . '&note_id=' . $form->quote($params{note_id}),
329       'title' => $locale->text('Vendor') . " '$params{trans_info}'",
330     };
331
332   } elsif ($params{trans_type} eq 'sales_quotation') {
333     $link = {
334       'url'   => 'oe.pl?action=edit&type=sales_quotation&id=' . $params{trans_id},
335       'title' => $locale->text('Sales quotation') . " $params{trans_info}",
336     };
337
338   } elsif ($params{trans_type} eq 'sales_delivery_order') {
339
340     $link = {
341       'url'   => 'do.pl?action=edit&type=sales_delivery_order&id=' . $params{trans_id} . '&edit_note_id=' . $form->quote($params{note_id}),
342       'title' => $locale->text('Sales delivery order') .' '. $params{trans_info},
343     };
344
345   } elsif ($params{trans_type} eq 'purchase_delivery_order') {
346
347     $link = {
348       'url'   => 'do.pl?action=edit&type=purchase_delivery_order&id=' . $params{trans_id} . '&edit_note_id=' . $form->quote($params{note_id}),
349       'title' => $locale->text('Purchase delivery order') .' '. $params{trans_info},
350     };
351
352   } elsif ($params{trans_type} eq 'sales_order') {
353     $link = {
354       'url'   => 'oe.pl?action=edit&type=sales_order&id=' . $params{trans_id},
355       'title' => $locale->text('Sales Order') . " $params{trans_info}",
356     };
357
358   } elsif ($params{trans_type} eq 'sales_invoice') {
359     $link = {
360       'url'   => 'is.pl?action=edit&type=invoice&id=' . $params{trans_id},
361       'title' => $locale->text('Sales Invoice') . " $params{trans_info}",
362     };
363
364   } elsif ($params{trans_type} eq 'credit_note') {
365     $link = {
366       'url'   => 'is.pl?action=edit&type=credit_note&id=' . $params{trans_id},
367       'title' => $locale->text('Credit Note') . " $params{trans_info}",
368     };
369
370   } elsif ($params{trans_type} eq 'dunning') {
371     $link = {
372       'url'   => 'dn.pl?action=print_dunning&format=pdf&media=screen&dunning_id=' . $params{trans_id},
373       'title' => $locale->text('Dunning') . " $params{trans_info}",
374     };
375
376   } elsif ($params{trans_type} eq 'request_quotation') {
377     $link = {
378       'url'   => 'oe.pl?action=edit&type=request_quotation&id=' . $params{trans_id},
379       'title' => $locale->text('Request quotation') . " $params{trans_info}",
380     };
381
382   } elsif ($params{trans_type} eq 'purchase_order') {
383     $link = {
384       'url'   => 'oe.pl?action=edit&type=purchase_order&id=' . $params{trans_id},
385       'title' => $locale->text('Purchase Order') . " $params{trans_info}",
386     };
387
388   } elsif ($params{trans_type} eq 'vendor_invoice') {
389     $link = {
390       'url'   => 'ir.pl?action=edit&type=invoice&id=' . $params{trans_id},
391       'title' => $locale->text('Vendor Invoice') . " $params{trans_info}",
392     };
393
394   } elsif ($params{trans_type} eq 'ar_transaction') {
395     $link = {
396       'url'   => 'ar.pl?action=edit&id=' . $params{trans_id},
397       'title' => $locale->text('AR Transaction') . " $params{trans_info}",
398     };
399
400   } elsif ($params{trans_type} eq 'ap_transaction') {
401     $link = {
402       'url'   => 'ap.pl?action=edit&id=' . $params{trans_id},
403       'title' => $locale->text('AP Transaction') . " $params{trans_info}",
404     };
405
406   } elsif ($params{trans_type} eq 'gl_transaction') {
407     $link = {
408       'url'   => 'gl.pl?action=edit&id=' . $params{trans_id},
409       'title' => $locale->text('GL Transaction') . " $params{trans_info}",
410     };
411
412   }
413
414   $main::lxdebug->leave_sub();
415
416   return $link || { };
417 }
418
419 sub save_access_rights {
420   $main::lxdebug->enter_sub();
421
422   my $self     = shift;
423   my %params   = @_;
424
425   Common::check_params(\%params, 'access');
426
427   my $myconfig = \%main::myconfig;
428   my $form     = $main::form;
429
430   SL::DB->client->with_transaction(sub {
431     my $dbh      = SL::DB->client->dbh;
432
433     my ($id)     = selectrow_query($form, $dbh, qq|SELECT id FROM employee WHERE login = ?|, $::myconfig{login});
434
435     do_query($form, $dbh, qq|DELETE FROM follow_up_access WHERE what = ?|, $id);
436
437     my $query    = qq|INSERT INTO follow_up_access (who, what) VALUES (?, ?)|;
438     my $sth      = prepare_query($form, $dbh, $query);
439
440     while (my ($who, $access_allowed) = each %{ $params{access} }) {
441       next unless ($access_allowed);
442
443       do_statement($form, $sth, $query, conv_i($who), $id);
444     }
445
446     $sth->finish();
447   });
448
449   $main::lxdebug->leave_sub();
450 }
451
452 sub retrieve_access_rights {
453   $main::lxdebug->enter_sub();
454
455   my $self     = shift;
456   my %params   = @_;
457
458   my $myconfig = \%main::myconfig;
459   my $form     = $main::form;
460
461   my $dbh      = $form->get_standard_dbh($myconfig);
462
463   my $sth      = prepare_execute_query($form, $dbh, qq|SELECT who FROM follow_up_access WHERE what = (SELECT id FROM employee WHERE login = ?)|, $::myconfig{login});
464   my $access   = {};
465
466   while (my $ref = $sth->fetchrow_hashref()) {
467     $access->{$ref->{who}} = 1;
468   }
469
470   $sth->finish();
471
472   $main::lxdebug->leave_sub();
473
474   return $access;
475 }
476
477 1;