Authority files

Prerequisites

• Have the knowledge of the basic Pathbuilder modeling mechanisms.
• Geofields and Map formatter are installed.

Installation

Visit Manage Extend and check

• Actions
• WissKI Authority Files
• WissKI DNB GND Adapter
• WissKI Geonames Adapter

and click Install.

Configuration

Add adapters

Navigate to Manage Configuration WissKI Salz Adapters (WissKI Salz section). Click + Add WissKI Salz Adapter, choose Geonames and enter a name for the geonames-adapter ... connects your WissKI with geonames API, has a administrative name like Geonames and a machine name like geonames. . Add another WissKI Salz Adapter, but now choose DNB GND and enter a name for the dnb-gnd-adapter ... connects your WissKI with the DNB GND API, has an administrative name like DNB GND and a machine name like dnb_gnd. as well.

Create authority files pathbuilder

Go to Manage Configuration Pathbuilders (WissKI Section), click + Add Pathbuilder and enter a Name for your authority-files-pathbuilder ... is the pathbuilder, where you add the groups and fields for the authority files, has a administrative name like Authority Files. . Under Additional settings, choose your repository-id ... is the machine name of the repository, i. e. default-adapter, backend-data or just wisski. and click Save without form generation. Model your Authority Information and Authority Document entity like the example in table 1 (do not forget to choose unique machine names) and click Save and generate bundles and fields.

Define the title pattern in Manage Structure WissKI Entities and Bundles for your bundles ("Authority ID" for Authority Information and "Name" for Authority Document).

Add authority information reference to your place and person entity

Now navigate to your existing named entities you want to extend with information with authority information and add the references to the authority information group  ... is a fundamental structure element of the pathbuilder and can be used as a disambiguation point. Enabled groups resulting in bundles, if you click Save and generate bundles and fields. Administrative names are i. e. Collection or Person and machine names should be start with "g_", like g_person. in their pathbuilder. Ensure that the Place entity has a field for coordinates. Do not forget to choose unique machine names! You see an example structure in table 2. When you are finished, click Save and generate bundles and fields.

Create DNB GND pathbuilder

Go to Manage Configuration Pathbuilders (WissKI Section), click + Add Pathbuilder, enter a Name for your dnb-gnd-pathbuilder ... is used for groups and fields only in connection with the DNB GND Adapter. Has a administrative name like DNB GND and a machine name like dnb_gnd. and choose DNB GND at Additional settings, Save without form generation. Model the groups and fields like in the example at table 3 (do not forget to choose unique machine names) and click Save and generate bundles and fields.

Create geonames pathbuilder

Go to Manage Configuration Pathbuilders (WissKI Section), click + Add Pathbuilder, enter a Name for your geonames-pathbuilder ... is the pathbuilder where you configure the groups and fields connected to you geonames adapter, has a administrative name like Geonames and a machine name like geonames. and choose Geonames at Additional settings, Save without form generation. Model the groups and fields like in the example at table 4  (do not forget to choose unique machine names). Save and generate bundles and fields.

Add DNB GND and Geonames authority file instance

Visit WissKI Create and click the bundle of your authority document, enter GND as Name. Save.

Repeat last step with Geonames.

Create action Complete authority file information

Navigate to Manage Configuration Actions (System section). Beneath Create an advanced action select Complete authority file information and click Create. You get the IDs for the fields from the groups and fields you modeled at your authority files pathbuilder (see Table 1).

Therefore open a new browser-tab and visit Manage Structure WissKI Entities and Bundles and in the row of your authority information entity, click Edit in the Operations column. You find the bundle ID next to Machine name. For the field IDs, visit the Manage fields tab, you see them in the column Machine name. Copy paste the IDs to the form of your Complete authority file information action.

For the field The completion patterns, you need the WissKI entity ID of your authority file individuals (GND and Geonames). Visit WissKI Navigate and click on the entity for your authority files. Click on the individual GND, you find the gnd-wissKI-entity-id in the adress bar of your browser. Please note the ID. Repeat the step for Geonames an note the geonames-wissKI-entity-id ... is the entity id of your geonames authority document, i. e. the 124 in http://wisski.com/wisski/navigate/124/view. , too.

Switch back to the Edit page of the action Complete authority file information and enter the pairs of entity ID and authority document URI in the field The completion patterns, in the pattern of:

gnd-wissKI-entity-id https://d-nb.info/gnd/{id}
geonames-wissKI-entity-id ... is the entity id of your geonames authority document, i. e. the 124 in http://wisski.com/wisski/navigate/124/view. https://sws.geonames.org/{id}/

For example 
 

97 https://d-nb.info/gnd/{id}

98 https://sws.geonames.org/{id}/

Create action Update authority file URI

Navigate to Manage Configuration Actions (System section). Beneath Create an advanced action select Update authority file URI and click Create.

In the Field IDs pointing to authority entries you need the pairs of the authority information ID from the named entities groups (at repository-id ... is the machine name of the repository, i. e. default-adapter, backend-data or just wisski. adapter, find examples in table 2) and in each case the authority URI (find examples in table 1).

Therefore open a new browser-tab and visit Manage Structure WissKI Entities and Bundles and in the row of your authority information entity (like Person or Place), click the caret to unfold the Operations menu and click Manage fields. Note the Machine name of the field of the authority information entity reference.

Switch back to the WissKI Bundles and Object page by clicking at the breadcrumb WissKI Bundles and Object Classes and repeat this step until you have noted every authortiy information field ID from every named entity. The example from table 2 shows that there are two authority information fields (ref_per_authority_info and ref_pla_authority_info), so that we can note two field IDs in this case (as shown in table 6).

You needed the Authority URI (i_aui_authority_uri) you already used for the form at action Complete authority file information (fe1e799aea63c96c9df2da87fbabd34a in our example, see table 5). 

Now, that you've got all IDs, switch back to the action Update authority file URI and enter the pairs of the authority Information field IDs with the authority URI field ID in field Field IDs pointing to authority entries, i. e. it could look like

The Input of the field Authority entry adapters is a pair of the machine name of your authority adapter and the regex of the authority domain:

dnb-gnd-adapter ... connects your WissKI with the DNB GND API, has an administrative name like DNB GND and a machine name like dnb_gnd. !^http[s]*://d-nb.info/gnd/\S+$!u
geonames-adapter ... connects your WissKI with geonames API, has a administrative name like Geonames and a machine name like geonames. !^http[s]*://sws.geonames.org/\d+/$!u

Click Save, when your finished.

Check results

Create a WissKI individual which is connected with an authority adapter (like Person). Inside the group  ... is a fundamental structure element of the pathbuilder and can be used as a disambiguation point. Enabled groups resulting in bundles, if you click Save and generate bundles and fields. Administrative names are i. e. Collection or Person and machine names should be start with "g_", like g_person. of your authority information, enter the type of authority (like GND) as the authority document and the identifier you copied from the source (wikipedia, gnd etc. like 6255146) as authority ID. Click Save. The information from the authority repository should automatically appear on the entity display page.