Document Tagging - Identical reference issue
Morgan
In UAT we have come across another issue we'd like your input on.
SCENARIO - Task: Analysis Data Capture
An admin is analyzing a document and selects a piece of text to tag for the jurisprudence Citator and saves reference:
- Cited Document UIN: OT/0001/01
- Type of Citation: Paragraph(s)
- Paragraph Reference(s) in Cited Document: 1
- Paragraph(s) of Document Referenced: Excerpt from: pa1
Admin continues analysis and selects another piece of text for the Jurisprudence Citator. The reference is identical except for the portion of text being tagged:
- Cited Document UIN: OT/0001/01
- Type of Citation: Paragraph(s)
- Paragraph Reference(s) in Cited Document: 1
- Paragraph(s) of Document Referenced: Excerpt from: pa7
Issue:
Because the tag is referencing the same dispute document and paragraph, it will be merged into a single reference. This in itself is not an issue as this is expected for the Jurisprudence Citator, however, within the document currently the second part of the reference (Excerpt from: pa7) is not being highlighted.
We have discussed this with DevIT and explained that all parts of the reference must appear highlighted within the document. The technical limitation is that two separate 'excerpts' (ie: created via the selection of text) cannot be combined in this way.
It seems the solution to this is that, once added the second part of the reference (Excerpt from: pa7) is saved as full paragraph(s) rather than an excerpt from. This means only the initial selection for the reference can be an excerpt and any subsequent references within the document to the same doc + paragraph will tag/highlight full paragraphs.
Please let me know your thoughts or if you'd like to discuss further.
Mel
This isn't ideal. Question: how does this function in the other tools (Subject Navigator, Article Citator, Publication Citator and Terms & Phrases).
For example with the Subject Navigator:
Parent Branch Name: [A] > [Oldest ancestor] > ... > [director parent] > [selected]
Branch Text: Branch ABC
Paragraph(s) of Document Referenced: Excerpt from: pa1
and then
Parent Branch Name: [A] > [Oldest ancestor] > ... > [director parent] > [selected]
Branch Text: Branch ABC
Paragraph(s) of Document Referenced: Excerpt from: pa7
Because the two references are referring to the same branch, the references are merged into:
Parent Branch Name: [A] > [Oldest ancestor] > ... > [director parent] > [selected]
Branch Text: Branch ABC
Paragraph(s) of Document Referenced: Excerpts from: pa1 and pa7
Would the excerpts from pa7 be maintained, or would it only capture the entire paragraph?
Another example with the Article Citator:
Legal Instrument UIN: OT/0006
Article/Provision: Article 25
Paragraph(s) of Document Referenced: Excerpt from: pa1
and then
Legal Instrument UIN: OT/0006
Article/Provision: Article 25
Paragraph(s) of Document Referenced: Excerpt from: pa7
Because the two references are referring to the same legal instrument and provision, the references are merged into:
Legal Instrument UIN: OT/0006
Article/Provision: Article 25
Paragraph(s) of Document Referenced: Excerpts from: pa1 and pa7
Would the excerpts from pa7 be maintained, or would it only capture the entire paragraph?
Another example with the Publication Citator:
Publication UIN: PU/0006
Type of Citation: Page(s)
Paragraph Reference(s) in Cited Document: 1
Paragraph(s) of Document Referenced: Excerpt from: pa1
and then
Publication UIN: PU/0006
Type of Citation: Page(s)
Paragraph Reference(s) in Cited Document: 1
Paragraph(s) of Document Referenced: Excerpt from: pa1
Because the two references are referring to the same publication and page, the references are merged into:
Publication UIN: PU/0006
Type of Citation: Page(s)
Paragraph Reference(s) in Cited Document: 1
Paragraph(s) of Document Referenced: Excerpts from: pa1 and pa7
Would the excerpts from pa7 be maintained, or would it only capture the entire paragraph?
Another example with the Terms & Phrases:
Terms & Phrases: Term
Legal Instrument: OT/0006
Article/Provision: Article 25
Paragraph(s) of Document Referenced: Excerpt from: pa1
and then
Terms & Phrases: Term
Legal Instrument: OT/0006
Article/Provision: Article 25
Paragraph(s) of Document Referenced: Excerpt from: pa7
Because the two references are referring to the same term, legal instrument and provision, the references are merged into:
Terms & Phrases: Term
Legal Instrument: OT/0006
Article/Provision: Article 25
Paragraph(s) of Document Referenced: Excerpts from: pa1 and pa7
Would the excerpts from pa7 be maintained, or would it only capture the entire paragraph?
My point is that if this isn't occurring in other tools, why would this be a problem limited to the Jurisprudence Citator?
Thanks,
Morgan
Yes, this is happening for all tools. The Jurisprudence Citator was just an example to illustrate the issue.
I all cases, the entire paragraph would be captured.
Mel
We need to come up with a fix for this. It defeats the whole purpose of creating excerpts. Let's discuss during tomorrow's call. I'll add it to the agenda.
Thanks,
Morgan
We have one question. Please provide your feedback.
Suppose, user will add one tag with "Excerpt 1". Then after, user will edit same tag and add manually same paragraph (e.x Pa1) then what will do ?
As per our technically, we should remove "Excerpt pa1" and keep it whole Pa1 as highlited.
If user will do same thing with another tag (ex. Excerpt Pa2) then it will work.
Is It OK ?
That's correct, but let me provide a couple more examples to further clarify things:
Existing references: ExcerptPa1, ExcerptPa2
User decides to manually add Pa3, which will result in the following:
ExcerptPa1, ExcerptPa2, WholePa3
User decides to deleted ExcerptPa2 and then manually add Pa2, which will results in the following:
ExcerptPa1, WholePa2, WholePa3
In both examples above, unless the user deletes an excerpt and then replaces it with a manual reference, the added manual references does not affect existing excerpts.
Thanks,
Morgan
Where this gets tricky is if a using has an existing reference: ExcerptPa1 then manually adds Pa1 (whole).
Within the tree this would appear as two identical pinpoint references.
Mel
Yes, that's fine. If the user manually adds Pa1 when excerpt Pa1 already exists, it would replace the excerpt with the whole paragraph.
Thanks,
Morgan
Could either of you provide me with an update on whether the issue above has been resolved.
Thanks,
Morgan
We are working on this change and will relase this change in all research tool by 23rd April.
Except following 3 task, we have done with all islg admin stories
Only Following 3 tasks are in progress in islg admin side.
We are planning to relase above 3 tasks by 23rd April.
Morgan
There is no any specific story for this change. The issue was occurred during UAT of Anlyzing/Taggig module.
You can tarck by card no. 14867 (This bug is related to this change).
Morgan