@item-enonic-types/lib-cristin v1.3.1
Cristin Library for Enonic XP
Cristin is a service that gathers and makes available information about Norwegian research.
Note This library is a companion to the xp-cristin application
This library is used to fetch data from the Cristin APIs, or read the data stored in a local repo by xp-cristin.
Installation
To install this library you need to add a new dependency to your app's build.gradle file.
Gradle
repositories {
maven { url 'https://jitpack.io' }
}
dependencies {
include "com.enonic.xp:lib-portal:${xpVersion}"
include "com.enonic.xp:lib-repo:${xpVersion}"
include "com.enonic.xp:lib-node:${xpVersion}"
include "com.enonic.xp:lib-value:${xpVersion}"
include "com.enonic.lib:lib-http-client:3.1.0"
include "no.item:lib-xp-cristin:1.0.15"
}
Usage
Getting Cristin data by ID
For most cases using the functions in "/lib/cristin"
is the most effective way to get Cristin data.
When calling these functions the following happens:
1. Check if the data with that Cristin ID is found in the local repo
2. If not, fetch it from the Cristin API and save it to the repo
3. Return the data (or void
if it doesn't exist)
The following functions to get a single entity are exported from "/lib/cristin"
:
getCristinPerson(id)
getCristinInstitution(id)
getCristinProject(id)
getCristinUnit(id)
getCristinResult(id)
getCristinResultContributors(id)
(Returns anArray
of contributors for a singleResult
)
The following functions to get Arrays
of entries are exported from "/lib/cristin"
:
getCristinPersons(ids)
getCristinInstitutions(ids)
getCristinProjects(ids)
getCristinUnits(ids)
getCristinResults(ids)
Example usage in an XP service:
var cristinLib = require('/lib/cristin');
exports.get = function() {
const person = cristinLib.getCristinPerson("12345")
return {
status: 200,
body: {
person: person
}
}
}
Fetch only from API
It is also possible to not use the local repo, and only get the data fresh from the API
The following functions to get a single entry are exported from "/lib/cristin/service"
:
fetchPersons({ id })
fetchProject({ id })
fetchResult({ id })
fetchResultContributors({ id })
fetchInstitution({ id })
fetchUnit({ id })
The following functions to get an Array
of entries are exported from "/lib/cristin/service"
:
fetchPersons(params)
fetchProjects(params)
fetchResults(params)
fetchPersonResults(params)
fetchInstitutions(params)
fetchResultCategories(params)
fetchUnits(params)
Only get from local repo (no API usage)
The following functions to get a single entry are exported from "/lib/cristin/storage"
:
lookupPerson(id)
lookupInstitution(id)
lookupProject(id)
lookupUnit(id)
lookupResult(id)
lookupResultContributors(id)
The following functions to get an Array
of entries are exported from "/lib/cristin/storage"
:
lookupPerson(ids)
lookupInstitution(ids)
lookupProject(ids)
lookupUnit(ids)
lookupResult(ids)
lookupResultContributors(ids)
Graphql Schemas
This library also exports GraphQL-definitions for use with the Guillotine library.
Names as strings
The following names as strings are exported from "/lib/cristin/graphql"
:
GRAPHQL_OBJECT_NAME_CRISTIN_UNIT
GRAPHQL_OBJECT_NAME_CRISTIN_INSTITUTION
GRAPHQL_OBJECT_NAME_CRISTIN_PERSON
GRAPHQL_OBJECT_NAME_CRISTIN_PROJECT
GRAPHQL_OBJECT_NAME_CRISTIN_RESULT
The following functions to create GraphQL object types are exported from "/lib/cristin/graphql"
:
createObjectTypeCristinPerson(context, options)
createObjectTypeCristinInstitution(context, options)
createObjectTypeCristinProject(context, options)
createObjectTypeCristinResult(context, options)
createObjectTypeCristinResultCategory(context, options)
createObjectTypeCristinUnit(context, options)
The following reference()
types are exported from "/lib/cristin/graphql"
(for usage after the object types has been registered):
GraphQLCristinPerson
GraphQLCristinInstitution
GraphQLCristinProject
GraphQLCristinResult
GraphQLCristinUnit
Example usage in Guillotine controller:
var guillotineLib = require("/lib/guillotine");
var cristinLib = require("/lib/cristin");
var cristinGraphqlLib = require("/lib/cristin/graphql");
var schema = guillotineLib.createSchema({
applications: ["com.myapp"],
creationCallbacks: {
com_myapp_Employee_Data: function(context, params) {
// Register GraphQL object types for Cristin objects needed
context.addDictionaryType(cristinGraphqlLib.createObjectTypeCristinInstitution(context));
context.addDictionaryType(cristinGraphqlLib.createObjectTypeCristinPerson(context));
params.fields.cristinProfile = {
// Use the reference type (`reference("no_item_cristin_Person")`)
type: cristinGraphqlLib.GraphQLCristinPerson,
resolve: function(env) {
return cristinLib.getCristinPerson(env.source.cristinProfileId);
}
};
},
}
});
Deploying
Building
To build he project run the following code
./gradlew build
Deploy locally
Deploy locally for testing purposes:
./gradlew publishToMavenLocal
Deploy to Jitpack
Go to the Jitpack page for lib-xp-cristin to deploy from Github.