Play the webinar
February 23, 2022
Figshare provides flexibility in how records are added to a repository and managed after publication. In this webinar, we will take a look at submission options and record management options in a Figshare repository from the user and administrator viewpoints. We will see self submission, administrator submission, impersonation of accounts, review workflow, record versioning, and removing records.
Please note that the transcript was generated with software and may not be entirely correct.
Hello everyone, thanks for joining us for this webinar.
Uh, it's nine o'clock. Well it's nine o'clock my time on the West Coast here.
And so I think we're just gonna get started, um, as folks, continue to trickle in.
My name is Andrew Mckenna-Foster, I'm a product specialist here at Figshare.
I'll be conducting the webinar, the title of which is Submission and Record Management Workflows and Share.
Um, this is part of a, basically a monthly series of monthly webinars, just on, you know, tips and tricks using the Figshare platform.
There are upcoming webinars over the next couple of months and links.
If you're on our mailing list, you will get invites to sign up for these webinars. So, in March, going to be talking about the link to Figshare, Record, how the Figshare record links to other systems, and digital objects.
The audience for that is librarians and researchers.
The next webinar in April is Collaboration in Figshare, really focused on the use of projects, also aimed at librarians and web and researchers.
In May, I'm excited for Figshare API for librarians, obviously, aimed at librarians, those using the Figshare platform in the role of a manager.
Then, finally, in July, a webinar on reporting statistics in Figshare.
Great for librarians and those in the research office, perhaps, for anyone.
I'm interested in reporting from a positive rate, So keep your eye out for those invites as they'll come into your mailbox.
I guess I should also mention throughout this webinar, you can put questions in, question, area, or chat?
Megan is joining me and she can help handle some of that in the background, so thank you, Megan, for helping with that.
So the audience for this webinar, really, anyone, but especially librarians yet, again, as you probably guessed, especially those managing a repository based on the Figshare platform over those considering Figshare as a repository platform.
If you do currently um administer a Figshare repository some of what I'm going to talk about is definitely gonna be review for you, but I hope that there are some things that maybe you didn't realize or you didn't know that happened within the platform and that'll. That'll be useful for you.
Quick review, just in case there's anybody who has no idea what the Figshare is. A Figshare is a leading repository platform for storing, accessing and citing research outputs, including data papers, theses teaching, materials conference outputs, and much more, and this year Figshare, turn 10 years old, that's really exciting. Keep your add further announcements around that, over the next months.
There are five million objects shared on Figshare right now. There are over 80,000 citations. So we're starting to see re-use of all these research outputs shared on the platform.
What I'm going to talk about, specifically over the next 20, 25 minutes, is researcher self's submission.
The review curation process, uh, ways you can have a mediated submission workflow.
Then just a couple of points, tips about managing existing records in the repository.
As a side note so Figshare is you know, plays well with others. It can be integrated with a variety of other systems, including CRIS systems like ... Elements which is pictured here.
I am not going to be talking about the greatly expanded submission options and workflows you have if you integrate Figshare with Elements or other systems, so you do that integration. There are many more options for your researchers and administrators.
But I will be focusing on the Figshare specific workflows.
There is A a recorded webinar video of how this whole integration works and the benefits of that, and I think Megan will put that in there, chat. Oh, yeah, it's already there, fantastic.
So, you can watch that if you want more information on this, this integration in those workflows.
So, I'm going to be using a stage instance today to kind of demonstrate some of these things.
If you have a Figshare repository, you have a stage instance as well, that you can test things out on it, should mostly near your production environment.
And actually little, there's a little premature I met. Before I go to the stage instance, I wanna give you a little kind of a high level overview.
Just so as I'm switching between accounts and groups, you'll kind of know what's going on.
So my stage instance today is Faber College from the movie Animal House, and I I'm going to be using or that'll be talking about these groups, so there's the top level Aber College Groups.
There's an Astronomy group, and an example, astronomy subgroup.
And so, you know, each of these groups can have its own users, can have its own administrators and have its own reviewers.
Groups are how the Figshare platform allows you to organize all of your items width in these groups.
I'm going to be talking about several users.
So the top level administrator has all the privileges.
Then there's an astronomy admin, group admin, for the astronomy group.
Then there's our researcher, Lewis.
There was a basic user part of the Astronomy group, so hopefully you can kinda keep this in mind, as I'm clicking around in the stage environment. OK, so now we can go to Favorite College.
So here we have favorite college, the stage instance.
It's behind a password wall, so nothing here is like indexed and shows up in search engines. I've uploaded a variety of example, items into this repository.
There are some groups visible as part of this repository, as I mention. So yours that astronomy and example, astronomy subgroup.
When logging in, most institutions, of course, use single sign on. That's not set up for the stage environment, so I'm gonna login, just through Figshares, login, to manually create users.
This is what they'd see.
So I'm going to log in as Louis or our researcher first.
And Louis owns a bunch of items for records. Which we can see here. Now, I'm not gonna go into detail, really, about the, you know, the anatomy of this page and all these other options here. And save that for a future webinar.
Um, but Louis' can easily create a new item and start filling out metadata.
Rather than, have you watch me, like miss type, a bunch of things.
I've already created a draft and see that here de identified data set. I'm going to open that up.
I've uploaded a CSV file here.
Drag and drop many files into that area, or it could be a metadata only record. Whatever the case may be, All the green dots are required, metadata, and so I've filled in basically everything to publish this.
one thing I did want to note, this is kind of a recent addition to the platform is an integration with Sherpa Romeo.
So that's turned on for this, this group, and this repository. And you can see that show up here. Check, publisher, Open access, policy.
So, if this wasn't a dataset, if it was an open access paper, from my research from Lewis has research, getting uploaded, Lewis could check, and make sure, you know, find out what copy was actually allowed to be shared by the journal publisher.
So here we have a list of journals from the Sherpa Romeo site.
Let's click in the, one of these here, and choose one of the journals, and we can see all the guidelines here and see details about what we are allowed to submit to our institutional repository.
If this all looks good, I can actually add this to my record, Like the Journal, and we can see it there. And you're gonna see this in the review process, too. So that's nice. Sounds like I've checked this.
I'm not going to violate any copyright rules.
So I can save changes. Click the Publish button.
And we see that this is going to go into review a review turned on for this whole repository.
You can turn our view on for just a certain group or a certain set of groups.
Doesn't have to be on for everywhere.
OK, great, so, we've published this item, here's what it looks like.
You see the, the preview of the little, uh, tabular data, and metadata.
There are a couple other ways to upload files. I'll just kinda mentioned them here. I'm going to click on the on Lewis's icon and go to applications.
And we see we can integrate this account with multiple tools, GitHub, Gitlab, Bitbucket, and an FTP client.
So all these tools are ways to upload I'd files, with very minimal metadata, basically, just the title. But you know for FTP, great way to upload a ton of files into a ton of records, if you needed to do that.
For example, Git Hub, integration allows you to take a snapshot of your Git hub repository, and it's a zipped zip file, and add that tea to your Figshare account.
And every time you do a release through GitHub, you can have it automatically version your Figshare record, great way to put a DOI on this type of work.
I'm not going to demonstrate those, but I will demonstrate the FTP upload. Or I'm not sure a lot of people try to use this, and that's where they really need to, but you have a huge file, and a lot of files. This is a great option.
If you click this link in your account, it'll bring up the Help page, or you can just Google search, FTP. Share upload instructions, really clear and easy.
I, um, you can see there's some credentials here, so the username and the password set this up previously.
Just open up my file zilla window here, so I'm going to connect, reconnect to the server.
I'll set up. I've previously entered the password.
Follow the directions, I made some folders in this data folder in this right window.
The each folder is going to be its own item in louis' account.
And this will be the title of the item, and I have some files over on the left here that I'm going to upload.
So, we have two upload ones, so let's see, I can drag and drop those.
And we can see that it immediately starts to upload.
So, I can do the second one.
Let's enter the third.
So, everything should be uploading, and it looks like everything was successful, is great, or minimize this.
I go back into louis's my data.
We see those records have appeared here.
And I'll show you there is not a lot of metadata here, really only the titles filled out and Lewis as the author.
There are a couple, you know, if these are all related, you know, from the same project, maybe they are all going to have the same category, same keywords.
There is a nice feature in here that allows you to quickly fill that in, edit in Batch. So I've selected those three records.
Um, I can choose Astronomy. Since this is, it's astrobiology.
And the item type, you know, maybe they're all figures.
I can fill in the rest of these keywords. I can even fill in custom metadata. So here's a custom metadata field I've added for language, so I can fill that in.
Then I can save changes once I've done that all in, so firm and save, I'm done.
And now we should see that, you know, we see the Category, type in English is filled in down here.
So a nice way to, to deal with a bunch of records.
I want to make a little mention that there's a new batch upload that's coming.
I'm going to click on the Roadmap tab up here at the top of the screen.
So, you can see that right here, planned for April.
This will be in the interface and a way to batch upload records, really for, you know, gonna be very useful for administrators. So just know that that is coming.
But in the meantime there is the FTP uploader for many records.
And I will mention one other way, going back to applications.
This is going to come up later.
Scroll all the way down.
We can create personal tokens to use with the API, yet another way to add files and metadata to your to an account.
OK, so, I'm now going to log out of Louis, it says account.
And log back in.
As an administrator.
So, this is that top level administrator account, full privileges across the repository. This account owns a lot of items.
You might have an administrator account that doesn't own anything.
And we see that the administrator as an administration links statistics, and this account is also a reviewer.
So, I'm going to click on the Review option, and we see the dataset that Lewis submitted.
I'm going to click on that.
Can assign this to myself, and see there are some other reviewers that can review astronomy related work.
Can preview the whole item here, if I need to, I can edit the metadata.
Now, Lewis was in the Astronomy group, did not have any options to place that article outside astronomy, but this administrator account can replace that item in other groups within Fabre College.
So I could place it in the system dissertations or English, whatever I need to do.
So that as an option, a little more way to help organize items in your repository, no matter where the users are coming from.
The other thing I want to point out, as I scroll all the way down, we can view selected …, Sherpa Romeo policy.
I can see what Louis has selected and decide if that's that's correct or not.
I need to make a change in ... account. I can just access Loss' account from this link right here, direct impersonation of the account and make any changes needed.
So when I'm when it looks good, it can improve and publish, leave notes for Louis, if you want, and that's all ready to go.
I will also want to quickly mention mediated deposit.
So, we just saw how a reviewer can submit something, and then that can be reviewed. Go to Administration.
We have three options here as the administrator and the top level administrator so I can actually unpublished records if I needed to.
But under users, we have, can see, all the users and as astro administrator.
So in this case, I'm using this account to hold items that maybe, you know, favorite college owns. Maybe a specific author isn't uploading them, Maybe they're telescope, images, or something.
So we want to put them all in one account, where we can easily manage them, rather than logging in as astro admin. I'm just going to impersonate.
And I'm looking at the Ask for Admin account as if I'm logged in as that person but we can see that clearly we're impersonating.
I've previously uploaded a few items here, Pretend I just uploaded these. You'll see, of course, that Astro Admin is added as the author.
But we can remove that author and put in Any, any author that makes sense saw this.
I'm just gonna select some here and wants to make sure all the metadata is correct.
We could just publish, here, I'm gonna save changes, but, if we have multiple items, you can also publish multiple items all at once. So, I'm going to select all the draft items I've just selected.
I Can Publish all of them all at once, so yes, they're going out under these terms, and they're all set.
So, if we look at the repository, we should see.
Hopefully, Oh, of course, they went into review, so I'd have to review them first, I would make sense.
I'm not going to review these, I'll just show you that they, they've showed up here for review, and we could have those reviewed, and then they'd be public on the repository.
OK, so, I'm going to spend the last couple of minutes talking about how to manage records, and different ways you can manage records within the repository.
The first, oh, I should leave this account.
So, items may get uploaded, reviewed, you might.
With the CSV uploading tool that's coming out, it might upload and and automatically approve a bunch of items to be published.
Um, then, you're clicking through the repository and you notice.
Like there was an error in this, in this metadata. So, for example, openness, Mars, curiosity, item here.
They might be in here and be like, oh, I see a mistake. We need to fix that.
Do you remember what account owned that, that item?
Because you might need to impersonate an account to make that change.
Right now, there's no way to actually do that.
However, I want to point out on the Figshare roadmap, scroll down, It's coming. So a solution to that is coming in under improvements here later this summer.
You will be able to, as an administrator, if you're logged in, just click right in and fix, fix some errors.
In the meantime, though, there are other ways to find out who owns an item.
And I want to just point out, … introduced how to use the API documentation page to do that.
So, I'm going to highlight are copy this item ID.
And I previously opened Figshare API documentation, It lives at docs dot Figshare dot com. Notice I'm at docs dot ...
dot com, they use with the stage instance.
And a lot of options here. A lot of endpoints and information.
We're gonna go to articles.
I have previously entered a token that I created from my administrator account.
This gives me a lot of access to to all of these endpoints.
And I'm gonna go to private article, even though I don't own this article. I can still get all that.
All the metadata from this article are going on, article details.
And we can just paste that article ID directly in here.
See, I've done it before, Try, and it brings up JSON formatted information. So we can see curation status, lots of information about the files.
I'm sorry, I'm going to scroll down, here, are a bunch of information past all the custom fields.
And we see our custom ID.
I don't know if I can zoom in here a little bit.
We see the customizer there.
So sorry, the account ID.
Then you might be like, Well, I don't, I don't, I didn't memorize the account IDs for my institution.
Take you back to the administration page.
Under the Users option, you can highlight all your users, or select them and download a user report, and this contains the item IDs, as well as tons of other information.
Done this previously, open it up.
And we see, uh, 1, 8, 8 3, 6, 8, 2.
We could search the page for it, and we see it right here. It's owned by Astro Admin.
So then we could impersonate that account and make that change.
Another, uh, thing that you might need to do when managing records is, I'm gonna go back to the main page here, it's changed the thumbnail.
Now, this, the ability to change thumbnails is discussed and planned for later feature release.
Um, but in the meantime, it's totally possible to do it through the API, and it's actually really very easy. So, notice the thumbnail here is this curiosity image, thanks NASA for all these images today.
But this page, this item also has this really cool curiosity rover image that I want to actually be the thumbnail, just to make the repository look even better than it already does.
So within the API Documentation, scroll down.
Article version, private updates, I'm on the left side of the screen. I know it might be a little difficult to see here, but I'm going to click on that.
And within this, this area, there's an update article, version thumbnail. I'm open that up. We see we need three pieces of information, Article ID, version ID and yield IDE or file ID.
And the file ID.
has to go in in a, in a JSON format. So, we see that over here.
I can click into this, and it'll click on the, on the right side, I clicked on the, kind of like example, and it pre filled this file ID for me.
OK, so we can gather up this information, The Item ID is within the URL, Copy, Paste, article ID.
Then the File ID is also in the URL, because I've selected the image that I want to be the thumbnail.
They sat in there.
Oops, wrong place.
There we go. Then, the version.
right here, version two, I need to fix this.
OK, now, assuming there no, like, Webinar ghosts that are going to mess things up all.
We got a response to hundred and five, which means everything worked.
We can check this to refresh the screen.
Great, we have the image that, that I think looks really neat and is now the thumbnail. So, you can use that to, to make your items look the way you want them to within the platform.
So the last thing I'm gonna just point out and talk about, is, uh, is a workflow to give access to items that might be embargoed. You maybe want to provide access to a class.
You know, maybe they're the records or physical objects within a collection, and you don't want to just let anybody be able to download those images of those, those, those pieces are, or something like that.
So you want to have a class that wants to be able to use these as part of their curriculum, other course.
How would you do that? And we have an example here.
Validation of a post-tax tuition dysphagia screening, something.
So, you can see it's, it's embargoed, if I click on it, it's embargoed for everyone.
That the account that I'm in owns this record.
So, I'm gonna go to my data, show you that it's right here, I could edit it, but it is embargoed.
Notice that it's been added to a project.
So, you can add things to projects using the actions button, um, and here's the project, over here, example Collaboration project, and you can see that I've added a bunch of other users to this project.
See, there are a bunch of other items in this project.
I'm gonna go to Manage, Edit Project details.
So, I have two collaborators, you know. Maybe these are the Professors, and Louis has been added as a viewer. So maybe a student here.
Because Lewis, as a student, as part of this project list, can actually access these on this embargo file, and see it, and even I can, no, I own this, but I can see it as well, accessing it through the project.
And you can see that the, that this is kind of a different view. We haven't the project link here.
So, just to show you that from Louis' perspective, um, I will log out and login as Lewis, and we'll see that record.
It'll come in as Louis here?
And now, So Lewis can go into the projects.
So, every student can have a, you know, an account and we can see that Lewis is a member of multiple projects And a viewer on this specific project can come in here.
And can see this, that's embargoed file and has access to it.
Now, when when the classes ended, Louis can be removed from the project, and will not have access to this file anymore.
So, I'm going to end it there and see if there are any questions. Thank you again for attending. And if you have any questions, you can please e-mail me. I hope that you walk away from this webinar with having learned at least some minor thing that was new to you.
And please do sign up for our future webinars, or, actually, a lot of other webinars than the ones I just mentioned coming up.
So, if you haven't already sign up for that newsletter link, and you'll stay up to date on all the Figshare happenings.
So, I will just kind of hang out if there are questions.
I can answer them now, or e-mail me later with your questions.
Thanks, Andrew, and there are currently any questions, but I'll give it a minute for people to ask them.
And I will say that all the links that are in the chat, that will be sent around with the recording as well.
So, don't worry about making sure that you took note during the webinar, just in case.
And I can also include Andrew’s e-mail address in the follow-up as well if you do have any questions that pop into your head.
And Megan, I'll also add that if you are current, no repository manager of a Figshare repository, and, um, all right. You saw something that you could add. I'm always interested in hearing how folks are using their repositories and managing their records.
So, I'm happy to, I would love to, to hear more, so I feel like sharing with me, I'd love to hear that.
Doesn't look like there are any questions. I think we can end it there. Thank you so much, Andrew, and run the recording. In the next couple of days, Keep an eye out for it, and yeah, any questions pop up, Either replies to e-mail us or someone, be happy to answer them.
Thank you! Bye!