Difference between revisions of "hierarchyEadAncestors"

From Archives Portal Europe Wiki
Jump to: navigation, search
 
(2 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
This service is a POST-request.
 
This service is a POST-request.
  
This hierarchy service delivers a list of all archival descriptions in the path from root to {id} in the hierarchy of the archival description. A web developer can use this service to create a tree-like presentation of a finding aid.  
+
This hierarchy-service delivers a list of all archival descriptions in the path from root to {id} of an archival description in the hierarchy of finding aid, a holdings guide or a source guide. A web developer can use this service to create a tree-like presentation of a finding aid, holdings guide or source guide.  
  
  
Line 9: Line 9:
 
Only one request parameter is required: the internal APE identifier of the descriptive unit for which a list of higher level ancestors is needed.
 
Only one request parameter is required: the internal APE identifier of the descriptive unit for which a list of higher level ancestors is needed.
  
On [base_url]/hierarchy/ead/{id}/ancestors, all the clevel descriptive units of that are on the path from {id} to the root of the hierarchy of the finding aid are given.
+
On [base_url]/hierarchy/ead/{id}/ancestors, all the clevel descriptive units that are on the path from {id} to the root in the hierarchy of a finding aid, holdings guide or source guide are given.
<br/><br/>
+
 
 +
''N.B.: you can find the (internal APE) identifier of a descriptive unit (always starting with a "C") which is necessary for using this service via the [[searchEad | /search/ead]] service''
  
 
= Response parameters =
 
= Response parameters =
The response contains a list of the descriptions that were found from the descriptive unit for which an identifier was provided up till the root of the finding aid.
+
The response contains a list of the descriptions that were found, from the descriptive unit for which an identifier was provided up till the root of the finding aid, holding guide or source guide.
  
Empty Response example:
+
== Empty Response example ==
<pre>
+
<pre style="white-space:-moz-pre-wrap; white-space:-pre-wrap; white-space:-o-pre-wrap; white-space:pre-wrap; word-wrap:break-word;">
 
{
 
{
 
   "totalResults": 0,
 
   "totalResults": 0,
Line 24: Line 25:
 
     {
 
     {
 
       "id": "string",
 
       "id": "string",
       "fondsUnitTitle": "string",
+
       "findingAidTitle": "string",
       "fondsUnitId": "string",
+
       "findingAidNo": "string",
 
       "repository": "string",
 
       "repository": "string",
 
       "country": "string",
 
       "country": "string",
Line 50: Line 51:
 
</pre>
 
</pre>
  
Basic Response example (for identifier: C85437490):
+
== Basic Response example ==
<pre>
+
For identifier C376209320:
 +
<pre style="white-space:-moz-pre-wrap; white-space:-pre-wrap; white-space:-o-pre-wrap; white-space:pre-wrap; word-wrap:break-word;">
 
{
 
{
 
   "totalResults": 2,
 
   "totalResults": 2,
Line 58: Line 60:
 
   "results": [
 
   "results": [
 
     {
 
     {
       "id": "F379211",
+
       "id": "F1049165",
       "fondsUnitTitle": "Inventaris van de collectie archieven Strijdkrachten in Nederlands-Indië, (1938 - 1939) 1941 - 1957 [1960]",
+
       "findingAidTitle": "Inventaris van de collectie archieven Strijdkrachten in Nederlands-Indië, (1938 - 1939) 1941 - 1957 [1960]",
       "fondsUnitId": "2.13.132",
+
       "findingAidNo": "2.13.132",
 
       "repository": "Nationaal Archief",
 
       "repository": "Nationaal Archief",
 
       "country": "NETHERLANDS",
 
       "country": "NETHERLANDS",
Line 82: Line 84:
 
     },
 
     },
 
     {
 
     {
       "id": "C85435671",
+
       "id": "C376208583",
       "fondsUnitTitle": "Inventaris van de collectie archieven Strijdkrachten in Nederlands-Indië, (1938 - 1939) 1941 - 1957 [1960]",
+
       "findingAidTitle": "Inventaris van de collectie archieven Strijdkrachten in Nederlands-Indië, (1938 - 1939) 1941 - 1957 [1960]",
       "fondsUnitId": "2.13.132",
+
       "findingAidNo": "2.13.132",
 
       "repository": "Nationaal Archief",
 
       "repository": "Nationaal Archief",
 
       "country": "NETHERLANDS",
 
       "country": "NETHERLANDS",
Line 93: Line 95:
 
       "hasDigitalObject": false,
 
       "hasDigitalObject": false,
 
       "numberOfDigitalObjects": 0,
 
       "numberOfDigitalObjects": 0,
       "numberOfDigitalObjectsInDescendents": 23297,
+
       "numberOfDigitalObjectsInDescendents": 0,
       "numberOfDescendents": 4525,
+
       "numberOfDescendents": 831,
 
       "docType": "Descriptive Unit",
 
       "docType": "Descriptive Unit",
 
       "docTypeId": "du",
 
       "docTypeId": "du",
 
       "level": "clevel",
 
       "level": "clevel",
 
       "indexDate": "",
 
       "indexDate": "",
       "unitId": "2.13.132 - A",
+
       "unitId": "2.13.132 - B",
       "unitTitle": "Beleidsterrein Operatiën",
+
       "unitTitle": "Beleidsterrein Personeel",
 
       "scopeContent": "",
 
       "scopeContent": "",
       "siblingPosition": 1,
+
       "siblingPosition": 2,
 
       "ancestorLevel": 1
 
       "ancestorLevel": 1
 
     }
 
     }
Line 119: Line 121:
  
 
== results ==
 
== results ==
Enumeration of the results. A result could be a holdings guide, a source guide, a finding aid, or a descriptive unit (ie. a sublevel component). They are all optional except "id".
+
Enumeration of the results. A result could be a holdings guide, a source guide, a finding aid, or a descriptive unit (ie a sublevel component). They are all optional except "id".
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 125: Line 127:
 
| Internal APE identifier of the result
 
| Internal APE identifier of the result
 
|-
 
|-
| fondsUnitTitle
+
| findingAidTitle
| Title of the finding aid
+
| Title of the finding aid, holdings guide or source guide
 
|-
 
|-
| fondsUnitId
+
| findingAidUnitId
 
| Identifier of the fonds provided by the repository
 
| Identifier of the fonds provided by the repository
 
|-
 
|-
Line 135: Line 137:
 
|-
 
|-
 
| country  
 
| country  
| Name of the country where the repository is. In English
+
| Name of the country where the repository is, in English
 
|-
 
|-
 
| language  
 
| language  
Line 144: Line 146:
 
|-
 
|-
 
| unitDate  
 
| unitDate  
| Date of creation of the result.
+
| Date of creation of the result
 
|-
 
|-
 
| repositoryCode  
 
| repositoryCode  
| Code of the repository holding the fonds. Preferably, but not necessarily [https://en.wikipedia.org/wiki/International_Standard_Identifier_for_Libraries_and_Related_Organizations ISIL]
+
| Code of the repository holding the fonds, preferably, but not necessarily [https://en.wikipedia.org/wiki/International_Standard_Identifier_for_Libraries_and_Related_Organizations ISIL]
 
|-
 
|-
 
| hasDigitalObject  
 
| hasDigitalObject  
Line 162: Line 164:
 
|-
 
|-
 
| docType  
 
| docType  
| Type of archives describing document where the result is found: "Finding Aid", "Holdings Guide", "Source Guide" or "Descriptive Unit"
+
| Type of document in which the result is found: "Finding Aid", "Holdings Guide", "Source Guide" or "Descriptive Unit"
 
|-
 
|-
 
| docTypeId
 
| docTypeId
| Acronym for the type of archives document ("fa" for "Finding Aid", "hg" for "Holdings Guide", "sg" for "Source Guide" or "du" for "Descriptive unit"
+
| Acronym for the type of document: "fa" for "Finding Aid", "hg" for "Holdings Guide", "sg" for "Source Guide" or "du" for "Descriptive unit"
 
|-
 
|-
 
| level
 
| level

Latest revision as of 15:44, 30 August 2017

Request url: https://api.archivesportaleurope.net/services/hierarchy/ead/{id}/ancestors. This service is a POST-request.

This hierarchy-service delivers a list of all archival descriptions in the path from root to {id} of an archival description in the hierarchy of finding aid, a holdings guide or a source guide. A web developer can use this service to create a tree-like presentation of a finding aid, holdings guide or source guide.




Request parameters

Only one request parameter is required: the internal APE identifier of the descriptive unit for which a list of higher level ancestors is needed.

On [base_url]/hierarchy/ead/{id}/ancestors, all the clevel descriptive units that are on the path from {id} to the root in the hierarchy of a finding aid, holdings guide or source guide are given.

N.B.: you can find the (internal APE) identifier of a descriptive unit (always starting with a "C") which is necessary for using this service via the /search/ead service

Response parameters

The response contains a list of the descriptions that were found, from the descriptive unit for which an identifier was provided up till the root of the finding aid, holding guide or source guide.

Empty Response example

{
  "totalResults": 0,
  "startIndex": 0,
  "totalPages": 0,
  "results": [
    {
      "id": "string",
      "findingAidTitle": "string",
      "findingAidNo": "string",
      "repository": "string",
      "country": "string",
      "language": "string",
      "langMaterial": "string",
      "unitDate": "string",
      "repositoryCode": "string",
      "hasDigitalObject": false,
      "numberOfDigitalObjects": 0,
      "numberOfDigitalObjectsInDescendents": 0,
      "numberOfDescendents": 0,
      "docType": "string",
      "docTypeId": "string",
      "level": "string",
      "indexDate": "string",
      "unitId": "string",
      "unitTitle": "string",
      "scopeContent": "string",
      "siblingPosition": 0,
      "ancestorLevel": 0
    }
  ]
}

Basic Response example

For identifier C376209320:

{
  "totalResults": 2,
  "startIndex": 0,
  "totalPages": 1,
  "results": [
    {
      "id": "F1049165",
      "findingAidTitle": "Inventaris van de collectie archieven Strijdkrachten in Nederlands-Indië, (1938 - 1939) 1941 - 1957 [1960]",
      "findingAidNo": "2.13.132",
      "repository": "Nationaal Archief",
      "country": "NETHERLANDS",
      "language": "",
      "langMaterial": "",
      "unitDate": "1938-1960",
      "repositoryCode": "NL-HaNA",
      "hasDigitalObject": false,
      "numberOfDigitalObjects": 0,
      "numberOfDigitalObjectsInDescendents": 23297,
      "numberOfDescendents": 5627,
      "docType": "Finding Aid",
      "docTypeId": "fa",
      "level": "archdesc",
      "indexDate": "",
      "unitId": "2.13.132",
      "unitTitle": "Ministerie van Defensie: Strijdkrachten in Nederlands-Indië",
      "scopeContent": "In het archief zijn de onder meer opgenomen de archieven van het Hoofdkwartier van de Generale Staf in Nederlands-Indië (HKGS-NI) (1945-1950), de Centrale Militaire Inlichtingendienst (1941-1949), de Commandant \"7 December\" Divisie, de Adjudant-Generaal in Nederlands-Indië/Indonesië (1945-1952), de staven van de T t/m Z Brigade, de Compagnieën Aan- en Afvoertroepen, de Kwartiermeester-Generaal en het Afwikkelingscommando in Indonesië (1950-1951). Tenslotte bevat het archief ook een collectie onderdeelsverslagen van Koninklijke Landmacht en het KNIL. Daaronder bevinden zich ook verslagen van het Korps Speciale Troepen en Korps Militaire Politie/Koninklijke Marechaussee.  Inhoud Onderzoek toonde aan dat bij het Bureau Centraal Archievendepot (BCAD) van het Defensie, Archieven-, Registratie- en Informatiecentrum een aantal archieven aanwezig was die door militaire instanties/onderdelen gevormd waren in het voormalige Nederlands-Indië. In overleg met het Nationaal Archief is besloten om deze in de \"Collectie archieven Strijdkrachten in Nederlands-Indië, (1938-1939) 1941-1957 [1960]\" samen te brengen, te inventariseren en over te dragen aan het Nationaal Archief. Het betreft hier de volgende archieven: Beleidsterrein Operatiën: Hoofdkwartier van de Generale Staf in Nederlands-Indië, 1945 - 1950; Hoofdkwartier van de Generale Staf in Nederlands-Indië, Sectie Krijgsgeschiedenis, 1945 - 1949; Kabinet van de Legercommandant in Nederlands-Indië, 1945 - 1950; Netherlands Forces Intelligence Service/Centrale Militaire Inlichtingendienst, 1941 - 1949; Hoofdkwartier Militaire Luchtvaart van het KNIL, Kantoor Inlichtingen in Nederlands-Indië, (1938-1939) 1942 - 1950; Collectie verspreide archivalia van de strijdkrachten in Indonesië, speciaal Oost-Java, 1945 - 1949; Collectie archiefbescheiden van de Commandant \"7 December\" Divisie en de onder zijn bevel ressorterende onderdelen in Nederlands-Indië, 1945 - 1950; Staven van de T t/m Z-Brigade en de Staf Bataljon 2-13 Regiment Infanterie in Nederlands-Indië, [1945] 1946 - 1950; Collectie onderdeelsverslagen in Nederlands-Indië, 1945 - 1950; Bataljons behorende tot Regimenten Infanterie in Nederlands-Indië, 1945 - 1950; Compagnieën Aan- en Afvoertroepen, 1945 - 1950; 6, 10 en 14 Genie Veldcompagnie Indië, 1947 - 1950. Beleidsterrein Personeel: Korps Militaire Politie/Koninklijke Marechaussee KNIL, 1947 - 1951; Hoofdkwartier Adjudant-Generaal in Indonesië, 1945 - 1952; Afwikkelingscommando in Indonesië, 1950 - 1951; Hoofdkwartier Militaire Luchtvaart, Kantoor Personeel, 1945 - 1949; Hoofd van de Militaire Geneeskundige Dienst te Batavia, 1948 - 1949; Subsistentenbataljon, 1946 - 1951; Persoonlijk archief van reserve luitenant-kolonel mr. J.F. Scheers, 1946 - 1948, 1952 - 1957 [1960]. Beleidsterrein Materieel: Kwartiermeester-Generaal/Territorium Nieuw-Guinea, 1949; Kwartiermeester-Generaal/Legermaterieeldienst, 1947 - 1950; Kwartiermeester-Generaal/Assistent Directeur Leger Materieeldienst - 3, [1947] 1949; Commissie van Proefneming in Nederlands-Indië, 1946 - 1950. Het totaal van de collectie heeft een omvang van 125m.",
      "siblingPosition": 0,
      "ancestorLevel": 0
    },
    {
      "id": "C376208583",
      "findingAidTitle": "Inventaris van de collectie archieven Strijdkrachten in Nederlands-Indië, (1938 - 1939) 1941 - 1957 [1960]",
      "findingAidNo": "2.13.132",
      "repository": "Nationaal Archief",
      "country": "NETHERLANDS",
      "language": "",
      "langMaterial": "",
      "unitDate": "",
      "repositoryCode": "NL-HaNA",
      "hasDigitalObject": false,
      "numberOfDigitalObjects": 0,
      "numberOfDigitalObjectsInDescendents": 0,
      "numberOfDescendents": 831,
      "docType": "Descriptive Unit",
      "docTypeId": "du",
      "level": "clevel",
      "indexDate": "",
      "unitId": "2.13.132 - B",
      "unitTitle": "Beleidsterrein Personeel",
      "scopeContent": "",
      "siblingPosition": 2,
      "ancestorLevel": 1
    }
  ]
}

totalResults

The response parameter "totalResults" gives the number of results.

startIndex

The response parameter "startIndex" gives the number of the chunk you requested.

totalPages

The response parameter "totalPages" gives the number of chunks.

results

Enumeration of the results. A result could be a holdings guide, a source guide, a finding aid, or a descriptive unit (ie a sublevel component). They are all optional except "id".

id Internal APE identifier of the result
findingAidTitle Title of the finding aid, holdings guide or source guide
findingAidUnitId Identifier of the fonds provided by the repository
repository Name of the repository holding the fonds
country Name of the country where the repository is, in English
language Language of the description of the result
langMaterial Language in which the result is created
unitDate Date of creation of the result
repositoryCode Code of the repository holding the fonds, preferably, but not necessarily ISIL
hasDigitalObject TRUE/FALSE
numberOfDigitalObjects Amount of digital objects available for the search result (is always 0 in case 'hasDigitalObject' = FALSE)
numberOfDigitalOjectsInDescendents Amount of digital objects available for descendents of the search result (can be > 0 in case 'hasDigtalObject' = FALSE)
numberOfDescendents Amount of descendents of the search result
docType Type of document in which the result is found: "Finding Aid", "Holdings Guide", "Source Guide" or "Descriptive Unit"
docTypeId Acronym for the type of document: "fa" for "Finding Aid", "hg" for "Holdings Guide", "sg" for "Source Guide" or "du" for "Descriptive unit"
level Type of result: "archdesc" for highest level description or "clevel" for subordinate components
indexDate Date showing when the result was ingested/updated and indexed in the Archives Portal Europe (ie last change date)
unitId Identifier of the result provided by the repository
unitTitle Description of the result
scopeContent More descriptive information about the result
siblingPosition Position of the result in the order of children in the level beneath the descriptive unit of the identifier in the request
ancestorLevel Position of the descriptive unit of the identifier in the request in the higher hierarchy of the document it belongs to