|
Lines 99-104
BEGIN {
Link Here
|
| 99 |
|
99 |
|
| 100 |
&CountItemsIssued |
100 |
&CountItemsIssued |
| 101 |
&CountBiblioInOrders |
101 |
&CountBiblioInOrders |
|
|
102 |
|
| 103 |
&GetMarcPermissionsRules |
| 104 |
&GetMarcPermissionsModules |
| 105 |
&ModMarcPermissionsRule |
| 106 |
&AddMarcPermissionsRule |
| 107 |
&DelMarcPermissionsRule |
| 102 |
); |
108 |
); |
| 103 |
|
109 |
|
| 104 |
# To modify something |
110 |
# To modify something |
|
Lines 126-131
BEGIN {
Link Here
|
| 126 |
# they are useful in a few circumstances, so they are exported, |
132 |
# they are useful in a few circumstances, so they are exported, |
| 127 |
# but don't use them unless you are a core developer ;-) |
133 |
# but don't use them unless you are a core developer ;-) |
| 128 |
push @EXPORT, qw( |
134 |
push @EXPORT, qw( |
|
|
135 |
&ApplyMarcPermissions |
| 129 |
&ModBiblioMarc |
136 |
&ModBiblioMarc |
| 130 |
); |
137 |
); |
| 131 |
|
138 |
|
|
Lines 263-269
sub AddBiblio {
Link Here
|
| 263 |
|
270 |
|
| 264 |
=head2 ModBiblio |
271 |
=head2 ModBiblio |
| 265 |
|
272 |
|
| 266 |
ModBiblio( $record,$biblionumber,$frameworkcode); |
273 |
ModBiblio($record, $biblionumber, $frameworkcode, $options); |
| 267 |
|
274 |
|
| 268 |
Replace an existing bib record identified by C<$biblionumber> |
275 |
Replace an existing bib record identified by C<$biblionumber> |
| 269 |
with one supplied by the MARC::Record object C<$record>. The embedded |
276 |
with one supplied by the MARC::Record object C<$record>. The embedded |
|
Lines 284-290
Returns 1 on success 0 on failure
Link Here
|
| 284 |
=cut |
291 |
=cut |
| 285 |
|
292 |
|
| 286 |
sub ModBiblio { |
293 |
sub ModBiblio { |
| 287 |
my ( $record, $biblionumber, $frameworkcode ) = @_; |
294 |
my ( $record, $biblionumber, $frameworkcode, $options ) = @_; |
|
|
295 |
$options //= {}; |
| 296 |
|
| 288 |
if (!$record) { |
297 |
if (!$record) { |
| 289 |
carp 'No record passed to ModBiblio'; |
298 |
carp 'No record passed to ModBiblio'; |
| 290 |
return 0; |
299 |
return 0; |
|
Lines 312-317
sub ModBiblio {
Link Here
|
| 312 |
|
321 |
|
| 313 |
_strip_item_fields($record, $frameworkcode); |
322 |
_strip_item_fields($record, $frameworkcode); |
| 314 |
|
323 |
|
|
|
324 |
# apply permissions |
| 325 |
if (C4::Context->preference('MARCPermissions') && $biblionumber && defined $options && exists $options->{'context'}) { |
| 326 |
$record = ApplyMarcPermissions({ |
| 327 |
biblionumber => $biblionumber, |
| 328 |
record => $record, |
| 329 |
filter => $options->{'context'}, |
| 330 |
} |
| 331 |
); |
| 332 |
} |
| 333 |
|
| 315 |
# update biblionumber and biblioitemnumber in MARC |
334 |
# update biblionumber and biblioitemnumber in MARC |
| 316 |
# FIXME - this is assuming a 1 to 1 relationship between |
335 |
# FIXME - this is assuming a 1 to 1 relationship between |
| 317 |
# biblios and biblioitems |
336 |
# biblios and biblioitems |
|
Lines 322-334
sub ModBiblio {
Link Here
|
| 322 |
_koha_marc_update_bib_ids( $record, $frameworkcode, $biblionumber, $biblioitemnumber ); |
341 |
_koha_marc_update_bib_ids( $record, $frameworkcode, $biblionumber, $biblioitemnumber ); |
| 323 |
|
342 |
|
| 324 |
# load the koha-table data object |
343 |
# load the koha-table data object |
| 325 |
my $oldbiblio = TransformMarcToKoha( $record, $frameworkcode ); |
344 |
my $oldbiblio = TransformMarcToKoha( $record, $frameworkcode, undef, $biblionumber); |
| 326 |
|
345 |
|
| 327 |
# update MARC subfield that stores biblioitems.cn_sort |
346 |
# update MARC subfield that stores biblioitems.cn_sort |
| 328 |
_koha_marc_update_biblioitem_cn_sort( $record, $oldbiblio, $frameworkcode ); |
347 |
_koha_marc_update_biblioitem_cn_sort( $record, $oldbiblio, $frameworkcode ); |
| 329 |
|
348 |
|
| 330 |
# update the MARC record (that now contains biblio and items) with the new record data |
349 |
# update the MARC record (that now contains biblio and items) with the new record data |
| 331 |
&ModBiblioMarc( $record, $biblionumber, $frameworkcode ); |
350 |
ModBiblioMarc( $record, $biblionumber, $frameworkcode ); |
| 332 |
|
351 |
|
| 333 |
# modify the other koha tables |
352 |
# modify the other koha tables |
| 334 |
_koha_modify_biblio( $dbh, $oldbiblio, $frameworkcode ); |
353 |
_koha_modify_biblio( $dbh, $oldbiblio, $frameworkcode ); |
|
Lines 2508-2514
sub TransformHtmlToMarc {
Link Here
|
| 2508 |
|
2527 |
|
| 2509 |
=head2 TransformMarcToKoha |
2528 |
=head2 TransformMarcToKoha |
| 2510 |
|
2529 |
|
| 2511 |
$result = TransformMarcToKoha( $record, undef, $limit ) |
2530 |
$result = TransformMarcToKoha($record, undef, $biblionumber, $option) |
| 2512 |
|
2531 |
|
| 2513 |
Extract data from a MARC bib record into a hashref representing |
2532 |
Extract data from a MARC bib record into a hashref representing |
| 2514 |
Koha biblio, biblioitems, and items fields. |
2533 |
Koha biblio, biblioitems, and items fields. |
|
Lines 2519-2525
hash_ref.
Link Here
|
| 2519 |
=cut |
2538 |
=cut |
| 2520 |
|
2539 |
|
| 2521 |
sub TransformMarcToKoha { |
2540 |
sub TransformMarcToKoha { |
| 2522 |
my ( $record, $frameworkcode, $limit_table ) = @_; |
2541 |
my ( $record, $frameworkcode, $limit_table, $biblionumber ) = @_; |
| 2523 |
# FIXME Parameter $frameworkcode is obsolete and will be removed |
2542 |
# FIXME Parameter $frameworkcode is obsolete and will be removed |
| 2524 |
$limit_table //= q{}; |
2543 |
$limit_table //= q{}; |
| 2525 |
|
2544 |
|
|
Lines 3206-3212
sub _koha_delete_biblio_metadata {
Link Here
|
| 3206 |
|
3225 |
|
| 3207 |
=head2 ModBiblioMarc |
3226 |
=head2 ModBiblioMarc |
| 3208 |
|
3227 |
|
| 3209 |
&ModBiblioMarc($newrec,$biblionumber,$frameworkcode); |
3228 |
&ModBiblioMarc($newrec, $biblionumber, $frameworkcode, $options); |
| 3210 |
|
3229 |
|
| 3211 |
Add MARC XML data for a biblio to koha |
3230 |
Add MARC XML data for a biblio to koha |
| 3212 |
|
3231 |
|
|
Lines 3533-3540
sub RemoveAllNsb {
Link Here
|
| 3533 |
return $record; |
3552 |
return $record; |
| 3534 |
} |
3553 |
} |
| 3535 |
|
3554 |
|
| 3536 |
1; |
3555 |
=head2 ApplyMarcPermissions |
|
|
3556 |
|
| 3557 |
my $record = ApplyMarcPermissions($arguments) |
| 3558 |
|
| 3559 |
Applies marc permission rules to a record. |
| 3560 |
|
| 3561 |
C<$arguments> is expected to be a hashref with below keys defined. |
| 3562 |
|
| 3563 |
=over 4 |
| 3564 |
|
| 3565 |
=item C<biblionumber> |
| 3566 |
biblionumber of old record |
| 3567 |
|
| 3568 |
=item C<record> |
| 3569 |
record that will modify old record |
| 3570 |
|
| 3571 |
=item C<frameworkcode> |
| 3572 |
only tags included in framework will be processed |
| 3573 |
|
| 3574 |
=item C<filter> |
| 3575 |
hashref containing at least one filter module from the marc_permissions_modules |
| 3576 |
table in form {module => filter}. Three predefined filter modules exists: |
| 3577 |
|
| 3578 |
* source |
| 3579 |
* category |
| 3580 |
* borrower |
| 3581 |
|
| 3582 |
=item C<log> |
| 3583 |
optional reference to array that will be filled with rule evaluation log |
| 3584 |
entries. |
| 3585 |
|
| 3586 |
=item C<nolog> |
| 3587 |
optional boolean which when true disables logging to action log. |
| 3588 |
|
| 3589 |
=back |
| 3590 |
|
| 3591 |
Returns: |
| 3592 |
|
| 3593 |
=over 4 |
| 3594 |
|
| 3595 |
=item C<$record> |
| 3596 |
|
| 3597 |
new MARC record based on C<record> with C<filter> applied. If no old |
| 3598 |
record for C<biblionumber> can be found, C<record> is returned unchanged. |
| 3599 |
Default action when no matching filter found is to leave old record unchanged. |
| 3600 |
|
| 3601 |
=back |
| 3602 |
|
| 3603 |
=cut |
| 3604 |
|
| 3605 |
sub ApplyMarcPermissions { |
| 3606 |
my ($arguments) = @_; |
| 3607 |
my $biblionumber = $arguments->{biblionumber}; |
| 3608 |
my $incoming_record = $arguments->{record}; |
| 3609 |
|
| 3610 |
if ( !$biblionumber ) { |
| 3611 |
carp 'ApplyMarcPermissions called on undefined biblionumber'; |
| 3612 |
return; |
| 3613 |
} |
| 3614 |
if ( !$incoming_record ) { |
| 3615 |
carp 'ApplyMarcPermissions called on undefined record'; |
| 3616 |
return; |
| 3617 |
} |
| 3618 |
my $old_record = GetMarcBiblio({ biblionumber => $biblionumber }); |
| 3619 |
|
| 3620 |
my $merge_rules = undef; |
| 3621 |
if ($old_record && $arguments->{filter} && ($merge_rules = GetMarcPermissions($arguments->{filter}))) { |
| 3622 |
return MergeRecords($old_record, $incoming_record, $merge_rules); |
| 3623 |
} |
| 3624 |
return $incoming_record; |
| 3625 |
} |
| 3626 |
|
| 3627 |
sub MergeRecords { |
| 3628 |
my ($old_record, $incoming_record, $merge_rules) = @_; |
| 3629 |
my $is_matching_regex = sub { |
| 3630 |
my ( $tag, $m ) = @_; |
| 3631 |
|
| 3632 |
# tag is not exactly same as possible regex |
| 3633 |
$tag ne $m && |
| 3634 |
|
| 3635 |
# wildcard |
| 3636 |
$m ne '*' && |
| 3637 |
|
| 3638 |
# valid tagDataType |
| 3639 |
$m !~ /^(0[1-9A-z][\dA-Z]) | |
| 3640 |
([1-9A-z][\dA-z]{2})$/x && |
| 3641 |
|
| 3642 |
# nor valid controltagDataType |
| 3643 |
$m !~ /00[1-9A-Za-z]{1}/ && |
| 3644 |
|
| 3645 |
# so we try it as a regex |
| 3646 |
$tag =~ /^$m$/ |
| 3647 |
}; |
| 3648 |
|
| 3649 |
my $fields_by_tag = sub { |
| 3650 |
my ($record) = @_; |
| 3651 |
my $fields = {}; |
| 3652 |
foreach my $field ($record->fields()) { |
| 3653 |
$fields->{$field->tag()} //= []; |
| 3654 |
push @{$fields->{$field->tag()}}, $field; |
| 3655 |
} |
| 3656 |
return $fields; |
| 3657 |
}; |
| 3658 |
|
| 3659 |
my $hash_field_data = sub { |
| 3660 |
my ($field) = @_; |
| 3661 |
my $indicators = join("\x1E", map { $field->indicator($_) } (1, 2)); |
| 3662 |
return $indicators . "\x1E" . join("\x1E", sort map { join "\x1E", @{$_} } $field->subfields()); |
| 3663 |
}; |
| 3664 |
|
| 3665 |
my $diff_by_key = sub { |
| 3666 |
my ($a, $b) = @_; |
| 3667 |
my @removed; |
| 3668 |
my @intersecting; |
| 3669 |
my @added; |
| 3670 |
my %keys_index = map { $_ => undef } (keys %{$a}, keys %{$b}); |
| 3671 |
foreach my $key (keys %keys_index) { |
| 3672 |
if ($a->{$key} && $b->{$key}) { |
| 3673 |
push @intersecting, $a->{$key}; |
| 3674 |
} |
| 3675 |
elsif ($a->{$key}) { |
| 3676 |
push @removed, $a->{$key}; |
| 3677 |
} |
| 3678 |
else { |
| 3679 |
push @added, $b->{$key}; |
| 3680 |
} |
| 3681 |
} |
| 3682 |
return (\@removed, \@intersecting, \@added); |
| 3683 |
}; |
| 3684 |
|
| 3685 |
my $get_matching_field_rule = sub { |
| 3686 |
my ($tag) = @_; |
| 3687 |
my $matched_rule = undef; |
| 3688 |
# Exact match takes precedence |
| 3689 |
if (exists $merge_rules->{$tag}) { |
| 3690 |
$matched_rule = $merge_rules->{$tag}; |
| 3691 |
} |
| 3692 |
else { |
| 3693 |
# TODO: sorty by module/weight rule id or something, grab first matching via listutils thingy |
| 3694 |
my @matching_rules = map { $merge_rules->{$_} } grep { $is_matching_regex->($tag, $_) } sort keys %{$merge_rules}; |
| 3695 |
# TODO: fix |
| 3696 |
if (@matching_rules) { |
| 3697 |
$matched_rule = pop @matching_rules; |
| 3698 |
} |
| 3699 |
elsif($merge_rules->{'*'}) { |
| 3700 |
$matched_rule = $merge_rules->{'*'}; |
| 3701 |
} |
| 3702 |
} |
| 3703 |
return $matched_rule; |
| 3704 |
}; |
| 3705 |
|
| 3706 |
my $merged_record = MARC::Record->new(); |
| 3707 |
my @merged_record_fields; |
| 3708 |
|
| 3709 |
# Leader is always overwritten, or kept??? |
| 3710 |
$merged_record->leader($incoming_record->leader()); |
| 3711 |
|
| 3712 |
my $current_fields = $fields_by_tag->($old_record); |
| 3713 |
my $incoming_fields = $fields_by_tag->($incoming_record); |
| 3714 |
|
| 3715 |
# First we get all new incoming control fields |
| 3716 |
my @new_field_tags = grep { !(exists $current_fields->{$_}) } keys %{$incoming_fields}; |
| 3717 |
|
| 3718 |
foreach my $tag (@new_field_tags) { |
| 3719 |
my $rule = $get_matching_field_rule->($tag) // { |
| 3720 |
on_new => {'action' => 'skip', 'rule' => 0} |
| 3721 |
}; |
| 3722 |
if ( |
| 3723 |
$rule->{on_new}->{action} eq 'add' || |
| 3724 |
$rule->{on_new}->{action} eq 'overwrite' # ??? |
| 3725 |
) { # Or could just be write/protect? |
| 3726 |
# Hmm, only one control field possible?? |
| 3727 |
push @merged_record_fields, @{$incoming_fields->{$tag}}; |
| 3728 |
} |
| 3729 |
} |
| 3730 |
|
| 3731 |
# Then we get all control fields no longer present in incoming fields |
| 3732 |
# (removed) |
| 3733 |
my @deleted_field_tags = grep { !(exists $incoming_fields->{$_}) } keys %{$current_fields}; |
| 3734 |
foreach my $tag (@deleted_field_tags) { |
| 3735 |
my $rule = $get_matching_field_rule->($tag) // { |
| 3736 |
on_deleted => {'action' => 'skip', 'rule' => 0} |
| 3737 |
}; |
| 3738 |
if ($rule->{on_deleted}->{action} eq 'skip') { |
| 3739 |
push @merged_record_fields, @{$current_fields->{$tag}}; |
| 3740 |
} |
| 3741 |
} |
| 3742 |
|
| 3743 |
# Then we get the intersection of control fields, present both in |
| 3744 |
# current and incoming record (possibly to be overwritten) |
| 3745 |
my @common_field_tags = grep { exists $incoming_fields->{$_} } keys %{$current_fields}; |
| 3746 |
foreach my $tag (@common_field_tags) { |
| 3747 |
# Is control field |
| 3748 |
my $rule = $get_matching_field_rule->($tag) // { |
| 3749 |
on_removed => {'action' => 'skip', 'rule' => 0}, |
| 3750 |
on_appended => {'action' => 'skip', 'rule' => 0} |
| 3751 |
}; |
| 3752 |
if ($tag < 10) { |
| 3753 |
# on_existing = on_match |
| 3754 |
if ($rule->{on_appended}->{action} eq 'skip') { # TODO: replace with "protect", "keep" |
| 3755 |
push @merged_record_fields, @{$current_fields->{$tag}}; |
| 3756 |
} |
| 3757 |
elsif ($rule->{on_appended}->{action} eq 'append') { |
| 3758 |
push @merged_record_fields, @{$incoming_fields->{$tag}}; |
| 3759 |
} |
| 3760 |
if ( |
| 3761 |
$rule->{on_appended}->{action} eq 'append' && |
| 3762 |
$rule->{on_removed}->{action} eq 'skip' |
| 3763 |
) { |
| 3764 |
#TODO: This is an invalid combination for control fields, warn!! |
| 3765 |
# Or should perform client/server side validation to prevent this choice |
| 3766 |
} |
| 3767 |
} |
| 3768 |
else { |
| 3769 |
# Compute intersection and diff using field data |
| 3770 |
my %current_fields_by_data = map { $hash_field_data->($_) => $_ } @{$current_fields->{$tag}}; |
| 3771 |
my %incoming_fields_by_data = map { $hash_field_data->($_) => $_ } @{$incoming_fields->{$tag}}; |
| 3772 |
my ($current_fields_only, $common_fields, $incoming_fields_only) = $diff_by_key->(\%current_fields_by_data, \%incoming_fields_by_data); |
| 3773 |
|
| 3774 |
# First add common fields (intersection) |
| 3775 |
# Unchanged |
| 3776 |
if (@{$common_fields}) { |
| 3777 |
push @merged_record_fields, @{$common_fields}; |
| 3778 |
} |
| 3779 |
# Removed |
| 3780 |
if (@{$current_fields_only}) { |
| 3781 |
if ($rule->{on_removed}->{action} eq 'skip') { |
| 3782 |
push @merged_record_fields, @{$current_fields_only}; |
| 3783 |
} |
| 3784 |
} |
| 3785 |
# Appended |
| 3786 |
if (@{$incoming_fields_only}) { |
| 3787 |
if ($rule->{on_appended}->{action} eq 'append') { |
| 3788 |
push @merged_record_fields, @{$incoming_fields_only}; |
| 3789 |
} |
| 3790 |
} |
| 3791 |
} |
| 3792 |
} |
| 3793 |
if ($#merged_record_fields != 0) { |
| 3794 |
$merged_record->insert_fields_ordered(@merged_record_fields); |
| 3795 |
} |
| 3796 |
return $merged_record; |
| 3797 |
} |
| 3798 |
|
| 3799 |
=head2 GetMarcPermissions |
| 3800 |
|
| 3801 |
my $marc_permissions = GetMarcPermissions() |
| 3802 |
|
| 3803 |
Loads MARC field permissions from the marc_permissions table. |
| 3804 |
|
| 3805 |
Returns: |
| 3806 |
|
| 3807 |
=over 4 |
| 3808 |
|
| 3809 |
=item C<$marc_permissions> |
| 3810 |
|
| 3811 |
hashref with permissions structure for use with GetMarcPermissionsAction. |
| 3812 |
|
| 3813 |
=back |
| 3814 |
|
| 3815 |
=cut |
| 3816 |
|
| 3817 |
sub GetMarcPermissions { |
| 3818 |
my ($filter) = @_; |
| 3819 |
my $dbh = C4::Context->dbh; |
| 3820 |
my $rule_count = 0; |
| 3821 |
my $modules = GetMarcPermissionsModules(); |
| 3822 |
# We only care about modules included in the context/filter |
| 3823 |
# TODO: Perhaps make sure source => '*' is default? |
| 3824 |
my @filter_modules = grep { exists $filter->{$_->{name}} } @{$modules}; |
| 3825 |
|
| 3826 |
my $cache = Koha::Caches->get_instance(); |
| 3827 |
my $permissions = $cache->get_from_cache('marc_permissions', { unsafe => 1 }); |
| 3828 |
|
| 3829 |
if (!$permissions) { |
| 3830 |
my $query = ' |
| 3831 |
SELECT `marc_permissions`.*, |
| 3832 |
`marc_permissions_modules`.`name`, |
| 3833 |
`marc_permissions_modules`.`description`, |
| 3834 |
`marc_permissions_modules`.`specificity` |
| 3835 |
FROM `marc_permissions` |
| 3836 |
LEFT JOIN `marc_permissions_modules` ON `module` = `marc_permissions_modules`.`id` |
| 3837 |
ORDER BY `marc_permissions_modules`.`specificity`, `id` |
| 3838 |
'; |
| 3839 |
my $sth = $dbh->prepare($query); |
| 3840 |
$sth->execute(); |
| 3841 |
while (my $perm = $sth->fetchrow_hashref) { |
| 3842 |
my $target = ($permissions->{$perm->{name}}->{$perm->{filter}}->{$perm->{tagfield}} //= {}); |
| 3843 |
foreach my $event (GetMarcPermissionEvents()) { |
| 3844 |
$target->{$event} = { action => $perm->{$event}, rule => $perm->{'id'} }; |
| 3845 |
} |
| 3846 |
} |
| 3847 |
$cache->set_in_cache('marc_permissions', $permissions); |
| 3848 |
} |
| 3849 |
|
| 3850 |
my $filtered_permissions = undef; |
| 3851 |
foreach my $module (@filter_modules) { |
| 3852 |
if ( |
| 3853 |
exists $permissions->{$module->{name}} && |
| 3854 |
exists $permissions->{$module->{name}}->{$filter->{$module->{name}}} |
| 3855 |
) { |
| 3856 |
# TODO: Support multiple overlapping filters/context?? |
| 3857 |
$filtered_permissions = $permissions->{$module->{name}}->{$filter->{$module->{name}}}; |
| 3858 |
last; |
| 3859 |
} |
| 3860 |
} |
| 3861 |
if (!$filtered_permissions) { |
| 3862 |
# No perms matching specific context conditions found, try wildcard value for each active context |
| 3863 |
foreach my $module (@filter_modules) { |
| 3864 |
if (exists $permissions->{$module->{name}}->{'*'}) { |
| 3865 |
$filtered_permissions = $permissions->{$module->{name}}->{'*'}; |
| 3866 |
last; |
| 3867 |
} |
| 3868 |
} |
| 3869 |
} |
| 3870 |
return $filtered_permissions; |
| 3871 |
} |
| 3872 |
|
| 3873 |
# TODO: Use this in GetMarcPermissions |
| 3874 |
=head2 GetMarcPermissionsRules |
| 3875 |
|
| 3876 |
my $rules = GetMarcPermissionsRules() |
| 3877 |
|
| 3878 |
Returns: |
| 3879 |
|
| 3880 |
=over 4 |
| 3881 |
|
| 3882 |
=item C<$rules> |
| 3883 |
|
| 3884 |
array (in list context, arrayref otherwise) of hashrefs from marc_permissions |
| 3885 |
table in order of module specificity and rule id. |
| 3886 |
|
| 3887 |
=back |
| 3888 |
|
| 3889 |
=cut |
| 3890 |
|
| 3891 |
sub GetMarcPermissionsRules { |
| 3892 |
my $dbh = C4::Context->dbh; |
| 3893 |
my @rules = (); |
| 3894 |
|
| 3895 |
my $query = ' |
| 3896 |
SELECT `marc_permissions`.`id`, |
| 3897 |
`marc_permissions`.`tagfield`, |
| 3898 |
`marc_permissions`.`filter`, |
| 3899 |
`marc_permissions`.`on_new`, |
| 3900 |
`marc_permissions`.`on_appended`, |
| 3901 |
`marc_permissions`.`on_removed`, |
| 3902 |
`marc_permissions`.`on_deleted`, |
| 3903 |
`marc_permissions_modules`.`name` as `module`, |
| 3904 |
`marc_permissions_modules`.`description`, |
| 3905 |
`marc_permissions_modules`.`specificity` |
| 3906 |
FROM `marc_permissions` |
| 3907 |
LEFT JOIN `marc_permissions_modules` ON `module` = `marc_permissions_modules`.`id` |
| 3908 |
ORDER BY `marc_permissions_modules`.`specificity`, `id` |
| 3909 |
'; |
| 3910 |
my $sth = $dbh->prepare($query); |
| 3911 |
$sth->execute(); |
| 3912 |
while ( my $row = $sth->fetchrow_hashref ) { |
| 3913 |
push(@rules, $row); |
| 3914 |
} |
| 3915 |
|
| 3916 |
return wantarray ? @rules : \@rules; |
| 3917 |
} |
| 3918 |
|
| 3919 |
=head2 GetMarcPermissionsModules |
| 3920 |
|
| 3921 |
my $modules = GetMarcPermissionsModules() |
| 3922 |
|
| 3923 |
Returns: |
| 3924 |
|
| 3925 |
=over 4 |
| 3926 |
|
| 3927 |
=item C<$modules> |
| 3928 |
|
| 3929 |
array (in list context, arrayref otherwise) of hashrefs from |
| 3930 |
marc_permissions_modules table in order of specificity. |
| 3931 |
|
| 3932 |
=back |
| 3933 |
|
| 3934 |
=cut |
| 3537 |
|
3935 |
|
|
|
3936 |
sub GetMarcPermissionsModules { |
| 3937 |
my $dbh = C4::Context->dbh; |
| 3938 |
my @modules = (); |
| 3939 |
|
| 3940 |
my $query = ' |
| 3941 |
SELECT * |
| 3942 |
FROM `marc_permissions_modules` |
| 3943 |
ORDER BY `specificity` DESC |
| 3944 |
'; |
| 3945 |
my $sth = $dbh->prepare($query); |
| 3946 |
$sth->execute(); |
| 3947 |
while ( my $row = $sth->fetchrow_hashref ) { |
| 3948 |
push(@modules, $row); |
| 3949 |
} |
| 3950 |
|
| 3951 |
return wantarray ? @modules : \@modules; |
| 3952 |
} |
| 3953 |
|
| 3954 |
sub GetMarcPermissionEvents { |
| 3955 |
return ('on_new', 'on_appended', 'on_removed', 'on_deleted'); |
| 3956 |
} |
| 3957 |
|
| 3958 |
=head2 ModMarcPermissionsRule |
| 3959 |
|
| 3960 |
my $success = ModMarcPermissionsRule($id, $fields) |
| 3961 |
|
| 3962 |
Modifies rule in the marc_permissions table. |
| 3963 |
|
| 3964 |
=over 4 |
| 3965 |
|
| 3966 |
=item C<$id> |
| 3967 |
|
| 3968 |
rule id to modify |
| 3969 |
|
| 3970 |
=item C<$fields> |
| 3971 |
|
| 3972 |
hashref defining the table fields |
| 3973 |
|
| 3974 |
* tagfield - required |
| 3975 |
* module - required |
| 3976 |
* filter - required |
| 3977 |
* on_new - required |
| 3978 |
* on_appended - required |
| 3979 |
* on_removed - required |
| 3980 |
* on_deleted - required |
| 3981 |
|
| 3982 |
=back |
| 3983 |
|
| 3984 |
Returns: |
| 3985 |
|
| 3986 |
=over 4 |
| 3987 |
|
| 3988 |
=item C<$success> |
| 3989 |
|
| 3990 |
undef if an error occurs, otherwise true. |
| 3991 |
|
| 3992 |
=back |
| 3993 |
|
| 3994 |
=cut |
| 3995 |
|
| 3996 |
sub ModMarcPermissionsRule { |
| 3997 |
my ($id, $f) = @_; |
| 3998 |
my $dbh = C4::Context->dbh; |
| 3999 |
|
| 4000 |
my $query = ' |
| 4001 |
UPDATE `marc_permissions` |
| 4002 |
SET |
| 4003 |
tagfield = ?, |
| 4004 |
module = ?, |
| 4005 |
filter = ?, |
| 4006 |
on_new = ?, |
| 4007 |
on_appended = ?, |
| 4008 |
on_removed = ?, |
| 4009 |
on_deleted = ? |
| 4010 |
WHERE |
| 4011 |
id = ? |
| 4012 |
'; |
| 4013 |
my $sth = $dbh->prepare($query); |
| 4014 |
my $result = $sth->execute ( |
| 4015 |
$f->{tagfield}, |
| 4016 |
$f->{module}, |
| 4017 |
$f->{filter}, |
| 4018 |
$f->{on_new}, |
| 4019 |
$f->{on_appended}, |
| 4020 |
$f->{on_removed}, |
| 4021 |
$f->{on_deleted}, |
| 4022 |
$id |
| 4023 |
); |
| 4024 |
ClearMarcPermissionsRulesCache(); |
| 4025 |
return $result; |
| 4026 |
} |
| 4027 |
|
| 4028 |
sub ClearMarcPermissionsRulesCache { |
| 4029 |
my $cache = Koha::Caches->get_instance(); |
| 4030 |
$cache->clear_from_cache('marc_permissions'); |
| 4031 |
} |
| 4032 |
|
| 4033 |
=head2 AddMarcPermissionsRule |
| 4034 |
|
| 4035 |
my $success = AddMarcPermissionsRule($fields) |
| 4036 |
|
| 4037 |
Add rule to the marc_permissions table. |
| 4038 |
|
| 4039 |
=over 4 |
| 4040 |
|
| 4041 |
=item C<$fields> |
| 4042 |
|
| 4043 |
hashref defining the table fields |
| 4044 |
|
| 4045 |
tagfield - required |
| 4046 |
module - required |
| 4047 |
filter - required |
| 4048 |
on_new - required |
| 4049 |
on_appended - required |
| 4050 |
on_removed - required |
| 4051 |
on_deleted - required |
| 4052 |
|
| 4053 |
=back |
| 4054 |
|
| 4055 |
Returns: |
| 4056 |
|
| 4057 |
=over 4 |
| 4058 |
|
| 4059 |
=item C<$success> |
| 4060 |
|
| 4061 |
undef if an error occurs, otherwise true. |
| 4062 |
|
| 4063 |
=back |
| 4064 |
|
| 4065 |
=cut |
| 4066 |
|
| 4067 |
sub AddMarcPermissionsRule { |
| 4068 |
my $f = shift; |
| 4069 |
my $dbh = C4::Context->dbh; |
| 4070 |
my $query = ' |
| 4071 |
INSERT INTO `marc_permissions` |
| 4072 |
( |
| 4073 |
tagfield, |
| 4074 |
module, |
| 4075 |
filter, |
| 4076 |
on_new, |
| 4077 |
on_appended, |
| 4078 |
on_removed, |
| 4079 |
on_deleted |
| 4080 |
) |
| 4081 |
VALUES (?, ?, ?, ?, ?, ?, ?) |
| 4082 |
'; |
| 4083 |
my $sth = $dbh->prepare($query); |
| 4084 |
my $result = $sth->execute ( |
| 4085 |
$f->{tagfield}, |
| 4086 |
$f->{module}, |
| 4087 |
$f->{filter}, |
| 4088 |
$f->{on_new}, |
| 4089 |
$f->{on_appended}, |
| 4090 |
$f->{on_removed}, |
| 4091 |
$f->{on_deleted} |
| 4092 |
); |
| 4093 |
ClearMarcPermissionsRulesCache(); |
| 4094 |
return $result; |
| 4095 |
} |
| 4096 |
|
| 4097 |
=head2 DelMarcPermissionsRule |
| 4098 |
|
| 4099 |
my $success = DelMarcPermissionsRule($id) |
| 4100 |
|
| 4101 |
Deletes rule from the marc_permissions table. |
| 4102 |
|
| 4103 |
=over 4 |
| 4104 |
|
| 4105 |
=item C<$id> |
| 4106 |
|
| 4107 |
rule id to delete |
| 4108 |
|
| 4109 |
=back |
| 4110 |
|
| 4111 |
Returns: |
| 4112 |
|
| 4113 |
=over 4 |
| 4114 |
|
| 4115 |
=item C<$success> |
| 4116 |
|
| 4117 |
undef if an error occurs, otherwise true. |
| 4118 |
|
| 4119 |
=back |
| 4120 |
|
| 4121 |
=cut |
| 4122 |
|
| 4123 |
sub DelMarcPermissionsRule { |
| 4124 |
my $id = shift; |
| 4125 |
my $dbh = C4::Context->dbh; |
| 4126 |
my $query = ' |
| 4127 |
DELETE FROM `marc_permissions` |
| 4128 |
WHERE |
| 4129 |
id = ? |
| 4130 |
'; |
| 4131 |
my $sth = $dbh->prepare($query); |
| 4132 |
my $result = $sth->execute($id); |
| 4133 |
ClearMarcPermissionsRulesCache(); |
| 4134 |
return $result; |
| 4135 |
} |
| 4136 |
1; |
| 3538 |
|
4137 |
|
| 3539 |
__END__ |
4138 |
__END__ |
| 3540 |
|
4139 |
|