EBMS Tickets

Issue Number 232
Summary [Literature] FYI Citations
Created 2014-07-30 16:52:38
Issue Type Improvement
Submitted By Juthe, Robin (NIH/NCI) [E]
Assigned To Kline, Bob (NIH/NCI) [C]
Status Closed
Resolved 2016-01-13 11:51:21
Resolution Fixed
Path /home/bkline/backups/jira/oceebms/issue.135734
Description

We need to determine a better way to track FYI articles. With the new ability to create FYI packets for approved citations in release 3.0, the "flag for FYI" option no longer carries the same meaning. We have to "pass" citations that we want to send as FYIs in order to make them available to us on the create packets page. I'm putting in this issue as a placeholder for now; we'll refine requirements once we've had a chance to work with the new FYI packets and discuss this further.

Comment entered 2015-11-04 16:33:06 by Juthe, Robin (NIH/NCI) [E]

We discussed this issue a bit today and came up with potential solution for handling FYIs that would be worth investigating (and getting a story point estimate for).

We propose using the Flagged for FYI option to identify FYI articles. The advantage to doing this is that we are consistent with what has been done historically and we can easily identify the articles as FYIs (on the search page and on the full citation page). However, rather than have these FYI-flagged articles be "dead in the water", we would display them on the Create Packets page and allow them to be included in a packet.

On the Create Packets page, we would have two separate sections - one for approved articles (which lists the same articles that currently appear on the page for each topic) and a second section for FYI articles (where each of the articles that have been flagged for FYI but haven't yet been included in a packet for that topic would display). We would then create a packet for the approved articles as we do now and we would create a second packet for the FYI articles, which would display on the Board members' FYI Packets page.

Comment entered 2015-11-10 16:35:27 by alan

I'm thinking we may also need modifications to the printing program to handle packets with a different summary page and response sheet, or no response sheet.

Comment entered 2015-11-12 10:03:14 by Kline, Bob (NIH/NCI) [C]

Since FYI packets don't have rows in the packet reviewer table, these packets aren't printed.

Comment entered 2015-12-04 09:13:52 by Kline, Bob (NIH/NCI) [C]

: are there any additional refinements needed for this request?

Comment entered 2015-12-04 09:18:22 by Juthe, Robin (NIH/NCI) [E]

This one needs discussion with the other Board managers to determine if we want to implement it at this time. Please hold off until I get a chance to run this past the group. Thanks.

Comment entered 2015-12-09 18:02:36 by Juthe, Robin (NIH/NCI) [E]

We discussed this some more today and we are considering a different approach that I'll summarize below. Our preference would be to include FYI articles within an assigned packet rather than have them on the FYI packets page, so we would be removing the FYI packets page. (One of the reasons for combining FYI articles and assigned articles is to allow editorials/commentaries to be sent as FYIs but still keep them alongside their associated article.) This isn't ready to be implemented, but if you see any red flags or have any suggestions, let us know!

1. Use "Flagged for FYI" option to identify FYIs (including editorial articles).
2. Display FYI articles on the Create Packets page (perhaps in their own section) and allow them to be included in a packet together with assigned articles.
3. Need to determine how the assigned packet would display - i.e., would FYI articles be mixed in with assigned articles, or would they appear at the bottom of the page? FYI articles would not have REVIEW buttons.
4. Need to determine how a packet that contained only FYI articles would move from the Assigned Packets page to the Completed Packets page. (We would no longer have the FYI Packets page.)
5. Add a new display option to the create packet page to allow for the list of reviewers to be expanded for each article. The default would be to choose reviewers for the entire packet (as we do now), but this would allow flexibility in selecting reviewers for each article.

Thanks. Sorry to change gears. This one might stay in the backlog for a bit while we iron out what we want, but I just wanted to keep you in the loop as to what we are considering.

Comment entered 2015-12-09 18:03:19 by Juthe, Robin (NIH/NCI) [E]

Adding Victoria.

Comment entered 2015-12-17 09:22:48 by Juthe, Robin (NIH/NCI) [E]

We discussed this yesterday and all of the Board managers have agreed on the most recent proposed approach (above, Dec 9 comment). For #3, we would like to have the FYIs display beneath the assigned articles (and above reviewer uploads). Please replace the REVIEW button with FYI (in red) beside these articles.

#4 still needs to be worked out. Please let me know once you've had a chance to review the proposed approach and we can discuss potential solutions for when to move these packets to the completed page.

Thank you!

Comment entered 2015-12-22 13:53:03 by Juthe, Robin (NIH/NCI) [E]

Just wanted to add a comment to recap some of our conversations surrounding this issue. (Bob, please add to this and/or correct me if I got anything wrong.)

The new proposal for handling FYIs is much more complicated - Bob has adjusted the LOE to 60 story points. The most challenging part (as I understand it) is the idea of associating Board member reviewers to articles on an article basis as opposed to a packet basis. There are 29 places in the system that rely on the reviewer-packet relationship that would be broken by this enhancement. Another sticking point is determining how a packet containing only FYI articles would move from the "Assigned Packets" page to the "Completed Packets" page.

We are considering other potential solutions, but this needs discussion with all of the Board managers, which won't be feasible until after Jan 4.

One possibility is to allow citations given the "Flag for FYI" decision to display on the Create packet page and be included in a packet together with assigned articles. Packets containing ONLY FYI articles would be displayed on the FYI Packets page.

Comment entered 2016-01-05 16:22:57 by Juthe, Robin (NIH/NCI) [E]

We just discussed this issue as a group and came up with the following scaled-back approach for FYIs that will still help us greatly in managing these articles.

1. Use the "Flagged for FYI" option to identify FYI articles.

2. Display "Flagged for FYI" articles on the Create Packets page in a separate section beneath the assigned articles.

3. Allow for the inclusion of FYI articles in a packet together with assigned articles. FYI articles should appear beneath the assigned articles on the packet page a Board member sees, with the word "FYI" in red beside the article in place of the REVIEW button. When the last assigned article in such a packet is reviewed, the packet would move to the Completed Packets page (as it does now).

4. Packets that are comprised ONLY of FYI articles would appear on the FYI packets page. Board members would continue to see any packets for their topics to which he/she is not assigned to review on the FYI packets page (as happens now).

Bob, could you please adjust the story point estimate for this approach (if you think this seems reasonable)? Please let me know if you have any questions or see any problems with this approach. Thank you!

Comment entered 2016-01-12 19:38:34 by Kline, Bob (NIH/NCI) [C]

Story points dropped to 20, which should be enough if the requirements don't wiggle around. :-)

Comment entered 2016-01-13 11:12:06 by Kline, Bob (NIH/NCI) [C]

✔ use the "Flagged for FYI" option to identify FYI articles
✔ display "Flagged for FYI" articles on the Create Packets page in a separate section beneath the assigned articles
✔ allow for the inclusion of FYI articles in a packet together with assigned articles
✔ ignore FYI articles when determining packet completion
✔ packets that are comprised ONLY of FYI articles appear on the FYI packets page
✔ board members continue to see packets for their topics to which they are not assigned to review on the FYI packets page
✔ FYI articles should appear beneath the assigned articles on the packet page a Board member sees, with the word "FYI" in red beside the article in place of the REVIEW button

Comment entered 2016-01-13 11:51:21 by Kline, Bob (NIH/NCI) [C]

Implemented on DEV.

Comment entered 2016-01-20 17:37:39 by Juthe, Robin (NIH/NCI) [E]

This is looking pretty good on DEV, but I noticed that the FYI Packets page is not sorting correctly by date or by packet name.

Comment entered 2016-01-21 08:27:48 by Kline, Bob (NIH/NCI) [C]

Good catch! Sorting bugs fixed.

Comment entered 2016-01-29 10:44:55 by Shields, Victoria (NIH/NCI) [E]

While QCing this issue (on the new QA-SG site), we realized we can't upload articles on the full citation page. You can browse and select an article, but when you try to save it, you get error messages:

File upload error. Could not move uploaded file.
Unable to upload 8e-levine jco 2013 23169503.pdf

Comment entered 2016-01-29 11:08:50 by Kline, Bob (NIH/NCI) [C]

File system permissions had not been configured correctly. Problem fixed, I think. Please try again.

Comment entered 2016-01-29 12:15:07 by Shields, Victoria (NIH/NCI) [E]

Yep, we're back in business! Thanks!

Comment entered 2016-01-29 15:52:31 by Shields, Victoria (NIH/NCI) [E]

Sharon created a packet with just FYI citations and when she saved it, she got this error message:

Notice: Undefined index: articles in pdq_ebms_edit_packet_form_submit() (line 4665 of /local/drupal/sites/ebms.nci.nih.gov/modules/custom/ebms/review.inc)

The packet was created, and it was in the queue for Test Board Member2 to review. I was able to recreate the problem and got the exact same error message one time. However, after trying different scenarios to see what combination of articles (all FYI or FYI and regular review articles) causes the errors, I am no longer getting the error for an all FYI packet. Is it possible that something was interrupting the site earlier? I'm wondering if I should keep trying to create a packet that will duplicate the error. Thanks.

Comment entered 2016-01-29 17:02:40 by Kline, Bob (NIH/NCI) [C]

Just checking – this is something that worked correctly on DEV, but not on QA?

Comment entered 2016-01-29 17:06:58 by Shields, Victoria (NIH/NCI) [E]

Sorry, I couldn't say for sure. I know we looked at this on DEV (see comment from Jan 20--we met that day to review the issues), but I don't remember if the packet that was created had just FYI articles or a combination.

Comment entered 2016-01-29 17:13:51 by Kline, Bob (NIH/NCI) [C]

Doesn't look like it would have worked on DEV, either. Could you try it on DEV, and if that works, I'll promote to the new QA.

Thanks!

Comment entered 2016-01-29 17:22:02 by Shields, Victoria (NIH/NCI) [E]

On DEV, none of the pages under the LITERATURE PACKETS tab are there.

And just to be clear... Sharon and I only saw the error message once. I haven't been able to recreate the error again. (I said that before, but wanted to make sure it didn't get lost in the rest of the message.)

Comment entered 2016-01-29 17:28:14 by Kline, Bob (NIH/NCI) [C]

The CBIIT servers are doing their late Friday afternoon walkabout - very slow (and sometimes whacky) responses. If I can I'll take a look over the weekend when things are back to normal. Otherwise I'll have to investigate Monday morning.

Comment entered 2016-01-29 17:35:48 by Shields, Victoria (NIH/NCI) [E]

Understood.

But... I did finally recreate the problem a few times using Chrome. (The first time, i was using Firefox, and haven't been able to re-create it there.) It only happens when ALL of the papers in the packet are FYI. If I unselect the non-FYI articles and send just the FYI articles, the error doesn't happen. So I had to create a packet that only had FYI articles to get the error.

However, while doing this, I uploaded a few packets that were just "regular review" articles (to get them out of the queue so I could create a new FYI-only packet) and I got an error message when I posted these packets:

Notice: Undefined index: fyi-articles in pdq_ebms_edit_packet_form_submit() (line 4668 of /local/drupal/sites/ebms.nci.nih.gov/modules/custom/ebms/review.inc).

I'm not getting either error message using Firefox.

Comment entered 2016-02-01 11:43:47 by Kline, Bob (NIH/NCI) [C]

On DEV, none of the pages under the LITERATURE PACKETS tab are there.

Not sure what you mean by this. Can you elaborate?

Comment entered 2016-02-01 11:48:23 by Shields, Victoria (NIH/NCI) [E]

You had asked me to see if this worked on DEV (comment from 5:13 on Friday) but when I logged into DEV, none of the pages under the LITERATURE PACKETS tab were there. They were all blank, so I couldn't test this.

Comment entered 2016-02-01 12:21:34 by Kline, Bob (NIH/NCI) [C]

Do you mean when you hover over the LITERATURE PACKETS menu you don't get the dropdown with Create Packet on it (among other options)? Here's what I see (on ebms-dev):

Can you attach a screenshot of what you're seeing?

Thanks!

Comment entered 2016-02-01 12:26:51 by Shields, Victoria (NIH/NCI) [E]

It's back now. Something weird must have been happening Friday.

Do you still want me to test the FYI packets on DEV?

Comment entered 2016-02-01 12:32:26 by Kline, Bob (NIH/NCI) [C]

Yes, please.

Comment entered 2016-02-01 13:06:59 by Shields, Victoria (NIH/NCI) [E]

It is not happening on DEV. It is still happening on the QA SG site. Still seems to be only when a packet containing only FYI articles is posted.

Comment entered 2016-02-01 13:51:07 by Kline, Bob (NIH/NCI) [C]

I think QA SG is working correctly now. Can you confirm?

Thanks.

Comment entered 2016-02-01 13:57:19 by Shields, Victoria (NIH/NCI) [E]

Yes, this is working correctly now on QA SG, with no errors. Thanks!!

Comment entered 2016-02-01 16:32:55 by Juthe, Robin (NIH/NCI) [E]

With our new FYI enhancements, it appears all of the articles we have flagged as an FYI since 2013 (and have presumably shared with our Boards via email since we couldn’t share them via the EBMS) are now appearing on the Create Packet page and are eligible to be included in a packet. Would it be possible to make this change to FYIs effective from this point forward rather than retroactive, so that we don’t see all of those FYI articles that we have presumably already dealt with?

Comment entered 2016-02-02 07:58:12 by Kline, Bob (NIH/NCI) [C]

If I can figure out how to do that, what should the cutoff date be?

Comment entered 2016-02-02 09:21:49 by Juthe, Robin (NIH/NCI) [E]

February 1 should be fine. Thanks, Bob.

Comment entered 2016-02-02 11:32:19 by Kline, Bob (NIH/NCI) [C]

Changed requirement implemented and installed on DEV and QA-SG.

Comment entered 2016-02-03 16:21:54 by Juthe, Robin (NIH/NCI) [E]

Sorry - I missed this yesterday. The FYI citations are no longer appearing on that page, which is great, but the topics that have old FYIs still show up and the number in parentheses after the topic name includes those old FYI articles. For example, on QA-SG, if you go to the Create Packet page and select Cancer Genetics, you'll see that there are 7 articles for the Cancer Genetics Overview topic. Yet, when you click on that topic there are no articles (because they are old FYIs that are now suppressed).

Comment entered 2016-02-03 16:51:26 by Kline, Bob (NIH/NCI) [C]

I think it's working OK now. Please check.

Comment entered 2016-02-03 17:43:10 by Juthe, Robin (NIH/NCI) [E]

This looks great! Thank you! Verified on QA-SG.

Comment entered 2016-04-06 15:51:44 by Juthe, Robin (NIH/NCI) [E]

Verified on PROD.

Comment entered 2017-06-09 10:08:27 by Kline, Bob (NIH/NCI) [C]

Decision to save FYI articles for the end of a user's packet page rescinded by OCEEBMS-436.

Comment entered 2022-09-06 09:29:14 by Burns, Kevin (NIH/NCI) [C]

testing comment

Comment entered 2022-09-06 09:43:42 by Solie, Chuck (NIH/NCI) [C]

testing comment too

Comment entered 2022-09-07 12:28:58 by Solie, Chuck (NIH/NCI) [C]

testing threaded comment by replying to

Attachments
File Name Posted User
2016-02-01 12_17_07-EBMS.jpg 2016-02-01 12:18:10 Kline, Bob (NIH/NCI) [C]

Elapsed: 0:00:00.001207