Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Extended list of fields described

Questions

...

FOLIO Attribute Definition Sources

-See ERM Statistics summary for report descriptions and priority.

-API reference documentation for all modules located at:  https://dev.folio.org/reference/api/

...

Folio Attribute

Folio Data Element Description

Notes

From internal table mod_agreements.subscription_agreement:

sa_idUUID of Agreement
sa_nameA name for the agreement assigned by the institution
sa_descriptionA description for the agreement assigned by the institution
sa_agreement_statusID of reference data value (mod_agreements.refdata_value.rdv_id) which describes the current status of the agreement (e.g. Active, Closed)
sa_reason_for_closureID of reference data value (mod_agreements.refdata_value.rdv_id) which describes for a closed agreement, the reason the agreement has been closed (a closed agreement is one with status == "Closed" - set via sa_agreement_status)
sa_renewal_priorityID of reference data value (mod_agreements.refdata_value.rdv_id) which describes whether an agreement should be renewed, reviewed or cancelled
sa_is_perpetualID of reference data value (mod_agreements.refdata_value.rdv_id) which describes whether the agreement is a perpetual agreement or not
sa_local_referenceWhere an agreement has been created through an integration / data import from an external system the sa_local_reference is used to store a reference/identifier for the agreement in the external system to support ongoing data synchronisation/updates
sa_license_noteTo record any general information about the license for the Agreement
custom_properties_idID used to link custom_properties (aka supplementary properties) via mod_agreements.custom_properties.parent_id to an agreement. (n.b. each agreement can have zero to many custom_properties)
From internal table mod_agreements.entitlement:

Each entitlement is linked to one and only one agreement

Each agreement can be linked to zero to many entitlements

Each entitlement must to linked to only one resource

ent_idUUID of Entitlement (aka Agreement Line)
ent_owner_fkID of Agreement (mod_agreements.subscription_agreement.sa_id) to which the entitlement belongs
ent_resource_fkID of the resource (mod_agreements.erm_resource.id, mod_agreements.package.id, mod_agreements.package_content_item.id ) which the Entitlement gives access to
ent_active_fromDate from which the entitlement was active in format yyyy-MM-dd. No time or timezone
ent_active_toDate to which the entitlement was active in format yyyy-MM-dd. No time or timezone
From internal table mod_agreements.order_line:

Links entitlements to purchase order lines in the Orders app.

Each entitlement can be linked to zero to many purchase order lines.

Each purchase borderline can be linked to zero to many entitlements

pol_idUUID of order_line record
pol_orders_fkID of purchase order line in Orders app
pol_owner_fkID of entitlement (mod_agreements.entitlement.ent_id) to which purchase order line is linked
From internal table mod_agreements.erm_resource:

erm_resource is one facet of resources that can be linked to entitlements

Each erm_resource can be linked to zero to many entitlements

idID of erm_resource
res_nameName of the resource (can be name of a package or other resource type or the title of a published work such as a book or journal)
res_type_fkID of reference data value for the type of resource. Common values include "serial", "monograph", "book", "journal".
res_subtype_fkID of reference data value for the subtype of resourceCommon values include "electronic" or "print".
From internal table mod_agreements.package:

A package represents a group of content

Every package is an erm_resource.

Each package contains zero or more package_content_items

idID of packageThe ID of the package will appear in the erm_resource table for the erm_resource record associated with the package
pkg_vendor_idID of the package provider organisation (in mod_agreements.orgs)Despite the column name, this is for the provider of the package NOT the vendor of the package
pkg_sourceString describing the source of the package data
pkg_remote_kbID of the remote knowledgebase from which the package data was obtained (in mod_agreements.remotekb)
pkg_referenceID or reference for the package in an external system
From internal table mod_agreements.package_content_item:

A package_content_item represents a particular resource (book or journal title) accessible via a particular online platform sold or made available as part of a particular package

Every package_content_item is an erm_resource.

Each package_content_item belongs to exactly one package

Each package_content_item is linked to exactly one platform_title_instance

idID of the package content itemThe ID of the package_content_item will appear in the erm_resource table for the erm_resource record associated with the package_content_item
pci_pti_fkID of the platform_title_instance that the package_content_item is linked to
pci_pkg_fkID of the package that the package_content_item belongs to
pci_access_startThe date on which a package_content_item was first accessible in a packageIf `null` then it is assumed that the package_content_item was accessible in the package at the earliest possible data
pci_access_endThe date on which a package_content_item was last accessible in a packageIf `null` then it is assumed that the package_content_item is still accessible in the package at the current date
From internal table mod_agreements.platform_title_instance:

A platform_title_instance represents a particular resource (book or journal title) accessible via a particular online platform.

Every platform_title_instance is an erm_resource. 

Each platform_title_instance belongs to exactly one platform

Each platform_title_instance is linked to exactly one title_instance

Each platform_title_instance is linked to zero or more package_content_items

idID of the platform_title_instanceThe ID of the platform_title_instance will appear in the erm_resource table for the erm_resource record associated with the platform_title_instance
pti_pt_fkThe ID of the platform that the platform_title_instance belongs to
pti_ti_fkThe ID of the title_instance to which the platform_title_instance is linked
pti_urlThe URL of the platform_title_instanceThis is the URL where the relevant resource content can be accessed
From internal table mod_agreements.platform:





From internal table mod_agreements.title_instance:





From internal table mod_agreements.work:





From internal table mod_agreements.identifier_occurrence:





From internal table mod_agreements.identifier:





From internal table mod_agreements.coverage_statement:





Plus the data from the RM-Costs Cluster Prototype

...