Koha/koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/acquisitions.pref
Agustin Moyano a551cb47ea
Bug 8179: Receive multiple orders
This patch implements the code to allow a patron to receive multiple
orders at the same time in /cgi-bin/koha/acqui/orderreceive.pl page

To test:
1. apply all patches
2. updatedatabase
3. Go to system preferences and allow AcqReceiveMultipleOrderLines
4. In acquisitions module, create a vendor if you don't have one and add
   3 baskets.. one with create items on ordering, one with create items
   on receiving and finally one with create items when cataloguing
5. Fill baskets with orders (There should be at least 15 orders in total). There should be a mix of orders created by suggestions, others by subscriptions and others by neither of those methods.
6. Close all baskets and receive shipment.
CHECK => in /cgi-bin/koha/acqui/parcel.pl page, in top table there is a column with checkboxes, and a button that says "Receive selected"
7. If all orders from all baskets are shown in the table, set the rows per page to 10, so table has more than one page
8. Check some of the checkboxes
CHECK => "Receive selected" button shows how many rows are selected
9. Go to the next page and select some more rows
CHECK => Changing page does not modify how many rows where selected
10. Go back to previous page
CHECK => Previously selected rows are still selected
11. Reload the page to deselect all rows
12. Select only one row and click on "Receive selected" button
CHECK => the page /cgi-bin/koha/acqui/orderreceive.pl behaves just the same as if the "receive" link in the selected row would have been clicked.
13. Click on cancel to go back to parcel.pl page
14. Select all rows (even the ones from the next page of the table) and
    click on "Receive selected"
CHECH => In orderreceive.pl page there is a table with all selected rows
15. Ensure table has more than one page, as in step 7
16. Click on the "edit" link in the last row of the current page
CHECK => A modal window is displayed with 4 tabs within: Info,
Accounting, Receipt history and Items
CHECK => Modal has 4 buttons at the bottom, 'Previous' to go to previos
order, 'Cancel' to close the modal without keeping modifications, 'Save'
to close modal keeping modifications and 'Next' to go to the next order
CHECK => Even that we are at the end of the current page, 'Next' button
is still available
17. Click on 'Next' button
CHECK => The table behind the modal now displays the next page, and the modal was not closed
18. Click on 'Previous'
CHECK => The table behind the modal went back to the first page, and the modal was not closed
19. Click on 'Previous' button till you reach the first row of the first
    page
CHECK => Only when you reach the first row of the first page 'Previous'
button gets disabled
20. Click on 'Next' button till you reach the last row of the last page
CHECK => Only when you reach the last button of the last page 'Next'
button gets disabled
21. Check that behaviour for the different types of order are still the
    same
    a. For orders that where created through suggestion, check that the
suggestion info is present in Info tab. If when suggestion was accepted
you set a reason, a dropdown to change the reason shoul display also.
    b. For orders that where created through subscriptions, check that
the Items tab is disabled, and the Receipt history is enabled. On
accounting tab you should be able to change quantity ordered. If there
were less items received than ordered, the next time you receive this
order the child order generated from this one shoul appear in receipt
history.
    c. For orders that don't come from subscription and creates there items on ordering, Receipt history
should be disabled, and a table with prefilled items shold appear in the
Items tab. You can edit them and the changes should appear in the item's
row.
    d. For orders that don't come from subscription and creates there
items on receiving, Receipt history should be disabled, and a form to
create the items should appear in Items tab. When you add an item a
table should appear.
    e. For orders that don't come from subscription and creates there
ites on cataloguing, Receipt history and Items tabs should be disabled.
    f. Any changes made in quantity (received or ordered) or funds in the modal should be
reflected in the table if you click save from the modal.
22. Once you've done all you checking and verifications click save
23. While saving a progress bar should appear
24. If no error was detected, you should be redirected back to parcel.pl
    page
25. If an error or warning was detected (like there is an order with 0
    items to receive) the save button should be disabled and warnings
are dispayed.
26. prove t/db_dependent/Koha/Acquisition/Fund.t t/db_dependent/Koha/Acquisitoin/Order.t t/db_dependent/Koha/Item.t

Sponsored-by: Virginia Polytechnic Institute and State University
Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>
Signed-off-by: Laura Escamilla <laura.escamilla@bywatersolutions.com>

Signed-off-by: Kyle M Hall <kyle@bywatersolutions.com>
Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>
2023-05-15 08:53:47 -03:00

149 lines
6.7 KiB
Text

Acquisitions:
Policy:
-
- Create an item when
- pref: AcqCreateItem
choices:
ordering: placing an order.
receiving: receiving an order.
cataloguing: cataloging the record.
- This is only the default behavior, and can be changed per-basket.
-
- "The following <a href='http://schema.koha-community.org/__VERSION__/tables/items.html' target='blank'>database columns</a> should be unique in an item:"
- pref: UniqueItemFields
type: modalselect
source: items
-
- When closing or reopening a basket,
- pref: BasketConfirmations
default: 1
choices:
1: always ask for confirmation.
2: do not ask for confirmation.
-
- Show baskets
- pref: AcqViewBaskets
choices:
user: created or managed by staff member.
branch: from staff member's library.
all: in system, regardless of owner.
-
- Display currencies using the following format
- pref: CurrencyFormat
choices:
US: 360,000.00 (US)
FR: 360 000,00 (FR)
CH: 360'000.00 (CH)
-
- Tax rates are
- pref: TaxRates
- . Enter in numeric form, 0.12 for 12%. The first item in the list will be selected by default. For more than one value, separate with | (pipe).
- "<br/><strong>NOTE:</strong> The database will only accept values up to 4 decimals precision, further values will be rounded."
- "<br/><strong>NOTE:</strong> Vendor tax rate information may need updating if tax rate values are removed."
-
- pref: AcqWarnOnDuplicateInvoice
choices:
1: Warn
0: "Do not warn"
- when the librarian tries to create an invoice with a duplicate number.
-
- "Upon receiving items, update their subfields if they were created when placing an order (e.g. o=5|a=\"foo bar\"):"
- pref: AcqItemSetSubfieldsWhenReceived
-
- "Upon cancelling a receipt, update the item's subfields if they were created when placing an order (e.g. o=5|a=\"bar foo\"):"
- pref: AcqItemSetSubfieldsWhenReceiptIsCancelled
-
- pref: AcqEnableFiles
choices:
1: Do
0: "Don't"
- enable the ability to upload and attach arbitrary files to invoices.
-
- Set the mapping values for a new order line created from a MARC record in a staged file.
- pref: MarcFieldsToOrder
type: textarea
syntax: text/x-yaml
- "You can use the following fields: price, quantity, budget_code, discount, sort1, sort2"
- "<br/>For example:<br/>price: 947$a|947$c<br/>quantity: 969$h<br/>budget_code: 922$a"
-
- Set the mapping values for new item records created from a MARC record in a staged file.
- pref: MarcItemFieldsToOrder
type: textarea
syntax: text/x-yaml
- "You can use the following fields: homebranch, holdingbranch, itype, nonpublic_note, public_note, loc, ccode, notforloan, uri, copyno, price, replacementprice and itemcallnumber. Special fields: quantity and budget_code"
- "<br/>For example:<br/>holdingbranch: 975$b<br/>itype: 975$9|975$z"
-
- pref: ClaimsBccCopy
default: no
choices:
1: Send
0: Don't send
- blind copy (BCC) to logged in user when sending serial or acquisitions claims notices.
-
- Keep accepted or rejected purchase suggestions for a period of
- pref: PurgeSuggestionsOlderThan
class: integer
- "days. Example: [30] Sets purgation of suggestions for those older than 30 days."
- "<br><strong>WARNING:</strong> Leave this field empty if you don't want to activate this automatic feature."
- "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/purge_suggestions.pl</code> cronjob. Ask your system administrator to schedule it."
-
- pref: OrderPriceRounding
default: ''
choices:
'': Don't round
nearest_cent: Round
- to nearest cent.<br>
- Determines whether full precision values or rounded values should be used in price calculations.
-
- pref: UseACQFrameworkForBiblioRecords
default: no
choices:
1: "Use"
0: "Don't use"
- " the framework 'ACQ' for bibliographic records fields."
-
- "Choose email address that new purchase suggestions will be sent to: "
- pref: EmailPurchaseSuggestions
default: 0
choices:
0: none
EmailAddressForSuggestions: EmailAddressForSuggestions
BranchEmailAddress: email address of library
KohaAdminEmailAddress: KohaAdminEmailAddress
- '<br>If you choose <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=EmailAddressForSuggestions">EmailAddressForSuggestions</a> you have to enter a valid email address:'
- pref: EmailAddressForSuggestions
class: email
Printing:
-
- Use the
- pref: OrderPdfFormat
choices:
"pdfformat::layout1page": English 1-page
"pdfformat::layout2pages": English 2-page
"pdfformat::layout3pages": English 3-page
"pdfformat::layout3pagesfr": French 3-page
"pdfformat::layout2pagesde": German 2-page
- layout when printing basket groups.
EDIFACT:
-
- pref: EDIFACT
default: no
choices:
1: Enable
0: Disable
- EDIFACT message exchange for acquisitions
-
- pref: EdifactInvoiceImport
default: no
choices:
automatic: "Do"
manual: "Don't"
- " automatically import EDIFACT invoice message files when they are downloaded."
-
- "Map sequence code (GIR:LSQ) field to "
- pref: EdifactLSQ
default: location
choices:
location: "location"
ccode: "collection"
- " in items."