Copyright © Xerox Corporation, Codendi Team, 2001-2006. All Rights Reserved

3.2 Fonctions des trackers

3.2.1 trackerlist

trackerlist : Affiche la liste des trackers d'un projet (sans la structure des trackers).

La structure des trackers n'est plus retournée par cette fonction. Si vous souhaitez obtenir la structure de tous les trackers d'un projet, veuillez désormais utiliser la fonction "trackers" (Section 3.2.2).

  • --project: nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker trackerlist --project=project1
+-------------------+----------+------------------+----------------------------------------------------...
| group_artifact_id | group_id |       name       |                         description                ...
+-------------------+----------+------------------+----------------------------------------------------...
| 116               | 104      | Bugs             | Bugs Tracker                                       ...
| 119               | 104      | Salome Bug       | Salome Bug Tracker                                 ...
| 120               | 104      | Scrum Backlog    | Scrum backlog used to store user stories and to pla...
| 118               | 104      | Support Requests | Support Requests Tracker                           ...
| 117               | 104      | Tasks            | Tasks Tracker                                      ...
+-------------------+----------+------------------+----------------------------------------------------...

[1]:
+-----------+-------------------+---------+------------------------------------+-------+
| report_id | group_artifact_id |  name   |            description             | scope |
+-----------+-------------------+---------+------------------------------------+-------+
| 116       | 116               | Bugs    | Bugs Report                        | P     |
| 100       | 116               | Default | The system default artifact report | S     |
+-----------+-------------------+---------+------------------------------------+-------+

[2]:
+-----------+-------------------+-------------+------------------------------------+-------+
| report_id | group_artifact_id |    name     |            description             | scope |
+-----------+-------------------+-------------+------------------------------------+-------+
| 119       | 119               | Salome Bugs | Salome Bugs Report                 | P     |
| 100       | 119               | Default     | The system default artifact report | S     |
+-----------+-------------------+-------------+------------------------------------+-------+

[3]:
+-----------+-------------------+---------+------------------------------------+-------+
| report_id | group_artifact_id |  name   |            description             | scope |
+-----------+-------------------+---------+------------------------------------+-------+
| 120       | 120               | Scrum   | Scrum Report                       | P     |
| 100       | 120               | Default | The system default artifact report | S     |
+-----------+-------------------+---------+------------------------------------+-------+

[4]:
+-----------+-------------------+---------+------------------------------------+-------+
| report_id | group_artifact_id |  name   |            description             | scope |
+-----------+-------------------+---------+------------------------------------+-------+
| 118       | 118               | SR      | Support Requests Report            | P     |
| 100       | 118               | Default | The system default artifact report | S     |
+-----------+-------------------+---------+------------------------------------+-------+

[5]:
+-----------+-------------------+---------+------------------------------------+-------+
| report_id | group_artifact_id |  name   |            description             | scope |
+-----------+-------------------+---------+------------------------------------+-------+
| 117       | 117               | Tasks   | Tasks Report                       | P     |
| 100       | 117               | Default | The system default artifact report | S     |
+-----------+-------------------+---------+------------------------------------+-------+
                        

Exemple 5. commande trackerlist

3.2.2 trackers

trackers : Affiche la liste des trackers d'un projet (avec leur structure).

Comme cette fonction retourne toute la structure de tous les trackers d'un projet, il se peut qu'elle devienne un peu lente avec des projets contenant beaucoup de trackers. Le cas échéant, vous pouvez utiliser la fonction "trackerlist", (voir Section 3.2.1) suivie de la fonction "tracker" (Section 3.2.3) pour obtenir la structure du tracker souhaité.

  • --project: nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker trackers --project=project1
+-------------------+----------+------------------+----------------------------------------------------...
| group_artifact_id | group_id |       name       |                         description                ...
+-------------------+----------+------------------+----------------------------------------------------...
| 116               | 104      | Bugs             | Bugs Tracker                                       ...
| 119               | 104      | Salome Bug       | Salome Bug Tracker                                 ...
| 120               | 104      | Scrum Backlog    | Scrum backlog used to store user stories and to pla...
| 118               | 104      | Support Requests | Support Requests Tracker                           ...
| 117               | 104      | Tasks            | Tasks Tracker                                      ...
+-------------------+----------+------------------+----------------------------------------------------...
[13]:
+----------+-------------------+----------+-------+-------------+----------+--------+
| field_id | group_artifact_id | value_id | value | description | order_id | status |
+----------+-------------------+----------+-------+-------------+----------+--------+
| 10       | 116               | 100      | None  |             | 10       | P      |
+----------+-------------------+----------+-------+-------------+----------+--------+

[14]:
+----------+-------------------+----------+-------+-------------+----------+--------+
| field_id | group_artifact_id | value_id | value | description | order_id | status |
+----------+-------------------+----------+-------+-------------+----------+--------+
| 7        | 116               | 103      | ounis |             | 0        |        |
| 7        | 116               | 100      | None  |             | 10       | P      |
+----------+-------------------+----------+-------+-------------+----------+--------+

[15]:
No results
(... liste des trackers, des field sets et des fields ...)
                        

Exemple 6. commande trackers

3.2.3 tracker

tracker : Affiche la structure d'un tracker.

  • --tracker_id* : ID du tracker.

  • --project: nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker tracker --project=project1 --tracker_id=116
+-------------------+----------+------+--------------+-----------+------------+-------------+----------...
| group_artifact_id | group_id | name | description  | item_name | open_count | total_count | total_fil...
+-------------------+----------+------+--------------+-----------+------------+-------------+----------...
| 116               | 104      | Bugs | Bugs Tracker | bug       | -1         | 1           | 0        ...
+-------------------+----------+------+--------------+-----------+------------+-------------+----------...
[1]:
+--------------+-------------------+-------------------------------+---------+-------------------------...
| field_set_id | group_artifact_id |             name              |  label  |          description    ...
+--------------+-------------------+-------------------------------+---------+-------------------------...
| 49           | 116               | fieldset_default_bugs_lbl_key | Details | fieldset_default_bugs_de...
| 50           | 116               | fieldset_status_bugs_lbl_key  | Status  | fieldset_status_bugs_des...
+--------------+-------------------+-------------------------------+---------+-------------------------...
(... liste des des field sets et des fields ...)
                        

Exemple 7. commande tracker

3.2.4 list

list: Affiche la liste des artefacts appartenant au tracker spécifié.

  • --tracker_id* : ID du tracker.

  • --limit: Nombre maximum d'artefacts retournés.

  • --offset: Nombre d'artefacts qui seront "sautés" (ce paramètre ne peut pas être utilisé seul, il doit être accompagné du paramètre limit).

  • --[nom du champ][opérateur][valeur]: critère de filtre pour les artefacts retournés. Fonctionne avec les champs standards et les champs utilisateurs.

    Exemple : "--open_date>2006-05-21" --assigned_to=135 --status_id=0.

    Les opérateurs autorisés sont >, >=, =, <, <=, <>.

  • --project: nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker list --tracker_id=116
+------------------------+-----------+
| total_artifacts_number | artifacts |
+------------------------+-----------+
| 1                      | [1]       |
+------------------------+-----------+

[1]:
+-------------+-------------------+-----------+--------------+------------+------------+---------------...
| artifact_id | group_artifact_id | status_id | submitted_by | open_date  | close_date | last_update_da...
+-------------+-------------------+-----------+--------------+------------+------------+---------------...
| 2           | 116               | 3         | 103          | 1289480620 | 1291276352 | 1291276353    ...
+-------------+-------------------+-----------+--------------+------------+------------+---------------...

[1]:
+----------+-------------+-------------+
| field_id | artifact_id | field_value |
+----------+-------------+-------------+
| 3        | 2           | 100         |
| 4        | 2           | 100         |
| 16       | 2           | 100         |
| 20       | 2           | 100         |
+----------+-------------+-------------+
                    

Exemple 8. commande list

3.2.5 reportlist

reportlist: Affiche la liste des artefacts appartenant au tracker spécifié, selon le rapport spécifié.

  • --tracker_id* : ID du tracker.

  • --limit: Nombre maximum d'artefacts retournés.

  • --offset: Nombre d'artefacts qui seront "sautés" (ce paramètre ne peut pas être utilisé seul, il doit être accompagné du paramètre limit).

  • --[nom du champ][opérateur][valeur]: critère de filtre pour les artefacts retournés. Fonctionne avec les champs standards et les champs utilisateurs.

    Exemple : "--open_date>2006-05-21" --assigned_to=135 --status_id=0.

    Les opérateurs autorisés sont >, >=, =, <, <=, <>.

  • --sort={[nom du champ] [direction du tri]}*: critère de tri pour classer les artefacts retournés. Fonctionne avec les champs standards et les champs utilisateurs.

    Exemple : --sort="severity DESC, open_date DESC, artifact_id ASC".

    Les directions autorisées sont ASC (ascendant) et DESC (descendant).

  • --project: nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker reportlist --tracker_id=116
+------------------------+-----------+
| total_artifacts_number | artifacts |
+------------------------+-----------+
| 1                      | [1]       |
+------------------------+-----------+

[1]:
+-------------+----------+--------+
| artifact_id | severity | fields |
+-------------+----------+--------+
| 2           | 5        | [1]    |
+-------------+----------+--------+

[1]:
+--------------+---------------+
|  field_name  |  field_value  |
+--------------+---------------+
| artifact_id  | 2             |
| summary      | bug           |
| open_date    | 1289480620    |
| assigned_to  | None          |
| submitted_by | ounis         |
+--------------+---------------+
                    

Exemple 9. commande reportlist

3.2.6 reports

reports: Affiche tous les rapports d'un tracker donné.

  • --tracker_id* : ID du tracker.

  • --project : nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker reports --tracker_id=116
+-----------+-------------------+---------+------------------------------------+-------+--------+
| report_id | group_artifact_id |  name   |            description             | scope | fields |
+-----------+-------------------+---------+------------------------------------+-------+--------+
| 116       | 116               | Bugs    | Bugs Report                        | P     | [1]    |
| 100       | 116               | Default | The system default artifact report | S     | [2]    |
+-----------+-------------------+---------+------------------------------------+-------+--------+

[1]:
+-----------+--------------+---------------+----------------+-------------+--------------+-----------+
| report_id |  field_name  | show_on_query | show_on_result | place_query | place_result | col_width |
+-----------+--------------+---------------+----------------+-------------+--------------+-----------+
| 116       | status_id    | 1             | 0              | 40          | 0            | 0         |
| 116       | bug_group_id | 1             | 0              | 20          | 0            | 0         |
| 116       | category_id  | 1             | 0              | 10          | 0            | 0         |
| 116       | artifact_id  | 0             | 1              | 0           | 10           | 0         |
| 116       | summary      | 0             | 1              | 0           | 20           | 0         |
| 116       | open_date    | 0             | 1              | 0           | 30           | 0         |
| 116       | assigned_to  | 1             | 1              | 30          | 40           | 0         |
| 116       | submitted_by | 0             | 1              | 0           | 50           | 0         |
+-----------+--------------+---------------+----------------+-------------+--------------+-----------+

[2]:
+-----------+--------------+---------------+----------------+-------------+--------------+-----------+
| report_id |  field_name  | show_on_query | show_on_result | place_query | place_result | col_width |
+-----------+--------------+---------------+----------------+-------------+--------------+-----------+
| 100       | category_id  | 1             | 0              | 10          |              |           |
| 100       | severity     | 0             | 0              |             |              |           |
| 100       | status_id    | 1             | 0              | 20          |              |           |
| 100       | artifact_id  | 1             | 1              | 50          | 10           |           |
| 100       | summary      | 0             | 1              |             | 20           |           |
| 100       | open_date    | 1             | 1              | 40          | 30           |           |
| 100       | assigned_to  | 1             | 1              | 30          | 40           |           |
| 100       | submitted_by | 0             | 1              |             | 50           |           |
+-----------+--------------+---------------+----------------+-------------+--------------+-----------+
                    

Exemple 10. commande reports

3.2.7 add

add: Ajoute un artefact au tracker.

  • --tracker_id* : ID du tracker dans lequel le nouvel artefact sera ajouté.

  • --summary: Summary de l'artefact.

  • --details: Details de l'artefact.

  • --status_id: Status_id de l' artefact.

  • --severity: Severity de l'artefact (1: basse, 9: haute).

  • --[nom extra field]: Valeur de l'extra field. Le nom de l'extra field doit être le nom du champ (field_name). La valeur de l'extra_field dépend de son type. Pour les champs multi-valués, séparez les valeurs par une virgule.

  • --project: nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker add --tracker_id=116 --summary="Back button is not working" --details="When I read my email and I press the back button, a blank page appears" --severity=4 --assigned_to=103
Confirm you want to add a new artifact with the following information:
summary: Back button is not working
details: When I read my email and I press the back button, a blank page appears
severity: 4
group_id: 104
group_artifact_id: 116
assigned_to: 103
Is this information correct? (y/n): y
+--------+
| Result |
+--------+
| 40     |
+--------+
                    

Exemple 11. commande add

Note: Dans cet exemple, "assigned_to" correspond à un extra_field et 103 est une valeur valide pour ce champ. La valeur retournée (40) est l'identifiant du nouvel artefact.

3.2.8 update

update: Mise à jour de l'artefact.

  • --tracker_id* : ID du tracker auquel appartient l'artefact à modifier.

  • --id* : ID de l'artefact à modifier.

  • --status_id: Nouveau status de l'artefact.

  • --summary: Summary de l'artefact.

  • --details: Details de l'artefact.

  • --severity: Severity de l'artefact (1: Basse, 9: Haute).

  • --[nom extra_field]: Valeur de l'extra field. La valeur de l'extra field dépend de son type.

  • --project: nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker update --tracker_id=116 --id=40 --severity=6
Confirm you want to add a new artifact with the following information:
severity: 6
group_id: 104
group_artifact_id: 116
artifact_id: 40
Is this information correct? (y/n): y
+--------+
| Result |
+--------+
| 40     |
+--------+
                    

Exemple 12. commande update

3.2.9 comments

comments: Affiche tous les commentaires d'un artefatc.

  • --tracker_id* : ID du tracker.

  • --id* : ID de l'artefact.

  • --project: nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker comments --tracker_id=116 --id=40
+-------------+--------------+------------------+------------+---------------+-------+-------------+---...
| artifact_id | follow_up_id |     comment      |    date    | original_date |  by   | original_by | co...
+-------------+--------------+------------------+------------+---------------+-------+-------------+---...
| 40          | 559          | Yet another one  | 1293718666 | 1293718666    | ounis | ounis       | 10...
| 40          | 558          | Another comment  | 1293718652 | 1293718652    | ounis | ounis       | 10...
| 40          | 556          | comment by ounis | 1293718608 | 1293718608    | ounis | ounis       | 10...
+-------------+--------------+------------------+------------+---------------+-------+-------------+---...
                    

Exemple 13. commande comments

3.2.10 addComment

addComment: Ajoute un commentaire à un artefact.

  • --tracker_id* : ID du tracker auquel appartient l'artefact.

  • --id* : ID de l'artefact.

  • --message* : Message du commentaire.

  • --comment_type_id: Type à ajouter au commentaire (optionnel).

  • --project: nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker addComment --tracker_id=116 --id=40 --format=html --message="I agree with you"
+--------+
| Result |
+--------+
| 1      |
+--------+
                    

Exemple 14. commande addComment

3.2.11 updateComment

updateComment: Modifie le commentaire existant d'un artefact.

  • --tracker_id*: ID du tracker auquel appartient l'artefact.

  • --artifact_id*: ID de l'artefact.

  • --comment_id*: ID du commentaire à modifier.

  • --comment*: le nouveau commentaire qui remplacera l'ancien.

  • --format: Format du commentaire, peut etre 'text' ou 'html' (optionnel).

  • --project: nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker updateComment --tracker_id=116 --artifact_id=40 --comment_id=560  --comment="This comment will replace the former one"
+--------+
| Result |
+--------+
| 1      |
+--------+
                    

Exemple 15. commande updateComment

3.2.12 deleteComment

deleteComment: Supprime le commentaire existant d'un artefact.

  • --tracker_id*: ID du tracker auquel appartient l'artefact.

  • --artifact_id*: ID de l'artefact.

  • --comment_id*: ID du commentaire à supprimer.

  • --project: nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker deleteComment --tracker_id=116 --artifact_id=40 --comment_id=560
+--------+
| Result |
+--------+
| 1      |
+--------+
                    

Exemple 16. commande deleteComment

3.2.13 CCList

CCList: Affiche la liste des CC d'un artefact.

  • --tracker_id* : ID du tracker.

  • --id* : ID de l'artefact.

  • --project: nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker CCList --tracker_id=116 --id=40
+----------------+-------------+----------------------+----------+---------------+---------+------------+
| artifact_cc_id | artifact_id |        email         | added_by | added_by_name | comment |    date    |
+----------------+-------------+----------------------+----------+---------------+---------+------------+
| 1              | 40          | nouha.terzi@st.com   | 103      | ounis         |         | 1293720479 |
| 2              | 40          | ounis                | 103      | ounis         |         | 1293720479 |
| 3              | 40          | salma.moakhar@st.com | 103      | ounis         |         | 1293720479 |
+----------------+-------------+----------------------+----------+---------------+---------+------------+
                    

Exemple 17. commande CCList

3.2.14 addCC

addCC: Ajoute une liste d'adresses email ou de logins à la liste des CC d'un artefact.

  • --tracker_id* : ID du tracker auquel appartient l'artefact.

  • --id* : ID de l'artefact.

  • --cc_list*: Liste d'adresses email et/ou de logins à ajouter à la liste des CC.

  • --cc_comment: Commentaire optionnel associé à la liste des CC ajoutés.

  • --project: nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker addCC --tracker_id=116 --id=40 --cc_list="nouha.terzi@st.com, ounis, salma.moakhar@st.com"
+--------+
| Result |
+--------+
| 1      |
+--------+
                    

Exemple 18. commande addCC

3.2.15 deleteCC

deleteCC: Supprime un CC d'un artefact.

  • --tracker_id* : ID du tracker auquel appartient l'artefact.

  • --id* : ID de l'artefact.

  • --cc_id* : ID du CC à supprimer.

  • --project : nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker deleteCC --tracker_id=116 --id=40 --cc_id=2
+--------+
| Result |
+--------+
| 1      |
+--------+
                    

Exemple 19. commande deleteCC

3.2.16 dependencies

dependencies: Affiche toutes les dépendances d'un artefact.

  • --tracker_id* : ID du tracker.

  • --id* : ID de l'artefact.

  • --project : nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker dependencies --tracker_id=116 --id=40
+--------------------+-------------+-----------------------------+-------------+------------+----------...
| artifact_depend_id | artifact_id | is_dependent_on_artifact_id |   summary   | tracker_id | tracker_n...
+--------------------+-------------+-----------------------------+-------------+------------+----------...
| 25                 | 40          | 41                          | Another bug | 116        | Bugs     ...
+--------------------+-------------+-----------------------------+-------------+------------+----------...
                    

Exemple 20. commande dependencies

3.2.17 inverseDependencies

inverseDependencies: Affiche toutes les dépendances inverses d'un artefact.

  • --tracker_id* : ID du tracker.

  • --id* : ID de l'artefact.

  • --project : nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker inverseDependencies --tracker_id=116 --id=40
+--------------------+-------------+-----------------------------+-----------------+------------+------...
| artifact_depend_id | artifact_id | is_dependent_on_artifact_id |     summary     | tracker_id | track...
+--------------------+-------------+-----------------------------+-----------------+------------+------...
| 26                 | 41          | 40                          | Another bug     | 116        | Bugs ...
| 27                 | 42          | 40                          | yet another bug | 116        | Bugs ...
+--------------------+-------------+-----------------------------+-----------------+------------+------...
                    

Exemple 21. commande inverseDependencies

3.2.18 addDependencies

addDependencies: Ajoute une liste de dépendances à un artefact.

  • --tracker_id* : ID du tracker.

  • --id* : ID de l'artefact.

  • --dependencies* : liste des dépendances à ajouter, séparées par une virgule.

  • --project : nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker addDependencies --tracker_id=116 --id=40 --dependencies="41"
+--------+
| Result |
+--------+
| 1      |
+--------+
                    

Exemple 22. commande addDependencies

3.2.19 deleteDependency

deleteDependency: Supprime une dépendance à un artefact.

  • --tracker_id* : ID du tracker.

  • --id* : ID de l'artefact.

  • --dependency* : ID de la dépendace à supprimer.

  • --project : nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php deleteDependency tracker --tracker_id=116 --id=40 --dependency=41
+--------+
| Result |
+--------+
| 41     |
+--------+
                    

Exemple 23. commande deleteDependency

3.2.20 artifactHistory

artifactHistory: Affiche l'historique des champs d'un artefact.

  • --tracker_id* : ID du tracker.

  • --id* : ID de l'artefact.

  • --project : nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker artifactHistory --tracker_id=116 --id=40
+------------+-----------------------------------------------+-----------------------------------------...
| field_name |                   old_value                   |                   new_value             ...
+------------+-----------------------------------------------+-----------------------------------------...
| cc         | nouha.terzi@st.com,ounis,salma.moakhar@st.com | nouha.terzi@st.com,salma.moakhar@st.com ...
| cc         |                                               | nouha.terzi@st.com,ounis,salma.moakhar@s...
| comment    | I agree with you                              |                                         ...
| comment    | I agree with you                              | In fact i don't agree                   ...
| summary    | Increased priority                            | Back button is not working              ...
| summary    | Back button is not working                    | Increased priority                      ...
| severity   | 4                                             | 6                                       ...
+------------+-----------------------------------------------+-----------------------------------------...
                    

Exemple 24. commande artifactHistory

3.2.21 attachedFiles

attachedFiles: Liste les fichiers attachés d'un artefact (le contenu des fichiers n'est pas présent).

  • --tracker_id* : ID du Tracker.

  • --artifact_id* : ID de l'artefact.

  • --project : nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker attachedFiles --tracker_id=116 --artifact_id=40
+----+-------------+----------+-------------------+----------+----------+------------+------------+----...
| id | artifact_id | filename |    description    | bin_data | filesize |  filetype  |  adddate   | sub...
+----+-------------+----------+-------------------+----------+----------+------------+------------+----...
| 2  | 40          | file2    | file2 description |          | 14       | text/plain | 1293721808 | oun...
| 1  | 40          | file1    | file1 description |          | 14       | text/plain | 1293721737 | oun...
+----+-------------+----------+-------------------+----------+----------+------------+------------+----...
                    

Exemple 25. commande attachedFiles

3.2.22 attachedFile

attachedFile: Télécharge le fichier attaché d'un artefact.

  • --tracker_id* : Id du Tracker.

  • --artifact_id* : ID de l'artifact.

  • --file_id* : ID du fichier attaché à télécharger.

  • --output: emplacement et nom du fichier à télécharger. Si non spécifié, le contenu sera affiché à l'écran.

  • --project : nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker attachedFile --tracker_id=116 --artifact_id=40 --file_id=2 --output=./file2
File retrieved successfully.
                    

Exemple 26. commande attachedFile

3.2.23 addAttachedFile

addAttachedFile: Attache un fichier à un artefact.

  • --tracker_id* : ID du Tracker.

  • --artifact_id* : ID de l'artefact.

  • --file* : fihcier local à attacher.

  • --description: Description du fichier.

  • --project : nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker addAttachedFile --tracker_id=116 --artifact_id=40 --file=file2 --description="file2 description"
+--------+
| Result |
+--------+
| 2      |
+--------+
                    

Exemple 27. commande addAttachedFile

Note : La valeur retournée (2) correspond à l'identifiant du nouveau fichier créé.

3.2.24 deleteAttachedFile

deleteAttachedFile: Supprime un fichier attaché à un artefact.

  • --tracker_id*: ID du Tracker.

  • --artifact_id*: ID de l'artefact.

  • --file_id*: ID du fichier a supprimer.

  • --project: nom UNIX du projet. Si vous ne le spécifiez pas, le projet spécifié lors de la connexion sera utilisé. Si aucun projet n'a été spécifié lors du login, une erreur sera affichée.

[ounis@linux tuleap-cli]$ ./tuleap.php tracker deleteAttachedFile --tracker_id=116 --artifact_id=40 --file_id=2
+--------+
| Result |
+--------+
| 2      |
+--------+
                    

Exemple 28. deleteAttachedFile command

Note: La valeur retournée (2) correspond à l'identifiant du fichier supprimé.


Copyright © Xerox Corporation, Codendi Team, 2001-2006. All Rights Reserved