Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Steps to setting up MOD-NCIP (also see the MOD-NCIP readme file in github)

...

  • If you are using the edge-ncip module to allow external access to mod-ncip you will have to create a key that relates to this user.  See the edge-common module for more details.  What you will end up with is an API key you can use to represent this user.  You will be able to provide whomever will be calling your NCIP module externally with a link that will look something like this:   http://thedirecturltomyexternalncipmodule/ncip?apikey=eyJzIjoiSkFucGg0Wmw2OFd4ZkRBdnabcedefsgeJ1IjoibXlsdWlkIn0    The key can also be sent through in the header of the requests.  The edge-common module documentation describes the ways you can use the apiKey.  The apiKey is the method of authentication for external users of your NCIP module.

Step #2 - Decide on and set up configuration values.

...

Mod-NCIP includes a utility to validate the configuration values are valid.  If you send a GET request to: http://myokapiurl/ncipconfigcheck  it will attempt to lookup the values you set in mod-configuration to make sure those values exist in FOLIO (for those that need to exist in FOLIO).

Link to a Python script that sets up the example values in FOLIO.

Link to a Python script that sets these example values in mod-configuration.


There are example NCIP requests in github (note: they use the fromAgency of Relais) and lots more information about the module in the github readme file.


Other things to keep in mind:

  • Remember to have a circulation rule that will work for the settings you create above.
  • The pickup location that will be included in all 'AcceptItem' requests MUST be a service point with pickup location set to TRUE in FOLIO.


grant permissions python script:

...