use POSIX regexp operator instead of ILIKE
[Evergreen.git] / Open-ILS / src / sql / Pg / 300.schema.staged_search.sql
1
2 DROP SCHEMA search CASCADE;
3
4 BEGIN;
5
6 CREATE SCHEMA search;
7
8 CREATE TABLE search.relevance_adjustment (
9     id          SERIAL  PRIMARY KEY,
10     active      BOOL    NOT NULL DEFAULT TRUE,
11     field       INT     NOT NULL REFERENCES config.metabib_field (id),
12     bump_type   TEXT    NOT NULL CHECK (bump_type IN ('word_order','first_word','full_match')),
13     multiplier  NUMERIC NOT NULL DEFAULT 1.0
14 );
15 CREATE UNIQUE INDEX bump_once_per_field_idx ON search.relevance_adjustment ( field, bump_type );
16
17 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(1, 'first_word', 1.5);
18 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(1, 'full_match', 20);
19 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(2, 'first_word', 1.5);
20 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(2, 'word_order', 10);
21 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(2, 'full_match', 20);
22 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(3, 'first_word', 1.5);
23 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(3, 'word_order', 10);
24 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(3, 'full_match', 20);
25 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(4, 'first_word', 1.5);
26 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(4, 'word_order', 10);
27 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(4, 'full_match', 20);
28 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(5, 'first_word', 1.5);
29 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(5, 'word_order', 10);
30 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(5, 'full_match', 20);
31 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(6, 'first_word', 1.5);
32 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(7, 'first_word', 1.5);
33 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(8, 'first_word', 1.5);
34 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(9, 'first_word', 1.5);
35 INSERT INTO search.relevance_adjustment (field, bump_type, multiplier) VALUES(14, 'word_order', 10);
36
37 CREATE OR REPLACE FUNCTION search.pick_table (TEXT) RETURNS TEXT AS $$
38     SELECT  CASE
39                 WHEN $1 = 'author'  THEN 'metabib.author_field_entry'
40                 WHEN $1 = 'title'   THEN 'metabib.title_field_entry'
41                 WHEN $1 = 'subject' THEN 'metabib.subject_field_entry'
42                 WHEN $1 = 'keyword' THEN 'metabib.keyword_field_entry'
43                 WHEN $1 = 'series'  THEN 'metabib.series_field_entry'
44             END;
45 $$ LANGUAGE SQL;
46
47 CREATE TYPE search.search_result AS ( id BIGINT, rel NUMERIC, record INT, total INT, checked INT, visible INT, deleted INT, excluded INT );
48 CREATE TYPE search.search_args AS ( id INT, field_class TEXT, field_name TEXT, table_alias TEXT, term TEXT, term_type TEXT );
49
50 CREATE OR REPLACE FUNCTION search.staged_fts (
51
52     param_search_ou INT,
53     param_depth     INT,
54     param_searches  TEXT, -- JSON hash, to be turned into a resultset via search.parse_search_args
55     param_statuses  INT[],
56     param_audience  TEXT[],
57     param_language  TEXT[],
58     param_lit_form  TEXT[],
59     param_types     TEXT[],
60     param_forms     TEXT[],
61     param_vformats  TEXT[],
62     param_pref_lang TEXT,
63     param_pref_lang_multiplier REAL,
64     param_sort      TEXT,
65     param_sort_desc BOOL,
66     metarecord      BOOL,
67     staff           BOOL,
68     param_rel_limit INT,
69     param_chk_limit INT,
70     param_skip_chk  INT
71  
72 ) RETURNS SETOF search.search_result AS $func$
73 DECLARE
74
75     current_res         search.search_result%ROWTYPE;
76     query_part          search.search_args%ROWTYPE;
77     phrase_query_part   search.search_args%ROWTYPE;
78     rank_adjust_id      INT;
79     core_rel_limit      INT;
80     core_chk_limit      INT;
81     core_skip_chk       INT;
82     rank_adjust         search.relevance_adjustment%ROWTYPE;
83     query_table         TEXT;
84     tmp_text            TEXT;
85     tmp_int             INT;
86     current_rank        TEXT;
87     ranks               TEXT[] := '{}';
88     query_table_alias   TEXT;
89     from_alias_array    TEXT[] := '{}';
90     used_ranks          TEXT[] := '{}';
91     mb_field            INT;
92     mb_field_list       INT[];
93     search_org_list     INT[];
94     select_clause       TEXT := 'SELECT';
95     from_clause         TEXT := ' FROM  metabib.metarecord_source_map m JOIN metabib.rec_descriptor mrd ON (m.source = mrd.record) ';
96     where_clause        TEXT := ' WHERE 1=1 ';
97     mrd_used            BOOL := FALSE;
98     sort_desc           BOOL := FALSE;
99
100     core_result         RECORD;
101     core_cursor         REFCURSOR;
102     core_rel_query      TEXT;
103     vis_limit_query     TEXT;
104     inner_where_clause  TEXT;
105
106     total_count         INT := 0;
107     check_count         INT := 0;
108     deleted_count       INT := 0;
109     visible_count       INT := 0;
110     excluded_count      INT := 0;
111
112 BEGIN
113
114     core_rel_limit := COALESCE( param_rel_limit, 25000 );
115     core_chk_limit := COALESCE( param_chk_limit, 1000 );
116     core_skip_chk := COALESCE( param_skip_chk, 1 );
117
118     IF metarecord THEN
119         select_clause := select_clause || ' m.metarecord as id, array_accum(distinct m.source) as records,';
120     ELSE
121         select_clause := select_clause || ' m.source as id, array_accum(distinct m.source) as records,';
122     END IF;
123
124     -- first we need to construct the base query
125     FOR query_part IN SELECT * FROM search.parse_search_args(param_searches) WHERE term_type = 'fts_query' LOOP
126
127         inner_where_clause := 'index_vector @@ ' || query_part.term;
128
129         IF query_part.field_name IS NOT NULL THEN
130
131            SELECT  id INTO mb_field
132              FROM  config.metabib_field
133              WHERE field_class = query_part.field_class
134                    AND name = query_part.field_name;
135
136             IF FOUND THEN
137                 inner_where_clause := inner_where_clause ||
138                     ' AND ' || 'field = ' || mb_field;
139             END IF;
140
141         END IF;
142
143         -- moving on to the rank ...
144         SELECT  * INTO query_part
145           FROM  search.parse_search_args(param_searches)
146           WHERE term_type = 'fts_rank'
147                 AND table_alias = query_part.table_alias;
148
149         current_rank := query_part.term || ' * ' || query_part.table_alias || '_weight.weight';
150
151         IF query_part.field_name IS NOT NULL THEN
152
153            SELECT  array_accum(distinct id) INTO mb_field_list
154              FROM  config.metabib_field
155              WHERE field_class = query_part.field_class
156                    AND name = query_part.field_name;
157
158         ELSE
159
160            SELECT  array_accum(distinct id) INTO mb_field_list
161              FROM  config.metabib_field
162              WHERE field_class = query_part.field_class;
163
164         END IF;
165
166         FOR rank_adjust IN SELECT * FROM search.relevance_adjustment WHERE active AND field IN ( SELECT * FROM search.explode_array( mb_field_list ) ) LOOP
167
168             IF NOT rank_adjust.bump_type = ANY (used_ranks) THEN
169
170                 IF rank_adjust.bump_type = 'first_word' THEN
171                     SELECT  term INTO tmp_text
172                       FROM  search.parse_search_args(param_searches)
173                       WHERE table_alias = query_part.table_alias AND term_type = 'word'
174                       ORDER BY id
175                       LIMIT 1;
176
177                     tmp_text := query_part.table_alias || '.value ILIKE ' || quote_literal( tmp_text || '%' );
178
179                 ELSIF rank_adjust.bump_type = 'word_order' THEN
180                     SELECT  array_to_string( array_accum( term ), '%' ) INTO tmp_text
181                       FROM  search.parse_search_args(param_searches)
182                       WHERE table_alias = query_part.table_alias AND term_type = 'word';
183
184                     tmp_text := query_part.table_alias || '.value ILIKE ' || quote_literal( '%' || tmp_text || '%' );
185
186                 ELSIF rank_adjust.bump_type = 'full_match' THEN
187                     SELECT  array_to_string( array_accum( term ), E'\\s+' ) INTO tmp_text
188                       FROM  search.parse_search_args(param_searches)
189                       WHERE table_alias = query_part.table_alias AND term_type = 'word';
190
191                     tmp_text := query_part.table_alias || '.value  ~ ' || quote_literal( '^' || tmp_text || E'\\W*$' );
192
193                 END IF;
194
195
196                 current_rank := current_rank || ' * ( CASE WHEN ' || tmp_text ||
197                     ' THEN ' || rank_adjust.multiplier || '::REAL ELSE 1.0 END )';
198
199                 used_ranks := array_append( used_ranks, rank_adjust.bump_type );
200
201             END IF;
202
203         END LOOP;
204
205         ranks := array_append( ranks, current_rank );
206         used_ranks := '{}';
207
208         FOR phrase_query_part IN
209             SELECT  * 
210               FROM  search.parse_search_args(param_searches)
211               WHERE term_type = 'phrase'
212                     AND table_alias = query_part.table_alias LOOP
213
214             tmp_text := replace( phrase_query_part.term, '*', E'\\*' );
215             tmp_text := replace( tmp_text, '?', E'\\?' );
216             tmp_text := replace( tmp_text, '+', E'\\+' );
217             tmp_text := replace( tmp_text, '|', E'\\|' );
218             tmp_text := replace( tmp_text, '(', E'\\(' );
219             tmp_text := replace( tmp_text, ')', E'\\)' );
220             tmp_text := replace( tmp_text, '[', E'\\[' );
221             tmp_text := replace( tmp_text, ']', E'\\]' );
222
223             inner_where_clause := inner_where_clause || ' AND ' || 'value  ~* ' || quote_literal( E'(^|\\W+)' || regexp_replace(tmp_text, E'\\s+',E'\\\\s+','g') || E'(\\W+|\$)' );
224
225         END LOOP;
226
227         query_table := search.pick_table(query_part.field_class);
228
229         from_clause := from_clause ||
230             ' JOIN ( SELECT * FROM ' || query_table || ' WHERE ' || inner_where_clause ||
231                     CASE WHEN core_rel_limit > 0 THEN ' LIMIT ' || core_rel_limit::TEXT ELSE '' END || ' ) AS ' || query_part.table_alias ||
232                 ' ON ( m.source = ' || query_part.table_alias || '.source )' ||
233             ' JOIN config.metabib_field AS ' || query_part.table_alias || '_weight' ||
234                 ' ON ( ' || query_part.table_alias || '.field = ' || query_part.table_alias || '_weight.id  AND  ' || query_part.table_alias || '_weight.search_field)';
235
236         from_alias_array := array_append(from_alias_array, query_part.table_alias);
237
238     END LOOP;
239
240     IF param_pref_lang IS NOT NULL AND param_pref_lang_multiplier IS NOT NULL THEN
241         current_rank := ' CASE WHEN mrd.item_lang = ' || quote_literal( param_pref_lang ) ||
242             ' THEN ' || param_pref_lang_multiplier || '::REAL ELSE 1.0 END ';
243
244         --ranks := array_append( ranks, current_rank );
245     END IF;
246
247     current_rank := ' AVG( ( (' || array_to_string( ranks, ') + (' ) || ') ) * ' || current_rank || ' ) ';
248     select_clause := select_clause || current_rank || ' AS rel,';
249
250     sort_desc = param_sort_desc;
251
252     IF param_sort = 'pubdate' THEN
253
254         tmp_text := '999999';
255         IF param_sort_desc THEN tmp_text := '0'; END IF;
256
257         current_rank := $$
258             ( COALESCE( FIRST ((
259                 SELECT  SUBSTRING(frp.value FROM E'\\d{4}')
260                   FROM  metabib.full_rec frp
261                   WHERE frp.record = m.source
262                     AND frp.tag = '260'
263                     AND frp.subfield = 'c'
264                   LIMIT 1
265             )), $$ || quote_literal(tmp_text) || $$ )::INT )
266         $$;
267
268     ELSIF param_sort = 'title' THEN
269
270         tmp_text := 'zzzzzz';
271         IF param_sort_desc THEN tmp_text := '    '; END IF;
272
273         current_rank := $$
274             ( COALESCE( FIRST ((
275                 SELECT  LTRIM(SUBSTR( frt.value, COALESCE(SUBSTRING(frt.ind2 FROM E'\\d+'),'0')::INT + 1 ))
276                   FROM  metabib.full_rec frt
277                   WHERE frt.record = m.source
278                     AND frt.tag = '245'
279                     AND frt.subfield = 'a'
280                   LIMIT 1
281             )),$$ || quote_literal(tmp_text) || $$))
282         $$;
283
284     ELSIF param_sort = 'author' THEN
285
286         tmp_text := 'zzzzzz';
287         IF param_sort_desc THEN tmp_text := '    '; END IF;
288
289         current_rank := $$
290             ( COALESCE( FIRST ((
291                 SELECT  LTRIM(fra.value)
292                   FROM  metabib.full_rec fra
293                   WHERE fra.record = m.source
294                     AND fra.tag LIKE '1%'
295                     AND fra.subfield = 'a'
296                   ORDER BY fra.tag::text::int
297                   LIMIT 1
298             )),$$ || quote_literal(tmp_text) || $$))
299         $$;
300
301     ELSIF param_sort = 'create_date' THEN
302             current_rank := $$( FIRST (( SELECT create_date FROM biblio.record_entry rbr WHERE rbr.id = m.source)) )$$;
303     ELSIF param_sort = 'edit_date' THEN
304             current_rank := $$( FIRST (( SELECT edit_date FROM biblio.record_entry rbr WHERE rbr.id = m.source)) )$$;
305     ELSE
306         sort_desc := NOT COALESCE(param_sort_desc, FALSE);
307     END IF;
308
309     select_clause := select_clause || current_rank || ' AS rank';
310
311     -- now add the other qualifiers
312     IF param_audience IS NOT NULL AND array_upper(param_audience, 1) > 0 THEN
313         where_clause = where_clause || $$ AND mrd.audience IN ('$$ || array_to_string(param_audience, $$','$$) || $$') $$;
314     END IF;
315
316     IF param_language IS NOT NULL AND array_upper(param_language, 1) > 0 THEN
317         where_clause = where_clause || $$ AND mrd.item_lang IN ('$$ || array_to_string(param_language, $$','$$) || $$') $$;
318     END IF;
319
320     IF param_lit_form IS NOT NULL AND array_upper(param_lit_form, 1) > 0 THEN
321         where_clause = where_clause || $$ AND mrd.lit_form IN ('$$ || array_to_string(param_lit_form, $$','$$) || $$') $$;
322     END IF;
323
324     IF param_types IS NOT NULL AND array_upper(param_types, 1) > 0 THEN
325         where_clause = where_clause || $$ AND mrd.item_type IN ('$$ || array_to_string(param_types, $$','$$) || $$') $$;
326     END IF;
327
328     IF param_forms IS NOT NULL AND array_upper(param_forms, 1) > 0 THEN
329         where_clause = where_clause || $$ AND mrd.item_form IN ('$$ || array_to_string(param_forms, $$','$$) || $$') $$;
330     END IF;
331
332     IF param_vformats IS NOT NULL AND array_upper(param_vformats, 1) > 0 THEN
333         where_clause = where_clause || $$ AND mrd.vr_format IN ('$$ || array_to_string(param_vformats, $$','$$) || $$') $$;
334     END IF;
335
336     core_rel_query := select_clause || from_clause || where_clause ||
337                         ' GROUP BY 1 ORDER BY 4' || CASE WHEN sort_desc THEN ' DESC' ELSE ' ASC' END || ';';
338     RAISE NOTICE 'Base Query:  %', core_rel_query;
339
340     IF param_depth IS NOT NULL THEN
341         SELECT array_accum(distinct id) INTO search_org_list FROM actor.org_unit_descendants( param_search_ou, param_depth );
342     ELSE
343         SELECT array_accum(distinct id) INTO search_org_list FROM actor.org_unit_descendants( param_search_ou );
344     END IF;
345
346     OPEN core_cursor FOR EXECUTE core_rel_query;
347
348     LOOP
349
350         FETCH core_cursor INTO core_result;
351         EXIT WHEN NOT FOUND;
352
353
354         IF total_count % 1000 = 0 THEN
355             -- RAISE NOTICE ' % total, % checked so far ... ', total_count, check_count;
356         END IF;
357
358         IF core_chk_limit > 0 AND total_count - core_skip_chk + 1 >= core_chk_limit THEN
359             total_count := total_count + 1;
360             CONTINUE;
361         END IF;
362
363         total_count := total_count + 1;
364
365         CONTINUE WHEN param_skip_chk IS NOT NULL and total_count < param_skip_chk;
366
367         check_count := check_count + 1;
368
369         PERFORM 1 FROM biblio.record_entry b WHERE NOT b.deleted AND b.id IN ( SELECT * FROM search.explode_array( core_result.records ) );
370         IF NOT FOUND THEN
371             -- RAISE NOTICE ' % were all deleted ... ', core_result.records;
372             deleted_count := deleted_count + 1;
373             CONTINUE;
374         END IF;
375
376         PERFORM 1
377           FROM  biblio.record_entry b
378                 JOIN config.bib_source s ON (b.source = s.id)
379           WHERE s.transcendant
380                 AND b.id IN ( SELECT * FROM search.explode_array( core_result.records ) );
381
382         IF FOUND THEN
383             -- RAISE NOTICE ' % were all transcendant ... ', core_result.records;
384             visible_count := visible_count + 1;
385
386             current_res.id = core_result.id;
387             current_res.rel = core_result.rel;
388
389             tmp_int := 1;
390             IF metarecord THEN
391                 SELECT COUNT(DISTINCT s.source) INTO tmp_int FROM metabib.metarecord_source_map s WHERE s.metarecord = core_result.id;
392             END IF;
393
394             IF tmp_int = 1 THEN
395                 current_res.record = core_result.records[1];
396             ELSE
397                 current_res.record = NULL;
398             END IF;
399
400             RETURN NEXT current_res;
401
402             CONTINUE;
403         END IF;
404
405         IF param_statuses IS NOT NULL AND array_upper(param_statuses, 1) > 0 THEN
406
407             PERFORM 1
408               FROM  asset.call_number cn
409                     JOIN asset.copy cp ON (cp.call_number = cn.id)
410               WHERE NOT cn.deleted
411                     AND NOT cp.deleted
412                     AND cp.status IN ( SELECT * FROM search.explode_array( param_statuses ) )
413                     AND cn.record IN ( SELECT * FROM search.explode_array( core_result.records ) )
414                     AND cp.circ_lib IN ( SELECT * FROM search.explode_array( search_org_list ) )
415               LIMIT 1;
416
417             IF NOT FOUND THEN
418                 -- RAISE NOTICE ' % were all status-excluded ... ', core_result.records;
419                 excluded_count := excluded_count + 1;
420                 CONTINUE;
421             END IF;
422
423         END IF;
424
425         IF staff IS NULL OR NOT staff THEN
426
427             PERFORM 1
428               FROM  asset.call_number cn
429                     JOIN asset.copy cp ON (cp.call_number = cn.id)
430                     JOIN actor.org_unit a ON (cp.circ_lib = a.id)
431                     JOIN asset.copy_location cl ON (cp.location = cl.id)
432                     JOIN config.copy_status cs ON (cp.status = cs.id)
433               WHERE NOT cn.deleted
434                     AND NOT cp.deleted
435                     AND cs.holdable
436                     AND cl.opac_visible
437                     AND cp.opac_visible
438                     AND a.opac_visible
439                     AND cp.circ_lib IN ( SELECT * FROM search.explode_array( search_org_list ) )
440                     AND cn.record IN ( SELECT * FROM search.explode_array( core_result.records ) )
441               LIMIT 1;
442
443             IF NOT FOUND THEN
444                 -- RAISE NOTICE ' % were all visibility-excluded ... ', core_result.records;
445                 excluded_count := excluded_count + 1;
446                 CONTINUE;
447             END IF;
448
449         ELSE
450
451             PERFORM 1
452               FROM  asset.call_number cn
453                     JOIN asset.copy cp ON (cp.call_number = cn.id)
454                     JOIN actor.org_unit a ON (cp.circ_lib = a.id)
455                     JOIN asset.copy_location cl ON (cp.location = cl.id)
456                     JOIN config.copy_status cs ON (cp.status = cs.id)
457               WHERE NOT cn.deleted
458                     AND NOT cp.deleted
459                     AND cp.circ_lib IN ( SELECT * FROM search.explode_array( search_org_list ) )
460                     AND cn.record IN ( SELECT * FROM search.explode_array( core_result.records ) )
461               LIMIT 1;
462
463             IF NOT FOUND THEN
464
465                 PERFORM 1
466                   FROM  asset.call_number cn
467                   WHERE cn.record IN ( SELECT * FROM search.explode_array( core_result.records ) )
468                   LIMIT 1;
469
470                 IF FOUND THEN
471                     -- RAISE NOTICE ' % were all visibility-excluded ... ', core_result.records;
472                     excluded_count := excluded_count + 1;
473                     CONTINUE;
474                 END IF;
475
476             END IF;
477
478         END IF;
479
480         visible_count := visible_count + 1;
481
482         current_res.id = core_result.id;
483         current_res.rel = core_result.rel;
484
485         tmp_int := 1;
486         IF metarecord THEN
487             SELECT COUNT(DISTINCT s.source) INTO tmp_int FROM metabib.metarecord_source_map s WHERE s.metarecord = core_result.id;
488         END IF;
489
490         IF tmp_int = 1 THEN
491             current_res.record = core_result.records[1];
492         ELSE
493             current_res.record = NULL;
494         END IF;
495
496         RETURN NEXT current_res;
497
498         IF visible_count % 1000 = 0 THEN
499             -- RAISE NOTICE ' % visible so far ... ', visible_count;
500         END IF;
501
502     END LOOP;
503
504     current_res.id = NULL;
505     current_res.rel = NULL;
506     current_res.record = NULL;
507     current_res.total = total_count;
508     current_res.checked = check_count;
509     current_res.deleted = deleted_count;
510     current_res.visible = visible_count;
511     current_res.excluded = excluded_count;
512
513     CLOSE core_cursor;
514
515     RETURN NEXT current_res;
516
517 END;
518 $func$ LANGUAGE PLPGSQL;
519
520 /*
521     param_statuses  INT[],
522     param_audience  TEXT[], x
523     param_language  TEXT[], x
524     param_lit_form  TEXT[], x
525     param_types     TEXT[], x
526     param_forms     TEXT[], x
527     param_vformats  TEXT[], x
528 */
529
530 CREATE OR REPLACE FUNCTION search.explode_array(anyarray) RETURNS SETOF anyelement AS $BODY$
531     SELECT ($1)[s] FROM generate_series(1, array_upper($1, 1)) AS s;
532 $BODY$
533 LANGUAGE 'sql' IMMUTABLE;
534
535 CREATE OR REPLACE FUNCTION search.parse_search_args (TEXT) RETURNS SETOF search.search_args AS $perlcode$
536     use JSON::XS;
537     my $json = shift;
538
539     my $args = decode_json( $json );
540
541     my $id = 1;
542
543     for my $k ( keys %$args ) {
544         (my $alias = $k) =~ s/\|/_/gso;
545         my ($class, $field) = split /\|/, $k;
546         my $part = $args->{$k};
547         for my $p ( keys %$part ) {
548             my $data = $part->{$p};
549             $data = [$data] if (!ref($data));
550             for my $datum ( @$data ) {
551                 return_next(
552                     {   field_class => $class,
553                         field_name  => $field,
554                         term        => $datum,
555                         table_alias => $alias,
556                         term_type   => $p,
557                         id          => $id,
558                     }
559                 );
560                 $id++;
561             }
562         }
563     }
564
565     return undef;
566
567 $perlcode$ LANGUAGE PLPERLU;
568
569
570 COMMIT;
571