Help

Welcome!

This Vulnerability site is intended to provide summary information that will help the IPD team do whatever it is you do. Right now that is fundamentally the Analyze page.

Recognizing that the team is using the Vulnerability Classification (Master) Google sheet as its master index, Analyze is built to leverage that.

Usage

It's pretty simple. When you click the Analyze link, you'll see:

Only three fields and a button! Pretty simple. And even better, most of the time you're only going to fill in ONE field...

You must fill in EITHER the 'Title' and 'URL' fields, OR the 'Shortcut' field, before clicking the 'Analyze' button at the bottom.

To make this faster, use the 'Shortcut' box. In the Google sheet, copy the entire contents of the 'Title' cell and paste it into the 'Shortcut' box. It will look something like this:

=HYPERLINK("https://database.ich.org/sites/default/files/E6_R2_Addendum.pdf","ICH E6(R2): Good Clinical Practice- Integrated Addendum to E6(R1)")

Then...click the 'Analyze' button below.

At THIS point there is a whole lot going on that you can't see...so don't worry if nothing happens for several seconds. In short, there's a virtual server somewhere in the U.S. with a few thousand lines of code on it that will

So here's an example. Let's look at the "Policy and Procedures on Protection of Human Subjects in EPA Conducted or Supported Research" document in the Vulnerability Classification (Master) sheet (currently row 13 but this will likely change):

Note that when you select the cell, the formula bar shows the entire hyperlink

=HYPERLINK("https://www.usaid.gov/sites/default/files/documents/1864/200mbe.pdf","Policy and Procedures on Protection of Human Subjects in EPA Conducted or Supported Research")

even though what appears in the cell view is just the label component

Policy and Procedures on Protection of Human Subjects in EPA Conducted or Supported Research

Next...nothing may happen for a few seconds, that's normal because a lot is happening in the background. In most cases, in less than 10 seconds you will see the results screen:

(This is the top of the screen that, most of the time, is all you will care about)

First, there are three links to information related to this request:

Second, a useful bit to make it easier to record this info in the Vulnerability Classification (Master) sheet.

The synopsis report starts with a list of all the 'classification' tags that were found in the document, and how many times it found them, with hyperlinks to each tag report section.

Click on any one of the tags to see where it was found and what the surrounding context was (in this case it was the 'job' tag):

Stats

In the results page after you analyze a document, after the links you'll find some additional information; here's an example:

Unusual Situations

Large/Complex Files

When you hit the 'Analyze' button, the server gets busy. And it pays no attention at all to your browser. Browsers in general are needy...like Yorkshire Terriers...and if you don't pay attention to them they will say "piss off!" by disconnecting your session. Most browsers have a 30-second attention span...after that, if you don't talk to them, they disconnect.

If the source file you are processing is big/complex enough, it may take more than 30 seconds to process them. If that looks like it is going to happen, the server will save the state of the work done so far and return control to the browser - with messages revealing what it did, and what you need to do to resume.

If this happens, you will see something like this in the Notices at the bottom of the results page:

Successfully saved the work-in-progress.
ACTION REQUIRED
The file being processed is large/complex that it must be processed in pieces.
The work-in-progress has been saved. Click the 'Back' button on your browser
to return to the 'Analyze' page, then click the 'Analyze' button again to complete the processing.
ACTION REQUIRED
Code execution completed in (some amount of time that is almost 30) seconds.

If you see these messages...do just what it says. Back up to the prior page and hit the 'Analyze' button again. The server will pick right back up where it left off. Note it is possible that you could have to do this more than once.