<!-- 
RSS generated by JIRA (1001.0.0-SNAPSHOT#100246-sha1:7a5c50119eb0633d306e14180817ddef5e80c75d) at Fri Feb 09 00:18:35 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary add field=key&field=summary to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>FOLIO Jira</title>
    <link>https://folio-org.atlassian.net</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>1001.0.0-SNAPSHOT</version>
        <build-number>100246</build-number>
        <build-date>07-02-2024</build-date>
    </build-info>

<item>
            <title>[ERM-361] Support API for retrieving license terms based on a resource identifier</title>
                <link>https://folio-org.atlassian.net/browse/ERM-361</link>
                <project id="10130" key="ERM">ERM Platform</project>
                    <description>&lt;p&gt;Support the ability to make an API and get a license JSON representation back for public facing properties. API should support requests by:&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;eHoldings titleID+packageID
	&lt;ul&gt;
		&lt;li&gt;Example: Harvard Business Review in the Academic ASAP package has ID: 18-34-32090 &lt;span class=&quot;error&quot;&gt;&amp;#91;34 = packageID&amp;#93;&lt;/span&gt; and &lt;span class=&quot;error&quot;&gt;&amp;#91;32090 = titleID&amp;#93;&lt;/span&gt;.&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
	&lt;li&gt;Agreement resource ID&lt;/li&gt;
	&lt;li&gt;Resource Title identifier e.g. ISSN, ISBN (lower priority)&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;When a Request is made, relevant licenses should be identified by:&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;Identifying a resource&lt;/li&gt;
	&lt;li&gt;Finding all agreements which that resource is part of (either as an agreement line, or as part of a package which is part of an agreement via an agreement line) which also fulfil the criteria:
	&lt;ul&gt;
		&lt;li&gt;Agreement Status == Active AND agreement start date in the past AND (an end date in the future OR a blank end date)&lt;/li&gt;
		&lt;li&gt;Agreement Status == (Active OR Cancelled) AND Perpetual Access == Yes&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
	&lt;li&gt;Finding the Controlling license (if one exists) for the agreements&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;Once all relevant licenses have been identified the details of each relevant agreement+controlling license combination will be returned as the API response&lt;/p&gt;

&lt;p&gt;Multiple Agreement+License maybe returned to a single API call. The structure of response will be specified by 
    &lt;span class=&quot;jira-issue-macro resolved&quot; data-jira-key=&quot;ERM-360&quot; &gt;
                &lt;a href=&quot;https://folio-org.atlassian.net/browse/ERM-360&quot; class=&quot;jira-issue-macro-key issue-link&quot;  title=&quot;Define JSON format for public agreement+license information&quot; &gt;
            &lt;img class=&quot;icon&quot; src=&quot;https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10300?size=medium&quot; /&gt;
            ERM-360
        &lt;/a&gt;
                                                    &lt;span class=&quot;aui-lozenge aui-lozenge-subtle aui-lozenge-success jira-macro-single-issue-export-pdf&quot;&gt;Closed&lt;/span&gt;
            &lt;/span&gt;
&lt;/p&gt;</description>
                <environment></environment>
        <key id="40848">ERM-361</key>
            <summary>Support API for retrieving license terms based on a resource identifier</summary>
                <type id="10004" iconUrl="https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10300?size=medium">Sub-task</type>
                            <parent id="40942">ERM-356</parent>
                                    <priority id="10002" iconUrl="https://dev.folio.org/assets/jira-priority/jira-p3.svg">P3</priority>
                        <status id="6" iconUrl="https://folio-org.atlassian.net/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="green"/>
                                    <resolution id="10003">Done</resolution>
                                                        <assignee accountid="5bfd62c75f77da6929583d6c">steve.osguthorpe</assignee>
                                                                <reporter accountid="63ada7c86f068efec8f6fbdf">Jag Goraya</reporter>
                                    <labels>
                            <label>erm</label>
                    </labels>
                <created>Mon, 24 Jun 2019 10:27:05 +0000</created>
                <updated>Mon, 23 Jan 2023 12:11:07 +0000</updated>
                            <resolved>Thu, 5 Dec 2019 17:20:40 +0000</resolved>
                                                                    <component>mod-agreements</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>8</watches>
                                                                <comments>
                                                            <comment id="89290" author="63ada7c86f068efec8f6fbdf" created="Wed, 24 Jul 2019 12:46:50 +0000"  >&lt;blockquote&gt;&lt;p&gt;Support the ability to make an API call to an &quot;edge API&quot; service and get a license JSON representation back for public facing properties&lt;/p&gt;&lt;/blockquote&gt;
&lt;p&gt;&lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=557058%3Af42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; class=&quot;user-hover&quot; rel=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; data-account-id=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; accountid=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; rel=&quot;noreferrer&quot;&gt;Owen Stephens&lt;/a&gt; is the &quot;license JSON representation&quot; the one defined in 
    &lt;span class=&quot;jira-issue-macro resolved&quot; data-jira-key=&quot;ERM-360&quot; &gt;
                &lt;a href=&quot;https://folio-org.atlassian.net/browse/ERM-360&quot; class=&quot;jira-issue-macro-key issue-link&quot;  title=&quot;Define JSON format for public agreement+license information&quot; &gt;
            &lt;img class=&quot;icon&quot; src=&quot;https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10300?size=medium&quot; /&gt;
            ERM-360
        &lt;/a&gt;
                                                    &lt;span class=&quot;aui-lozenge aui-lozenge-subtle aui-lozenge-success jira-macro-single-issue-export-pdf&quot;&gt;Closed&lt;/span&gt;
            &lt;/span&gt;
?&lt;/p&gt;</comment>
                                                            <comment id="89291" author="557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa" created="Thu, 25 Jul 2019 05:50:40 +0000"  >&lt;p&gt;Yes&lt;/p&gt;</comment>
                                                            <comment id="89293" author="62a96ae7192edb006f9f1bf9" created="Wed, 31 Jul 2019 13:43:16 +0000"  >&lt;p&gt;&lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=557058%3Af42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; class=&quot;user-hover&quot; rel=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; data-account-id=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; accountid=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; rel=&quot;noreferrer&quot;&gt;Owen Stephens&lt;/a&gt; &lt;/p&gt;
&lt;ul class=&quot;alternate&quot; type=&quot;square&quot;&gt;
	&lt;li&gt;What about this scenario Status = Cancelled AND Perpetual Access = Yes?&lt;/li&gt;
	&lt;li&gt;The eholdings resourceID = titleID+packageID?&lt;/li&gt;
	&lt;li&gt;What is the Agreement resource ID?&lt;/li&gt;
&lt;/ul&gt;
</comment>
                                                            <comment id="89295" author="557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa" created="Wed, 31 Jul 2019 13:50:34 +0000"  >&lt;p&gt;&amp;gt; What about this scenario Status = Cancelled AND Perpetual Access = Yes?&lt;br/&gt;
&lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=62a96ae7192edb006f9f1bf9&quot; class=&quot;user-hover&quot; rel=&quot;62a96ae7192edb006f9f1bf9&quot; data-account-id=&quot;62a96ae7192edb006f9f1bf9&quot; accountid=&quot;62a96ae7192edb006f9f1bf9&quot; rel=&quot;noreferrer&quot;&gt;Khalilah Gambrell&lt;/a&gt; I&apos;m happy to add this to the criteria if that&apos;s your preference?&lt;/p&gt;

&lt;p&gt;&amp;gt;The eholdings resourceID = titleID+packageID?&lt;br/&gt;
&lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=62a96ae7192edb006f9f1bf9&quot; class=&quot;user-hover&quot; rel=&quot;62a96ae7192edb006f9f1bf9&quot; data-account-id=&quot;62a96ae7192edb006f9f1bf9&quot; accountid=&quot;62a96ae7192edb006f9f1bf9&quot; rel=&quot;noreferrer&quot;&gt;Khalilah Gambrell&lt;/a&gt; can you clarify with some examples of what IDs you&apos;d want to be able to use and how they map to the IDs we can access in Agreements/eHoldings?&lt;/p&gt;

&lt;p&gt;&amp;gt;What is the Agreement resource ID?&lt;br/&gt;
I had in mind this was a Folio UUID for a resource in the Agreement internal KB &lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=5bfd62c75f77da6929583d6c&quot; class=&quot;user-hover&quot; rel=&quot;5bfd62c75f77da6929583d6c&quot; data-account-id=&quot;5bfd62c75f77da6929583d6c&quot; accountid=&quot;5bfd62c75f77da6929583d6c&quot; rel=&quot;noreferrer&quot;&gt;steve.osguthorpe&lt;/a&gt; does that make sense?&lt;/p&gt;</comment>
                                                            <comment id="89297" author="62a96ae7192edb006f9f1bf9" created="Fri, 2 Aug 2019 11:44:12 +0000"  >&lt;p&gt;&amp;gt; What about this scenario Status = Cancelled AND Perpetual Access = Yes?&lt;br/&gt;
Khalilah Gambrell I&apos;m happy to add this to the criteria if that&apos;s your preference?&lt;br/&gt;
&lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=557058%3Af42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; class=&quot;user-hover&quot; rel=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; data-account-id=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; accountid=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; rel=&quot;noreferrer&quot;&gt;Owen Stephens&lt;/a&gt;, proceed. &lt;/p&gt;

&lt;p&gt;&amp;gt;The eholdings resourceID = titleID+packageID?&lt;br/&gt;
Khalilah Gambrell can you clarify with some examples of what IDs you&apos;d want to be able to use and how they map to the IDs we can access in Agreements/eHoldings?&lt;br/&gt;
Example: Harvard Business Review in the Academic ASAP package -  &lt;a href=&quot;https://folio-snapshot.aws.indexdata.com/eholdings/resources/18-34-32090&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;https://folio-snapshot.aws.indexdata.com/eholdings/resources/18-34-32090&lt;/a&gt;    &lt;span class=&quot;error&quot;&gt;&amp;#91;34 = packageID&amp;#93;&lt;/span&gt;  and &lt;span class=&quot;error&quot;&gt;&amp;#91;32090 = titleID&amp;#93;&lt;/span&gt;. It would be great to retrieve by both IDs or at minimum the packageID. &lt;/p&gt;

&lt;p&gt;&amp;gt;What is the Agreement resource ID?&lt;br/&gt;
I had in mind this was a Folio UUID for a resource in the Agreement internal KB Steve Osguthorpe does that make sense?&lt;/p&gt;</comment>
                                                            <comment id="89299" author="557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa" created="Fri, 2 Aug 2019 11:57:26 +0000"  >&lt;p&gt;Thanks &lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=62a96ae7192edb006f9f1bf9&quot; class=&quot;user-hover&quot; rel=&quot;62a96ae7192edb006f9f1bf9&quot; data-account-id=&quot;62a96ae7192edb006f9f1bf9&quot; accountid=&quot;62a96ae7192edb006f9f1bf9&quot; rel=&quot;noreferrer&quot;&gt;Khalilah Gambrell&lt;/a&gt; have updated description based on this. One additional question:&lt;/p&gt;

&lt;blockquote&gt;&lt;p&gt;It would be great to retrieve by both IDs or at minimum the packageID.&lt;/p&gt;&lt;/blockquote&gt;
&lt;p&gt;So if API were passed: 18-34-32090 (Harvard Business Review in the Academic ASAP package)&lt;/p&gt;

&lt;p&gt;Should that (ideally) return Agreement+License for all Agreements containing HBR (titleID = 32090) or only for those that contain HBR as part of Academic ASAP (i.e. Agreement line for packageID = 34 OR Agreement line for packageID+titleID 34-32090) ?&lt;/p&gt;

&lt;p&gt;My initial assumption had been only the latter - because if you are querying based on the package that will have specific licenses that apply. But happy to return more if we can (tbh we may have to explore exactly what&apos;s possible but at the moment just trying to understand the ideal from your perspective)&lt;/p&gt;</comment>
                                                            <comment id="89302" author="63ada7c86f068efec8f6fbdf" created="Mon, 2 Dec 2019 12:19:54 +0000"  >&lt;p&gt;&lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=5bfd62c75f77da6929583d6c&quot; class=&quot;user-hover&quot; rel=&quot;5bfd62c75f77da6929583d6c&quot; data-account-id=&quot;5bfd62c75f77da6929583d6c&quot; accountid=&quot;5bfd62c75f77da6929583d6c&quot; rel=&quot;noreferrer&quot;&gt;steve.osguthorpe&lt;/a&gt; what&apos;s the url structure for calling this to test please? /cc &lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=557058%3Af42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; class=&quot;user-hover&quot; rel=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; data-account-id=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; accountid=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; rel=&quot;noreferrer&quot;&gt;Owen Stephens&lt;/a&gt;&lt;/p&gt;</comment>
                                                            <comment id="89304" author="712020:e80f9b53-714e-4326-a026-ec430909e42c" created="Mon, 2 Dec 2019 13:41:39 +0000"  >&lt;p&gt;I found a new &lt;tt&gt;erm/sas/publicLookup&lt;/tt&gt; endpoint in Steves commits, no idea, if that&apos;s what you&apos;re looking for &lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=63ada7c86f068efec8f6fbdf&quot; class=&quot;user-hover&quot; rel=&quot;63ada7c86f068efec8f6fbdf&quot; data-account-id=&quot;63ada7c86f068efec8f6fbdf&quot; accountid=&quot;63ada7c86f068efec8f6fbdf&quot; rel=&quot;noreferrer&quot;&gt;Jag Goraya&lt;/a&gt;, &lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=557058%3Af42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; class=&quot;user-hover&quot; rel=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; data-account-id=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; accountid=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; rel=&quot;noreferrer&quot;&gt;Owen Stephens&lt;/a&gt;&lt;/p&gt;</comment>
                                                            <comment id="89306" author="557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa" created="Mon, 2 Dec 2019 14:06:25 +0000"  >&lt;p&gt;Thanks &lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=712020%3Ae80f9b53-714e-4326-a026-ec430909e42c&quot; class=&quot;user-hover&quot; rel=&quot;712020:e80f9b53-714e-4326-a026-ec430909e42c&quot; data-account-id=&quot;712020:e80f9b53-714e-4326-a026-ec430909e42c&quot; accountid=&quot;712020:e80f9b53-714e-4326-a026-ec430909e42c&quot; rel=&quot;noreferrer&quot;&gt;Claudia Malzer&lt;/a&gt; - I saw that and was trying to use it, but couldn&apos;t get an expected response (JSON with license details in) - I was unclear where the resourceId or referenceId should go (part of the path? or a parameter?)&lt;/p&gt;</comment>
                                                            <comment id="89309" author="5bfd62c75f77da6929583d6c" created="Tue, 3 Dec 2019 14:57:42 +0000"  >&lt;p&gt;&lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=557058%3Af42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; class=&quot;user-hover&quot; rel=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; data-account-id=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; accountid=&quot;557058:f42d9c43-226d-4aa3-bb31-9b2dd07920aa&quot; rel=&quot;noreferrer&quot;&gt;Owen Stephens&lt;/a&gt;&lt;br/&gt;
the endpoint and full path is `erm/sas/publicLookup`&lt;/p&gt;

&lt;p&gt;And the rule for nearly all our controllers is you can supply the following (all as encoded url parameters):&lt;br/&gt;
`term`&lt;br/&gt;
`match`&lt;br/&gt;
`filters`&lt;br/&gt;
`sort`&lt;br/&gt;
`offset` or `page`&lt;br/&gt;
`max` or `perPage`&lt;/p&gt;

&lt;p&gt;`term`, `match`, `filters`, `sort` can only be used on the data stored in this module So you can not filter by license term from this endpoint.&lt;/p&gt;

&lt;p&gt;Bu also for this one I added&lt;br/&gt;
`referenceId` and `resourceId` (which both just effectively prepoulate a load of filters for you)&lt;/p&gt;

&lt;p&gt;You should be able to use a url like this for E-Holdings or other references should we add them:&lt;br/&gt;
`/erm/sas/publicLookup?referenceId=18-34-32090` find all agreements with that resource as part of it.&lt;br/&gt;
`/erm/sas/publicLookup?referenceId=18-34` find all agreements specifically with the package.&lt;/p&gt;

&lt;p&gt;resourceId can be supplied for any of our resources that you can add to an agreement +titelInstance and it should do the correct joins.&lt;br/&gt;
`/erm/sas/publicLookup?resourceId=some-id-of-internal-resource`&lt;/p&gt;
</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10003">
                    <name>Relates</name>
                                            <outwardlinks description="relates to">
                                        <issuelink>
            <issuekey id="41147">ERM-641</issuekey>
        </issuelink>
                            </outwardlinks>
                                                                <inwardlinks description="relates to">
                                        <issuelink>
            <issuekey id="43546">ERM-2514</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10000" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummarycf">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10057" key="com.atlassian.jira.plugin.system.customfieldtypes:select">
                        <customfieldname>Development Team</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="10141"><![CDATA[Bienenvolk]]></customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10019" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|hzzufj:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10020" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue id="160">ERM Sprint 78</customfieldvalue>
    <customfieldvalue id="164">ERM Sprint 70</customfieldvalue>
    <customfieldvalue id="165">ERM Sprint 71</customfieldvalue>
    <customfieldvalue id="139">ERM Sprint 75</customfieldvalue>
    <customfieldvalue id="140">ERM Sprint 76</customfieldvalue>
    <customfieldvalue id="141">ERM Sprint 72</customfieldvalue>
    <customfieldvalue id="142">ERM Sprint 73</customfieldvalue>
    <customfieldvalue id="143">ERM Sprint 77</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10024" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>[CHART] Date of First Response</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Thu, 25 Jul 2019 05:50:40 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10025" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>[CHART] Time in Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                    </customfields>
    </item>
</channel>
</rss>