Update release notes for 22.05.22 release
[koha.git] / t / db_dependent / AuthorisedValues.t
1 #!/usr/bin/perl
2
3 use Modern::Perl;
4 use Test::More tests => 16;
5 use Try::Tiny;
6
7 use t::lib::TestBuilder;
8
9 use Koha::Database;
10 use C4::Context;
11 use Koha::AuthorisedValue;
12 use Koha::AuthorisedValues;
13 use Koha::AuthorisedValueCategories;
14 use Koha::MarcSubfieldStructures;
15
16 my $schema  = Koha::Database->new->schema;
17 $schema->storage->txn_begin;
18 my $builder = t::lib::TestBuilder->new;
19
20 my @existing_categories = Koha::AuthorisedValues->new->categories;
21
22 # insert
23 Koha::AuthorisedValueCategory->new({ category_name => 'av_for_testing', is_system => 1 })->store;
24 Koha::AuthorisedValueCategory->new({ category_name => 'aaav_for_testing' })->store;
25 Koha::AuthorisedValueCategory->new({ category_name => 'restricted_for_testing' })->store;
26 my $av1 = Koha::AuthorisedValue->new(
27     {
28         category         => 'av_for_testing',
29         authorised_value => 'value 1',
30         lib              => 'display value 1',
31         lib_opac         => 'opac display value 1',
32         imageurl         => 'image1.png',
33     }
34 )->store();
35
36 my $av2 = Koha::AuthorisedValue->new(
37     {
38         category         => 'av_for_testing',
39         authorised_value => 'value 2',
40         lib              => 'display value 2',
41         lib_opac         => 'opac display value 2',
42         imageurl         => 'image2.png',
43     }
44 )->store();
45
46 my $av3 = Koha::AuthorisedValue->new(
47     {
48         category         => 'av_for_testing',
49         authorised_value => 'value 3',
50         lib              => 'display value 3',
51         lib_opac         => 'opac display value 3',
52         imageurl         => 'image2.png',
53     }
54 )->store();
55
56 my $av4 = Koha::AuthorisedValue->new(
57     {
58         category         => 'aaav_for_testing',
59         authorised_value => 'value 4',
60         lib              => 'display value 4',
61         lib_opac         => 'opac display value 4',
62         imageurl         => 'image4.png',
63     }
64 )->store();
65 my $av_empty_string = Koha::AuthorisedValue->new(
66     {
67         category         => 'restricted_for_testing',
68         authorised_value => undef, # Should have been defaulted to ""
69         lib              => 'display value undef',
70         lib_opac         => 'opac display value undef',
71     }
72 )->store();
73 my $av_0 = Koha::AuthorisedValue->new(
74     {
75         category         => 'restricted_for_testing',
76         authorised_value => 0,
77         lib              => 'display value 0',
78         lib_opac         => 'opac display value 0',
79     }
80 )->store();
81
82 ok( $av1->id(), 'AV 1 is inserted' );
83 ok( $av2->id(), 'AV 2 is inserted' );
84 ok( $av3->id(), 'AV 3 is inserted' );
85 ok( $av4->id(), 'AV 4 is inserted' );
86
87 { # delete is_system AV categories
88     try {
89         Koha::AuthorisedValueCategories->find('av_for_testing')->delete
90     }
91     catch {
92         ok(
93             $_->isa('Koha::Exceptions::CannotDeleteDefault'),
94             'A system AV category cannot be deleted'
95         );
96     };
97
98     try {
99         Koha::AuthorisedValueCategories->search->delete
100     }
101     catch {
102         ok(
103             $_->isa('Koha::Exceptions::CannotDeleteDefault'),
104             'system AV categories cannot be deleted'
105         );
106     };
107 }
108
109 is( $av3->opac_description, 'opac display value 3', 'Got correction opac description if lib_opac is set' );
110 $av3->lib_opac('');
111 is( $av3->opac_description, 'display value 3', 'Got correction opac description if lib_opac is *not* set' );
112
113 my @authorised_values =
114   Koha::AuthorisedValues->new()->search( { category => 'av_for_testing' } )->as_list;
115 is( @authorised_values, 3, "Get correct number of values" );
116
117 my $branchcode1 = $builder->build({ source => 'Branch' })->{branchcode};
118 my $branchcode2 = $builder->build({ source => 'Branch' })->{branchcode};
119
120 $av1->add_library_limit( $branchcode1 );
121
122 @authorised_values = Koha::AuthorisedValues->search_with_library_limits( { category => 'av_for_testing' }, {}, $branchcode1 )->as_list;
123 is( @authorised_values, 3, "Search including value with a branch limit ( branch can use the limited value ) gives correct number of results" );
124
125 @authorised_values = Koha::AuthorisedValues->search_with_library_limits( { category => 'av_for_testing' }, {}, $branchcode2 )->as_list;
126 is( @authorised_values, 2, "Search including value with a branch limit ( branch *cannot* use the limited value ) gives correct number of results" );
127
128 $av1->del_library_limit( $branchcode1 );
129 @authorised_values = Koha::AuthorisedValues->search_with_library_limits( { category => 'av_for_testing' }, {}, $branchcode2 )->as_list;
130 is( @authorised_values, 3, "Branch limitation deleted successfully" );
131
132 $av1->add_library_limit( $branchcode1 );
133 $av1->library_limits( [ $branchcode1, $branchcode2 ] );
134
135 my $limits = $av1->library_limits->as_list;
136 is( @$limits, 2, 'library_limits functions correctly both as setter and getter' );
137
138 my @categories = Koha::AuthorisedValues->new->categories;
139 is( @categories, @existing_categories+3, 'There should have 3 categories inserted' );
140 is_deeply(
141     \@categories,
142     [ sort { uc $a cmp uc $b } @categories ],
143     'categories must be ordered by category names'
144 );
145
146 subtest 'search_by_*_field + find_by_koha_field + get_description' => sub {
147     plan tests => 5;
148
149     my $test_cat = Koha::AuthorisedValueCategories->find('TEST');
150     $test_cat->delete if $test_cat;
151     my $mss = Koha::MarcSubfieldStructures->search( { tagfield => 952, tagsubfield => 'c', frameworkcode => '' } );
152     $mss->delete if $mss;
153     $mss = Koha::MarcSubfieldStructures->search( { tagfield => 952, tagsubfield => 'c', frameworkcode => 'ACQ' } );
154     $mss->delete if $mss;
155     $mss = Koha::MarcSubfieldStructures->search( { tagfield => 952, tagsubfield => 'd', frameworkcode => '' } );
156     $mss->delete if $mss;
157     $mss = Koha::MarcSubfieldStructures->search( { tagfield => 952, tagsubfield => '5', frameworkcode => '' } );
158     $mss->delete if $mss;
159     Koha::AuthorisedValueCategory->new( { category_name => 'TEST' } )->store;
160     Koha::AuthorisedValueCategory->new( { category_name => 'ANOTHER_4_TESTS' } )->store;
161     Koha::MarcSubfieldStructure->new( { tagfield => 952, tagsubfield => 'c', frameworkcode => '', authorised_value => 'TEST', kohafield => 'items.location' } )->store;
162     Koha::MarcSubfieldStructure->new( { tagfield => 952, tagsubfield => 'c', frameworkcode => 'ACQ', authorised_value => 'TEST', kohafield => 'items.location' } )->store;
163     Koha::MarcSubfieldStructure->new( { tagfield => 952, tagsubfield => 'd', frameworkcode => '', authorised_value => 'ANOTHER_4_TESTS', kohafield => 'items.another_field' } )->store;
164     Koha::MarcSubfieldStructure->new( { tagfield => 952, tagsubfield => '5', frameworkcode => '', authorised_value => 'restricted_for_testing', kohafield => 'items.restricted' } )->store;
165     Koha::AuthorisedValue->new( { category => 'TEST', authorised_value => 'location_1', lib => 'location_1' } )->store;
166     Koha::AuthorisedValue->new( { category => 'TEST', authorised_value => 'location_2', lib => 'location_2' } )->store;
167     Koha::AuthorisedValue->new( { category => 'TEST', authorised_value => 'location_3', lib => 'location_3' } )->store;
168     Koha::AuthorisedValue->new( { category => 'ANOTHER_4_TESTS', authorised_value => 'an_av' } )->store;
169     Koha::AuthorisedValue->new( { category => 'ANOTHER_4_TESTS', authorised_value => 'another_av' } )->store;
170     subtest 'search_by_marc_field' => sub {
171         plan tests => 4;
172         my $avs;
173         $avs = Koha::AuthorisedValues->search_by_marc_field();
174         is ( $avs, undef );
175         $avs = Koha::AuthorisedValues->search_by_marc_field({ frameworkcode => '' });
176         is ( $avs, undef );
177         $avs = Koha::AuthorisedValues->search_by_marc_field({ tagfield => 952, tagsubfield => 'c'});
178         is( $avs->count, 3, 'default fk');
179         is( $avs->next->authorised_value, 'location_1', );
180     };
181     subtest 'search_by_koha_field' => sub {
182         plan tests => 3;
183         my $avs;
184         $avs = Koha::AuthorisedValues->search_by_koha_field();
185         is ( $avs, undef );
186         $avs = Koha::AuthorisedValues->search_by_koha_field( { kohafield => 'items.location' } );
187         is( $avs->count,                  3, );
188         is( $avs->next->authorised_value, 'location_1', );
189
190     };
191     subtest 'find_by_koha_field' => sub {
192         plan tests => 3;
193         # Test authorised_value = 0
194         my $av;
195         $av = Koha::AuthorisedValues->find_by_koha_field( { kohafield => 'items.restricted', authorised_value => 0 } );
196         is( $av->lib, $av_0->lib, );
197         # Test authorised_value = ""
198         $av = Koha::AuthorisedValues->find_by_koha_field( { kohafield => 'items.restricted', authorised_value => '' } );
199         is( $av->lib, $av_empty_string->lib, );
200         # Test authorised_value = undef => we do not want to retrieve anything
201         $av = Koha::AuthorisedValues->find_by_koha_field( { kohafield => 'items.restricted', authorised_value => undef } );
202         is( $av, undef, );
203     };
204     subtest 'get_description_by_koha_field' => sub {
205         plan tests => 4;
206         my $descriptions;
207
208         # Test authorised_value = 0
209         $descriptions = Koha::AuthorisedValues->get_description_by_koha_field(
210             { kohafield => 'items.restricted', authorised_value => 0 } );
211         is_deeply( $descriptions,
212             { lib => $av_0->lib, opac_description => $av_0->lib_opac },
213         );
214
215         # Test authorised_value = ""
216         $descriptions = Koha::AuthorisedValues->get_description_by_koha_field(
217             { kohafield => 'items.restricted', authorised_value => '' } );
218         is_deeply(
219             $descriptions,
220             {
221                 lib              => $av_empty_string->lib,
222                 opac_description => $av_empty_string->lib_opac
223             },
224         );
225
226         # Test authorised_value = undef => we do not want to retrieve anything
227         $descriptions = Koha::AuthorisedValues->get_description_by_koha_field(
228             { kohafield => 'items.restricted', authorised_value => undef } );
229         is_deeply( $descriptions, {}, ) ;    # This could be arguable, we could return undef instead
230
231         # No authorised_value
232         $descriptions = Koha::AuthorisedValues->get_description_by_koha_field(
233             { kohafield => 'items.restricted', authorised_value => "does not exist" } );
234         is_deeply( $descriptions, {}, ) ;    # This could be arguable, we could return undef instead
235     };
236     subtest 'get_descriptions_by_koha_field' => sub {
237         plan tests => 1;
238         my @descriptions = Koha::AuthorisedValues->get_descriptions_by_koha_field( { kohafield => 'items.restricted' } );
239         is_deeply(
240             \@descriptions,
241             [
242                 {
243                     authorised_value => $av_0->authorised_value,
244                     lib              => $av_0->lib,
245                     opac_description => $av_0->lib_opac
246                 },
247                 {
248                     authorised_value => '',
249                     lib              => $av_empty_string->lib,
250                     opac_description => $av_empty_string->lib_opac
251                 }
252             ],
253         );
254     };
255 };
256
257 $schema->storage->txn_rollback;