diff --git a/docs/datasheet-faq.rst b/docs/datasheet-faq.rst index 84a06eabfa0512d4fc17ea0acfdf8dceec035ed1..4158e22fc37e6b4a665b76eda0c11859a67d1650 100644 --- a/docs/datasheet-faq.rst +++ b/docs/datasheet-faq.rst @@ -11,7 +11,7 @@ Datasheet Editor FAQ .. topic:: Why can Geolocation Completion not find the places I added to the table? - The names of places have to be added to the “Address†column and capitalized to be found via Geolocation Completion. If these two steps are followed and the location is still missing, its name might not be registered in Getty. + The names of places have to be added to the “Address†column and capitalized to be found via Geolocation Completion. If these two steps are followed and the location is still missing, its name might not be registered in the Getty Thesaurus of Geographic Names (TGN), which is the default geocoder to be used. Please try out one of the other available geocoders, OSM or GeoNames, in the the drop-down menu at “Place selection“. .. topic:: Why is my Datasheet Editor data displayed incompletely in Geo-Browser? @@ -19,9 +19,9 @@ Datasheet Editor FAQ Some HTML-Symbols like “&†confuse the Geo-Browser. Please check your entries for special characters and replace “&†with “&†for example. For more information you can visit `Bug #14359 <https://projects.gwdg.de/issues/14359>`__ in our Geo-Browser-Bugtracker. -.. topic:: Is it possible to only add coordinates to certain places by using the set all places named-button? +.. topic:: Is it possible to only add coordinates to certain places by using the “Set“ button? - No unfortunately not. This feature is planned for an upcoming version (please refer to `Feature #15318 <https://projects.gwdg.de/issues/15318>`__). In the meantime you can temporarily change the names of places, you plan the same coordinates for, and then set their coordinates. If you entered “Berlin†multiple times and want to change the coordinates for some of them, you can either change them into a different place or change their name slightly, so that they are not recognized as Berlin. After that you can return to the original name. This process has to be repeated every time you edit the names. + Yes, this feature is now available. For example, if you entered “Berlin†multiple times and want to change the coordinates for only some of them, you can select the respective rows or cells by left-clicking and holding the left mouse button until they are highlighted blue. Please make sure that the “Address†fields are part of your selection, not just the Latitude/Longitude/GettyID fields. The easiest option is to select entire rows by left-clicking on the gray row index area (1,2,...) and extending or reducing the selection by dragging up and down. By both left-clicking and pressing CRTL on your keyboard, single rows can be added to the selection. If you then use the “Set“ button (or start the entire “Geolocation completion“ process), only the values within your selection will be considered for geolocation. .. topic:: The automatically generated geographic data by Getty ID is partially incorrect. Why do some places appear to be up to 40 km removed from their origin, making them unusable for further examination? diff --git a/docs/datasheet.rst b/docs/datasheet.rst index b0a10b99dc901b3cb8e59d038409e22af5492dce..64746fb61a313c988bb25e896e044be57554759c 100644 --- a/docs/datasheet.rst +++ b/docs/datasheet.rst @@ -60,9 +60,11 @@ If completed, you can **View your dataset** by opening it with the Geo-Browser. Create or import your data ^^^^^^^^^^^^^^^^^^^^^^^^^^ -The first option after calling the website is to either create a new datasheet or to import an existing datasheet. By clicking “Create a new datasheetâ€, a new document is generated. By clicking “Durchsuchen...†(German) or “Browse...“ (English), a CSV file from the local storage can be loaded into the datasheet. +The first option after calling the website is to either create a new datasheet or to import an existing datasheet. By clicking “Create a new datasheetâ€, a new document is generated. By clicking “Import local CSV or KML file“ a CSV or KML file from the local storage can be loaded into the datasheet. -After clicking on “Create a new datasheet“ or “Durchsuchen...“ / “Browse...“, you will be redirected to the DARIAH-DE log-in, the DARIAH AAI (Authentication & Authorization Infrastructure). +KML files must comply with the `specification <https://geobrowser.de.dariah.eu/doc/_downloads/M3.3.2_eConnect_KML_Specification_v1.0_UGOE.pdf>`__ in order to be processed correctly. Hence, KML files with no “Placemark“ tag cannot be imported! Once the KML file was read without errors, it is transformed to CSV format and also stored as such. As a CSV file, it can be enhanced by additional content such as further columns. + +After clicking on “Create new datasheet“ or “Durchsuchen...“ / “Browse...“, you will be redirected to the DARIAH-DE log-in, the DARIAH AAI (Authentication & Authorization Infrastructure). Here, you have to log in with your DARIAH account or any other eduGAIN federation account. @@ -115,38 +117,41 @@ After logging in, a green window with the title “New datasheet created!†ope Fig. 5: New datasheet created -By right-clicking on a cell in the datasheet, a row above (“Insert row aboveâ€) or below (“Insert row belowâ€) can be inserted. Rows can be removed via “Remove row†and columns via “Remove columnâ€. Columns can be inserted as well either to the left (“Insert column on the leftâ€) or right (“Insert column on the rightâ€). Thus it is possible to create new categories in the datasheet if additional information on the locations is to be saved. Categories can also be altered in the Datasheet Editor. +By right-clicking on a cell in the datasheet, a row above (“Insert row aboveâ€) or below (“Insert row belowâ€) can be inserted. Rows can be removed via “Remove row†and columns via “Remove columnâ€. Columns can be inserted as well either to the left (“Insert column leftâ€) or right (“Insert column rightâ€) in order to add further information about locations in the datasheet. .. figure:: datasheet-screenshots/6-insert-column.png :align: center Fig. 6: Insert new column +By clicking on a cell, it gets highlighted in blue and is considered as selected. You can extend the selection by holding the left mouse button. Right-click to open the context menu and select an action for the selected cells. Alternatively, you can use a keyboard shortcut, e.g. CRTL+C for copying or DEL for deleting the contents of selected cells. Moreover, cell selection can be used to specify which addresses should be geocoded (see below). + +If no cells are selected (highlighted in blue), the entire datasheet is considered as selected by default. You can clear a selection by either clicking on the button “Clear selection“ or by left-clicking on the white area outside the datasheet. Find the coordinates for the places in your datasheet ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -To enter a location directly into the Datasheet Editor, the longitude and latitude must be known to display the place in the Geo-Browser. If these data are not already known, the tools on the website “Add geocoordinates“, “Place selection“ and “Map selection“ can be used to find them. By clicking “Geolocation completion“ in the “Add geocoordinates“ box, the fields “Longitude“, “Latitude“ and “GettyID“ are added automatically for all locations listed in the “Address“ field of the datasheet. These locations will also be listed in the “Place selection“ box. +For locations entered into the Datasheet Editor, longitude and latitude must be specified in order to display them in the Geo-Browser. If these coordinates are not known, the tool „Geolocation completion“ and its refinement options “Place Selection“, “Map selection“ and “Map search“ can be used to find them. By clicking “Geolocation completion“ in the “Add geocoordinates“ box, the fields “Longitude“, “Latitude“ and “GettyID“ are added automatically for all (or all selected) locations listed in the “Address“ field of the datasheet. These automatically processed locations will also be listed in the “Place selection“ box. .. figure:: datasheet-screenshots/7-geolocation-completion.png :align: center Fig. 7: Using geolocation completion +By default, The Getty Thesaurus of Geographic Names (TGN) is used for finding coordinates for addresses (“geocoding“). With TGN, smaller locations are not always found. As alternatives, the drop-down menu in the “Place selection“ box offers two other geocoders: GeoNames and Nominatim by OpenStreetMap (OSM). OSM often finds smaller locations not available in the TGN, and also streets and house numbers. -The Getty Thesaurus of Geographic Names (TGN) is used for searching locations. With TGN larger locations are found, smaller locations are not always found. If the location is not the desired one, in the “Place selection“ box you can click on the arrow next to the location name to open a drop-down menu with a list of other locations with the same name (if existing). After choosing the correct location from this list, you can click “Set“ right to the drop-down menu to fill in the corresponding fields “Longitude“, “Latitude“ and “GettyID“ in the datasheet. +When using TGN, you further have the choice between geocoding based on the “Address“ column, or based on the “GettyID“ column. The default is “Address“. OSM and GeoNames can only be based on “Address“. -To find places and coordinates for “Place selection“ the method “exact-match“ of the `DARIAH-DE Normdata Services <https://wiki.de.dariah.eu/display/publicde/DARIAH-DE+Normdatendienste#DARIAH-DENormdatendienste-ThesaurusofGographicalNames(Getty)>`_ is being used, that accesses the Thesaurus of Geographical Names (Getty). If more than one entry is being found, the coordinates of the first match are put into the table. To choose another set of coordinates, you can do so by choosing another place and then click on the “Set“ button on the right. Please note, that only the coordinates of the chosen place for „Address“ are changes, and not the content of the „Address“ field itself! +If the automatically retrieved location is not the desired one, you can click on the arrow next to the location name in the “Place selection“ box to open a drop-down menu with a list of other locations with the same name (if available). For example, when geocoding with TGN, the method “exact-match“ of the `DARIAH-DE Normdata Services <https://wiki.de.dariah.eu/display/publicde/DARIAH-DE+Normdatendienste#DARIAH-DENormdatendienste-ThesaurusofGographicalNames(Getty)>`_ queries the Thesaurus of Geographical Names and adds the coordinates of the first match to the table. Existing entries will not be overwritten automatically. If additional matches are available, they are added to the drop-down list. After choosing the correct location from this list, you can click “Set“ on the right of the drop-down menu to complete the corresponding fields “Longitude“, “Latitude“ and (when using TGN based on “Address“) “GettyID“ in the datasheet. By clicking “Set“, existing coordinates will be overwritten. Please note that the content of the „Address“ field itself will not be changed - except in the case of using TGN based on GettyID. Here, “Address“ fields will be completed automatically in case they are empty and as long as valid GettyIDs are given. -If the desired location is not listed in the drop-down menu, you can click on the “Map“ field next to it. By this, the location will be entered in the “Map selection“ box, both above and below the world map. Below the world map you can find the search options TGN, OpenStreetMap (OSM) and GeoNames. OSM often also finds smaller locations, which TGN does not find. With OSM it is also possible to find streets and street numbers. By clicking the “Set“ field above the world map, the fields “Longitude“ and “Latitude“ will be updated in the datasheet for the corresponding location. Caution: the location entered in the text field above the world map has to be spelled in the same way as the location in the “Address“ field of the datasheet! +If the desired location is not listed in the drop-down menu, you can click on the “Map“ field next to it. By this, the location will be entered in the “Map selection“ box, both above and below the world map. Below the world map you have the option of searching TGN, OpenStreetMap (OSM) or GeoNames for the address. By clicking the “Set“ field above the world map, the datasheet fields “Longitude“ and “Latitude“ will be updated for the corresponding location. Existing values will be overwritten. If you have multiple locations with the same address in the “Address“ column and want to update only some of them, select them in the table first. Caution: the address entered in the text field next to “Set“ has to be spelled in the same way as the term in the “Address“ field of the datasheet! .. figure:: datasheet-screenshots/8-manual-search.png :align: center Fig. 8: Manual place and map selection - -Another option is to drag the flag in the “Map selection“ box with the mouse, hereby the longitude and latitude can be determined with more precision. By zooming into the map, it’s possible to see streets more precisely. You can also search “manually“ for the places in the datasheet within the “Map selection“ box. But by searching locations via OSM or GeoNames in the “Map selection“ box, GettyIDs will not be given. +Another option is to drag the flag in the “Map selection“ box with the mouse in order to retrieve longitude and latitude with high precision. By zooming into the map, streets names can been viewed in detail. A manual address search by using TGN, OSM or GeoNames is also possible. When using TGN, you can even enter a GettyID into the search field. With OSM and Geonames, however, no GettyIDs are recognized or returned. .. figure:: datasheet-screenshots/9-current-table-view.png :align: center @@ -157,7 +162,7 @@ Another option is to drag the flag in the “Map selection“ box with the mouse DARIAH-DE OwnStorage ^^^^^^^^^^^^^^^^^^^^ -The datasets stored in the OwnStorage are accessible to you only at first. You can read, write, delete, and share each of your datasets. +Initially, the datasets stored in the OwnStorage are accessible only to you. You can read, write, delete, and share each of your datasets. .. figure:: datasheet-screenshots/10-share-dataset.png :align: center diff --git a/docs/de/datasheet-faq.rst b/docs/de/datasheet-faq.rst index d9374e044df071beb965e89bd06163cc9e9df6e3..756152c403c4f7d053c5dd66943b921d8f25e2b1 100644 --- a/docs/de/datasheet-faq.rst +++ b/docs/de/datasheet-faq.rst @@ -11,7 +11,7 @@ Datasheet EditorFAQ .. topic:: Wieso finde ich mit der Geolocation Completion nicht die Orte, die ich in die Tabelle eingetragen habe? - Die Ortsnamen müssen (a) in die Spalte mit der Ãœberschrift Address eingetragen sein und (b) sollten Sie auf Groß/Kleinschreibung achten. Momentan berücksichtigt die Suche nur korrekt groß geschriebene Ortsnamen (z. B. Mainz, Göttingen). Wenn Sie dies berücksichtigt haben und dennoch keine Treffer erhalten, ist der betreffende Ortsname möglicherweise nicht im Getty ausgezeichnet. + Die Ortsnamen müssen (a) in die Spalte mit der Ãœberschrift „Address“ eingetragen sein und (b) sollten Sie auf Groß-/Kleinschreibung achten. Momentan berücksichtigt die standardgemäß verwendete TGN-Suche nur korrekt groß geschriebene Ortsnamen (z. B. Mainz, Göttingen). Wenn Sie dies berücksichtigt haben und dennoch keine Treffer erhalten, ist der betreffende Ortsname möglicherweise nicht im Getty-Thesaurus verzeichnet. In diesem Fall können Sie im Dropdown-Menü unter „Place selection“ einen der beiden anderen verfügbaren Geocoder (OSM oder GeoNames) wählen und es damit erneut versuchen. .. topic:: Meine Daten aus dem Datasheet Editor werden unvollständig im Geo-Browser dargestellt. Woran kann das liegen? @@ -19,9 +19,9 @@ Datasheet EditorFAQ Einige HTML-Sonderzeihen wie z. B. das „&“ bringen die Darstellung im Geo-Browser durcheinander. Prüfen Sie bitte Ihre Eingaben in der Tabelle auf solche Sonderzeichen und ersetzen Sie z. B. das „&“ mit einem „&“. Mehr Informationen hierzu siehe unter `Bug #14359 <https://projects.gwdg.de/issues/14359>`__ im Geo-Browser-Bugtracker. -.. topic:: Kann ich auch nur ausgewählte Ortsnamen mit den Set all places named-Button mit Koordinaten versehen? +.. topic:: Kann ich auch nur ausgewählte Ortsnamen über den „Set“-Button mit Koordinaten versehen? - Nein, das geht leider noch nicht. Dies ist jedoch als Feature vorgesehen für zukünftige Versionen (siehe `Feature #15318 <https://projects.gwdg.de/issues/15318>`__). Als Zwischenlösung könnte man alle Ortsnamen, die mit den gleichen Koordinaten versehen werden sollen, zeitweise umbenennen und dann nur diese neu setzen lassen. Wenn man also nur einige „Berlin“s mit anderen Koordinaten versehen lassen will, benenne man alle diese „Berlin“s um in z. B. „Berlin-tmp", oder nimmt gleich einen anderen treffenden Ortsnamen, und läßt alle diese Koordinaten neu setzen. Danach können alle „Berlin-tmp“s wieder in „Berlin“ umbenannt werden. Bei einer erneuten Bearbeitung der Ortsnamen im Datasheet Editor wäre die Prozedur zu wiederholen. + Ja, das ist nun möglich. Wenn Sie beispielsweise mehrere Einträge für die Adresse „Berlin“ haben und nur einigen davon andere Koordinaten zuweisen möchten, ziehen Sie mit der linken Maustaste einen Auswahlbereich (blau umrandet) über die betreffenden Zellen in der Tabelle. Stellen Sie dabei sicher, dass die „Address“-Felder Teil der Selektion sind, nicht nur die Latitude/Longitude/GettyID-Felder. Am einfachsten ist es, komplette Zeilen zu selektieren, indem Sie mit der linken Maustaste auf den grauen nummerierten Zeilenindex (1,2,...) klicken und durch Ziehen die Auswahl beliebig erweitern oder verringern. Einzelne Zeilen können durch Klick mit der linken Maustaste und gleichzeitiges Drücken der STRG-Taste der Auswahl hinzugefügt werden. Wenn Sie anschließend den „Set“-Button nutzen (oder den gesamten „Geolocation completion“-Prozess starten), werden nur die Orte im selektierten Bereich der Tabelle berücksichtigt. .. topic:: Die automatisch mit Getty ID erzeugten geographischen Daten sind nur partiell korrekt, im Bereich „Map Selection“ bspw. wurde Stuttgart auf der Karte im Gebiet um Köngen zwischen Plochingen und Denkendorf angezeigt, was einer geographischen Verschiebung von ca. 40 km entspricht und somit ein unbrauchbares Ergebnis anzeigt. Solche Abweichungen können auch für weitere eingegebene Ortsnamen beobachtet werden. Woran liegt das? diff --git a/docs/de/datasheet.rst b/docs/de/datasheet.rst index 77bc619cf51b8f754d8dc970d8bcc0f3d9993818..c9b1db4c494a824f84dacc2dab980f9169acff07 100644 --- a/docs/de/datasheet.rst +++ b/docs/de/datasheet.rst @@ -48,16 +48,18 @@ GUI Dokumentation ----------------- -Create or import your data -^^^^^^^^^^^^^^^^^^^^^^^^^^ +Anlegen oder Importieren von Daten +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Die erste Option nach Aufruf der Seite ist entweder ein neues Datasheet zu erstellen oder ein vorhandenes Datasheet zu importieren. Mit Klick auf „Create an empty worksheet“ kann ein neues Dokument erstellt werden. Mit Klick auf „Datei auswählen“ kann eine CSV-Datei vom lokalen Speicher in ein Datasheet geladen werden. +Die erste Option nach Aufruf der Seite ist entweder ein neues Datasheet zu erstellen oder ein vorhandenes Datasheet zu importieren. Mit Klick auf „Create new datasheet“ kann ein neues Dokument erstellt werden. Mit Klick auf „Import local CSV or KML file“ kann eine CSV-Datei oder eine KML-Datei vom lokalen Speicher in ein Datasheet geladen werden. CSV-Dateien können mithilfe von Microsoft Excel oder Open Office Calc erstellt werden. Unter Mac OS X können CSV-Dateien auch mit Numbers erstellt werden. -Nach Klick auf „Create a new datasheet“ or „Durchsuchen...“ / „Browse...“ werden Sie umgeleitet zum DARIAH-DE Login, zur DARIAH AAI (Authentication & Authorization Infrastructure). +KML-Daten müssen der `Spezifikation <https://geobrowser.de.dariah.eu/doc/_downloads/M3.3.2_eConnect_KML_Specification_v1.0_UGOE.pdf>`__ entsprechen, um korrekt eingelesen zu werden. KML-Files, die kein „Placemark“-Tag enthalten, können also nicht importiert werden! Wurde das KML-File korrekt eingelesen, wird es in eine CSV-Datei umgewandelt und auch als solche im OwnStorage gespeichert. Als CSV-File kann es nun um beliebige Tabelleninhalte (z.B. zusätzliche Spalten) ergänzt werden. -Sie können sich mit Ihrem DARIAH-Account oder mit jedem andern eduGAIN Föderations-Account einloggen. +Nach Klick auf „Create new datasheet“ or „Durchsuchen...“ / „Browse...“ werden Sie umgeleitet zum DARIAH-DE Login, zur DARIAH AAI (Authentication & Authorization Infrastructure). + +Sie können sich mit Ihrem DARIAH-Account oder mit jedem anderen eduGAIN Föderations-Account einloggen. .. figure:: ../datasheet-screenshots/1-datasheet-login.png :align: center @@ -71,7 +73,7 @@ Sie können sich mit Ihrem DARIAH-Account oder mit jedem andern eduGAIN Föderat Abb. 2: Einloggen in den Datasheet Editor mit Ihrem DARIAH-Account -Benutzen Sie Ihren DARIAH-Account zum allerersten mal, werden Sie zu Ihrer `Nutzerdaten-Seite des DARIAH AAI Self Service <https://auth.de.dariah.eu/cgi-bin/selfservice/ldapportal.pl?mode=modifyentry>`__ weitergeleitet. Bitte ergänzen Sie Ihren vollen Namen und lesen Sie die `DARIAH-DE Nutzungsbedingungen `<https://hdl.handle.net/21.11113/0000-000B-CB45-3@data>`__ und bestätigen Sie diese. Sie müssen dies nur einmalig tun. +Benutzen Sie Ihren DARIAH-Account zum allerersten Mal, werden Sie zu Ihrer `Nutzerdaten-Seite des DARIAH AAI Self Service <https://auth.de.dariah.eu/cgi-bin/selfservice/ldapportal.pl?mode=modifyentry>`__ weitergeleitet. Bitte ergänzen Sie Ihren vollen Namen und lesen Sie die `DARIAH-DE Nutzungsbedingungen <https://hdl.handle.net/21.11113/0000-000B-CB45-3@data>`__ und bestätigen Sie diese. Sie müssen dies nur einmalig tun. .. figure:: ../datasheet-screenshots/2.1-datasheet-selfservice.png :align: center @@ -108,18 +110,21 @@ Nach dem Einloggen erscheint ein Bestätigungsfenster mit dem Titel „New datas Abb. 5: Ein neues Datasheet wurde erstellt -Durch Rechts-Klick in einer Zelle des Datasheets können Reihen oberhalb der aktuellen Zeile („Insert row aboveâ€) und unterhalb der aktuellen Zeile („Insert row belowâ€) hinzugefügt werden. Spalten können sowohl links durch „Insert column on the left†als auch rechts („Insert column on the rightâ€) beiderseits hinzugefügt werden. Reihen und Spalten können durch „Remove row†und durch „Remove column†entfernt werden. Außerdem ist es möglich, neue Kategorien im Datasheet anzulegen, um weiterführende Informationen über die zu beschreibenden Orte zu speichern. +Durch Rechts-Klick in einer Zelle des Datasheets können Zeilen oberhalb der aktuellen Zeile („Insert row aboveâ€) und unterhalb der aktuellen Zeile („Insert row belowâ€) hinzugefügt werden. Spalten können sowohl links durch „Insert column left†als auch rechts („Insert column rightâ€) beiderseits hinzugefügt werden, um weiterführende Informationen über die zu beschreibenden Orte zu speichern. Zeilen und Spalten können durch „Remove row†bzw. „Remove column†entfernt werden. .. figure:: ../datasheet-screenshots/6-insert-column.png :align: center Abb. 6: Einfügen einer neuen Spalte +Wenn Sie mit der Maus auf eine Zelle klicken, wird diese blau umrandet und gilt somit als selektiert. Indem Sie die linke Maustaste gedrückt halten, können Sie den Auswahlbereich auf mehrere Zellen erweitern. Klicken Sie dann einmal mit der rechten Maustaste, um das Kontextmenü zu öffnen und eine gewünschte Aktion für die Zellen in diesem Bereich auszuführen. Alternativ können Sie dafür Tastenkombinationen verwenden, zum Beispiel STRG+C um die Inhalte im markierten Bereich zu kopieren, oder ENTF um die Inhalte zu löschen. Das Selektieren von Tabellenbereichen kann zudem für die Geokodierung verwendet werden, um anzugeben, welche Bereiche geokodiert werden sollen (siehe unten). + +Sind in der Tabelle keine einzelnen Zellen selektiert (blau umrandet), gilt standardgemäß die gesamte Tabelle als selektiert. Eine Selektion kann aufgehoben werden, indem Sie entweder auf den Button „Clear selection“ oder einmal mit der linken Maustaste auf die weiße Fläche außerhalb der Tabelle klicken. -Finden der Koordinaten für die Orte im Datasheet -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Ermittlung der Koordinaten für die Orte im Datasheet +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Beim direkten Eintragen eines Ortes in den Editor ist es für eine Darstellung der Orte im Geo-Browser nötig, den Längen- und den Breitengrad zu kennen. Falls diese Daten nicht bekannt sind, gibt es dafür auf der Seite die Tools „Place selection“, „Add geocoordinates“ und „Map selection“, um diese zu ermitteln. Durch Klicken von „Geolocation completion“ im Bereich „Add geocoordinates“ werden automatisch die Felder „Longitude“, „Latitude“ and „GettyID“ für alle Orte im Feld „Address“ des Datasheets ermittelt und ergänzt. Diese Orte finden sich dann auch in der Box „Place selection“. +Um in den Editor eingetragene Orte im Geo-Browser darstellen zu können, müssen ihnen zunächst Längen- und Breitengrade zugewiesen werden. Falls diese Koordinaten nicht bekannt sind, kann das Tool „Geolocation completion“ mit den Verfeinerungsoptionen „Place Selection“, „Map selection“ und „Map search“ bei der Ermittlung helfen. Durch Klicken auf „Geolocation completion“ im Bereich „Add geocoordinates“ werden automatisch alle (bzw. alle zuvor ausgewählten) Felder in den Spalten „Longitude“, „Latitude“ und „GettyID“ für alle Orte in der Spalte „Address“ des Datasheets ermittelt und ergänzt. Die Box „Place selection“ zeigt Ihnen die automatisch prozessierten Orte an. .. figure:: ../datasheet-screenshots/7-geolocation-completion.png :align: center @@ -127,11 +132,13 @@ Beim direkten Eintragen eines Ortes in den Editor ist es für eine Darstellung d Abb. 7: Nutzen der „Geolocation completion“ -Für das automatisierten Ermitteln der Koordinaten wird zunächst der Getty Thesaurus of Geographic Names (TGN) genutzt. Bei dieser Suchoption werden größere Orte gefunden, kleinere Orte werden durch TGN nicht immer gefunden. Falls der ermittelte Ort nicht der gewünschte Ort ist, gibt es die Option, rechts neben dem eingetragenen Ortsnamen auf den Pfeil zu klicken, wodurch sich eine Liste an anderen (falls vorhanden) Orten mit dem gleichen Namen öffnet. Nachdem der gewünschte Ort aus der Liste gewählt wurde, können durch Klicken von „Set“ die Koordinaten und die Getty ID in das Datasheet übernommen werden. +Standardgemäß wird für das automatisierte Ermitteln von Adresskoordinaten („Geokodieren“) der Getty Thesaurus of Geographic Names (TGN) genutzt. Bei dieser Suchoption werden größere Orte gefunden, kleinere Orte werden durch TGN jedoch nicht immer gefunden. Als Alternative stehen im Dropdown-Menü unter „Place selection“ zwei weitere Geokodierer (Geocoder) zur Verfügung: GeoNames und der Geocoder von OpenStreetMap (OSM), Nominatim. OSM findet oft auch kleinere Orte, die im TGN nicht verzeichnet sind, außerdem findet man mit OSM auch Straßen und Hausnummern. + +Bei der Nutzung von TGN haben Sie zudem die Wahl zwischen der Geokodierung auf Basis der „Address“-Spalte oder der „GettyID“-Spalte. Der Standardwert ist „Address“. OSM und GeoNames können grundsätzlich nur basierend auf „Address“ verwendet werden. -Für die Auswahl wird im Datasheet Editor die Funktion „exact-match“ des `DARIAH-DE Normdatendienstes <https://wiki.de.dariah.eu/display/publicde/DARIAH-DE+Normdatendienste#DARIAH-DENormdatendienste-ThesaurusofGographicalNames(Getty)>`_ genutzt, der auf den Thesaurus of Geographical Names (Getty) zugreift. Werden hier mehrere Einträge gefunden, werden jeweils die Koordinaten des ersten Treffers in die Tabelle eingetragen. Sollen nun die Koordinaten eines anderen Ortes aus der Liste in die Tabelle eingetragen werden, geschieht dies durch Wählen des Ortes und durch Klicken auf den „Set“ rechts neben dem Auswahlfeld. Es werden nun die Koordinaten des gewählten Ortes unter „Address“ in die Tabelle übernommen. Der Inhalt des „Address“-Feldes wird jedoch nicht geändert. +Falls der automatisch ermittelte Ort nicht der gewünschte Ort ist, gibt es die Option, unter „Place selection“ rechts neben dem eingetragenen Ortsnamen auf den Pfeil zu klicken, wodurch sich eine Liste an anderen Orten (falls vorhanden) mit dem gleichen Namen öffnet. Bei Verwendung des TGN wird beispielsweise die Funktion „exact-match“ des `DARIAH-DE Normdatendienstes <https://wiki.de.dariah.eu/display/publicde/DARIAH-DE+Normdatendienste#DARIAH-DENormdatendienste-ThesaurusofGographicalNames(Getty)>`_ genutzt, der auf den Thesaurus of Geographical Names zugreift. Werden hierbei mehrere Einträge gefunden, werden jeweils die Koordinaten des ersten Treffers in das Datasheet eingetragen. Bereits existierende Koordinaten werden dabei allerdings nicht automatisch überschrieben. Sind mehrere Treffer vorhanden, werden sie in der Dropdown-Liste vermerkt. Nachdem der gewünschte Ort manuell aus der Liste gewählt wurde, können durch Klicken von „Set“ die zugehörigen Latitude/Longitude-Koordinaten (und im Falle von TGN basierend auf „Address“ auch die GettyID) in das Datasheet übernommen werden. Duch Klick auf „Set“ werden existierende Koordinaten überschrieben. Der Inhalt des „Address“-Feldes selbst wird jedoch nicht verändert - mit der einzigen Ausnahme von TGN-Geokodierung basierend auf „GettyID“. In diesem Fall können Adressen automatisch in die Tabelle eingetragen werden, sofern gültige GettyIDs vorhanden sind und die zugehörigen „Address“-Felder noch leer sind. -Ist der gewünschte Ort nicht im der Liste aufgeführt, kann durch Klick auf „Map“ direkt daneben der Ort in die Karte der „Map selection“ übernommen werden. Unterhalb der Karte finden sich Suchoptionen für den Getty Thesaurus of Geographical Names (TGN), OpenStreetMap (OSM) und GeoNames. OSM findet oft auch kleinere Orte, die oft im Getty nicht verzeichnet sind, außerdem findet man mit OSM auch Straßen und Hausnummern. Durch Klicken auf „Set“ oberhalb der Karte werden die Koordinaten im Datasheet für den gewählten Ort aktualisiert. Vorsicht: Der Ortsname im Textfeld oberhalb der Karte muss exakt so geschrieben sein wie der Ort im Feld „Address“! +Ist der gewünschte Ort nicht in der Liste aufgeführt, kann durch Klick auf „Map“ direkt daneben der Ort in die Karte der „Map selection“ übernommen werden. Unterhalb der Karte gibt es die Möglichkeit, über den Getty Thesaurus of Geographical Names (TGN), OpenStreetMap (OSM) oder GeoNames nach der entsprechenden Addresse zu suchen. Durch Klicken auf „Set“ oberhalb der Karte werden die Koordinaten im Datasheet für den gewählten Ort aktualisiert (d.h. überschrieben, falls bereits vorhanden). Falls Sie mehrere Orte mit gleichem Namen im „Address“-Feld haben und nur bestimmte davon aktualisieren wollen, selektieren Sie die betreffenden Zeilen zunächst in der Tabelle. Vorsicht: Der Ortsname im Textfeld neben „Set“ muss exakt so geschrieben sein wie der Ort im Feld „Address“, für den die Koordinaten eingetragen werden sollen! .. figure:: ../datasheet-screenshots/8-manual-search.png :align: center @@ -139,7 +146,7 @@ Ist der gewünschte Ort nicht im der Liste aufgeführt, kann durch Klick auf „ Abb. 8: Manuelle Ort- und Kartenauswahl -Eine weitere Option ist es, die Flagge auf der Karte der „Map selection“ per Maus zu verschieben, so können die Koordinaten präzisiert werden. Durch Zoomen in der Karte ist es ebenfalls möglich, auch Straßennamen kleinerer Straßen zu erfassen. Eine manuelle Suche per Getty (TGN), OSM und GeoNames ist im Suchfeld unterhalb der Karte ebenfalls möglich, wobei jedoch per OSN und GeoNames keine Getty IDs vergeben werden können. +Eine weitere Option ist es, die Flagge auf der Karte der „Map selection“ per Maus zu verschieben, um die Koordinaten zu präzisieren. Durch Zoomen in der Karte ist es möglich, auch Straßennamen kleinerer Straßen zu erfassen. Eine manuelle Suche per TGN, OSM und GeoNames ist im Suchfeld unterhalb der Karte ebenfalls möglich. Bei Verwendung des TGN kann hier auch gezielt nach einer GettyID gesucht werden; mit OSM und GeoNames können jedoch keine GettyIDs erkannt oder zurückgeliefert werden. .. figure:: ../datasheet-screenshots/9-current-table-view.png :align: center @@ -174,7 +181,7 @@ Durch Klicken auf „Create new dataset“ im Table View kann ein neuer Datensat Abb. 12: Erstellen eines neuen Datensatzes aus dem Table View -Access your data +Datenzugriff ^^^^^^^^^^^^^^^^ Sobald ein neues Worksheet erstellt wird, wird der Datei eine ID im DARIAH-Storage Service zugeteilt. Über die ID lässt sich das Worksheet wieder aufrufen. @@ -182,7 +189,7 @@ Sobald ein neues Worksheet erstellt wird, wird der Datei eine ID im DARIAH-Stora .. figure:: ../datasheet-screenshots/14-search-for-local-csv-files.png :align: center - Abb. 13: Importieren einer lokalen CSV-Datei + Abb. 13: Download- und Lösch-Optionen für eine lokale CSV-Datei Beim Klick auf „Download CSV“ lässt sich die Datei als CSV-Datei herunterladen und im lokalen Speicher speichern. Außerdem wird die Storage ID angezeigt und die gesamte URL kann durch Klick auf den Button „Copy URL to clipboard“ in den Zwischenspeicher kopiert werden, zwecks direkter Adressierung der Datei im DARIAH-Storage. @@ -211,9 +218,9 @@ Sobald Sie Einträge in der Tabelle geändert haben, werden diese in Ihrem Datas **Description** wird für die weitere Beschreibung und die Darstellung zusätzlicher Daten genutzt. - **Longitude** kann per „Geolocation completion“ or manuell ausgefüllt werden und nutzt dezimale geographische Koordinaten. Bereits eingetragene Koordinaten werden durch „Geolocation completion“ nicht überschrieben. + **Longitude** kann per „Geolocation completion“ oder manuell ausgefüllt werden und nutzt dezimale geographische Koordinaten. Bereits eingetragene Koordinaten werden durch „Geolocation completion“ nicht überschrieben. - **Latitude** kann per „Geolocation completion“ or manuell ausgefüllt werden und nutzt dezimale geographische Koordinaten. Bereits eingetragene Koordinaten werden durch „Geolocation completion“ nicht überschrieben. + **Latitude** kann per „Geolocation completion“ oder manuell ausgefüllt werden und nutzt dezimale geographische Koordinaten. Bereits eingetragene Koordinaten werden durch „Geolocation completion“ nicht überschrieben. **TimeStamp** wird genutzt, um den Zeitpunkt eines Eintrags zu definieren. Einige Beispiele für dieses Feld wären etwa *1970*, *1970-12*, *1970-12-10*, and *1970-12-10T20:15:00*. Weitere Informationen über nutzbare Zeitformate finden Sie unter `xsd:date <http://books.xmlschemata.org/relaxng/ch19-77041.html>`__, `xsd:dateTime <http://books.xmlschemata.org/relaxng/ch19-77049.html>`__, `xsd:gYear <http://books.xmlschemata.org/relaxng/ch19-77127.html>`__ und `xsdGYearMonth <http://books.xmlschemata.org/relaxng/ch19-77135.html>`__. diff --git a/edit/js/dariah.workflow.conf.js b/edit/js/dariah.workflow.conf.js index 1af7448d5b895ac8ef8226e9c91f6c1809b9501b..46fc92933ca8786ad3ce582399bfcfa0eafd7a7a 100644 --- a/edit/js/dariah.workflow.conf.js +++ b/edit/js/dariah.workflow.conf.js @@ -18,7 +18,7 @@ const requiredColumnsGeobrowser = ["Address", "TimeStamp", "TimeSpan:begin", "Ti // columns with date format const dateColumns = ["TimeStamp", "TimeSpan:begin", "TimeSpan:end"]; // Mimetypes which pass check to get parsed into table. -var allowedMimeTypes = ["text/csv", "text/comma-separated-values", "application/vnd.dariahde.geobrowser.csv", "application/vnd.ms-excel", "application/vnd.google-earth.kml+xml", "text/xml"] +var allowedMimeTypes = ["text/csv", "text/comma-separated-values", "application/vnd.dariahde.geobrowser.csv", "application/vnd.google-earth.kml+xml", "text/xml"] // CSV mimetype used for storing datasheets. var csvStorageMimetype = 'application/vnd.dariahde.geobrowser.csv';