Changes for page EBRAINS Knowledge Graph guide for software curation
Last modified by adavison on 2024/11/13 11:30
From version 27.1
edited by patriziaduhr
on 2022/11/13 09:01
on 2022/11/13 09:01
Change comment:
Uploaded new attachment "guide1.JPG", version {1}
Summary
-
Page properties (3 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 1 removed)
Details
- Page properties
-
- Parent
-
... ... @@ -1,1 +1,1 @@ 1 -Collabs.sw c-guide.WebHome1 +Collabs.sw-curation-nest-desktop.WebHome - Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. patriziaduhr1 +XWiki.jan - Content
-
... ... @@ -1,5 +1,5 @@ 1 1 (% class="wikigeneratedid" %) 2 -**For any questions or support directly reach out to [[Jan Gründling>>mailto:gruendling@uni-trier.de]].** 2 +**~*~*~* This Guide is not complete yet and needs further extension. For any questions or support directly reach out to [[Jan Gründling>>mailto:gruendling@uni-trier.de]].~*~**** 3 3 4 4 5 5 (% class="wikigeneratedid" %) ... ... @@ -7,27 +7,42 @@ 7 7 8 8 == How to enter software metadata manually == 9 9 10 - Fieldsmarkedwithanasterisk(*)arerequired.Whenyou are done,just contactthecuratorsyansweringtoyourticketemail.10 +To manually input meta data of your software into the KG, you use a tool called "KG Editor". The KG Editor can be reached at [[HBP Knowledge Graph Editor>>url:https://editor.kg.ebrains.eu/]]. Just log in with your HBP credentials. 11 11 12 - (% id="cke_bm_36775S"style="display:none"%) (%%)Toregisteryoursoftware,you willneed toinputinformationfor theinstance"Software" andfor "Softwareversion".12 +After you are logged in, you are probably prompted to choose a space in a view like below: 13 13 14 - After clickingthelink for software sent to you, you will see an instance editor view like below, where you can add all relevant information on your software.Pleasenote that fields marked withan asterisk(*) are mandatory.14 +[[image:image-20220323113258-3.png||height="386" width="681"]] 15 15 16 - Whenfinishedwiththesoftwareview,repeatthesamefor the softwareversion.16 +From the available choices (should not be too many in your case) choose the one that corresponds to the title of your software. Something like## swcuration-{your_software_name} ##should apply. 17 17 18 +After that, you see the view below. now click on the little magnifyer glass symbol at the top. 19 + 20 +[[image:image-20220323120123-6.png||height="412" width="1032"]] 21 + 22 +After that, you see this list on the left side: 23 + 24 +[[image:image-20220323121426-1.png||height="202" width="258"]] 25 + 26 + 27 +To register your software, you will need to create one instance "Software" and one or more instances "Software version". To create instances, just click the small +button that appears when you are hovering over the respective list entry. We recommed starting with "Software". After clicking the plus icon you will see the software instance editor view like below: 28 + 18 18 [[image:image-20220323152326-1.png||height="1062" width="1023"]] 19 19 20 20 21 - Afteryouhaveentered andinformation on the software,**donot forgettosave your changes!**32 +Now you can start entering the information on your data! Fields marked with an asterisk (*) are required. When you arrive at the "Has version" field, you can create one or more versions of your software to be curated. 22 22 23 - **->**[[image:image-20220323121238-10.png||height="170"width="382"]]34 +After you have entered the software, **do not forget to save your changes!** 24 24 25 - === How to updatexistingSoftwareinstances===36 +[[image:image-20220323121238-10.png||height="170" width="382"]] 26 26 27 -If you have registered a software previously, updating means adding a new instance of type "Software version". Curators will later link it to the existing instance of type "Software". 28 28 29 -T o make updating easier, wehave already placed a copy of your lastoftwareversion instancein theKG space that belongstothis collab. Youcan usethat copy andjust change the fields that require changes. Again - if you made all changesthat youconsider necessary, let the curatorknowviatheticketassigned with this case.39 +That's it. When you are done, just contact the curators via your ticket. 30 30 41 + 42 +=== How to update an existing Software instances === 43 + 44 +If you have registered a software previously, updating means adding a new instance of type "Software version" and link it to the existing instance of type "Software". 45 + 31 31 == How to upload software metadata programmatically == 32 32 33 33 To create a valid jsonld file, please use the [[API>>https://core.kg.ebrains.eu/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config]]. ... ... @@ -37,4 +37,4 @@ 37 37 38 38 Before using it, you need to authorize, using the "Authorize" button found in the top right corner of the API documentation (see below) or by using a service account. 39 39 40 -[[image:image-20220323111341-2.png ||height="74" width="186"]]55 +[[image:image-20220323111341-2.png]]
- guide1.JPG
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.patriziaduhr - Size
-
... ... @@ -1,1 +1,0 @@ 1 -95.5 KB - Content