Help:De:MergeEdit
Categories: WikiTree-Hilfe | WikiTree Apps Project | Entwicklerhilfe
Haftungsausschluss: Dies ist eine inoffizielle Übersetzung. Die englischsprachigen Versionen sind die offiziellen Hilfeseiten.
Übersetzt: D. Lewerenz, Geprüft: I. Caruso, 16 Okt 2022
Special:MergeEdit ist ein Tool für Entwickler, das es erlaubt, externe Daten in ein WikiTree-Profil einzubinden.
Wenn Du irgendwelche Fragen hast, kannst Du der WikiTree-Apps Google Gruppe beitreten und dort fragen.
Contents |
Verwendung von MergeEdit
Um MergeEdit zu verwenden, stelle eine entsprechende POST-Anfrage an https://www.wikitree.com/wiki/Special:MergeEdit.
Du musst zwei Dinge in deiner POST-Anfrage übermitteln:
- Einen Identifikator für das Profil, das Du bearbeiten möchtest.
- Welche Felder Du verändern möchtest und die neuen Daten für diese Felder
Der Identifikator kann die WikiTree-ID (user_name), die Benutzer-ID (id) oder die Seiten-ID (page_id) eines Profils sein.
Die Änderungsdaten können entweder im Format JSON (Person) oder GEDCOM X (Daten) gesendet werden.
Inhalt der Anfrage
user_name
Dies ist die WikiTree-ID des Profils. Sie sollte das Format Name-1234 haben.
id
Dies ist die Benutzer-ID des Profils. Es ist eine Zahl.
page_id
Dies ist die Seiten-ID des Profils. Es ist eine Zahl.
person
Dies sind die Daten, die Du zum Ändern des Profils verwenden möchtest. Sie bestehen aus vier Teilen:
- Die Felder, die Du ändern möchtest, und ihre neuen Werte (erforderlich)
- Die Daten, die Du für das Profil erwartest, bevor Du es änderst (optional)
- Verschiedene Optionen für die Daten (optional)
- Eine Zusammenfassung der Änderungen (optional)
person
Dies sind die Felder, die Du ändern möchtest.
Die anerkannten Felder sind:
Prefix: Das Präfix der Person.
FirstName: Der Vorname der Person bei der Geburt.
RealName: Der aktuelle Vorname der Person.
MiddleName: Der Mittelname der Person.
LastNameCurrent: Der aktuelle Nachname der Person.
LastNameOther: Alle anderen Nachnamen, die die Person hatte, durch Kommas getrennt.
Nicknames: Alle Spitznamen, die die Person hat, durch Kommas getrennt.
Suffix: Das Suffix einer Person.
BirthDate: Das Geburtsdatum einer Person.
BirthLocation: Der Geburtsort einer Person.
DeathDate: Das Sterbedatum einer Person.
DeathLocation: Der Sterbeort einer Person.
Gender: Das Geschlecht einer Person.
Bio: Der Text der Biografie.
expected
Dies sind die Werte, die Du für das Profil erwartest. Wenn der erwartete Wert nicht mit dem übereinstimmt, was im Profil steht, dann wird der ursprüngliche Wert weiterhin geprüft und Du erhältst eine Fehlermeldung wie: "Es gibt eine eingehende Änderung für den aktuellen Nachnamen, aber die ursprünglichen Daten stimmen nicht mit dem erwarteten Wert "Nelson" überein. Diese Aktualisierung wird übersprungen."
Die akzeptierten Felder für die erwarteten sind die gleichen wie die personenbezogenen.
options
Derzeit gibt es nur eine Option.
mergeBio: Wenn diese Option auf 1 gesetzt ist, wird der Text im Feld “Bio“ an das Ende des Abschnitts == Biography == des Profils angefügt. Wenn diese Option nicht gesetzt ist, wird die gesamte Biografie durch den Text im "Bio"-Feld überschrieben.
summary
Dies ist der Text, der im Feld "Change summary" (Zusammenfassung ändern) erscheint. Die Standardmeldung lautet "Imported data from external site" (Daten von externer Seite importiert).
Beispiel
{
}
- "person": {
- "FirstName": "John",
- "MiddleName": "Alexander",
- "LastNameCurrent": "Doe",
- "Suffix": "Jr",
- "BirthDate": "25 Jun 1990",
- "BirthLocation": "Montana, United States",
- "Bio": "Dies ist eine Ergänzung zur Biografie."
- },
- "expected": {
- "LastNameCurrent": "Doe"
- },
- "options": {
- "mergeBio": 1
- },
- "summary": "Ich habe einige Daten geändert."
data
Dies sind die Daten, die Du zum Ändern des Profils verwenden möchtest. Sie setzen sich aus drei Teilen zusammen:
- Die Felder, die Du ändern möchtest, und ihre neuen Werte (erforderlich)
- Die Quellen, die Du dem Profil hinzufügen möchtest (optional)
- Eine Zusammenfassung der Änderungen (optional)
Es werden GEDCOM X Daten verwendet. Du kannst hier mehr über GEDCOM X lesen .
persons
persons ist ein Bereich für Personen. Für die Zwecke von MergeEdit sollte nur eine Person in dem Bereich enthalten sein. Personen sind aus vier Teilen zusammengesetzt:
- Ein Identifikator für die Person.
- Die mit der Person verbundenen Namen.
- Das Geschlecht der Person.
- Ereignisse, die mit der Person verbunden sind.
id
Dies ist eine Referenz-ID. Sie erscheint auf der Seite MergeEdit, wird aber nicht im Profil gespeichert.
names
Dies ist eine Liste von Namen der Person. Für die Zwecke von MergeEdit wird nur einer benötigt. Names besteht aus einer Liste von nameForms und nameForms besteht aus einer Liste von Namensteilen.
Name parts have a type and a value.
type: Welcher Typ von Namensteil es ist. Eine Liste der Namensteil-Typen kannst Du hier sehen.
value: Der entsprechende Name. Beispiel: John.
gender
Das Geburtsgeschlecht der Person.
type: Es kann männlich, weiblich oder unbekannt sein.
Lies mehr über Typen von Geschlechtern bei GEDCOM X hier.
facts
Dies ist eine Liste von Ereignissen, die sich auf eine Person beziehen. Jedes Ereignis besteht aus drei Teilen.
type: Der Typ des Ereignisses. Du kannst die verschiedenen Ereignis-/Faktentypen hier sehen.
date: Das Datum des Ereignisses.
place: Der Ort des Ereignisses.
Ein Fakt vom Typ Geburt füllt die Informationen für Geburtsdatum und Geburtsort aus.
Ein Fakt vom Typ Tod füllt die Informationen für Sterbedatum und Sterbeort aus.
Alle anderen Faktentypen erscheinen in der Biografie in einer Aufzählung im Format Fact: FACT TYPE (FACT DATE) FACT PLACE.
sourceDescriptions
Dies sind die Quellen, die dem Profil hinzugefügt werden sollten.
summary
Dies ist der Text, der im Feld "Change summary" (Zusammenfassung ändern) erscheint. Die Standardmeldung lautet "Imported data from external site" (Daten von externer Seite importiert).
Beispiel
{
- "persons": [{
- "id": "Test123",
- "names": [{
- "nameForms": [{
- "parts": [
- {"type": "http://gedcomx.org/Prefix", "value": "Sir"},
- {"type": "http://gedcomx.org/Given", "value": "Bob"},
- {"type": "http://gedcomx.org/Surname", "value": "Smith"},
- {"type": "http://gedcomx.org/Suffix", "value": "Jr"}
- ]
- "parts": [
- }]
- "nameForms": [{
- }],
- "gender": {
- "type": "http://gedcomx.org/Male"
- },
- "facts": [{
- "type": "http://gedcomx.org/Birth",
- "date": {"original": "21 Feb 1927"},
- "place": {"original": "Dies ist der Geburtsort."}
- },
- {
- "type": "http://gedcomx.org/Death",
- "date": {"original": "10 Mar 2018"},
- "place": {"original": "Dies ist der Sterbeort."}
- },
- {
- "type": "http://gedcomx.org/Burial",
- "date": {"original": "11 Mar 2018"},
- "place": {"original": "Dies ist der Beerdigungsort."}
- }],
- "sources": [{
- "description": "#1"
- }]
- }],
- "sourceDescriptions": [{
- "id": "1",
- "citations": [{
- "value": "Dies ist eine Zitierung."
- }]
- }],
- "summary": "Dies ist die Meldung, die im Feld Änderungsübersicht erscheint."
}
Demonstrations-App & App-Beispiele
Um MergeEdit in Aktion zu sehen, gibt es eine Demo-App hier.
Apps, die MergeEdit verwenden:
- WikiTree X
- Die Fehler-Autokorrektur-Funktion von WikiTree+.
This page was last modified 17:58, 16 October 2022. This page has been accessed 207 times.