App Resources in Specify 7

First, you need to navigate to the User Tools menu. You access this menu by clicking on your username in the navigation menu.

From here, you need to click App Resources.

App resources are all resource files pertaining to queries, export mappings, DwCA metadata, labels, reports, and other miscellaneous database files.

View Definitions contains all of the view definitions established in the database. The view heiarchy goes as follows:

User > User Type > Collection > Discipline

If a user has a view definition under their username in a collection, it is used first. If there is not one, it uses the user type view definition. If that does not exist, then it uses the collection view and so on…

You can filter the resource type by clicking on the Filter button in the bottom left.

From here you can see the major categories - App Resources and View Definitions.

Under App Resources, you can see a large number of resource types along with their count.


Resource Types

Label (Documentation)

These are the labels used for reporting purposes. These are JRXML files.

Report (Documentation)

These are the reports used for reporting purposes. These are JRXML files.

User Preferences & Default User Preferences

This uses the user preferences visual editor and allows you to set the preferences of a user or default for users using the same interface as the traditional user preferences menu.

User Preferences resources are the customized user preferences for an individual user.

Default User Preferences can be placed at the root of a division, collection, or user type rank and will set the default for all users added to that group. This is how you establish default preferences in Specify 7. These can be overwritten by a user when they customize their preferences.

Leaflet Layers (Documentation)

RSS Export Feed (Documentation)

Express Search Config (Documentation)

This is where you can configure the simple search behavior manually in the XML for a user in Specify 7. This is carried over from the Specify 6 configuration.

Web Links (Documentation)

This stores all of the web link configurations in the database. They look similar to this:

<vector>
  <weblinkdef>
    <name>WEBLINK</name>
    <tableName></tableName>
    <desc></desc>
    <baseURLStr><![CDATA[http://specify6-test.nhm.ku.edu/echo.php?text1=<this>]]></baseURLStr>
    <args>
      <weblinkdefarg>
        <name>this</name>
        <prompt>false</prompt>
      </weblinkdefarg>
    </args>
    <usedByList/>
  </weblinkdef>
</vector>

Field formatters (Documentation)

  <format system="true" name="AccessionNumber" class="edu.ku.brc.specify.datamodel.Accession" fieldname="accessionNumber" default="true">
  <autonumber>edu.ku.brc.specify.dbsupport.AccessionAutoNumberAlphaNum</autonumber>
    <field type="year" size="4" value="YEAR" byyear="true"/>
    <field type="separator" size="1" value="-"/>
    <field type="alphanumeric" size="2" value="AA"/>
    <field type="separator" size="1" value="-"/>
    <field type="numeric" size="3" inc="true"/>
  </format>

This is the resource type for UIFormatters, used for setting the format for fields in Specify in XML. You can configure the format of individual fields by manually editing this resource.

Record Formatters (Documentation)

This is the resource type for DataObjFormatters, used for establishing custom formatters in the database in XML for use in all areas of Specify.

    <format
        name="Address"
        title="Address"
        class="edu.ku.brc.specify.datamodel.Address"
        default="true"
        >
        <switch single="true">
            <fields>
                <field>address</field>
                <field sep=" ">address2</field>
                <field sep=", ">city</field>
                <field sep=", ">state</field>
                <field sep=" ">postalCode</field>
            </fields>
        </switch>
    </format>

Search Dialog Definitions (Documentation)

Data Entry Tables (Documentation)

This is the resource type for DataEntryTaskInit, used to define which data entry tables are visible in the data entry dialog window.

<views>
  <std>
    <view title="Collection Object" view="CollectionObject" iconname="CollectionObject" tooltip="Open Collection Object Form" order="0" sidebar="true"/>
    <view title="Collecting Event" view="CollectingEvent" iconname="CollectingEvent" tooltip="Open Collecting Event Form" order="1" sidebar="true"/>
    <view title="Locality" view="Locality" iconname="Locality" tooltip="Open Locality Form" order="2" sidebar="true"/>
    <view title="Taxon" view="Taxon" iconname="Taxon" tooltip="Open Taxon Form" order="3" sidebar="true"/>
    <view title="Agent" view="Agent" iconname="Agent" tooltip="Open Agent Form" order="4" sidebar="true"/>
    <view title="Geography" view="Geography" iconname="Geography" tooltip="Open Geography Form" order="5" sidebar="true"/>
    <view title="DNA Sequence" view="DNASequence" iconname="dnasequence" tooltip="DNA Sequence" order="6" sidebar="true"/>
    <view title="Reference Work" view="ReferenceWork" iconname="referencework" tooltip="Reference Work" order="7" sidebar="true"/>
  </std>
  <misc>
    <view title="Storage" view="Storage" iconname="Storage" tooltip="Open Storage Form" order="0" sidebar="true"/>
  </misc>
  <batch/>
</views>

Interactions Tables (Documentation)

This is the resource type for InteractionsTaskInit, used to define which interactions tables are visible in the interactions dialog window.

Other XML Resource

This is for miscellaneous XML resources in the app resource viewer.

Other JSON Resource

This is for miscellaneous JSON resources in the app resource viewer.

Other Properties Resource

This is the resource type for the global and remote user pref resources.

Here is a sample Global Prefs file:

#Global Prefs
#Tue Nov 01 15:46:51 CDT 2022
FixSpAuditLogFields=true
RELEASES=6.4.11
DNACheck\:32768=co-yes ms-no
InteractionsTaskAfterDeaccFix=true
InvalidPermissionCleanup=true
UniquenessConstraintsFix=true
FixedSpQueryOperators=true
FixUploaderRecordsets=true
attachment.key=c3wNpDBTLMedXWSb8w2TeSwHWVFLvBwiYmtU0CdOzLQtelcibV9sTXW7NxZlX68
FixedGTPTreeDefParents=true
FixPaleoContextTypeSearch=true
attachment.url=http\://biimages.biodiversity.ku.edu/web_asset_store.xml
FixNullEmbeddedCollectingEvents=true
FixNullTreeableFields=true
FixPaleoContextSearchView=true
DNACheck\:4=co-yes ms-no
GEONAMES_LAST_MOD=1478203068000
PaleoAftermathCleanup=true
FixNullDatePrecisions=true
FixedUnmappedSchemaConditions=true
FIX_DEFDATES_PREF=true
UPDATED_GUIDS_CNV_32768=true
FixAttachmentOrdinal=true
GGBNAftermathCleanup=true
CHECK_ATTCH_ERR=false
attachment.use_path=false
fixSymbiotaExportSchema=true
FixedUnMatchedWBSpecifyUserIDs=true
CollectingEventsAndAttrsMaint1=true
ExsiccataUpdateFor1_7=true
USE_GLOBAL_PREFS=true

This is also for miscellaneous property resources in the app resource viewer.

Other app resource

This is the proper resource type for DwCA and DwCA_metadata files for RSS feed setup.

<?xml version="1.0" encoding="utf-8"?>
<archive>
  <core rowType="http://rs.tdwg.org/dwc/terms/Occurrence">
      <queries>
      <query name="occurrence.csv" contextTableId="1">
	<id term="http://rs.tdwg.org/dwc/terms/occurrenceID" isNot="false" isRelFld="false" oper="11" stringId="1.collectionobject.guid" value=""/>
        <field term="http://rs.tdwg.org/dwc/terms/institutionCode" isNot="false" isRelFld="false" oper="11" stringId="1,23,26,96,94.institution.code" value=""/>
        <field term="http://rs.tdwg.org/dwc/terms/institutionID" isNot="false" isRelFld="false" oper="11" stringId="1,23,26,96,94.institution.altName" value=""/>
        <field term="http://purl.org/dc/terms/license" isNot="false" isRelFld="false" oper="11" stringId="1,23,26,96,94.institution.copyright" value=""/>

This is for all other remaining resources in the app resource viewer.


App Resource Navigation

Once you are viewing a resource, you can Download, Load File, Delete, Clone or Save.

Download allows you to download a copy of that resource file. This can be useful when troubleshooting issues or editing the file externally.

Load File allows you to select a file on your system to replace the existing file or resource you are viewing.

Delete removes the resource.

Clone creates a duplicate of the resource in the database at the same level.

Save commits all changes to the database.

There is also a full screen button Full screen button in the top right of the form. This expands the viewer to occupy the entire window and removes distractions.

You can edit the name of the resource by clicking on the :pencil2: icon to the right of the name.

Creating a New Resource

Add Resource button

To create a new resource, you can click on the + Add Resource button below any list of items at any rank in the resource hiearchy.

From here, you need to select either App Resource or Form Definitions.

For app resources, you will see a list of resource types with corresponding links to documentation.

You can see the entire list of types and examples here.

Now you can create resources and save them. Clear your cache and your changes will be reflected in Specify itself!