<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
        {font-family:"Cambria Math";
        panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
        {font-family:Calibri;
        panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
        {margin:0in;
        margin-bottom:.0001pt;
        font-size:11.0pt;
        font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
        {mso-style-priority:99;
        color:#0563C1;
        text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
        {mso-style-priority:99;
        color:#954F72;
        text-decoration:underline;}
p.msonormal0, li.msonormal0, div.msonormal0
        {mso-style-name:msonormal;
        mso-margin-top-alt:auto;
        margin-right:0in;
        mso-margin-bottom-alt:auto;
        margin-left:0in;
        font-size:11.0pt;
        font-family:"Calibri",sans-serif;}
span.EmailStyle18
        {mso-style-type:personal;
        font-family:"Calibri",sans-serif;
        color:windowtext;}
span.EmailStyle19
        {mso-style-type:personal-reply;
        font-family:"Calibri",sans-serif;
        color:windowtext;}
.MsoChpDefault
        {mso-style-type:export-only;
        font-size:10.0pt;}
@page WordSection1
        {size:8.5in 11.0in;
        margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
        {page:WordSection1;}
--></style>
</head>
<body lang="EN-US" link="#0563C1" vlink="#954F72">
<div class="WordSection1">
<p class="MsoNormal">Hi Adrien,<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">We use top containers, container profiles, and locations. Our reporting needs vary, but often they are related to answering questions like:<o:p></o:p></p>
<p class="MsoNormal">               “What boxes/materials are in this location?”<o:p></o:p></p>
<p class="MsoNormal" style="text-indent:.5in">“How much space do those boxes occupy?”<o:p></o:p></p>
<p class="MsoNormal" style="text-indent:.5in">“What’s in the box(es)?”<o:p></o:p></p>
<p class="MsoNormal" style="text-indent:.5in">“How many VHS boxes do we have?”<o:p></o:p></p>
<p class="MsoNormal" style="text-indent:.5in">“How many linear feet is collection X?”<o:p></o:p></p>
<p class="MsoNormal" style="text-indent:.5in">“Here’s a list of barcodes that should be in X location, are they actually there?”<o:p></o:p></p>
<p class="MsoNormal" style="text-indent:.5in">“How many boxes are in ArchivesSpace that aren’t associated with a descriptive record?”<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">To answer these questions, and others, we’ve typically used database queries. The API is not usually the most efficient way to retrieve ArchivesSpace data, though we have used the search endpoints for some reporting functions. For instance,
 this tool - <a href="https://github.com/ucancallmealicia/barcode_search">https://github.com/ucancallmealicia/barcode_search</a> - will take a list of barcodes, which are stored in top container records, and retrieve data about the containers and their associated
 descriptive records. This helps us to manage transfers of material to off-site storage.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">For the most part, though, SQL queries are the way to go. You’ll find a bunch of examples in these repos:<o:p></o:p></p>
<p class="MsoNormal">                <a href="https://github.com/ucancallmealicia/mysql_demo">
https://github.com/ucancallmealicia/mysql_demo</a> <o:p></o:p></p>
<p class="MsoNormal">                <a href="https://github.com/ucancallmealicia/archivesspace-sql">
https://github.com/ucancallmealicia/archivesspace-sql</a> <o:p></o:p></p>
<p class="MsoNormal">                <a href="https://github.com/YaleArchivesSpace/yams_data_auditing">
https://github.com/YaleArchivesSpace/yams_data_auditing</a> <o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">We haven’t used the out-of-the box reporting functionality, but we are considering it now that the module has been updated to allow users to add custom reports using raw SQL. Doing so would allow non-technical users to run these reports
 without having to ask technical staff for assistance. It has worked well during testing, though I think we as an institution will need to determine some criteria re: which reports we want to add before we start using it, since the reports are shared across
 repositories. <o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Hope this helps,<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Alicia<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Alicia Detelich<o:p></o:p></p>
<p class="MsoNormal">Archivist<o:p></o:p></p>
<p class="MsoNormal">Manuscripts and Archives<o:p></o:p></p>
<p class="MsoNormal">Yale University Libraries<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<div style="border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b><span style="font-size:12.0pt;color:black">From: </span></b><span style="font-size:12.0pt;color:black"><archivesspace_users_group-bounces@lyralists.lyrasis.org> on behalf of "Hilton, Adrien" <adrien_hilton@harvard.edu><br>
<b>Reply-To: </b>Archivesspace Users Group <archivesspace_users_group@lyralists.lyrasis.org><br>
<b>Date: </b>Tuesday, March 19, 2019 at 9:53 AM<br>
<b>To: </b>"archivesspace_users_group@lyralists.lyrasis.org" <archivesspace_users_group@lyralists.lyrasis.org><br>
<b>Subject: </b>[Archivesspace_Users_Group] Container and Location management reports<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<p class="MsoNormal">Dear Colleagues, <o:p></o:p></p>
<p class="MsoNormal"> <o:p></o:p></p>
<p class="MsoNormal">I’m wondering if anyone at a repository that currently uses containers, container profiles, locations, and/or location profiles might offer me some advice regarding reporting.
<o:p></o:p></p>
<p class="MsoNormal"> <o:p></o:p></p>
<p class="MsoNormal">What kinds of data do you find yourself needing most regularly? How are you getting that data? Customized reporting, out of the box reports, database queries, API, others?<o:p></o:p></p>
<p class="MsoNormal"> <o:p></o:p></p>
<p class="MsoNormal">Thanks in advance, <o:p></o:p></p>
<p class="MsoNormal">Adrien<o:p></o:p></p>
</div>
</body>
</html>