Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Attendees (please add your name):

Magda Zacharska leeda.adkins@duke.edu Christine Tobias Scott Perry Lloyd Chittenden Sara Colglazier 

Note taker:

Robert Scheier

...

TopicNotes 

Housekeeping

  • Please add your name to the attendees list

Development updates

  • Magda: We have a guest presenter today. Uh, Christine Tobias will be talking about the documentation for Bulk Edit and the project as well. But before we get to the point, I would like to give a quick update on the development progress and go over the list of agenda items after Christine's presentation.
  • Magda: I will start with the, with the development board of the team. We have a new quality assurance engineer on the team. She is very thorough. Every ticket goes through her for review and to completion. As you can see we have an additional column in QA. So once the developers complete their development and the code is committed and reviewed by other developers, then it is evaluated by the quality assurance. And after that it is landing in my column where I review if what was implemented is what we expected. That it's a huge step forward to assure that the quality is as we would like to. I was struggling in the prior releases spending a lot of time on finding bugs that should have been prevented earlier. So this is, this is really good news. Do you have any questions about that?

Image Added

  • Magda: When it comes to the work, as you see, we have a lot of work in progress. We have also some other work because the team is responsible also for OAI-PMH. But everywhere you see mod data export worker (MODEXPW), it is the backend work for the bulk edit.
  • Magda: As we discussed at our last meeting, I added stories for narrowing down the options in the bulk edit form.  This is bulk edit 76 and also to enable type ahead in the location look up. The team estimated that hopefully we will be able to work on this in the next sprint that starts in two weeks. And this will be the last sprint of the Morning Glory development. So there's a big chance this will make that release.

Image Added

  • Magda: I wanted to show you the snapshot version that was building this morning, We addressed several bugs that we saw recently.

  • Magda: We added the progress bar the displays once the data is being loaded.

Image Added

  • Magda: And this is the "are you sure" form that we had problems last time. The record count was incorrect. This has been resolved.

Image Added

  • Magda: I have a question about the expected behavior. Hopefully you will be able to discuss this later today and downloading the preview.
  • Bob: Was there a confirmation of the changes?
  • Magda: There used to be the green popup. It is gone. This is a work in progress. We lost it as some point. It will be back confirming the changes were committed.
  • Magda: And as you can see here is the "New Bulk Edit" button.

Image Added

  • Magda: It will reset to the original state but It does not reset the radio button and keeps the App that was selected, in this case "Inventory Items."  Any questions for comments?

Image Added

  • Bob asked about the narrow options in drop-down.
  • Magda: This is what I was referring to with UIBULKED-76. Hopefully this will get squeezed into Morning Glory.
  • Bob: Exciting to see the changes.
  • Magda: Yes it is moving along. This is it for the development update. Any questions?
  • Don: I have a question about the preview screen. Is it possible to show what the current state is next to the preview of the changes we intend to make on the "Preview of records to be cahnged" screen to provide one last opportunity to catch any problems, e.g., records you did not intend to change.
  • Magda: This ties into what I want to discuss later in this meeting regarding selected vs. affected recrods. But I do agree with you that you would like to have here additional column, that if you are changing the location, you would like to see. What is the location. So it will be just repeating whatever was on the, on the first preview preview.
  • Don: Exactly.
  • Bob: So, one thing you can do in Sierra is you can check on check and uncheck at that point (agreement from Don).

  • Magda: Yes, we don't have this option right here right now, but I'm not saying we will not have this ever. This is something we can discuss. The checkbox definitely will work on the smaller data set. Let's say you have like 100 records and you want to make those changes on the 100. And then this is the moment you want to have the check boxes. But if you have thousands of records the check boxes may not be that helpful. So I'm making a note for two things are the columns of the records that will be modified, and the other one checked boxes to narrow down the list of the records that would be updated.

  • Bob: And if we couldn't have check boxes for larger sets, then there was a point in the process where you can re-upload after you take out the ones that you don't want from the preview spreadsheet to start a new bulk edit?

  • Magda: But you cannot upload the preview. Not in the in-app approach. For this you will need to extract only the one column from the preview spreadsheet, the ids, and then run a new bulk edit using those ids.

  • Bob: I see. You cannot have all those other fields from the spreadsheet. Just the ids can be in the file.
  • Magda: We will be working on CSV approach for items, but this will not be available by the end of Morning Glory, but I'm really glad that you see that connection, the fact that you can use this approach also. I will make a note of this as well for the CSV upload.
  • Lloyd: I'm wondering, will there be a possibility of selecting the thing I want to change? So I only want to change all annex to another location but leave the others unchanged.
  • Magda: We will get back to this shortly when we discuss matched and affected records.
  • Sara: I'm confused by what Donald, Bob, and Lloyd said. I would have understood that if I had three records and two of them had permanent location stacks, and the third one said annex, and I indicated that I wanted the change to be stacks to new books that then only two records would be affected by my change because the item in annex would not have the permanent location that I was indicating needed to be changed. And so I'm not sure why the check boxes are necessary. What for me would be more relevant would be identifying which records did not actually meet my expected criteria so that I can perhaps re-run the file to pick up the records that were not identified in my original query.

  • Magda: We will be working on bulk edit for several releases to come. And once you start having a little bit more time to play with the application, I'm sure you will be providing more feedback like we are getting now of what would make your life easier. I'm not saying we will be able to address all of your suggestions and address them right away. But I will definitely put them on the roadmap. And from this discussion it's obvious you need a little bit more on the screen and more flexibility in seeing the columns. And regarding the selection, maybe instead of doing it on the "are you sure" form, we should allow the selection of the record on that preview screen. I would like to table this conversation for now. We will definitely come back to it. I would like to give Christine time to talk and then we can come back to the conversation about selected and affected records and also to spend at least couple of minutes to talk about the user acceptance testing and what we can do to make it better in the future.

Bulk edit documentation for the app for docs.folio.org (Christine Tobias)

  • Christine: I'm Christine Tobias for anyone who doesn't know me. I'm at Michigan state university libraries, and I'm also a member of the documentation work group. I'm the user management liaison for that group, and Erin Nettifee is the resource access liaison for that group. The documentation work group began last summer in 2021. And what we write the technical documentation for the docs.folio.org site, the official documentation for FOLIO which contains the basics of installing and using the FOLIO UI at a high level. It does not include any institutional workflows.
  • Christine:  We have written documentation for Honeysuckle Iris, Juniper, and just yesterday we published a Kiwi. We have different volunteers who are responsible for writing the documentation for each app. With bulk edit coming up in Morning Glory, we need to have somebody start documenting the bulk edit app. So this is basically a call for volunteers.
  • Christine: It's not a scary endeavor by any means. The group works together and we meet monthly. We write our documentation in a shared Google drive folder. We use markdown language to write our documentation, but it is okay if you don't know how to write in markdown language, you can write it in plain text. And we have members who can help you converted to markdown. We simply use the release notes and the FOLIO dev sites to iteratively change the documentation. Right now we are starting on Lotus.
  • Christine: What we do is write documentation and bring it to the respective interest groups for comments and suggestions. When the SIG gives it the thumbs up it gets published.
  • Christine: So we need somebody to take on the bulk edit app. I have to be honest, it will take some time to get started and build a foundation. But with the changes being iterative with each release, once you have that foundational document, it doesn't take as much time to make changes. So if you're interested in more information or you excited and you want to volunteer and jump on board just let me or Erin Nettifee know. We are happy to help onboard you into the documentation work group.
  • Christine: Erin and I just wanted to bring to your attention that we need some help with the bulk edit app. Ddoes anyone have any questions or concerns that I can address right now?
  • Magda: I would like to add that at this point bulk edit has a pretty decent code coverage when it comes to use test cases in Raleigh, we also have our internal documentation for the team that we would be more than happy to share with the person who is brave enough to start working on the documentation.
  • Christine: It's definitely a community effort. It takes a village. So you would have the support of the various groups to get you through it.

  • Christine: We meet once a month on the second Wednesday of the month. Our next meeting is scheduled for Wednesday June 8th. And we will hopefully have our Lotus documentation drafted and ready to publish. Let me know if you have any questions or if you're interested.

  • Magda: Do we need to have a deadline for someone to volunteer?

  • Christine: I think if they volunteered before the next documentation work group meeting, which is June 8th, that would probably be best. The sooner, the better, because even though bulk edit isn't going to be ready until the Morning Glory, this person should allow themselves some time to building that document. So in the next couple of weeks, for sure.

  • Magda: So we have 17 people on the call and the 41 people in the Slack channel. If no one volunteers from this group, maybe it would make sense to post also the question on the .

  • And the questions, comments, we are not moving to the next bullet, Andrew, someone volunteers,

UAT review

UAT follow-up 

Questions:

  • How much time is needed for UAT?
  • How to help with learning the app?
Are you sure? form: selected vs. affected records
  • Magda: I think this become a good segue to my next bullet on the agenda, which is the failed user acceptance testing. I call it failed because I got only one response out of 41 people in the slack channel and at lease 10 people attending on these meetings on a regular basis. And I got only four responses as a followup from those who did not responded. We will another user acceptance testing probably in a couple of weeks and I definitely would like us to do better. So, the question I have is how much time do you think we need to have allocated to the testing to give you enough time to participate?
  • Leeda: I would say at least two weeks. I'm more on the metadata side than the user side, but I did want to get in there, time permitting. But I believe Wednesday we were till we had until Tuesday. And when I went to get in there Monday, the system was down. So then we had until Wednesday morning, But then I was booked. I think two weeks I could find some time, but less than a week is just not enough time.
  • Magda: I apologize for the system being down. It is something that our team does not fully controls.
  • Leeda: We have to be prepared for it and be able to work again. The two weeks would help cushion.
  • Magda: My concern was that two weeks will be just too long that we will be postponing the answer, but of course we will allocate two weeks.
  • Magda: And then, do we need to allocate a little bit more time to spend playing with the application more as a group before you, UAT so you are more comfortable with what to expect? Because my concern was that maybe this was just too convoluted for you and you just did not allocated enough time and it wasn't enticing for you to start playing with the app.
  • Bob: What exactly is, what exactly do you do for this user acceptance testing?
  • Magda: Magda explained to Bob that you go through the steps of using the app and then respond to a survey.
  • Magda: From the four responses, somebody said more reminders. I didn't want it to be annoying. But I feel that I'm getting a permission to e annoying. I will be sending those reminders next time.
  • Sara: I think actually all the suggestions so far are really good. You should be annoying to us, you should be a squeaky wheel, and we need reminders. And I think having a proposed two weeks because things happen and then especially right now, people are towards the end of the fiscal year, and we're getting ready to migrate. But also this time of year, people are desperately trying to take the days off that they need to take off or they lose them. So then that cuts into your weeks. And so having that extra the two weeks but maybe you could say with the caveat that if you get sufficient responses, whatever number you say that you'll close it early. So if you really want to participate better to participate early, but it will also give everybody time to participate of everybody has crazy schedules. I think also the third thing kind of what you suggested and then actually Bob's response was actually kind of confirming it. I think I know for me, I often feel like I need a little hand holding to begin with. Once I've done it once it's okay. But I still get confused and then that just takes more time and then I get frustrated. I have all these other things, emails and chats and slacks coming at me, and I need to deal with those things. I just don't have time. I can't finish this. And then I back out and I just close. I didn't do this with yours, but this has happened to me with others. Where, I just don't have the mind space to figure everything out. So having that initial together kind of walking through, really baby stepping me through it would be helpful and then I'll feel like, OK I think I get it. I can go do this now.
  • Magda: So we can devote one of our meetings, probably not in two weeks, but at the following meeting, we can make it a user acceptance testing kickoff. And then we do the hand holding, like walking through the steps and what I would like, what type of feedback I would like to get from you. So after that meeting is over, you should feel a bit more comfortable with the app and with my expectation. And then we will start two weeks for the testing period.
  • Magda: The challenge is that this environment is also used for performance testing, but this can be coordinated with the team.
  • Jennifer: I just wanted to, um, agree with what's been said so far, please be annoying. The Five Colleges is migrating next month. So our attention span is, I don't think I have an attention span anymore, but anyway, frequent reminders and just having that extra week to fill in that survey would be really nice. I'd appreciate a little more guidance. And I was wondering if we could maybe use a lab as well as a place to come together and test and work on some of these steps step-by-step things as well. I know many of us are in lab.
  • Magda: So you're talking about the Thursday lab. This is a great idea. The more the merrier, and I'm not sure everybody that is on this group will be able to to make it. I know I will not be able to make it this week, but I can do this following week. But I like the idea we can do that too. I definitely cannot attend those meetings.
  • Magda: Thank you for the feedback.
  • Sara: I can snatch moments, right? I can snatch and fit in 10 minutes here, 10 minutes there maybe. There is no way to save your survey adn come back easily or. That is a huge problem.
  • Magda: This is a very good feedback.
  • Magda: I think the whole user acceptance testing for for this should not take you more than 10 minutes altogether, assuming that you are familiar with with the app.
  • Magda: And I think what I would like this application to be be simple. So you don't need to spend hours to figure it out  and make it like really simple to figure out the things that you can do. I think we succeeded with the data export to make it pretty straightforward to use, and I would like bulk to be the same. But also to give you the flexibility as well, and that's why we have both the  in-app approach and CSV approach, one is simple and quick and the other one is in more involving but it's also more powerful. Thank you very much. This was awesome feedback.
Are you sure? form: selected vs. affected records
  • Magda: And I would like to move to the affected versus, um, selected records.
  • Magda: So here's the example of the records that we plan to update. We have three records and two of them have ORWIG ETHNO CD, and one that has Annex.


Image Added

  • Magda: On the in-app edit fom, we select that we would like to change the permanent location to Annex.

Image Added

  • Magda: Then when we go to the "are you sure" form, we see only two records instead of three, because only two will be changed. So those are the affected records. And this is what you see on the form. So you see here two records because only the two records will be changed. And the preview has only two records. And when you click down on download preview, it shows the only two records. And my question to you is, is this intuitive, or would you expect to see three records records on the screen. What would be the most intuitive behavior for you?

Image Added

  • Sara: I'm sorry that I misunderstood earlier, Bob and Donald, about the Check marks. I didn't realize that we're not saying change permanent location from this to this, we're actually saying change that location to this. And so if my permanent, I cannot control which ones are being changed and your case is not the one that's not being changed because it is already permanent location. Then I totally agree with Donald and Bob that we have to be able to control for that. Because when you have thousands of records, you need to know that you're not changing things that are not what you intend, and this is a little bit different, but it's the same it's related because there's match and affected. And so right now, the three records that you brought back, what did they match on? They matched on something. They got selected off of something that is not the thing that you're changing because otherwise the annex one wouldn't be there.
  • Magda: So you go the list of the barcodes. This is how how this bug edit started. So let's say you got a list of the barcodes from circulation that was scanned. You uploaded it and you see the records. But you know, in my example it is prominent. It's visible because the first record is annexed. But in reality, if you have hundreds of records and the one that is already matching the new location may be further down in the the list and you will not see it on the previous screen. So from what you're saying, the behavior that we implemented that on the screen is not intuitive and needs to be changed?
  • Bob: I think it would be better to have something, either the message up there that says one record won't be changed for whatever reason, or to have an additional, in this case an additional row that has some sort of distinct look to it in some way, showing that it's not going to be changed, maybe red, you know, or a message in one of the columns telling you why it was excluded.
  • Sara: If you have quantity, as soon as we have a thousand records with five not there, how do you locate them? How do you know why they didn't change. It could be different reasons.
  • Kimie: Magda after you submit this saving close modal and it's submitted, doesn't the next screen you come to also have like an error accordion that tells you which ones couldn't be changed?
  • Magda: But this is not an error because we are not even attempting to record. Okay.
  • Kimie: So maybe it's a different accordion.
  • Magda: Yeah, it is.
  • Kimie: Yeah. So maybe there's an additional accordion that says these things couldn't be changed. So you have errors, plus you have something else. So let me try to swim.
  • Sara: It sounds like in all reality, you could have both right. There could be two error. two could be errors and three could be, well, they were already annex. And so they didn't change.
  • Magda: So from what you're saying, we could change the label from "Errors" (in the screen below) and instead of make it  "notifications" and list here the records that were not affected because the data was already there.

Image Added

  • Kimie: That or may an additional bar. Isn't the thing that's happening different than just an error? It's not quite an error.
  • Magda: Yeah, exactly. So that's why I suggest to rename this as errors and notifications.
  • Christie: In data import we use discarded for the records where there's no error, but no action was taken because it didn't meet the criteria for the import. So I just wanted to throw that out there as potential language for describing this category.
  • Magda: Discarded is not not, I think, applicable for bulk edit because we are not discarding. In our case, we are just not modifying the record not discarding it.
  • Magda: We are on like one minute left. We will definitely come back to this conversation to get how we can handle the options that I heard today.
    • One of them was information on the "are your sure" form stating that some of the records will not be affected.
    • The other one is to add notification on the confirmation screen.
    • And, the third option would be instead of showing the only the affected records on the "affected records" screen, you will see all of them on the form. So, in our example, you will still see three records, showing records if there are affected or not.
  • Sara: If on this screen the system knows these are the records that will be acted on, can we have a next button that we click to get a list of the records that will not be acted on?
  • Magda: Okay. That's also very good feedback. I think we are on top of the hour. Thank you so much for the great feedback as always good luck with everything else you have besides bulk edits, and I'll see you in two weeks. Bye-bye.


Permissions to Export Manager for accessing files with user records (UIBULKED-70)
Triggering Bulk Edit by CQL file (as in Data Export)

...