<!DOCTYPE html>
<html class="writer-html5" lang="en" data-content_root="./">
<head>
  <meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />

  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>Getting Started &mdash; ASM 49u documentation</title>
      <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" />
      <link rel="stylesheet" type="text/css" href="_static/css/theme.css?v=86f27845" />

  
  
        <script src="_static/jquery.js?v=8dae8fb0"></script>
        <script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
        <script src="_static/documentation_options.js?v=1fe27ac2"></script>
        <script src="_static/doctools.js?v=888ff710"></script>
        <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
    <script src="_static/js/theme.js"></script>
    <link rel="index" title="Index" href="genindex.html" />
    <link rel="search" title="Search" href="search.html" />
    <link rel="next" title="Search" href="searching.html" />
    <link rel="prev" title="Foreword" href="foreword.html" /> 
</head>

<body class="wy-body-for-nav"> 
  <div class="wy-grid-for-nav">
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search" >

          
          
          <a href="index.html" class="icon icon-home">
            ASM
          </a>
              <div class="version">
                49u
              </div>
<div role="search">
  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
    <input type="hidden" name="check_keywords" value="yes" />
    <input type="hidden" name="area" value="default" />
  </form>
</div>
        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
              <ul class="current">
<li class="toctree-l1"><a class="reference internal" href="foreword.html">Foreword</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Getting Started</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#menus-and-shortcuts">Menus and Shortcuts</a></li>
<li class="toctree-l2"><a class="reference internal" href="#shortcut-keys">Shortcut Keys</a></li>
<li class="toctree-l2"><a class="reference internal" href="#dates">Dates</a></li>
<li class="toctree-l2"><a class="reference internal" href="#tables">Tables</a></li>
<li class="toctree-l2"><a class="reference internal" href="#initial-setup">Initial Setup</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="searching.html">Search</a></li>
<li class="toctree-l1"><a class="reference internal" href="animals.html">Animals</a></li>
<li class="toctree-l1"><a class="reference internal" href="people.html">People</a></li>
<li class="toctree-l1"><a class="reference internal" href="movements.html">Movements</a></li>
<li class="toctree-l1"><a class="reference internal" href="documents.html">Documents</a></li>
<li class="toctree-l1"><a class="reference internal" href="animalcontrol.html">Animal Control</a></li>
<li class="toctree-l1"><a class="reference internal" href="boarding.html">Boarding</a></li>
<li class="toctree-l1"><a class="reference internal" href="clinic.html">Clinic</a></li>
<li class="toctree-l1"><a class="reference internal" href="events.html">Events</a></li>
<li class="toctree-l1"><a class="reference internal" href="lostandfound.html">Lost and Found</a></li>
<li class="toctree-l1"><a class="reference internal" href="waitinglist.html">Waiting List</a></li>
<li class="toctree-l1"><a class="reference internal" href="generaldiary.html">General Diary</a></li>
<li class="toctree-l1"><a class="reference internal" href="accounts.html">Accounts</a></li>
<li class="toctree-l1"><a class="reference internal" href="stockcontrol.html">Stock Control</a></li>
<li class="toctree-l1"><a class="reference internal" href="reports.html">Reports</a></li>
<li class="toctree-l1"><a class="reference internal" href="onlineform.html">Online Forms</a></li>
<li class="toctree-l1"><a class="reference internal" href="paymentprocessors.html">Payment Processors</a></li>
<li class="toctree-l1"><a class="reference internal" href="rota.html">Rota</a></li>
<li class="toctree-l1"><a class="reference internal" href="mobile.html">Mobile Interface</a></li>
<li class="toctree-l1"><a class="reference internal" href="service.html">Service API</a></li>
<li class="toctree-l1"><a class="reference internal" href="publishing.html">Publishing</a></li>
<li class="toctree-l1"><a class="reference internal" href="mailmerge.html">Mail Merge Sources</a></li>
<li class="toctree-l1"><a class="reference internal" href="configuration.html">Configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="options.html">Options</a></li>
<li class="toctree-l1"><a class="reference internal" href="faq.html">Appendix: Frequently Asked Questions</a></li>
<li class="toctree-l1"><a class="reference internal" href="csvimportfields.html">Appendix: CSV file import fields</a></li>
<li class="toctree-l1"><a class="reference internal" href="databasetables.html">Appendix: Database Tables/Columns</a></li>
<li class="toctree-l1"><a class="reference internal" href="relationships.html">Appendix: Entity Relationship Diagrams</a></li>
<li class="toctree-l1"><a class="reference internal" href="website.html">Appendix: Integrating with Your Website</a></li>
<li class="toctree-l1"><a class="reference internal" href="onlineformfields.html">Appendix: Online Form import fields</a></li>
<li class="toctree-l1"><a class="reference internal" href="wordkeys.html">Appendix: Wordkeys</a></li>
</ul>

        </div>
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
          <a href="index.html">ASM</a>
      </nav>

      <div class="wy-nav-content">
        <div class="rst-content">
          <div role="navigation" aria-label="Page navigation">
  <ul class="wy-breadcrumbs">
      <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
      <li class="breadcrumb-item active">Getting Started</li>
      <li class="wy-breadcrumbs-aside">
            <a href="_sources/gettingstarted.rst.txt" rel="nofollow"> View page source</a>
      </li>
  </ul>
  <hr/>
</div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
             
  <section id="getting-started">
<h1>Getting Started<a class="headerlink" href="#getting-started" title="Link to this heading">¶</a></h1>
<img alt="_images/login.png" src="_images/login.png" />
<p>On starting ASM for the first time, you will be prompted to log in to the
system. The default username is “user” with the password “letmein”. If there
are no animals in the database, ASM will remind you of these defaults in the
dialog.</p>
<img alt="_images/home_screen.png" src="_images/home_screen.png" />
<p>Once logged in, ASM’s home screen will appear. Across the top, a menu bar is
used to navigate the system.</p>
<p>At the top right, a keyword search box allows you to quickly locate any type of
record within ASM and the user menu shows the currently logged in user, the
locale and allows user specific actions to be taken (changing the current
user’s password, logging out of the system).</p>
<p>The default landing page shows recently changed animals, alerts for any actions
that need to be taken, current diary tasks to be performed today, any messages
from other users and news from the ASM website. Additionally, this pane will
show a series of user-configurable quicklinks for quickly getting to different
areas of the system.</p>
<section id="menus-and-shortcuts">
<h2>Menus and Shortcuts<a class="headerlink" href="#menus-and-shortcuts" title="Link to this heading">¶</a></h2>
<img alt="_images/menu.png" src="_images/menu.png" />
<p>You open screens in ASM by navigating and clicking on menu items. Menu items
are laid out across the top of the screen.</p>
</section>
<section id="shortcut-keys">
<h2>Shortcut Keys<a class="headerlink" href="#shortcut-keys" title="Link to this heading">¶</a></h2>
<p>Some of the most common menu commands can be actioned by pressing combinations
of certain keys. These keys are known as shortcut keys or accelerators.
Pressing these keys is the same as navigating the menu and clicking on them
with the mouse.</p>
<p>If a menu command has a shortcut key, it will be displayed at the side of it in
the menu. For example, the Add Animal option on the menu can be accessed by
pressing <kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">ALT</kbd>+<kbd class="kbd docutils literal notranslate">SHIFT</kbd>+<kbd class="kbd docutils literal notranslate">N</kbd></kbd> - this means you hold down the shift and alt keys
together, and tap N. It is worth learning these as you will find them much
quicker to use when you are proficient with the system.</p>
<p>There are some additional shortcut keys you can use (some depend on which
browser you have):</p>
<ul class="simple">
<li><p><kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">CTRL</kbd>+<kbd class="kbd docutils literal notranslate">H</kbd></kbd> will return to the home screen</p></li>
<li><p><kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">CTRL</kbd>+<kbd class="kbd docutils literal notranslate">S</kbd></kbd> will save the current screen (animal, person details, etc).</p></li>
<li><p><kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">CTRL</kbd>+<kbd class="kbd docutils literal notranslate">R</kbd></kbd> or <kbd class="kbd docutils literal notranslate">F5</kbd> will reload the current screen.</p></li>
<li><p><kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">CTRL</kbd>+<kbd class="kbd docutils literal notranslate">W</kbd></kbd> will close the current browser tab</p></li>
<li><p><kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">CTRL</kbd>+<kbd class="kbd docutils literal notranslate">A</kbd></kbd> will select all items on screens that display a table with multiple
items (eg: Foster book, Vaccination Book, etc).</p></li>
<li><p><kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">CTRL</kbd>+<kbd class="kbd docutils literal notranslate">LMB</kbd></kbd> (left mouse button) when clicking a link will open that link
in a new tab.</p></li>
</ul>
</section>
<section id="dates">
<h2>Dates<a class="headerlink" href="#dates" title="Link to this heading">¶</a></h2>
<img alt="_images/dates.png" src="_images/dates.png" />
<p>It is worth mentioning early on that Animal Shelter Manager has a keyboard user
interface for dealing with dates (as well as the more usual calendar). Every
field within the system where a date is expected, the following keyboard
shortcuts can be used:</p>
<ul class="simple">
<li><p><kbd class="kbd docutils literal notranslate">T</kbd> Today</p></li>
<li><p><kbd class="kbd docutils literal notranslate">Y</kbd> Today + 1 year</p></li>
<li><p><kbd class="kbd docutils literal notranslate">M</kbd> Today + 1 month</p></li>
<li><p><kbd class="kbd docutils literal notranslate">W</kbd> Today + 1 week</p></li>
<li><p><kbd class="kbd docutils literal notranslate">D</kbd> Today + 1 day</p></li>
<li><p><kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">SHIFT</kbd> <kbd class="kbd docutils literal notranslate"></kbd>+<kbd class="kbd docutils literal notranslate"></kbd> <kbd class="kbd docutils literal notranslate">(YMWD)</kbd></kbd> Today less 1 year/month/week/day</p></li>
<li><p><kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">CTRL</kbd> <kbd class="kbd docutils literal notranslate"></kbd>+<kbd class="kbd docutils literal notranslate"></kbd> <kbd class="kbd docutils literal notranslate">Cursor</kbd> <kbd class="kbd docutils literal notranslate">Keys</kbd></kbd> Move the date selector around (up/down is +/- one week)</p></li>
<li><p><kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">CTRL</kbd> <kbd class="kbd docutils literal notranslate"></kbd>+<kbd class="kbd docutils literal notranslate"></kbd> <kbd class="kbd docutils literal notranslate">PgUp/PgDn</kbd></kbd> go forwards and backwards 1 month.</p></li>
</ul>
</section>
<section id="tables">
<h2>Tables<a class="headerlink" href="#tables" title="Link to this heading">¶</a></h2>
<img alt="_images/table.png" src="_images/table.png" />
<p>ASM uses tables to display data throughout the application. You can sort any
table in ascending order by clicking on the column heading you wish to sort on.
If you click the column heading again, it will be sorted in descending order
instead.  Hold down shift while clicking to sort on multiple columns at the
same time.</p>
<p>A system setting <span class="menuselection">Settings ‣ Options ‣ Display ‣ Keep
table headers visible when scrolling</span> allows the table headers to float at the
top when you scroll the screen if desired.</p>
<p>In addition, if you need to select any items in a table, tickboxes will appear
down the left hand side. Any actions you can take on selected items in a table
will be via buttons above the table.</p>
<p>The keyboard shortcut <kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">CTRL</kbd> <kbd class="kbd docutils literal notranslate"></kbd>+<kbd class="kbd docutils literal notranslate"></kbd> <kbd class="kbd docutils literal notranslate">A</kbd></kbd> can be used to select all items in the
currently visible table.</p>
</section>
<section id="initial-setup">
<h2>Initial Setup<a class="headerlink" href="#initial-setup" title="Link to this heading">¶</a></h2>
<p>Before doing anything else with your new ASM installation, you should now
perform the initial configuration of ASM for your shelter. The steps are as
follows:</p>
<ol class="arabic simple">
<li><p>If you want to use your own animal classifications, you can use the
<span class="menuselection">Settings ‣ Lookup Data ‣ Animal Types</span> to alter the
standard ASM ones - ASM assumes your shelter deals with dogs and cats and
wants to differentiate between stray, feral and abandoned animals. It also
has an extra type for boarding, which allows you to generate separate figures
for boarding animals.
After doing that, select your new defaults in the correct place on the
<span class="menuselection">Settings ‣ Options ‣ Defaults</span> screen.</p></li>
<li><p>Go to the <span class="menuselection">Settings ‣ Options ‣ Details</span> screen and enter
your shelter’s details. You can set all of the systemwide behaviours for ASM
and control the format of generated animal codes from the other tabs on this
screen as well.</p></li>
<li><p>Go to <span class="menuselection">Settings ‣ Lookup Data ‣ Locations</span> to setup your
available shelter locations. A location can have multiple units, which you
list in the “units” box of the location, separated by a comma. Locations can
be anything you want - eg: a room, an area of a room, a building. Units are
individual areas, pens or cages within that location.  For example, you
could create a location called “Dog Block A” with units “1, 2, 3, 4, 5” to
have 5 numbered pens.  When you use shelter view, you can have it group by
the location or the location and unit and it will allow you to drag and drop
animals between pens and locations to move them around. It will also
highlight empty pens so you can see capacity at a glance.</p></li>
<li><p>Go to <span class="menuselection">Settings ‣ Lookup Data ‣ Breeds</span> - Remove any
unwanted breeds and species from the database that your shelter does not
deal with.</p></li>
<li><p>Go to <span class="menuselection">Settings ‣ Reports ‣ Browse sheltermanager.com</span> and
install some reports. The “Select Recommended” button allows you to quickly
choose our recommended set for installation.</p></li>
<li><p>Create usernames and passwords for all your shelter staff in the
<span class="menuselection">Settings ‣ System User Accounts</span> screen. Once you have
your own username and password, delete the default “user” user. It is
advised that everyone has their own username and password rather than
using a shared account as it makes it easier to revoke individual permissions
or remove the account when staff leave without disrupting everyone else.</p></li>
</ol>
</section>
</section>


           </div>
          </div>
          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
        <a href="foreword.html" class="btn btn-neutral float-left" title="Foreword" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
        <a href="searching.html" class="btn btn-neutral float-right" title="Search" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
    </div>

  <hr/>

  <div role="contentinfo">
    <p>&#169; Copyright 2024, Sheltermanager, Ltd.</p>
  </div>

  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
    provided by <a href="https://readthedocs.org">Read the Docs</a>.
   

</footer>
        </div>
      </div>
    </section>
  </div>
  <script>
      jQuery(function () {
          SphinxRtdTheme.Navigation.enable(true);
      });
  </script> 

</body>
</html>