•  
     
    story #13324 easily associate Document and Artifacts
Summary
Empty
easily associate Document and Artifacts

I can get the best of the two worlds

Overview

The feature is provided is the Document plugin is active.

At this level of implemenation:

  • Only 1 folder (no other types of documents) can be associated with an artifact
  • A folder can be associated with only one artifact
  • Select of the folder is done with done with it's ID

Functional overview

You can checkout a live mock-up to better feel the feature.

Creation / link

The association is meant to be done in the Artifact via an "Action menu" option (mock-up to be done):

With the Following behaviours:

Create new will

  • pop-up a modal window that allow to select a parent folder (within the current project) where the new document will be created
  • then either (to be checked with Dev & UX team)
    • Option 1
      1. redirect to the Document service to proceed to creation of Folder
      2. redirect to the Artifact after creation
    • Option 2
      1. Displays the Folder creation modale within the Aritfact view
      2. and then reload the artifact page

Link with existing will

  • Allow to select a folder in the Document service with folder ID

Display

In Artifact view

When an artifact is linked to a document, the link appears in the tab view as it's done for (file releases ATM).

In Document view

Management of deletions

We need to take into account deletes. With special case of delete in docman that can ce reverted (folder restored).

On delete of folder the link is no longer displayed.

  • if the folder is restored, the link is displayed again
  • if someone links the artifact to another folder while the 1st one is deleted-not-yet-purged, if the deleted-not-yet-purged folder is restored, the link is not restored (the artifact is now attached to a different folder)
  • at document purge, if the folder is still associated to the artifact, the link is purged too.

If the artifact is deleted, the link is purged

Access rights

In order to link an artifact with a folder, a user must have:

  • "canWrite" permission on folder
  • "canAccess" (read) permission to the artifact

XML import/exported

As docmant is not part of standard XML/Import, the link cannot be imported nor exported.

Technical overview

The feature must be provided by a new Plugin (Tuleap Enterprise) that bridges Document & Trackers. This plugin will be responsible of

  • storing the link between one artifact and one folder.
  • providing the REST API to manipulate this link: OPTIONS, GET, POST & DELETE
  • a VueJS app to manage the creation and/or link from artifact view (hook in action menu + in artifact view JS)
  • + 2 VueJS component that should be dynamically loaded by Document app to provide the integration.

The ability for Document app to dynamically load components provided by a 3rd party plugin seems possible according to the spec but a quick spike should be done to ensure it works as expected.

In addition to that, the following views need to be modified to take into account the new tab:

  • Agile Dashboard Milestone details
  • Agile Dashboard Planning
  • Agile Dashboard Cardwall
  • Artifact view
  • FRS release view

Story Split

  1. Link with existing folder with it's ID and display in Artifact view
    1. New entry in action menu
    2. New app to manage the modale & the creation
    3. Manage permission for linking
    4. New tracker_document plugin for storage of the link with 2 routes: POST & DELETE
    5. Display of the link in Artifact view
    6. Management of delete of artifact or folder
  2. Display in Document view
    1. Display the tabs (Document, Artifact, FRS, ...) in Document view (display of tabs might a a builtin feature of docman or dynamic-loaded feature provided by the plugin).
    2. Display the link to artifact (and only artifact) in the folder "Quick View"
    3. Implement GET of link between document & artifact
    4. Display & check permission of tabs in all services (Document, Artifact, FRS, AgileDasbhoard)
    5. Impelement a new GET route to fetch all linked resources.
  3. Link with existing folder with a folder selector
    1. TBD
  4. Link + Create a new folder
    1. TBD
external.Kevin.LAVILLE@jtekt.eu, Benjamin Dauton (bdauton_enalean)
Status
Doc/Documentation manager
Canceled
Development
  • [ ] Does it involves User Interface? 
  • [ ] Are there any mockups?
  • [ ] Are permissions checked?
  • [ ] Does it need Javascript development?
  • [ ] Does it need a forge upgrade bucket?
  • [ ] Does it need to execute things in system events?
  • [ ] Does it impact project creation (templates)?
  • [ ] Is it exploratory?
Empty
Details
#13324
Manuel Vacelet (vaceletm)
2022-05-11 15:40
2019-04-26 10:44
4038

References
Referencing story #13324

Artifact Tracker v5

epic #13846 Document v2

Follow-ups

User avatar

Need never confirmed. Closing


  • Status changed from Ready (stalled) to Canceled
  • Category set to Doc/Documentation manager
User avatar
> how do we display that we have several artifacts associated to the folder (the reverse is true too).
You put an s to “artifact” and you write several line in the "artifacts" window , one line per artifact (like one line for documents), like a tracker report, in case there are several artifacts.
Or you put a drow down list (like the "project" dropdown, listing all artifacts

The reverse: no issue, in the artifact , you just need one document area because only one document area per artifact.

You welcome ;-)

Cheers,
Denis

  • Category set to
User avatar

> A folder can be associated with only one artifact
I don't understand why this limitation. We might have 2 stories + one bug associated to the same document folder.

This limitation was set simplify the integration view. To better frame the problem, imagine mock-up 04-from-docman.png but with several stories, how do we display that we have several artifacts associated to the folder (the reverse is true too).

Technically there are little to no issues, it really an UX thing here.

> Select of the folder is done with done with it's ID
A "copy ID" button in the quick look menu would be welcome because users will have difficulties (like for documents today) to know where is this ID.

Good idea !

We could even imagine that if  a doc copyid was done, it would be pre-selected when doing the doc <-> artifact linking

Since the ID is unique, what if the user choose this doc id from another poject ?
Do you reduce this feature to a single projet ? In term of permission, I think you just don't care, they are set in the docman so if people don't have access they can claim

As of today I'm keen to limit that within a project in order to simplify the first implementation and to solve the multi-project when problem arise. In any case, we need to have it working within the project before extending to multi-project.

 

User avatar
> A folder can be associated with only one artifact
I don't understand why this limitation. We might have 2 stories + one bug associated to the same document folder.

> Select of the folder is done with done with it's ID
A "copy ID" button in the quick look menu would be welcome because users will have difficulties (like for documents today) to know where is this ID.

Since the ID is unique, what if the user choose this doc id from another poject ?
Do you reduce this feature to a single projet ? In term of permission, I think you just don't care, they are set in the docman so if people don't have access they can claim
User avatar
  • Acceptance criteria
    Something went wrong, the follow up content couldn't be loaded
    Only formatting have been changed, you should switch to markup to see the changes
User avatar
  • Acceptance criteria
    Something went wrong, the follow up content couldn't be loaded
    Only formatting have been changed, you should switch to markup to see the changes
User avatar
  • Acceptance criteria
    Something went wrong, the follow up content couldn't be loaded
    Only formatting have been changed, you should switch to markup to see the changes
User avatar
  • Acceptance criteria
    Something went wrong, the follow up content couldn't be loaded
    Only formatting have been changed, you should switch to markup to see the changes
User avatar