# Interactions Forms in Specify 6 **URL:** \ **Category:** Specify 6 Documentation\ **Tags:** Specify-6\ **Created:** [March 17, 2022, 4:31pm UTC](https://speciforum.org/t/interactions-forms-in-specify-6/204 "2022-03-17T16:31:49Z")\ **Posts on this page:** 1\ **Page:** 1
**Author:** ![Grant](https://yyz1.discourse-cdn.com/flex029/user_avatar/speciforum.org/grant/32/4255_2.png) [@Grant](https://speciforum.org/u/Grant)\ **Post date:** [March 17, 2022, 4:31pm UTC](https://speciforum.org/t/interactions-forms-in-specify-6/204/1 "2022-03-17T16:31:49Z")
> :specify7: If you are looking for Specify 7 documentation, please see [this post](https://speciforum.org/t/interactions-forms-in-specify-7/961). ## ![interactions](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/a/a02a93afea6ab1289491e395faad469e0979e694.png) Interactions Forms Interactions in Specify allow users to create and manage documentation associated with the movement of specimens or data into or outside of the collection. This includes information about loans, gifts, borrowed items, permits, shipments, accessions, disposals, deaccessions and information requests. For example, a collection manager may respond to a request for a loan of specimens for research by creating loan record in Specify. The record would include the list of specimens to be loaned, along with other required loan information (loan number, date of loan, due date, agents, etc.). When the loan is returned, the manager would then update the loan record to note the date of the return and which specimens were returned. Access Interaction Forms by clicking the ![interactions_20](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/2/22ff67c3560cce6aa74189b5497203906059b9a0.png) Interactions button. A list of forms will appear in the side bar. > **_Note:_** If an Interactions button is not available on the task bar choose _Specify \> Preferences \> ![taskbar](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/3/3cd51443ab05e0500d1576b29343ea0372916fe6.png) Task Bar_, then click the _Interactions_ checkbox. Specify 6 ships with the most frequently used forms listed on the side bar.   A **Side Bar Interaction Form Configuration** allows the available Interaction forms listed on the side bar to be rearranged and hidden: > Choose _Tabs \> Configure Side Bar_ in the main menu. > > - Use the ![ReorderUp16x16](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/f/f6d3b4c83dd216935dfae09af9cdd89107e15981.png), and ![ReorderDown16x16](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/8/8b6d8a6caf1906fbd1726f7ce90813ff0de082d9.png)(reorder) buttons to change the order in which the forms appear in the side bar and More Forms list. > - Use the ![Map16x16](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/4/42e2683a0676bc66a460c81071dffed0ba116436.png), and ![Unmap16x16](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/2/28ff08d8270e2c0ee20b1f549cd521bcfeb884a4.png)(move) buttons to show or hide an available side bar item. > > Interactions forms can be activated by clicking them in the side bar. Accessions, Disposals, Gifts, Loans, Exchange Outs or Information Requests can also be activated by dropping a Collecion Object record set onto them in the side bar. > > > **_Note:_** The Side Bar Configuration tool can also be opened by right-button-clicking in the right side of the side bar to open the Form Configuration tool, then click on the ![configure](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/f/f9b84e4ce0f1ad3160f5b2647733c0b112d04cea.png) button.   ### Accessions > Accessioning is the formal process by which a specimen or object is legally accepted and recorded as a museum item and differs from cataloging. This usually entails proof of ownership (in the form of a signed deed of gift) and legal collection (in the form of all associated permits - collecting, import and export). Accessioning and its numbering system are usually a policy adopted as a museum-wide policy but is not used by all museums. An accession usually covers an entire field trip and multiple catalog items could be included within a single accession. Within the database there is a one-to-many relationship between Accessions and Collection Objects. Accessions can be created through the Interactions menu or directly from the Collection Object being entered. > > Note: Accession number is one of the fields that can be formatted through the schema localizer. The accession numbering system can also be associated at the Collection level for individual collection use or the Institution level where a single numbering system is adopted by all collections within an Institution. > > All associated agents and permitting information can be entered in a one-to-many relationship within the accession. > > A Deaccession, the legal process of removing items from a collection, can be associated with the relevant accession(s).   ### **Creating a Transaction** **Record** > Loans, Gifts, Exchange Outs and Disposals document items leaving the Institution, and Collection Objects are linked to them through preparations.  The first step in creating a record is choosing the specimens (as preparations) to add to the transaction. > > A Specify preference allows collections to choose whether to use collection object identifiers (catalog numbers) or preparation identifiers (preparation numbers or bar codes), or to be asked. For more information see Interactions Preferences. > > - Click the desired transaction in the side bar to start the process. > > ![interactions_choose](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/b/bfb5cb2edaa6c46cb7712390bfb3ef790a192cbd.png) > > A dialog will appear to select how you wish to choose specimens/items to include in the transaction. > > ![interactions_choose_inforequest](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/9/90fb6fab10fc1ef1f98dbbfdd458e05b1bc0cf5e.png) > > If any record sets or Information Requests have been saved, a dialog appears prompting the user to either _Enter Items_ or use an existing _Record Set or Information Request_. The Record Set option is the easiest method to use when loaning/gifting large numbers of Collection Objects or Preparations. The Information Request is a good way to document the data sent outside of the collection. > > Uncataloged items may also be recorded in Interactions (See Loaning Uncataloged and Cataloged Items) > > _Choose Enter Items_ > > **_Note:_** If the Interactions Preference is set to 'Ask' as the _Default Source Table_ in the Interactions Preference a dialog listing the _Item Source_ will be presented. Choose either the _Collection Object_ or _Preparation_ from the list. > > - **Enter (Item Source)** **List**  by typing the identifying numbers into the text dialog, separating multiple numbers with commas (100, 105, 152)) > - **Enter a consecutive range of numbers** , with a slash as a separator for the range, for example: 12012-12020 > > OR, if the number includes a dash a slash can be used, for example: 2011-0001/2011-0010 > > or Choose _Record Sets or Information Requests (when available)_ > > - A dialog will then appear listing the appropriate Records Sets. If only one record set exists, it will be used by default. This can also be accomplished by dragging and dropping the record set onto the Loan button on the sidebar. > > - > > > **_Note:_** If a non-loanable Preparation Type is selected a warning dialog will appear informing the user that the chosen specimen(s) are not loanable. > > Next, a dialog listing all preparations associated with the choice above (collection object or preparation) will appear. > > ![loan_screen](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/9/94ff5b72552e8be9bd0e670f428051f71874cc04.png) > > Create Loan from Preparations > > Each checkbox represents either a Collection Object or Preparation (depending on the preference selected above) and is labeled with the appropriate identifier and determination. Specimen counts reflect the number of specimens that are currently available to be loaned. An indication is also given if any additional specimens are associated with previous open loans or gifts. In these cases the total number of available specimens would be reduced by this number. The ![info_20x20](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/d/d56f189e16ab0fd70f21f7cd612474d0abdba630.png)(information) button links to information about the unavailable preparation. > > - **Select specimens** by typing the number of specimens of each preparation being sent on loan into the dialog or use the up and down arrow keys.  If multiple preparations for a single Collection Object are present, they will be listed together under the same checkbox. All preparations can be selected at once by clicking the _Select All_ button at the bottom of the dialog. > - Click the _OK_ button to accept the preparations and progress to the Loan/Gift form where all additional information pertaining to the Loan or Gift can be added. > > **Loaning Uncataloged and Cataloged Items** > > To document both cataloged and uncataloged items and track the counts first choose the transaction from the Side Bar. > > ![loan_choose_source](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/2/2fb59919a44be65df1d7324b3b2cde084ec39b7a.png) > > _Choose Source for Loan_ > >   > > If you have appropriate Record Sets available to choose from you will immediately see the Choose Source dialog above. Choose _Enter Items_ from the Choose Source dialog. > > **_Note:_** If you do not have appropriate Record Sets (Collection Object or Preparation) you will only see the Enter List dialog below. > > ![loan_catnum_dialog](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/6/6bdd37605254bba2dea570e6155e83b5ffef14d9.png) > > _Create Loan from Preparations_ > > Next, choose the _Uncataloged_ button at the bottom of the dialog box. > > ![loan_form_mixed](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/f/fa671887367ee220311427e2bb1d2dae775835aa.png) > > _Loan with Uncataloged Item_ > >   > > An Interaction form with a single Preparation with '0' quantity is presented. Double click the Preparation row to change the information associated with it. > > Click the ![add](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/d/d31fe3612cf16ac93232eb490ae084c1d71630f0.png) (add) button to add additional Cataloged or Uncataloged items. > > Calculated fields for Total Items, Total Quantities, Unresolved Items and Unresolved Quantities are included on the default Interaction form. These allow total counts to be captured but are not associated with uncataloged items.   #### Invoices Once the interaction has been successfully completed, a _Generate Invoice on Save_ check box becomes available on the form.  If checked and the necessary query and Report have been constructed, the Report associated with the Interaction will be created automatically once the _Save_ button has been clicked. A sample invoice for each Discipline is included with Specify and will print automatically if a custom invoice has not been created. When creating a custom invoice in SPiReport save the report/invoice as an 'invoice'. Once an invoice has been saved checking the _Generate Invoice on Save_ check box will display your invoice in a list and allow you to print it.   ### Loans Loans are unique in that the items are expected to be returned; therefore extra fields can be added to the Loan form for tracking the status of the loaned items and Due Dates. Note: A Due Date can be set automatically in the Interactions Preference.   **Returning** **Loans** > To return items associated with a loan open the loan by searching for it with the appropriate field (for example Loan Number) into the Simple Search bar or querying for it. Once the Loan is open click the Edit button. A **_Return Loan_** button appears on the bottom of the Loan form. > >   > > ![return_loan_button](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/1/1430fba7c326b937ea83b49403089be9b6f6dfea.png) > > _Return Loan Button_ > > - Click the **_Return Loan_** button > >   > > ![loan_return_selection](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/9/94ca2b632b6f0ba1e4241e1b08b9c7dec54981ec.png)  > > _Return Loan Selection Options_ > > Next, select the appropriate option for returning the loaned item(s) > > - **_Use all Items_** presents a dialog listing all loaned items based on the unique identifier selected in the Interactions Preference. > - **_Enter Item IDs_** allows you to enter specific identifiers for the loaned items either by typing them or by using a bar code reader. Identifiers are entered based on the unique identifier selected in the Interactions Preference.  > - **_Record Sets_** will present a dialog listing all items in a Record Set. If any of the items in the Record Set are not included in the Loan you will be presented with a warning. > > ![select_all_button](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/2/2666b496b2aaff73dfa9e2f91c593a48c5710d7f.png) > > _Select All Button_ > > When returning all of the items in a loan it is easiest to use the _Select_ All button at the bottom of the Loan Retun dialog. Clicking _Select All_ will return and resolve the loan and close the loan by checking the _Is Closed_ checkbox in the loan, thereby closing the loan.  The _Return Loan_ button ont the form will also change to _All Returned_.  If any of these numbers are altered at any stage, thereby reopening the loan, this button will revert to Return Loan.  For partial returns, or when some items are resolved but not returned, due to loss or damage, the quantity returned and quantity resolved can be manipulated and remarks inserted. > > When returning loans, a Loan Return Prep record is created for each preparation lent out.  There are three values associated with each Loan Return preparation: > > > **Quantity** - the quantity of each preparation lent out. > > > > **Quantity Returned** - the quantity of preparations returned.  This may not equal the quantity sent out in cases of partial returns and/or lost/damaged specimens not returned (see resolved below). > > > > **Quantity Resolved** - used to document items that are resolved but have not been returned. This is used in the case where specimens are lost or damaged and are no longer associated with the collection.  It us often helpful to use the remarks field to describe the circumstances of this discrepancy.  > > For the loan to be closed, the quantity lent must equal the quantity resolved.  In the case of a full return of a loan, all three numbers would be identical for each preparation. > > Loan Return Prep's can also be individually altered using the Loan Return Prep button ![loan_return_prep_20x20](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/b/bd46e694504c682aa5b71cd5ead26b675d64b505.png) on the Loan Preparation form. > > > **_Note:_**   The quantity, quantity returned, and quantity resolved cannot be manually edited on the Loan Preparation form. > > > > **_Note:_**   The _Is Closed_ check box is editable only when the quantity returned and quantity resolved do not equal each other i.e. when the loan is NOT closed.   **Tracking Loans** Fields for tracking loan counts, especially for partial returns, are available on the Loan form. The default Loan form includes fields to track total counts near the top of the form: ![loan_top](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/c/cbece37163ec3824258f9f64abfaf522fee643a6.png) _Loan Counts on Loan Form_   **Total Preps** - the count of Preparation Types, for all Catalog Numbers, included in the loan. **Total Items** - the total count of individual items included in the loan. **Returned Preps** - the count of Preparation Types, or all Catalog Numbers, returned. **Returned Items** - the count of individual items returned. **Unresolved Preps** - the count of Preparation Types, for all Catalog Numbers, not resolved. **Unresolved Items** - the count of individual items not resolved.   Detailed information is included in the Loan Preparation sub form located near the bottom of the default Loan form: ![loan_bottom](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/5/51b1822a45bd191dd01232a6181f725e879d5253.png) _Preparation Counts on Loan Form_     ### **Information Request** s > Collection managers are regularly asked to share specific data records with local or external researchers. In most cases this is accomplished by attaching a spreadsheet or .csv file to an email message. The information shared is usually in the form of Collection Objects. Specify 6 has an automated function to handle responses to specimen information requests and record these for later retrieval and reporting. > > Interactions such as Loans, Gifts, Exchange Outs and Disposals can also be created using Information Requests. > > Click _ **Information Request** _ in the side bar to start the process. > > If any record sets have been saved, a dialog appears prompting the user to either Enter Catalog Numbers or use an existing record set.  The Record Set method would be easiest when using large sets of data. - **Enter Catalog Numbers** by typing catalog numbers into the text dialog, separating multiple numbers with commas. - - Select a **Record** Set from the list.  If only one record set exists, it will be used by default.  This can also be accomplished by dragging and dropping the record set onto the Information Request item in the sidebar. > The Collection Objects will be added to the Information Request form.  Once they are added, the _Send Email on Save_ check box becomes available on the form.  If checked and a) the recipient has an email address associated with their agent name in the database and b) the necessary email settings have been entered in _Preferences \> Email_, an email will automatically be sent to the designated recipient once the Save button has been clicked.  The attached Collection Objects will appear in the main portion of the email and will also be attached as a CSV file. > > Unlike queries, Information Requests are only saved on the side bar and not in the database and are not searchable.  Saved Information Requests listed on the side bar can be deleted by dragging and dropping them onto the trash can.  No record will be kept in the database of an Information Request once it has been deleted. > > It is possible to send an Information Request via email at a later date or resend it if it has been saved. - Click on the _Information Request_ button in the side bar to open it in the workspace. - Click the ![form_editor20x20](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/3/3272d1b5619e645d4dfaa5a5cd887fca63b30c09.png)(edit form) button at the bottom of the workspace to edit the Information Request. - Make a change to the Information Request (this could simply be retyping part of the date). - Check the _Send Email on Save_ button. - Click the _Save_ button ### ### **Gifts** Specimens may be transferred outside of the collection and not expected to be returned. In these instances they may be considered a Gift. Gifts can be documented by creating a record using the methods described above. ###   ### **Exchange In / Exchange Out** > The Exchange In / Exchange Out feature of Specify 6 is intended to give certain disciplines the facility to track incoming and outgoing specimens related to each other. > > The Exchange Out table is connected to preparations for the exchanging of cataloged items. Functionality follows that of Gifts and Loans above. Forms can also be modified or augmented to incorporate the exchanging of non-cataloged items much like in Loans without Preps. > > The Exchange In table is similar to the borrow table in recording incoming material and thus does not use preparations.   ### **Disposals** > There may be times when specimens are no longer available in a collection for reasons other than a transfer of ownership (such as a Gift or Exchange Out transaction). This may be a destructive sample, item lost in transport, the item was disposed, or simply no longer found in the collection. For this purpose Specify created the Disposal table. Disposals can be created using the steps outlined above.   ### Deaccessions > **Video:** [Deaccessions in Specify 6](https://speciforum.org/t/deaccessions-in-specify-6/1611) > > Deaccessions in Specify are the opposite of an Accession i.e. the legal process of relinquishing possession of a specimen through removal from the collection. For this reason Deaccessions can not be created without a specimen first being associated with the relevant transaction - Gift, Exchange Out or Disposal. Deaccessions can be queried and viewed, but the creation of a Deaccession can only be accomplished from a Gift, Exchange Out or Disposal form as shown below. > > ![interactions_disposalform](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/b/b0980263414d6cfc2e785ae7745d6dc8bcfb367e.png) > > Create a Deaccession from the Disposal Form > > Click the  ![add](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/d/d31fe3612cf16ac93232eb490ae084c1d71630f0.png)(add) button for a Deaccession in a Disposal, Exchange Out, or Gift form to create a new Deaccession or alternatively type in the first few numbers of an existing Deaccession number and then click the down arrow and select an existing Deaccessions. > > ![interactions_deaccession_add](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/8/8a25c80d36c4fb172f48c926f35db9fdd086b4a6.png) > > Documenting a Deaccession > > Information such as Total Preps and Total Items will automatically update once the Deaccession is saved. As shown on the form above, Deaccessions are related to Accessions and Accession information can be viewed from the Deaccession form and vice versa. > > ![interactions_deaccession_view](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/0/03093d3de0542134c7a688c909d55de9cc5be952.png) > > Deaccession Form > > Once created, Deaccessions information can be viewed by first searching for the Deaccession and then opening it in a form.   ### **Borrows** > Specimens that are on loan from another collection can be tracked in Specify by creating a Borrow. Borrows never become part of your collection and therefore the forms and data will not be entered into any Collection Object fields or related fields. Borrows must be given an Invoice Number. > >   ### Repository Agreements > A repository agreement is similar to an accession but does not transfer ownership of the specimens. This is most frequently entered into with countries that do not wish to lose claim to their biodiversity but will allow museums to house their specimens and, in some cases, is the only method of legally collecting in some countries. Repository agreements can entail multiple accessions i.e. multiple field trips, and thus there is a one-to-many relationship in the database between repository agreements and accessions and a method for linking many accessions to a single repository agreement. > > Much like an accession, all associated agents and permitting information can be entered in a one-to-many relationship within the repository agreement.