Dieses Tutorial führt Sie durch das Hinzufügen von Informationen zu einem ORCID Datensatz, Formatierung von Daten pro ORCID Nachrichtenschema und das Aktualisieren oder Löschen von Daten, die Sie zuvor zu einem hinzugefügt haben ORCID Rekord.
- Holen Sie sich einige Kundenanmeldeinformationen
- Erhalten Sie die Erlaubnis, Datensätze zu aktualisieren
- Artikel hinzufügen
- Artikel aktualisieren
- Elemente löschen
- Mehr Infos
Holen Sie sich einige Kundenanmeldeinformationen
Client-Anmeldeinformationen sind der Benutzername und das Passwort, die Ihre Anwendung/Website für den Zugriff verwendet ORCID API. Jeder kann sich für schreibgeschützte öffentliche API-Anmeldeinformationen registrieren. ORCID Mitglieder können sich für die Mitglieder-API registrieren.
Sie benötigen dafür Mitglieds-API-Anmeldeinformationen Sandbox-Testserver, sowie ein Testprotokoll auf dem ORCID Sandbox, um das Hinzufügen und Aktualisieren von Elementen zu testen ORCID Rekord.
Du kannst dich Fordern Sie Anmeldeinformationen für die Sandbox-Mitglieds-API an um Ihre Anwendung zu erstellen und zu testen. Mit diesen Anmeldeinformationen können Sie Aufrufe an die Sandbox-Premium-Mitglieds-API tätigen, um zu lesen, zu schreiben und zu aktualisieren ORCID Aufzeichnungen. Der Zugriff auf die Sandbox-Testumgebung steht jedem frei zur Verfügung, auch wenn Sie kein Benutzer sind ORCID Mitgliedsorganisation.
Note: Wenn Sie eine verwenden ORCID zertifiziertes Service-Provider-System, das bereits ORCIDmüssen Sie sich nicht für Sandbox-API-Anmeldeinformationen registrieren, es sei denn, Sie möchten die ORCID Integrationsfunktionalität innerhalb der Sandbox-Umgebung.
Mit der Sandbox können Sie Testbenutzerkonten erstellen und Ihre Integration entwickeln, ohne sich Gedanken über die Beeinträchtigung der Live-Daten (Produktion) machen zu müssen. ORCID Registrierung. Die Sandbox verhält sich genauso wie die Produktion ORCID Registrierung bei ein paar Ausnahmen.
Erstellen eines Testkontos
Um das zu testen ORCID API und API-Aufrufe, z. B. das Lesen und Hinzufügen von Informationen zu einem ORCID Um den Datensatz aufzuzeichnen, müssen Sie auch einen Test erstellen ORCID Aufnahme in die Sandbox. Dies kann über die Benutzeroberfläche erfolgen, ähnlich wie in der Produktion ORCID Registrierung. Gehe zu https://sandbox.orcid.org/register und registrieren Sie sich für ein Konto.
Mailinator-E-Mail-Adressen
Der Sandbox-Server sendet E-Mails nur an Mailinator (@mailinator.com) E-Mail-Adressen, um Mailserver nicht unbeabsichtigt zu spammen. Sie erhalten keine Verifizierungs-E-Mail oder Benachrichtigung zum Zurücksetzen des Passworts, es sei denn, Sie verwenden eine @mailinator.com-Adresse und eine Verifizierung ist erforderlich, um manuelle Änderungen an Sandbox-Datensätzen vorzunehmen. Erfahren Sie mehr über die kostenlosen öffentlichen Posteingänge . Wenn Sie a nicht verwenden möchten Mailinator Bitte notieren Sie sich dann Ihren Benutzernamen und Ihr Passwort (da Sie diese beim Testen zur Autorisierung Ihrer Anwendung verwenden) und kontaktieren Sie uns, um Unterstützung bei der Verifizierung anzufordern.
Mailinator ist ein E-Mail-Dienst, der über einen öffentlichen kostenlosen Dienst und einen privaten kostenpflichtigen Dienst verfügt. Zum Testen können Sie den völlig kostenlosen öffentlichen Dienst nutzen. Erfahren Sie mehr über ihre Stufen Hier .
Mailinator ist ein Drittanbieterdienst, der nicht von verwaltet oder gewartet wird ORCID. Wir empfehlen Ihnen, die Funktionsweise dieses Dienstes und seine Einschränkungen zu prüfen, bevor Sie diese Adressen verwenden.
Erhalten Sie die Erlaubnis, Datensätze zu aktualisieren
Um Informationen zu einem hinzuzufügen oder zu aktualisieren ORCID Um einen Datensatz zu erstellen, müssen Sie zunächst die Erlaubnis des Eigentümers des Datensatzes einholen. Nur ORCID Mitglieder können Aktualisierungsberechtigungen anfordern. Dies geschieht durch Anfordern des „/Aktivitäten/Update"Und / oder"/person/update„Bereiche, die OAuth verwenden.
Es gibt zwei unterschiedliche Aktualisierungsbereiche – einen für biografische Details und einen für Aktivitäten.
Geltungsbereich | Beschreibung | API-Endpunkte |
/person/update | Biografische Daten – die linke Spalte des ORCID Benutzeroberfläche aufzeichnen. | /Adresse /externe-Identifikatoren /Schlüsselwörter /andere Namen /researcher-urls |
/Aktivitäten/Update | Forschungsaktivitätsdaten – die rechte Spalte des ORCID Benutzeroberfläche aufzeichnen. | /Unterscheidung /Unterscheidungen /Bildung /Bildungen /Anstellung /Beschäftigungen /Finanzierung /Finanzierungen /eingeladene-position /eingeladene-positionen /Mitgliedschaft /Mitgliedschaften /peer-review /peer-reviews /Qualifikation /Qualifikationen / Forschungsressource / Forschungsressourcen /Bedienung /Dienstleistungen /Arbeit /funktioniert |
ORCID Integrationen verwenden „3-beiniges OAuth“, um Benutzer zu authentifizieren und die Erlaubnis zur Interaktion mit ihren Datensätzen anzufordern. Jede Integration kann mithilfe der öffentlichen API Leseberechtigungen anfordern. ORCID Mitglieder können die Mitglieder-API verwenden, um Aktualisierungsberechtigungen anzufordern. Es funktioniert so:
- Sie erstellen einen speziellen Link
- Beim Anklicken wird der Benutzer weitergeleitet ORCID
- ORCID fordert den Benutzer auf, sich anzumelden
- ORCID fordert den Benutzer auf, Ihrer Anwendung die Erlaubnis zu erteilen
- ORCID sendet den Benutzer mit einem Autorisierungscode an Ihr System zurück
- Ihr System tauscht diesen Code gegen ein Zugriffstoken aus
Die benutzerdefinierte Autorisierungs-URL enthält Ihre Kundeninformationen sowie die „Bereiche“, die die spezifischen Bereiche ihres Datensatzes angeben, auf die Sie zugreifen möchten. Nach der Anmeldung autorisiert der Benutzer die Verbindung mit Ihrem System und wird zusammen mit einem Autorisierungscode zu Ihrer Zielseite zurückgeleitet. Dieser Code wird dann verwendet, um ihre zu erhalten ORCID iD zusammen mit einem Zugriffstoken, das für die angeforderten Bereiche gültig ist.
Sie erstellen Ihren Autorisierungslink, indem Sie die Client-ID Ihrer API-Anmeldeinformationen und die zugehörige Zielseite (Umleitungs-URI) angeben. Sie wählen aus, welche Berechtigungen angefordert werden sollen, indem Sie der Scope-Parameter.
Im folgenden Beispiel wird die Erlaubnis zum Lesen von Daten mit eingeschränktem Zugriff angefordert ORCID Sandbox-Testserver. In der realen Welt zeigen Sie diesen Link auf Ihrer Website an oder fügen ihn in eine E-Mail ein, wenn Sie den Benutzer zur Authentifizierung und Autorisierung auffordern. Zu Testzwecken können Sie es jedoch einfach in Ihren Webbrowser einfügen. Ersetzen Sie die Daten in Klammern durch Ihre Kundeninformationen und entfernen Sie unbedingt die eckigen Klammern!
https://sandbox.orcid.org/oauth/authorize?client_id=[Your client ID]&response_type=code&scope=/read-limited&redirect_uri=[Your landing page]
Sobald der Benutzer auf den Link geklickt hat, hat er sich angemeldet ORCID und erteilten Berechtigungen werden sie auf Ihre Website zurückgeleitet, wie folgt:
https://[Your landing page]?code=Q70Y3A
Sie sollten den Autorisierungscode umgehend gegen den austauschen ORCID iD und Zugriffstoken. Der Autorisierungscode verfällt bei Verwendung. Die Anfrage sieht so aus und kann nicht in einem Webbrowser erstellt werden, es muss von Ihrem Server erstellt werden.
URL=https://sandbox.orcid.org/oauth/token
HEADER: Accept: application/json
HEADER: Content-Type: application/x-www-form-urlencoded
METHOD: POST
DATA:
client_id=[Your client ID]
client_secret=[Your client secret]
grant_type=authorization_code
code=Six-digit code
redirect_uri=[Your landing page]
ORCID wird dann die Authentifizierung des Forschers zurücksenden ORCID iD und ein Zugriffstoken im JSON-Format:
{"access_token":"f5af9f51-07e6-4332-8f1a-c0c11c1e3728","token_type":"bearer",
"refresh_token":"f725f747-3a65-49f6-a231-3e8944ce464d","expires_in":631138518,
"scope":"/read-limited","name":"Sofia Garcia","orcid":"0000-0001-2345-6789"}
Zugriffstoken haben standardmäßig eine lange Lebensdauer und verfallen 20 Jahre nach der Ausstellung. Der Token kann mehrfach verwendet werden, bevor er abläuft.
Verwenden Sie das Zugriffstoken
Dreibeinige Zugriffstoken sind mit bestimmten verknüpft ORCID aufzeichnen. Um sie zu verwenden, fügen Sie sie in API-Anfragen ein, die Sie zum Lesen oder Aktualisieren dieses Datensatzes stellen.
Wenn Sie um Erlaubnis zur Interaktion mit einem bitten ORCID Im Datensatz des Benutzers geben Sie einen oder mehrere „Bereiche“ an. In jedem Bereich können Sie bestimmte Dinge tun, z. B. den Datensatz lesen oder einen bestimmten Abschnitt aktualisieren.
Dreibeinig bezieht sich auf die drei Akteure, die an der Einholung der Erlaubnis eines Benutzers beteiligt sind; ORCID, Ihr System und der Benutzer selbst.
/authentifizieren
Dieser Bereich wird zum Sammeln der verwendet ORCID iD und lesen Sie öffentliche Informationen nur in der Akte. Alle anderen dreibeinigen Bereiche umfassen die Authentifizierungsberechtigung, sodass dieser Bereich weggelassen werden kann, wenn Sie einen anderen Zugriff anfordern. Dieser Bereich ist in der Member- oder Public-API verfügbar.
/read-limited (nur Mitglieder-API)
Dieser Bereich wird verwendet, um Zugriff zum Lesen öffentlicher und eingeschränkt sichtbarer Elemente auf einem zu erhalten ORCID aufzeichnen. Dieser Bereich ist nur auf der Member-API verfügbar.
/activities/update (nur Mitglieder-API)
Dieser Bereich wird zum Schreiben, Aktualisieren und Löschen von Einträgen in den Abschnitten Zugehörigkeit, Finanzierung, Werke, berufliche Aktivitäten, Forschungsressourcen und Peer-Review eines ORCID aufzeichnen. Dieser Bereich ist nur auf der Member-API verfügbar.
/person/update (nur Mitglieder-API)
Dieser Bereich wird zum Schreiben, Aktualisieren und Löschen von Elementen in den Abschnitten „Andere Namen“, „Schlüsselwörter“, „Länder“, „Forscher-URLs“, „Websites“ und „Persönliche externe Identifikatoren“ des Datensatzes verwendet. Dieser Bereich ist nur auf der Member-API verfügbar.
openid
Dieser Bereich wird von OpenID-Integratoren verwendet, wenn ein id_token erforderlich ist. Wenn der openid-Bereich enthalten ist, gibt die Registry ein id_token in der Token-Antwort zurück und erteilt dem Client die Berechtigung, auf den Benutzerinformationsendpunkt für diesen Benutzer zuzugreifen. Dieser Bereich ist in der öffentlichen und Mitglieder-API verfügbar.
Bitte beachten Sie, dass der Bereich „openid“ nicht wie der andere mit einem „/“ beginnt ORCID API-Bereiche. Dies liegt daran, dass der Bereich „openid“ nicht durch definiert ist ORCID, sondern durch die OpenID Connect-Spezifikation definiert. Bitte sehen Sie sich unsere an OpenID-Dokumentation um mehr zu erfahren.
Mehrere Bereiche
In einer einzigen Interaktion können mehrere Bereiche angefordert werden, indem die Bereiche in der Authentifizierungs-URL mit einem codierten Leerzeichen dazwischen aufgelistet werden, z. B. „scope=/read-limited%20/activities/update%20/person/update“.
Vollständiger Zugriff
Wenn Sie vollen Zugriff zum Lesen und Bearbeiten eines Datensatzes wünschen, schließen Sie drei Bereiche in Ihre Authentifizierungs-URL ein: /read-limited, /activities/update und /person/update. In der URL würden sie als „scope=/read-limited%20/activities/update%20/person/update“ erscheinen
Zweibeinige Bereiche (Client-Anmeldeinformationen).
Für einige Aktivitäten müssen Sie den Benutzer nicht um Erlaubnis bitten. Zweibeinige OAuth-Bereiche werden direkt vom angefordert ORCID API und erfordern keine Erlaubnis des Forschers. Token mit diesen Gültigkeitsbereichen sind 20 Jahre lang gültig und können wiederverwendet werden
/read-public
Dieser Bereich wird verwendet, um öffentliche Informationen zu einem einzelnen zu lesen ORCID iD,Suche nach ORCID Datensätze oder zum Lesen von Übersichtsinformationen (nur Mitglieds-API). Dieser Bereich ist für die Mitglieds- oder öffentliche API verfügbar.
/ Webhook
Dieser Bereich ermöglicht es einer Clientanwendung, einen Webhook auf einem zu registrieren ORCID Datensatz, um Benachrichtigungen zu erhalten, wenn ein Datensatz aktualisiert wird. Dieser Umfang steht Premium zur Verfügung ORCID nur für Mitglieder.
Artikel hinzufügen
Elemente (Arbeiten, Beschäftigung, Finanzierung, Peer-Review usw.) können zu einem hinzugefügt werden ORCID Aufnahme mit dem ORCID Mitglieds-API. Sie werden mit Ihrem Kundennamen als „Quelle“ des Artikels angezeigt.
Elemente (Arbeiten, Beschäftigung, Finanzierung, Peer-Review usw.) können zu einem hinzugefügt werden ORCID Aufnahme mit dem ORCID Mitglieds-API. Dazu müssen Sie zunächst Holen Sie mithilfe von OAuth die Erlaubnis des Forschers ein und dem Formatieren Sie die Elementmetadaten Verwendung der ORCID Nachrichtenschema.
Sobald Sie die Daten formatiert und gesammelt haben ORCID iD und Zugriffstoken erstellen Sie eine API-Anfrage mit HTTP POST und geben dabei an relevanten Endpunkt.
Method: POST
Content-type: application/vnd.orcid+xml or application/vnd.orcid+json
Authorization type and Access token: Bearer [stored access token]data: link to file or text of single employment item to add
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/employment
Der folgende Aufruf fügt eine neue hinzu Beschäftigung Zugehörigkeit zu einem Datensatz auf dem Sandbox-Testserver:
<?xml version="1.0" encoding="UTF-8"?>
<employment:employment [...]>
[...]
</employment:employment>
Die API gibt eine 201-Nachricht zurück, um anzuzeigen, dass der Artikel zusammen mit dem Artikel korrekt gepostet wurde Code eingeben. Ihr Kunde wird als aufgeführt Quelle des Artikels.
Schauen Sie sich unsere Fehlersuche Seite, wenn eine andere Nachricht zurückgegeben wird. Sie müssen das speichern Speichern Sie den Put-Code und das Zugriffstoken um Aktualisierungen vorzunehmen oder das Element zu entfernen.
An ORCID Der Datensatz kann Informationen über die Arbeit, Zugehörigkeiten, Finanzierung, Peer-Review und mehr eines Forschers enthalten.
Artikel an ORCID Datensätze können unterteilt werden in Behauptungen die verbinden die ORCID iD-Inhaber mit einer Tätigkeit oder Zugehörigkeit. Diese Behauptungen können zu einer hinzugefügt werden ORCID Aufzeichnung durch den Forscher, der Eigentümer der Aufzeichnung ist, oder durch Systeme, denen der Forscher die Erlaubnis dazu erteilt hat. Wir nennen die Entität, die eine Behauptung zu einem hinzugefügt hat ORCID Nehmen Sie die auf Quelle.
Beispiele
Gemäß unseren Grundsätzen der Transparenz und Offenheit halten wir es für wichtig, die Quelle der Behauptung sehen zu können – wer diese Informationen in die Akte einfügt. So machen wir das:
- Wenn ein Forscher (oder sein Beauftragter vertrauenswürdige Person) fügt ihrem Datensatz eine Behauptung hinzu, ORCID zeichnet diese Person automatisch als Quelle auf
- Wenn ein vom Forscher genehmigtes System eine Behauptung zu einem Datensatz hinzufügt, ORCID erfasst automatisch den Anlageneigentümer (an ORCID Mitglied) als Quelle.
Wir zeigen den Quellnamen in der Benutzeroberfläche an und stellen ihn (mit seiner eindeutigen Kennung) in der API zur Verfügung:
Arbeitsabläufe bei der Recherche von Informationen können jedoch komplizierter sein, und die wahre Quelle einer Behauptung kann unbeabsichtigt verschleiert werden, indem ein System ein Element im Namen einer Person oder ein anderes System hinzufügt. Um Transparenz zu gewährleisten, müssen wir unterscheiden, wer die Verbindung zwischen der Person und dem Element hergestellt hat und wer das Element zum Datensatz hinzugefügt hat. Wie oben: Wer auch immer das Element hinzufügt ORCID Rekord ist der Quelle; wer auch immer die Verbindung zwischen den herstellt ORCID iD und der Artikel ist der Ursprung der Behauptung.
Beispielsweise:
- Ein Forscher importiert Daten in sein ORCID Datensatz aus einem System, z. B. einem Such- und Verknüpfungsassistenten. Der Forscher stellt die Behauptung auf, sie zu verbinden iD mit dem Artikel, also sind sie das Ursprung der Behauptung; während das System die Entität ist, die die Behauptung zum hinzufügt ORCID Rekord – der Quelle
- Ein Forscher interagiert mit System A (dem Behauptung origin), das zur Aktualisierung die von System B bereitgestellten Dienste nutzt ORCID Aufzeichnungen, was System B zum macht Quelle
Wir ermutigen unsere Community, Schritte zu unternehmen, um Informationen über den Ursprung der Behauptung zu bewahren und weiterzugeben, damit jeder von der Einsicht in die Quelle profitieren kann.
Weitere Informationen finden Sie unter:
Artikel aktualisieren
Es empfiehlt sich, die von Ihnen hinzugefügten Informationen aufzubewahren ORCID Aufzeichnungen auf dem neuesten Stand. Beispielsweise das Hinzufügen von Enddaten zu Beschäftigungsverhältnissen, wenn Mitarbeiter ausscheiden, oder das Hinzufügen der Kennungen veröffentlichter Artikel zu Datensätzen.
ORCID Mitglieder können Informationen aktualisieren, die sie zuvor zu einem hinzugefügt haben ORCID aufzeichnen. Es kann jeweils nur ein Element aktualisiert werden, und zwar nur mit den Client-Anmeldeinformationen, mit denen es ursprünglich erstellt wurde.
Um die Aktualisierung zu erleichtern, stellen Sie sicher, dass Sie Speichern Sie den Put-Code und das Zugriffstoken beim Erstellen von Artikeln.
Formatieren Sie das aktualisierte Element in ORCID Nachrichtenschema mit den geänderten Informationen und schließen die gespeicherten ein Code eingeben.
<?xml version="1.0" encoding="UTF-8"?> <employment:employment put-code="739288" [...]> [...] </employment:employment>
Rufen Sie die API auf:
Method: PUT Content-type: application/vnd.orcid+xml or application/vnd.orcid+jsonnAuthorization type and Access token: Bearer [stored access token]Data: link to file or text of affiliation to update URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/employment/739288
Die API gibt eine 200 OK-Meldung zurück, um anzuzeigen, dass das Element korrekt aktualisiert wurde. Schauen Sie auf unserer Fehlerbehebungsseite nach, wenn eine andere Meldung zurückgegeben wird.
Alle Artikel (außer dem Biografietext) auf einem ORCID Rekord haben eine Code eingeben:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<record:record path="/0000-0001-2345-6789" xmlns:internal="https://www.orcid.org/ns/internal" [...]>
<funding:funding-summary put-code="4413" path="/0000-0001-2345-6789/funding/4413" visibility="public" display-index="0"> [...]
</record:record>
Mit diesem Put-Code kann die API aufgerufen werden, um die vollständigen Daten für einen Artikel abzurufen. Die folgenden Elemente können mit a abgefragt werden Code eingeben:
Endpunkt | Beschreibung |
/address/[Code eingeben] | Ein einzelnes Land oder eine einzelne Region |
/Biografie | Das Biografiefeld: ein freier Textbereich, der nur vom Forscher bearbeitet werden kann |
/education/[Code eingeben] | Ein individuelles Bildungszugehörigkeitselement |
/email/[Code eingeben] | Eine individuelle E-Mail-Adresse, die dem Datensatz zugeordnet ist |
/employment/[Code eingeben] | Ein individuelles Beschäftigungszugehörigkeitselement |
/external-identifier/[Code eingeben] | Eine einzelne verknüpfte externe Kennung in einem anderen System |
/funding/[Put-Code] | Eine individuelle Fördermaßnahme |
/keywords/[Code eingeben] | Ein individuelles Schlüsselwort, das sich auf den Forscher und seine Arbeit bezieht |
/andere-namen/[Code eingeben] | Ein individueller Zusatzname, unter dem der Forscher bekannt ist |
/peer-review/[Code eingeben] | Eine individuelle Peer-Review-Aktivität |
/researcher-urls/[Code eingeben] | Ein individueller externer Link zur persönlichen Seite oder Profilseite des Forschers |
/work/[Code eingeben] | Eine individuelle Forschungsarbeit |
/works/[Put-Code1],[Put-Code2],[Put-Code3] | Einzelne Forschungsarbeiten in großen Mengen (bis zu 100) |
Mithilfe des Abschnittsendpunkts und des Put-Codes können Sie die API mit demselben Zugriffstoken aufrufen, um dieses bestimmte Element vollständig abzurufen. Dieser Beispielaufruf ruft den vollständigen Finanzierungsartikel 4413 im XML-Format mithilfe der Mitglieds-API auf dem Sandbox-Server ab.
Method: GET Accept: application/vnd.orcid+xml Authorization type and Access token: Bearer [stored access token]URI: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/funding/4413
Die API gibt eine 200 OK-Nachricht zurück, um anzugeben, dass die Nachricht erfolgreich empfangen wurde, und gibt den vollständigen XML-Code des Finanzierungselements zurück:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<funding:funding put-code="4413" path="/0000-0002-9227-8514/funding/4413" visibility="public" [...] >
[...]
</funding:funding>
Sie können das überprüfen Quelle eines Artikels wenn Sie es lesen möchten, wenn Sie wissen möchten, wer es hinzugefügt hat.
Elemente löschen
Möglicherweise möchten Sie Elemente löschen, die Sie zuvor hinzugefügt haben, beispielsweise wenn sie fälschlicherweise hinzugefügt wurden oder durch andere Elemente ersetzt wurden.
Wenn Sie Daten hinzugefügt haben, die gelöscht werden müssen, z. B. wenn diese mit einem Unrecht verknüpft wurden ORCID iD, dann können Sie eine HTTP-DELETE-Anfrage unter Angabe der stellen relevanten Endpunkt, zusammen mit ORCID Ich würde, gespeicherter Zugriffstoken und gespeicherter Put-Code. Es kann jeweils nur ein Element gelöscht werden, und Sie können nur von Ihrem Kunden hinzugefügte Elemente löschen. Sie können Elemente auch dann löschen, wenn der Benutzer die Berechtigung widerrufen hat.
Dieser Beispielaufruf löscht das Beschäftigungselement mit dem Put-Code „739288“ aus einem Datensatz.
Method: DELETE
Content-type: application/vnd.orcid+xml or application/vnd.orcid+json
Authorization type and Access token: Bearer [stored access token]
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/employment/739288
Mehr Infos
Persistente Identifikatoren
Die meisten Artikel innerhalb eines ORCID Der Datensatz verfügt über einen oder mehrere dauerhafte Identifikatoren. Es gibt sie in zwei „Geschmacksrichtungen“, Arbeitskennungen und Organisationskennungen.
Bitte beachten Sie unsere Liste der unterstützten Bezeichner für die V3.0-API. Auf Wunsch fügen wir gelegentlich neue Typen hinzu ORCID Mitglieder, die sie beim Hinzufügen von Elementen zur Registrierung verwenden möchten.
ORCID unterstützt die Verwendung von ROR-Kennungen, GRID-Bezeichner und dem Crossref-Förderregister Identifikatoren zur eindeutigen Unterscheidung von Organisationen ORCID Records.
Für weitere Informationen, siehe Arbeiten mit Organisationskennungen
Obwohl Ringgold-Identifikatoren immer noch innerhalb der existieren ORCID Register, ab 1. August 2023, ORCID erhält keine Aktualisierungen der von unserem Register verwendeten RINGGOLD-Organisationsidentifikationsdatenbank mehr und wir können auch nach diesem Datum erstellte RINGGOLD-IDs nicht mehr verarbeiten oder nutzen. Sehen Sie sich unsere an FAQ für weitere Infos
Gruppierung
Elemente werden in Gruppen zusammengefasst ORCID Datensätze anhand ihrer Kennungen. Möglicherweise stellen Sie fest, dass von Ihnen hinzugefügte Elemente zu einer vorhandenen Gruppe hinzugefügt werden.
Funktioniert ORCID werden auf der Grundlage ihrer Identifikatoren und der Beziehung dieser Identifikatoren zum Werk gruppiert. Es gibt vier Arten von Beziehungen:
- Selbst: Die Kennung bezieht sich ausschließlich auf dieses Werk und kann mit anderen Werken gruppiert werden, die dieselbe Kennung haben
- Ein Teil: Das Werk ist Teil dieser Kennung und kann nicht mit anderen Werken gruppiert werden
- Version von: Diese Identifikatoren gelten für alternative Versionen des Werks und können mit Selbst- und Versions-Identifikatoren gruppiert werden
- Gefördert durch: Diese Kennungen gelten für die Finanzierung der Arbeit. Diese Kennungen werden nicht zur Gruppierung von Werken verwendet.
Unsere API bietet hierfür Unterstützung im XSD. Jedes Element hat ein Anzeigeindexattribut, das seinen Rang innerhalb seiner Gruppe angibt. Der höchste Anzeigeindex ist das vom Forscher ausgewählte bevorzugte Element. Über die API hinzugefügte Elemente, die vom Forscher nicht bewertet wurden, haben einen Anzeigeindex von 1 und werden als standardmäßig bevorzugte Quelle innerhalb der Gruppe verwendet, bis sie vom Forscher geändert werden. Der Anzeigeindex bestimmt auch die Arbeitsreihenfolge beim Lesen der ORCID Datensatz mit der API.
Weitere Informationen zur Gruppierung finden Sie unter ORCID Aufzeichnungen finden Sie in unserer Unterstützungsartikel.
Sichtbarkeit
Forscherkontrolle von ORCID Records ist einer von ORCID'Ergebnis Grundsätze. Elemente werden hinzugefügt ORCID Datensätze mit der standardmäßigen Sichtbarkeitseinstellung der Forscher.
Die Sichtbarkeit gibt die Datenschutzeinstellung des Elements an, basierend auf der vom Benutzer festgelegten Sichtbarkeitseinstellung. Wenn bei der Veröffentlichung von Informationen über die API ein Sichtbarkeits-Tag enthalten ist, wird es ignoriert. Vielmehr werden die Informationen gemäß der standardmäßigen Sichtbarkeitseinstellung des Benutzers veröffentlicht, die in seinen Kontoeinstellungen festgelegt ist.
Öffentliche Elemente können von jedem über die API gelesen werden und werden im öffentlichen Datensatz des Forschers angezeigt. Elemente vertrauenswürdiger Parteien werden nur über die API an Clients zurückgegeben, die über eingeschränkten Lesezugriff verfügen. sie sind nicht in den öffentlichen Aufzeichnungen des Forschers enthalten. Private Elemente sind nur für den Forscher und die Quelle des Elements sichtbar – die einzigen privaten Elemente, die über die API zurückgegeben werden, sind diejenigen, die über Ihre Integration zum Datensatz hinzugefügt wurden Weitere Informationen zu Sichtbarkeitseinstellungen finden Sie im ORCID Registratur.
Benutzerbenachrichtigungen
wenn ein ORCID Mitglied fügt einem Datensatz ein Element hinzu oder aktualisiert es, ORCID informiert den Benutzer darüber, dass dies geschehen ist.
Sie erhalten eine Benachrichtigung in ihrem ORCID Posteingang. Immer wenn sich die Daten ändern ORCID Datensatz erhält der Benutzer eine Benachrichtigung mit grundlegenden Informationen über die Änderung, einschließlich des Namens des Clients, der die Aktualisierung durchführt, des Änderungsdatums und des Elements im ORCID Datensatz, der aktualisiert wurde. Sehen Sie sich unsere an Weitere Informationen zu Benachrichtigungen finden Sie in der Benutzer-Wissensdatenbank.
ORCID Datensätze auf der Sandbox haben auch funktionierende Posteingänge. Wir empfehlen Ihnen, die Posteingänge Ihrer Tests regelmäßig durchzusehen ORCID Aufzeichnungen, wenn Sie planen, wie Ihre Systeme Datenaktualisierungen planen.