Hochladen von IGSN-Registrierungsdaten

Um IGSN-Metadaten im IGSN-Service der Universität Kiel zu registrieren, können Sie Daten in verschiedenen Formaten wie JSON oder CSV hochladen. Dieses Dokument enthält Anweisungen zum Hochladen von IGSN-Registrierungsdaten in den unterstützten Dateiformaten.

Hochladen der Datei

Suchen Sie den Bereich zum Hochladen von Dateien oder die Dropzone, die zum Hochladen von Daten vorgesehen ist.
Ziehen Sie die JSON-, CSV- oder TSV-Datei per Drag & Drop in die Dropzone oder klicken Sie auf den Upload-Bereich, um die Datei auf Ihrem lokalen System zu suchen und auszuwählen.
Nach Abschluss des Hochladevorgangs verarbeitet das System die Daten und führt Validierungsprüfungen an der hochgeladenen Datei durch.
Sie können nun mit allen weiteren Aktionen oder Vorgängen fortfahren, die Sie mit den IGSN-Metadaten durchführen müssen.

Bemerkung

Es ist wichtig, die spezifischen Anforderungen an das Dateiformat zu beachten und sicherzustellen, dass die Daten korrekt strukturiert sind, um Validierungsfehler zu vermeiden. Weitere Hinweise zum erforderlichen Format finden Sie in den beigefügten Beispielen.

Dateiformate

JSON

Sie können JSON-Dateien mit IGSN-Metadaten hochladen, die dem Metadatenschema folgen. Die JSON-Datei sollte entweder ein einzelnes IGSN-Metadatenobjekt oder eine Liste mit mehreren IGSN-Metadatenobjekten darstellen.

Beispiel

Beispiel für eine JSON-Datei mit einem einzigen IGSN-Metadatenobjekt mit minimalen Angaben (vgl. example_minimal.json).

{
  "creators":[
    {
      "name":"Musterfrau, Erika",
      "nameType":"Personal",
      "givenName":"Erika",
      "familyName":"Musterfrau"
    }
  ],
  "titles":[
    {
      "title":"My Sample Title"
    }
  ],
  "publicationYear":"2024"
}

In Fällen, in denen keine IGSN-ID angegeben wird, wird eine Zufalls-ID generiert.
Wenn die URL nicht festgelegt ist, wird eine Ersatz-URL generiert.
Wenn kein Ereignis angegeben wird, wird die IGSN mit dem Status „Entwurf“ registriert.

Beispiel

Beispiel für eine simple JSON-Datei mit einem einzigen IGSN-Metadatenobjekt (vgl. example_simple.json):

{
  "event": "publish",
  "doi":"10.82421/example01",
  "url":"https://example.com",
  "creators":[
    {
      "name":"Musterfrau, Erika",
      "nameType":"Personal",
      "givenName":"Erika",
      "familyName":"Musterfrau"
    }
  ],
  "titles":[
    {
      "title":"My Sample Title"
    }
  ],
  "publicationYear":"2024"
}

Die DOI und die URL wurden ausdrücklich angegeben.
Die Eigenschaft event ist explizit angegeben worden. Sie kann einen der folgenden Werte haben: publish, register oder hide. Weitere Einzelheiten entnehmen Sie bitte der offiziellen Dokumentation.

Beispiel

Beispiel für eine komplexe JSON-Datei mit einem einzigen IGSN-Metadatenobjekt (vgl. example_complex.json):

{
  "event":"publish",
  "doi":"10.82421/EXAMPLE0000000",
  "url":"https://example.com",
  "creators":[
    {
      "name":"Mustermann, Erika",
      "nameType":"Personal",
      "givenName":"Erika",
      "familyName":"Mustermann",
      "nameIdentifiers":[
        {
          "nameIdentifier":"https://orcid.org/0000-0000-0000-0000",
          "nameIdentifierScheme":"ORCID",
          "schemeURI":"https://orcid.org/"
        }
      ]
    }
  ],
  "titles":[
    {
      "title":"Sample Title"
    }
  ],
  "publicationYear":"2024",
  "subjects":[
    {
      "subject":"Subject Example"
    }
  ],
  "contributors":[
    {
      "name":"Mustermann, Max",
      "nameType":"Personal",
      "givenName":"Max",
      "familyName":"Mustermann",
      "contributorType":"ContactPerson",
      "nameIdentifiers":[
        {
          "nameIdentifier":"https://orcid.org/0000-0000-0000-0001",
          "nameIdentifierScheme":"ORCID",
          "schemeURI":"https://orcid.org/"
        }
      ]
    },
    {
      "name":"Example Institution",
      "nameType":"Organizational",
      "contributorType":"Distributor"
    }
  ],
  "dates":[
    {
      "date":"2021-07-22",
      "dateType":"Collected"
    },
    {
      "date":"2021-07-29",
      "dateType":"Issued"
    }
  ],
  "relatedIdentifiers":[
    {
      "relatedIdentifier":"https://www.example.com",
      "relatedIdentifierType":"URL",
      "relationType":"IsDocumentedBy"
    }
  ],
  "descriptions":[
    {
      "description":"Short Description",
      "descriptionType":"Other"
    }
  ],
  "geoLocations":[
    {
      "geoLocationPoint":{
        "pointLatitude":45,
        "pointLongitude":53.23
      }
    }
  ]
}

CSV

Sie können auch CSV-Dateien mit IGSN-Metadaten hochladen. Die Datei sollte einem bestimmten Format folgen, wobei jede Spalte ein anderes Feld der IGSN-Metadaten darstellt.

Beispiel

Beispiel für eine minimale CSV-Datei (vgl. example_minimal.csv):

"Creator","Title","Publication year"
"Musterfrau, Erika","My Sample Title",2024

Beispiel

Beispiel für eine simple CSV-Datei (vgl. example_simple.csv):

"Event","URL","Identifier","Creator","Title","Publication year"
"publish","https://example.com","10.82421/example01","Musterfrau, Erika","My Sample Title",2024

Beispiel

Beispiel für eine komplexe CSV-Datei mit zusätzlichen Feldern (vgl. example_complex.csv):

"Event","URL","Identifier","Creator","Title","Publication year","Subject","Contributor","Date","Related identifier","Description","Geo location","Alternate identifier"
"publish","https://example.com","10.82421/example01","Petersen, Thorge (orcid:0000-0002-2354-5914) [Kiel University (ror:04v76ef78)]; Paul-Stüve, Thilo (orcid:0000-0001-7451-0976) [Kiel University (ror:04v76ef78)]","My Sample Title",2024,"My subject","Musterfrau, Erika (orcid:0000-0000-0000-0000) [Affiliation name (ror:000000000)]; Mustermann, Max (orcid:0000-0000-0000-0001) [Affiliation name (ror:000000000)]","2023-07-06 (Issued); 2023-06-05T04:13:00+00:00 (Collected)","https://www.example.com","Short Description","54.0447,11.07825 (Kiel, Germany); 50.3267,9.0512","10273/example02 (IGSN); 10273/example03 (IGSN)"

Syntax

Urheber/Mitwirkende:

Die Namen sollten das Format <Nachname>, <Vorname> haben.
Es können mehrere Ersteller oder Mitwirkende aufgelistet werden, getrennt durch ein Semikolon (;).
Sie können eine ORCID ID für einen Urheber oder Mitwirkenden angeben, indem Sie (orcid:0000-0000-0000-0000) an den Namen anhängen.
Zugehörigkeiten können durch Einfügen von [Zugehörigkeitsname (ror:000000000)] nach dem Namen hinzugefügt werden. Derzeit werden nur ROR IDs unterstützt.

Datum:

Daten sollten wie in W3CDTF22 beschrieben formatiert werden.
Es können mehrere Daten angegeben werden, die durch ein Semikolon (;) getrennt sind.
Optionale Datumsarten können nach dem Datum in runden Klammern eingefügt werden. Zum Beispiel: 2023-06-05T04:13:00+00:00 (Collected).

Geostandorte:

Es können mehrere Geostandorte angegeben werden, die durch ein Semikolon (;) getrennt sind.
Für jeden Geostandort können Sie die Koordinaten im Format <Breitengrad>,<Längengrad> angeben.
Optionale Ortsnamen können nach den Koordinaten in runden Klammern eingefügt werden. Zum Beispiel: 54.0447,11.07825 (Kiel, Deutschland).

Bemerkung

Weitere Informationen finden Sie im Metadatenschema