GOBI® (Global Online Bibliographic Information) Integration (v1)

https://github.com/folio-org/mod-gobi

Table of contents

GOBI® (Global Online Bibliographic Information) Integration

GOBI® (Global Online Bibliographic Information) is the leading web-based acquisitions tool for finding, ordering and managing e-books and print books for libraries. This module allows GOBI initiated orders to be fulfilled by FOLIO.

/gobi/orders/mappings

GET /gobi/orders/mappings/fields

Get list of Folio fields

GET /gobi/orders/mappings/fields

Response 200

Returns a list of fields

Body

Media type: application/json

Type: json

Content:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "Collection of pairs field name and path in the JSON",
  "type": "object",
  "properties": {
    "fields": {
      "description": "An array of pairs field name and path in the JSON",
      "id": "fields",
      "type": "array",
      "items": {
        "type": "object",
        "$schema": "http://json-schema.org/draft-04/schema#",
        "description": "Field description",
        "properties": {
          "name": {
            "description": "Name of the field",
            "type": "string"
          },
          "path": {
            "description": "Path to field",
            "type": "string"
          },
          "description": {
            "description": "Description of the field",
            "type": "string"
          }
        }
      }
    },
    "totalRecords": {
      "description": "total number of records in the array",
      "type": "integer"
    }
  },
  "required": [
    "fields",
    "totalRecords"
  ]
}

Example:

{
  "fields": [
    {
      "name": "PREFIX",
      "path": "po.poNumberPrefix",
      "description": "Purchase order prefix"
    },
    {
      "name": "QUANTITY_ELECTRONIC",
      "path": "poLine.cost.quantityElectronic",
      "description": "Purchase order line electronic quantity"
    }
  ],
  "totalRecords": 2
}

GET /gobi/orders/mappings/translators

Get list of Gobi fields to Folio fields translators

GET /gobi/orders/mappings/translators

Response 200

Returns a list of translators

Body

Media type: application/json

Type: json

Content:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "Collection of pairs translator Java method name and name of translator",
  "type": "object",
  "properties": {
    "translators": {
      "description": "An array of pairs translator Java method name and name of translator",
      "id": "translators",
      "type": "array",
      "items": {
        "type": "object",
        "$schema": "http://json-schema.org/draft-04/schema#",
        "description": "Translator description",
        "properties": {
          "name": {
            "description": "Name of the translator",
            "type": "string"
          },
          "translator": {
            "description": "Path to java method to process",
            "type": "string"
          },
          "description": {
            "description": "Description of the translator",
            "type": "string"
          }
        }
      }
    },
    "totalRecords": {
      "description": "total number of records in the array",
      "type": "integer"
    }
  },
  "required": [
    "translators",
    "totalRecords"
  ]
}

Example:

{
  "translators": [
    {
      "name": "LOOKUP_LINKED_PACKAGE",
      "translator": "lookupLinkedPackage",
      "description": "Lookup purchase order line UUID by order line number"
    },
    {
      "name": "LOOKUP_SUFFIX",
      "translator": "lookupSuffix",
      "description": "Lookup suffix UUID for purchase order number"
    }
  ],
  "totalRecords": 2
}

GET /gobi/orders/mappings/types

Get list of types of the GOBI order

GET /gobi/orders/mappings/types

Response 200

Returns a list of types

Body

Media type: application/json

Type: string