LP#1373690 EDI 'use_attrs' configuration option
[working/Evergreen.git] / Open-ILS / src / support-scripts / edi_order_pusher.pl
1 #!/usr/bin/perl
2 # ---------------------------------------------------------------
3 # Copyright (C) 2016 King County Library System
4 # Author: Bill Erickson <berickxx@gmail.com>
5 #
6 # Copied heavily from edi_pusher.pl
7 #
8 # This program is free software; you can redistribute it and/or
9 # modify it under the terms of the GNU General Public License
10 # as published by the Free Software Foundation; either version 2
11 # of the License, or (at your option) any later version.
12 #
13 # This program is distributed in the hope that it will be useful,
14 # but WITHOUT ANY WARRANTY; without even the implied warranty of
15 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 # GNU General Public License for more details.
17 # ---------------------------------------------------------------
18 use strict;
19 use warnings;
20 use Getopt::Long;
21 use OpenSRF::Utils::Logger q/$logger/;
22 use OpenILS::Utils::Fieldmapper;
23 use OpenILS::Application::Acq::EDI;
24 use OpenILS::Utils::EDIWriter;
25
26 my $osrf_config = '/openils/conf/opensrf_core.xml';
27 my $po_id;
28 my $test_mode;
29 my $verbose;
30 my $help;
31
32 my $ops = GetOptions(
33     'osrf-config=s' => \$osrf_config,
34     'test-mode'     => \$test_mode,
35     'po-id=i'       => \$po_id,
36     'verbose'       => \$verbose,
37     'help'          => \$help
38 );
39
40 sub help {
41     print <<HELP;
42
43     Synopsis:
44
45         Generate and deliver 'ORDERS' EDI for purchase orders.  Unless a
46         specific PO is provided (via --po-id), EDI messages will be 
47         generated for all PO's that meet the following conditions:
48         
49         1. PO must be activated.
50         2. PO provider must be active.
51         3. PO must use a provider that supports EDI delivery (via edi_default)
52         4. EDI account linked to provider must have 'use_attrs' set to true.
53         5. PO must have no EDI ORDERS messages attached or, if it does, 
54            the message has a status of "retry".
55
56     Usage:
57
58         $0
59
60         --osrf-config [/openils/conf/opensrf_core.xml]
61
62         --test-mode
63             Prints EDI that would be sent to STDOUT.  No files are sent
64             and no edi_message's are created.
65
66         --po-id <po-id-value>
67             Process a specific PO instead of processing all available PO's
68
69         --verbose
70             Log debug info to STDOUT.  This script logs various information
71             via \$logger regardless of this option.
72
73         --help
74             Show this message.
75 HELP
76     exit 0;
77 }
78
79 help() if $help or !$ops;
80
81 # $lvl should match a $logger logging function.  E.g. 'info', 'error', etc.
82 sub announce {
83     my $lvl = shift;
84         my $msg = shift;
85     $logger->$lvl($msg);
86
87     # always announce errors and warnings
88     return unless $verbose || $lvl =~ /error|warn/;
89
90     my $date_str = DateTime->now(time_zone => 'local')->strftime('%F %T');
91     print "$date_str $msg\n";
92 }
93
94 # connect to osrf...
95 OpenSRF::System->bootstrap_client(config_file => $osrf_config);
96 Fieldmapper->import(IDL => 
97     OpenSRF::Utils::SettingsClient->new->config_value("IDL"));
98 OpenILS::Utils::CStoreEditor::init();
99 my $e = OpenILS::Utils::CStoreEditor->new;
100
101 announce('debug', "FTP_PASSIVE is ".($ENV{FTP_PASSIVE} ? "ON" : "OFF"));
102
103 my $po_ids;
104
105 if ($po_id) {
106     # Caller provided a specific PO to process.
107     $po_ids = [$po_id];
108
109 } else {
110     # Find PO's that have an order date set (i.e. are activated) and are 
111     # linked to active providers that support EDI orders, but has no 
112     # successful "ORDERS" edi_message attached.
113     
114     my $ids = $e->json_query({
115         select => {acqpo => ['id']},
116         from => {
117             acqpo => {
118                 acqedim => {
119                     type => 'left',
120                     filter => {message_type => 'ORDERS'}
121                 },
122                 acqpro => {
123                     join => {
124                         acqedi => {
125                         }
126                     }
127                 }
128             }
129         },
130         where => {
131             '+acqpo' => {
132                 order_date => {'!=' => undef} # activated
133             },
134             '+acqpro' => {
135                 active => 't', 
136                 edi_default => {'!=' => undef}
137             },
138             '+acqedi' => {
139                 use_attrs => 't'
140             },
141             '+acqedim' => {
142                 '-or' => [
143                     {id => undef}, # no ORDERS message exists
144                     {status => 'retry'} # ORDERS needs re-sending
145                 ]
146             }
147         }
148     });
149
150     $po_ids = [map {$_->{id}} @$ids];
151 }
152
153 if (!@$po_ids) {
154     announce('info', "No purchase orders to process");
155     exit 0;
156 }
157
158 for $po_id (@$po_ids) {
159
160     my $edi = OpenILS::Utils::EDIWriter->new->write($po_id);
161
162     if (!$edi) {
163         announce('error', "Unable to generate EDI for PO $po_id");
164         next;
165     }
166
167     if ($test_mode) {
168         # Caller just wants the EDI printed to STDOUT
169         print "EDI for PO $po_id:\n$edi\n";
170         next;
171     }
172
173     # this may be a retry attempt.  if so, reuse the original edi_message
174     my $message = $e->search_acq_edi_message({
175         purchase_order => $po_id,
176         message_type => 'ORDERS', 
177         status => 'retry'
178     })->[0];
179
180     if (!$message) {
181         $message = Fieldmapper::acq::edi_message->new;
182         $message->create_time('NOW');
183         $message->purchase_order($po_id);
184         $message->message_type('ORDERS');
185         $message->isnew(1);
186     }
187
188     $message->edi($edi);
189
190     $e->xact_begin;
191     if ($message->isnew) {
192         unless($e->create_acq_edi_message($message)) {
193             announce('error', 
194                 "Error creating acq.edi_message for PO $po_id: ".$e->die_event);
195             next;
196         }
197     } else {
198         unless($e->update_acq_edi_message($message)) {
199             announce('error', 
200                 "Error updating acq.edi_message for PO $po_id: ".$e->die_event);
201             next;
202         }
203     }
204     $e->xact_commit;
205
206     my $po = $e->retrieve_acq_purchase_order([
207         $po_id, {
208             flesh => 2,
209             flesh_fields => {
210                 acqpo  => ['provider'],
211                 acqpro => ['edi_default'],
212             }
213         }
214     ]);
215
216     if (!$po->provider->edi_default) {
217         # Caller has provided a PO ID for a provider that does not
218         # support EDI.  
219         announce('error', "Cannot send EDI for PO $po_id, because the ".
220             "provider (".$po->provider->id.") is not configured to use EDI");
221         next;
222     }
223
224     my $res = OpenILS::Application::Acq::EDI->send_core(
225         $po->provider->edi_default, [$message->id]);
226
227     if (my $out = $res->[0]) {
228         announce('info', "message ".$message->id." status: ".$out->status);
229     } else {
230         announce('error', "send_core failed for message ".$message->id);
231     }
232 }
233
234