Phabricator/Help/fr

Cher utilisateur de Phabricator, si vous avez des questions, n’hésitez pas à simplement les partager sur la page de discussion. Nous améliorons notre documentation en nous basant sur les retours qui nous sont faits. Si vous désirez tester Phabricator, vous devez utiliser l'instance des services du Cloud.

Pour un aperçu basique de ce qu'est Phabricator et de ce qu'il peut faire,. Ou continuez à lire cette page pour entrer directement dans le sujet et faire vos premiers pas.

Créer votre compte
Vous pouvez vous connecter à votre nouveau compte Phabricator soit avec votre compte wiki global de Wikimedia, ou avec votre compte développeur de Wikimedia. Dans les deux cas, vous n'avez pas besoin d'avoir des mots de passe différents.

Avec votre compte global wiki



 * Premièrement, assurez vous que vous êtes Wikimédia.
 * Si vous n’en possédez pas encore,.
 * Allez sur la page de connexion de Phabricator (lorsque vous êtes déconnecté le lien s'affiche en haut à droite sous forme d’une flèche pointant vers une porte)
 * Activez le bouton représentant un tournesol qui est libellé « Se connecter ou s’enregistrer - Mediawiki ».
 * Une fenêtre de dialogue Mediawiki.org vous demandera l’autorisation de vous connecter
 * Phabricator vous demandera un nom d’utilisateur. En cas de doute, utilisez simplement votre nom d’utilisateur Wikimedia, remarquez cependant que les noms d’utilisateur de Phabricator ne peuvent pas avoir de caractères non-ASCII tels que العَرَبِيةُ ou 中华民族, ou Xï, ni inclure des espaces (n'utilisez qu'un caractère souligné " " à la place). Vous devrez également fournir une adresse de courriel valide pour vérification, mais elle ne sera pas communiquée aux autres utilisateurs.


 * Cliquez sur Manage dans la barre de navigation à gauche.
 * Cliquez sur Edit Profile et remplissez le champs « Also Known As » (par exemple, avec votre nom complet) pour qu’il soit plus facile de vous rechercher.

Avec votre compte développeur Wikimedia

 * Si vous avez un compte de développeur Wikimedia &mdash; aussi nommé compte LDAP ou compte Gerrit ou wikitech — vous pouvez également l’utiliser pour vous authentifier. Le même compte utilisateur Phabricator peut être relié à la fois au compte MediaWiki.org et au compte LDAP. Cela peut servir de moyen de récupération dans le cas improbable ou le compte unifié Wikimédia ne fonctionnerait pas. Connectez vos comptes Wikimedia SUL et LDAP à un même et unique compte utilisateur Phabricator ! Sans quoi vous allez créer deux comptes Phabricator séparés.

Authentication à facteurs multiples

 * Nous n’encourageons pas l’utilisation de l'authentification multifactorielle sur le Phabricator de Wikimedia sauf si vous avez un accès aux tâches de sécurité. Si vous souhaitez néanmoins l’utiliser, veuillez lire d'abord les prérequis et les recommandations pour l’authentification multifactorielle.

Résolution des problèmes
We cannot correct your email address but we can delete your account so you can register again.
 * Si vous ne pouvez pas vérifier votre compte Phabricator parce que vous avez saisi une mauvaise adresse de courriel, veuillez laissez un message sur Talk:Phabricator/Help. Nous ne pouvons pas corriger votre adresse courriel mais nous pouvons supprimer votre compte pour que vous puissiez vous enregistrer à nouveau.
 * Si vous voyez que votre compte Phabricator est désactivé, laissez un message sur Talk:Phabricator/Help.
 * Si vous obtenez une erreur de type "Adresse courriel déjà prise" quand vous essayez de créer un compte Phabricator via "Connexion ou Enregistrement - MediaWiki" il est possible que vous ayez déjà créé un compte Phabricator en liaison avec votre compte développeur Wikimedia. Vous devrez vous connecter dans Phabricator avec votre compte développeur. Utilisez wikitech:Special:PasswordReset si vous avez oublié le mot de passe de votre compte développeur.
 * Pour changer votre nom d'utilisateur sur Phabricator pour un raison quelconque, veuillez laissez un message sur Talk:Phabricator/Help et inclure un lien vers votre profil Phabricator.
 * Pour modifer le compte wiki global ou le compte développeur associé à votre compte Phabricator :
 * Notez que votre compte Phabricator doit être associé soit à un compte wiki global, soit à un compte développeur à tout instant.
 * Si vous voulez modifier votre compte global wiki qui est connecté à votre compte Phabricator : connectez-vous à Phabricator avec votre compte développeur également lié à votre compte Phabricator. Puis supprimez votre ancien compte wiki global et connectez votre nouveau compte wiki global à votre compte Phabricator. (Si votre compte Phabricator n'est connecté qu'à votre compte global mais pas encore à votre compte développeur, connectez un compte développeur à votre compte Phabricator account d'abord.)
 * Si vous voulez modifier votre compte développeur connecté à votre compte Phabricator : connectez-vous à Phabricator avec votre compte global wiki qui est également lié à votre compte Phabricator. Puis supprimez votre ancien compte développeur et connectez votre nouveau compte développeur à votre compte Phabricator. Si votre compte Phabricator n'est associé qu'à votre compte wiki global mais pas encore à un compte développeur en plus, connectez un compte développeur à votre compte Phabricator d'abord.)

Revendiquer vos anciens comptes Bugzilla et RT
Suivez ce lien.

Recevoir les mises à jour et les notifications
Phabricator vous alerte sur les activités significatives, y compris sur vos propres actions.

Phabricator propose plusieurs outils pour réceptionner les alertes que vous souhaitez recevoir.


 * Si vous êtes intéressé par un objet bien déterminé (une tâche, un mockup…), cliquez simplement sur  dans la page où il se trouve. L’ajout d’un commentaire vous abonnera automatiquement.
 * Si vous êtes intéressé par toutes les activités d’un projet, vous pouvez cliquer sur  sur la page de présentation du projet. Plus d’informations à ce sujet dans le guide utilisateur des projets section « Watching Projects ».

Voir Phabricator/Help/Managing mail pour réduire la quantité de notifications de courriels et leur filtrage.

Dépannage
Si vous recevez des notifications non désirées, par courriel, à propos d'une tâche :


 * Vous pouvez être inscrit à la tâche.
 * Il est possible que vous soyez membre d'un projet ou d'un sous-projet associé à cette tâche. Une liste de tous les projets dont vous êtes membre est disponible.
 * Il est possible que vous suiviez un projet associé à cette tâche. Une liste de tous les projets que vous suivez est disponible.
 * Dans vos préférences de courriel sous "Tâches Maniphest", il est possible que vous ayez activé "Changement d'états de l'une des sous-tâches de tâche".
 * Vous pouvez avoir défini une règle Herald personnelle. Vérifiez le champ "X-Herald-Rules" de l'entête de message pour voir la liste de toutes les règles Herald appliquées.
 * If nothing helps, check the "X-Phabricator-Stamps" message header field for further information. See.

Créer des règles plus complexes pour les notifications (Herald)
Vous pouvez créer des règles de notification personnalisées dans l'instance Herald de Phabricator de Wikimedia. C'est une option plus avancée, dont la prise en main peut être plus difficile et qui doit être utilisée soigneusement pour des raisons de performances.

Créer une tâche
Il existe plusieurs façons de créer une tâche, en fonction des informations que vous souhaitez rapporter : Complétez le formulaire, sans modifier les champs dont vous n’êtes pas sûr.
 * Pour une nouvelle tâche : cliquez sur le bouton des favoris (Bookmark) à droite de la barre de navigation supérieure. Dans le menu déroulant, choisissez Create Task . Vous serez dirigé vers un formulaire à compléter.
 * Pour un problème de sécurité : cliquez sur le bouton des favoris, à droite de la barre de navigation supérieure. Dans la liste déroulante, choisissez Déclarer un problème de sécurité. Vous obtiendrez un formulaire prérempli avec Security, et un lien vers les instructions spéciales pour renseigner le bogue de sécurité.
 * Une sous-tâche d’une tâche existante : cliquez sur « Edit Related Tasks… > Create Subtask » situé dans la colonne de droite de la tâche courante. La relation de dépendance entre les deux tâches sera paramétrée et quelques valeurs de la tâche parente seront récupérées comme valeurs par défaut (Assigned To, Subscribers, Priority, Projects). Les sous-tâches seront répertoriées dans la tâche parente sous « Task Graph », et triées par date de modification la plus récente.

Phabricator reconnait certains formatages dans les zones textuelles. Voir.

Utilisez l'aperçu en ligne à la fin de la page pour vérifier si votre texte ressemble à ce que vous désirez.

Sélection des projets
Pour relier une tâche à un projet (le taguer) qui utilise Phabricator, il suffit de commencer à saisir son nom dans le champ « Tags » et de sélectionner le projet dans la liste des résultats correspondants (la liste ne montrera que cinq projets correspondants). Vous pouvez chercher des projets et en lire de courtes descriptions en cliquant sur l’icône de loupe dans le champ Tags. Vous pouvez ajouter un ou plusieurs projets au champ Tags. En cas de doute, il est possible de ne pas le renseigner, les personnes s’occupant du tri des tâches se chargeront d’attribuer une valeur idoine. Il existe une (très longue) liste des projets disponible. Le bouton  permet de rechercher des projets. Cette liste est également disponible sur la page Phabricator/Projects.

Paramétrer la priorité d’une tâche
La priorité doit être paramétrée par les chefs de produit, les chargés de projet, les développeurs qui prévoient de travailler sur la tâche, ou les inspecteurs de ticket (bugwrangler) ou les membres expérimentés de la communauté, et non par les personnes qui soumettent le ticket ou par des observateurs externes. Voir la gestion de projet de Phabricator pour plus d’informations.

Utilisation du courriel
Il est également possible de créer des tâches en envoyant des mails à [mailto:task@phabricator.wikimedia.org task@phabricator.wikimedia.org]. Le sujet sera utilisé comme titre, le corps sera utilisé directement tel quel, et les pièces jointes seront associés à la tâche. Pour ajouter un projet, utilisez la commande correspondante !projects avec son mot-clé (hashtag) au début du corps. Par exemple,. D'autres commandes pour paramétrer l’assignement de la tâche, la priorité ou le statut par mail sont disponibles.

''Note : si la signature de votre compte courriel n'est pas formatée d'après de facto standards (incluant « -- » pour la séparer du corps du texte), elle sera postée telle quelle. La suppression des informations privées dans la signature est vivement encouragée lors des premiers essais, juste pour être sûr.''

Passage de certaines valeurs dans l’URL de la création de tâche
Le lien « Signaler un problème dans Phabricator » peut faire passer de nombreuses valeurs en tant que paramètres d'URL en les ajoutant au lien générique de création de tâche.

C’est une fonctionnalité très avancée. Plus d’informations sont fournies sur cette page.

Commenter et modifier une tâche
Pour répondre, vous avez également besoin d'un compte.



Phabricator vous permet de poster et de modifier les commentaires et les descriptions en utilisant la mise en forme du texte et l’insertion d’images ou d’autres fichiers ; voir Téléverser des pièces jointes. Vous pouvez utiliser la barre d’outils au dessus du champ de texte et utiliser la syntaxe propre à Phabricator.

Utilisez l'affichage en ligne à la fin de la page pour vérifier si votre texte ressemble à ce que vous désirez.

Pour modifier la description d'une tâche, choisissez « Edit Task » dans la barre latérale.

Pour fermer une tâche qui fait double emploi avec une autre tâche existante, sélectionnez « Modifier les tâches liées... » (Edit Related Tasks) puis « Clore en tant que doublon » (Close As Duplicate) dans la barre latérale.

Mise en forme et balisage


Phabricator prend en charge certaines mises en forme des zones de texte.

Remarquez que la syntaxe de mise en forme de Phabricator est différente de celle de Médiawiki.

Les usages les plus populaires comprennent :
 * le fait de mentionner les utilisateurs préfixés d’un arobase pour créer un lien vers leur page de profil et les souscrire à la tâche.
 * l’ajout d’un numéro de tâche comme dans  va créer un lien vers la tâche en adjoignant une infobulle de description.   insère le titre de la tâche dans votre texte.
 * L’ajout d’un nom de projet en préfixant un terme d’un dièse créera un lien vers la page principale du projet correspondant.
 * Si vous souhaitez citer un texte, il suffit de débuter la ligne par le signe supérieur . Si vous souhaitez répondre à un commentaire en l’incorporant sous forme de citation, passez par le menu déroulant symbolisé par une flèche en bas, à droite du commentaire à répondre.
 * Si vous souhaitez afficher la maquette image d’un fichier téléversé, comme, en l’incorporant dans votre commentaire, écrivez.
 * Si vous souhaitez créer un lien externe, par exemple vers  avec le marquage wiki, utilisez   en conservant les espaces dans Phabricator.
 * Si vous souhaitez ajouter une adresse web (lien URL) dans un commentaire, par exemple pour fournir un cas de test, il est vivement recommandé de copier et coller l’adresse complète depuis la barre d’adresse du navigateur web. Par exemple  plutôt que  . Les préfixes interwiki comme   ne sont pas pris en compte par l’analyse syntaxique de Phabricator, pas plus que la plupart des adaptations qui existaient dans le Bugzilla de Médiawiki. Les modifications Gerrit devraient également également être recopiées avec des adresses web complètes.
 * Si vous souhaitez recopier un ligne de code, ajoutez une ligne avec trois accents graves (backticks) avant et la même après le code. Ou pastecréez une copie en ligne et ajoutez un lien vers la copie à partir de la tâche.

Téléverser les pièces jointes
Il y a plusieurs moyens de téléverser des fichiers : vous pouvez ajouter un fichier (par exemple une capture d’écran) à un commentaire ou à une description de tâche par un simple geste de glisser-déposer réalisé avec votre souris. Les utilisateurs peuvent également copier et coller des images à l’aide de la fonctionnalité du presse-papier de leur système.

Si cette fonctionnalité n’existe pas sur votre système, vous pouvez utiliser un phabricator:file/upload et faire référence au numéro de fichier (par exemple « 123 ») qui est affiché à coté des fichiers déjà téléversés en le préfixant avec la lettre F majuscule. Cela créera un lien vers le fichier. Pour inclure le fichier dans le commentaire, placez l’identifiant entre accolades :. Par défaut c’est inclus comme une miniature. Pour plus d’options de formatage, voir [#Formatting and markup|Mise en forme et marquage]. Si vous devez téléverser des fichiers fréquemment et considérez les options actuelles inconfortables, vous pouvez aussi ajouter un onglet textuel à votre page principale avec un lien direct.

Remarquez que vous ne pouvez pas téléverser un fichier et postérieurement en restreindre le niveau d’accèssibilité (par exemple pour le relier à un ticket à accès restreint sur un sujet de sécurité). Vous devrez supprimer le fichier et le téléverser à nouveau avec des autorisations d'accès plus strictes. Il est recommandé de téléverser ensemble les fichiers dont l’accès doit être restreint avec la création du ticket restreint (de sécurité). Ensuite, remarquez que toute personne qui possède l'URL complète vers un fichier peut le télécharger ou partager le lien avec d'autres. Il n'y a pas de contrôle des droits pour accèder aux fichiers afin de les protéger. Les fichiers de Phabricator font confiance entièrement à la sécurité dans l'ombre; deviner l'URL (pseudo-aléatoire) pour un fichier quelconque serait très difficile. Si vous avez besoin de plus de protection pour des fichiers particulièrement sensibles, alors vous devez envisager une alternative plus sécurisée.

Si jamais vous aviez besoin de supprimer un fichier que vous avez téléversé, ouvrez la liste de vos fichiers, sélectionnez le fichier et cliquez sur « Supprimer un fichier » dans le panneau latéral.

Gestion de projet dans Phabricator
Si vous gérez ou êtes responsable d’un projet, veuillez s’il-vous-plaît suivre ce lien pour obtenir plus d’informations.

Tâches parentes et sous-tâches
Les tâches peuvent êtres parentes d’autres tâches ou être une sous-tâche d’un certain nombre d’autres tâches. Si la tâche A n'est pas résolue tant que la tâche B n'est pas résolue, alors la tâche A est la tâche parente, et la tâche B est la sous-tâche. De telles relations peuvent être déclarées via « Modifier les tâches liées... ». Les tâches parentes et les sous-tâches sont affichées sous « Graphe des tâches ». Cette fonctionalité peut être utilisée pour réaliser différentes choses :

Remarque : il existe une fonctionnalité « Edit Related Tasks… > Create Subtask ». En plus de paramétrer les relations de dépendance entre parent et sous-tâche, elle s’occupe également de gérer la liste des abonnements (CC) dans la nouvelle sous-tâche.
 * Bloqueurs et sous-tâches. Une tâche (parente) peut simplement être bloquée par une autre (sous-) tâche avec laquelle elle a des relations de dépendance (voir Special:MyLanguage/Phabricator/Project management sur comment ajouter une sous-tâche).
 * Suivi. Une tâche ne correspondant à aucune réalisation spécifique (le parent) peut être bloquée par plusieurs autres (sous-)tâches afin de permettre le suivi d’une collection de (sous-)tâches lié à un objectif de version, ou à une autre période temporelle. Remarquez que suivi ici a un sens différent du drapeau obsolète #Tracking de Phabricator.
 * Approbation. Plusieurs tâches (parentes), comme des ébauches ou des objectifs d’équipe, peuvent être bloquées par une seule (sous-) tâche qui représente les tâches d’ébauches approuvées, après quoi ces ébauches d’objectif deviennent des objectifs réels.

Établissement des priorités
Voir configurer la priorité des tâches

Assignation
Voir l'assignation des tâches

Tâches de suivi
Le terme "tâche de suivi" est emprunté à Bugzilla, où un sens bien particulier lui était attribué : une tâche qui est définie comme bloquée par d’autres tâches, mais qui en elle même ne correspond à aucune activité à exécuter, pas plus qu’elle n’est liée à un jalon de publication ou à une date butoir. Ces tâches de suivi avaient tendance à demeurer longtemps (voir éternellement) sans évolution, étant donné que leurs sous-tâches courantes pouvaient être résolues mais que de nouvelles leurs étaient attribuées. Dans Phabricator, il vaut mieux créer un projet plutôt que des 'tâches de suivi' avec des dépendances.

Remarquez cependant qu’il existe d’autres types de tâche 'chapeau' associables à aucune activité particulière, mais qui conservent leur place dans Phabricator. C’est notamment le cas des tâches de jalon de publication (Release). Une publication à venir pourrait être représentée par une tâche répertoriant comme sous-tâches toutes les activités qu’il est nécessaire de réaliser pour atteindre l’objectif de la publication. Une fois la publication effectuée, la tâche peut être marquée comme achevée. Une utilisation similaire serait d’avoir une tâche qui représente les objectifs globaux d’une équipe pour le trimestre, et avec comme tâche bloquante on non, chacun des objectifs.

Contexte de recherche (global et avancé)


Phabricator est composé de plusieurs applications (la gestion des tâches de « Maniphest » étant l'une d'entre elles, ou Diffusion pour la navigation dans le code).



Il existe 2 manières différentes de chercher :


 * La recherche globale sur https://phabricator.wikimedia.org/search/query/advanced/, dénommée confusément « recherche avancée ». Celle-ci est très simple. Elle se trouve dans le coin supérieur droit. Par défaut, la recherche est faite sur toutes les applications et presque tous les types de documents (tâches ouvertes, fermées, validations du code(commit), etc…). Vous pouvez modifier le contexte par défaut en utilisant le menu fléche, à gauche de la barre de recherche. Par exemple, sélectionnez "Open Tasks" pour n'afficher que les résultats concernant les tâches ouvertes dans le gestionnaire de problèmes Maniphest. Ou sélectionnez "Current Application" pour rechercher Maniphest dans Maniphest, Diffusion dans Diffusion etc. Les balises spécifiées sont des unions (OR logiques).
 * Recherche avancée par application spécifique, par exemple sur https://phabricator.wikimedia.org/maniphest/query/advanced/ pour Maniphest. Celui-ci a plus de champs, et une auto-completion qui inclut "Not in:..." (équivalent à NOT) et "In any:..." (équivalent à OR) (par exemple, entrez "echo" dans le champ des balises (tags) ). Il existe aussi une recherche avancée pour la plupart des autres applications (par exemple file/query/advanced sur les fichiers). Pour ne rechercher que les tâches ou les rapports de bogues, utilisez la recherche avancée de Maniphest. Les balises spécifiées sont des intersections (AND logiques).

A l'intérieur de Maniphest, la personalisation, les recherches sauvegardées et les options de recherche avancée sont listées dans la barre de navigation sur la gauche.

Recherche de termes
Un soin particulier doit être porté sur la manière de choisir les termes corrects à rechercher.

Certaines des propriétés valides localement pour le champ de recherche :


 * Insensible à la casse :  est équivalent à
 * la recherche de phrases fonctionne :
 * réalisation basique de l'analyse lexicale (tokenization), par exemple pour supprimer la ponctuation
 * Le stemming est réalisé : « edited » est également rencontré lorsque vous recherchez . Néanmoins,   n'est pas équivalent à   car le texte entre guillemets ne correspond pas.
 * La recherche de sous-chaînes est prise en charge :  détecte , mais   ne le fait pas.
 * fait correspondre  comme entre guillemets et le texte de l'opérateur de sous-chaîne utilise la recherche de sous-chaînes.
 * Les recherches booléennes pour exclure certains termes sont possibles en utilisant le symbole - devant le terme non-souhaité. Par exemple utilisez  pour exclure les erreurs non-fatales des résultats.
 * Pour ne chercher que dans un titre de tâche mais pas dans la description ni les commentaires, utilisez  qui est la même chose que  . Pour chercher un terme dans le titre de la tâche et les autres termes ailleurs dans une tâche, utilisez   ou  . Voir https://secure.phabricator.com/book/phabricator/article/search/ pour plus d'informations.

Les formulaires de recherche avancée ne sont pas explicites à propos de la logique mais en général ils font le ET (AND) entre les différents champs. Vous pouvez exclure des résultats, des projets spécifiques en saisissant  (équivalent de NOT) et combiner plusieurs projets via   (équivalent de OR) via les suggestions d' auto-completion. La limite est de 5 éléments pour l'auto-complétion de Maniphest. Pour augmenter cette limite, voyez les scripts utilisateur pour Chrome et pour Firefox.

Autres moyens de trouver quelque chose
Si vous ne vous souvenez plus des mots exacts utilisés dans un élément que vous recherchez, vous pouvez utiliser une de ces pistes :


 * utilisez le flux d'activité et modifiez la requête pour la restreindre à certains projets ou périodes données
 * utilisez le flux d'activité pour lister toutes les actions que vous avez réalisées sur une période donnée sur feed/query/EW2FwdAi.Kfz/
 * utilisez un moteur de recherche externe;
 * supprimez tous les termes de recherche, affinez la recherche seulement par projet, etc.. puis listez tous les résultats possibles manuellement ou utilisez Ctrl+F pour chercher des chaînes spécifiques (vous devrez peut-être adapter la taille de la page « Page Size » à une grande valeur pour afficher plus de 100 résultats);
 * enregistrez une nouvelle tâche, en disant qu'un ancien rapport existe déjà, et attendez que quelqu'un fusionne les deux rappports.

Choisir des dates ou des intervalles de temps
Ceci n'est disponible qu'avec dans la recherche avancée.

En utilisant les champs Date tels que "Créé après" ou "Créé avant" vous poouvez entrer des dates absolues ou relatives. Notez que Maniphest utilise UTC.

Pour avoir la liste des tâches qui ont été créées ces dernières 24 heures, mettez le champ "Created After" à "-24 hours" ou "-1 day". Notez que "Updated Before" signifie actuellement "Last updated before" et que les valeurs de date absolue comme "2014-11-26" se réfèrent au temps UTC tandis que la valeur de votre fuseau horaire peut être différente. Les champs "Mis à jour après" et "Mis à jour avant" retournent toute modification d'une tâche. Par exemple si une tâche est déplacée vers une autre colonne dans un tableau, elle est enregistrée "mise à jour". Cela peut ajouter du bruit aux résultats de votre recherche.

Exemples sur la façon dont Maniphest interprète les recherches : L'expression « il y a X jours » peut prêter à confusion. Phabricator interprète aujourd'hui comme faisant partie de tout ensemble de valeurs. Même si il est 12:30 UTC, Phabricator va interpréter cela comme un jour potentiel dans la période.
 * "02/25/2015" - interprété comme "00:01 le 25 février 2015" (UTC)
 * "5 days ago" - interprété comme "00:01 du quatrième jour calendaire précédant le jour d'aujourd'hui" (UTC)
 * "2:45 AM 5 days ago" - interprété comme "02:45 du quatrième jour précédant le jour d'aujourd'hui" (UTC)

Enregistrer et gérer les recherches/requêtes
Les requêtes peuvent être enregistrées et gérées dans Maniphest.

Maniphest offre des liens vers certaines requêtes de recherche prédéfinies dans la barre de navigation, à gauche. Par exemple, cliquez sur authored pour obtenir une liste des tâches que vous avez créées.

Les adresses (URL) des requêtes de recherche sont stables et donc vous pouvez les enregistrer et les réutiliser. Vous pouvez partager l'adresse avec d'autres personnes dans la barre d'adresses de votre navigateur web par exemple en postant le lien sur une page wiki.

Si vous voulez enregistrer une recherche, cliquez le bouton « Save Query » en dessous de l'IHM de « Advanced Search ».

En allant dans la barre de navigation gauche de Maniphest, si vous cliquez sur le lien « Edit Queries… », vous verrez la liste des requêtes personnelles que vous avez enregistrées. Chaque utilisateur a un ensemble par défaut qui peut être supprimé via cet IHM.

Quelques options de cette IHM :


 * Utilisez les éléments verticaux formés de petites lignes, à gauche pour pointer/déplacer les requêtes et ordonner ainsi la liste.
 * La croix (x) supprimera définitivement une recherche.
 * L'icône du crayon vous permet de modifier le nom d'une recherche
 * en cliquant sur un nom de requête, vous afficherez les options de recherche ainsi que les résultats de cette requête

Une fois que vous avez enregistré une requête vous ne pouvez plus modifier ses paramètres, mais vous pouvez la renommer. Pour modifier une requête, cliquez sur son nom, modifiez les paramètres et enregistrez-la en tant que nouvelle requête. Phabricator permet aussi aux utilisateurs d'enregistrer plusieurs requêtes avec le même nom.

Pour que le nom de l'utilisateur soit dynamique dans les recherches que vous voudriez partager avec d'autres (par exemple pour les tâches assignées à la personne qui exécute la recherche), choisissez Authors > icône loupe > Browse Users > sélectionnez « Current viewer ».

Notez que certaines requêtes communes sont assi disponibles dans les onglets « Activity » de la page d'accueil de Phabricator.

Trouver la tâche Maniphest qui correspond à un numéro de bogue Bugzilla
Utilisable uniquement dans « Advanced Search ».

Toutes les tâches Phabricator migrées en 2014 de Bugzilla ont un champ Reference qui contient une valeur « bz » suivie d'un numéro correspondant au rapport dans Bugzilla. Si vous recherchez la tâche correspondant à un rapport particulier dans Bugzilla, utilisez le champ Reference dans advanced search ou ajoutez simplement 2000.

Utiliser les tableaux de bord
Les tableaux de bord sont des pages d’accueil spécialement conçues pour afficher un grand nombre d’informations personnalisées. Elles peuvent créées, administrées et partagées avec d’autres utilisateurs.

Consultez cette page pour une visite guidée détaillée du tableau de bord.

Modifications par lots
Phabricator offre aux tâches la possibilité de faire des modifications en masse/par lot. En bas de chaque page de requête permettant de faire des recherches Maniphest se trouve un lien « Batch Edit Selected » (Modification par lot de la sélection) qui permet de modifier toutes les tâches que vous avez sélectionnées en utilisant la touche majuscule et le clic. Les utilisateurs désireux de faire appel à cette fonctionnalité doivent d’abord rejoindre le groupe des trieurs de rapports d’anomalie.

La modification par batch peut être réversée en notant le numéro de la tâche globale, généré au début d'une modification par batch. On trouve cela en cliquant sur "Détails" avant ou après l'exécution. Sur la page suivante, il y aura sur la droite, une entrée de menu "Continuer" qui génèrera une requête Maniphest de toutes les tâches concernées.

If you have to perform the very same 'uninteresting' action on a lot of tasks (cleanup or reorganizing project structures) and you do not want to trigger notifications, ask someone with CLI server access (people listed under "phabricator-admin" or "phabricator-roots") to silence that specific batch edit before running it, so no notifications will be triggered for that batch edit.

Favoris
Le menu du marque-pages (Bookmark) à droite le la barre de navigation supérieure peut être personnalisé avec des liens vers vos formulaires et vos actions préférées. Voir les instructions du Menu Profil pour plus d'informations.

Listes personnalisées d’éléments
La fonctionnalité "Flag For Later" (Consigner pour plus tard) permet de marquer les objets (comme des tâches ou des révisions) au sein d'un aide-mémoire pour une consultation ultérieure. Huit drapeaux de couleur sont disponibles. Les drapeaux sont personnels et privés donc vos listes ne peuvent pas être partagées avec d'autres personnes. Vos objets ainsi marqués sont affichés sur la page flag. Il est possible d’effectuer des recherches par couleur ou par type d’objet, contrairement aux |symboles.

Phabricator badges
Badges are awarded to users to distinguish certain people or people in a particular group. Currently all active badges can only be awarded by administrators.

Créer un projet


Dans Phabricator les projets sont des étiquettes et inversement. Ils peuvent être hiérarchisés en sous-projets depuis février 2016 (upstream). Les tâches peuvent être assignées à plus d’un projet, et elles peuvent aussi être soumises sans être assignées à aucun projet.

Quand créer d’un projet ?
Généralement, vous aurez besoin d’un projet si :
 * vous avez déja une équipe qui s’occupe d’un ou plusieurs projets (commencez par cela, et demandez-en plus au fur et à mesure de vos besoins)
 * vous avez besoin d’un tableau de bord (par exemple, pour un 'sprint')
 * vous avez besoin d’une étiquette ou d’un mot clé pour organiser un type de tâche qui peut faire partie d’un projet quelconque (par exemple : « Accessibilité »).

Demander un nouveau projet
Voir Demande de création d’un nouveau projet.

Restreindre l’accès à des tâches
If you are a member of the #WMF-NDA project tag, then access to a task that you plan to create can be restricted to members of the #WMF-NDA project by clicking the Bookmark dropdown in the top bar and selecting "NDA Protected Task".

Access to a task that you plan to create can be restricted to a list of specific users by changing the "Visible To" field to something else than "Public".

L'accès à une tâche spécifique peut être changé via "Modifier la tâche" puis en initialisant le champ "Visible par" à quelque chose d'autre que "Public".

Cette option n'est seulement disponible que pour quelques utilisateurs.

Security issues
Notez que les tâches marquées comme ayant des problèmes de sécurité ne sont pas visibles publiquement. An existing task can be converted into a Security issue via "Protect as security issue" in the side bar.

Afficher et utiliser les espaces
''Les espaces (documentation du flot montant) permettent de restreindre l'accès aux groupes d'objets (comme les tâches) seulement aux membres d'un groupe spécifique. Voir Restreindre l'accès en utilisant la police des espaces pour la configuration.''

Si vous pouvez accéder à au moins deux espaces, vous avez une entrée supplémentaire dans le menu « Espaces » sous « Visible à » lorsque vous créez ou modifiez un objet. Les utilisateurs qui n'ont accès qu'à un espace n'ont pas ce contrôle.

Dans la vue des tâches de Maniphest, l'Espace sera également affiché devant le résumé de la tâche. Vous pouvez modifier à l'aide de scripts les tâches pour les déplacer vers un Espace différent.

Notez que vous aurez encore à associer à une tâche, le projet « publique » correspondant (s'il existe) pour faire une tâche dans un Espace restreint (auquel vous avez accès) afin d'apparaître lors des recherches et sur le tableau de bord du projet. Le projet « publique » peut être automatiquement ajouté en demandant une règle globale Herald.

Lorsque vous créez des tâches dans les Espaces, utilisez l'option « Créer une tâche avancée » dans le menu déroulant « Créer une tâche ». Cette option affichera un menu déroulant « Espaces » sous « Visible à » dans l'interface utilisateur de création de tâche qui vous permettra de fixer la visibilité dans l'Espace pour lequel cette tâche devrait être visible.

Si à la place, vous créez une tâche en utilisant l'option « Créer une simple tâche » dans le menu déroulant « Créer une tâche », alors, après que vous l'aurez créée, vous devrez la modifier pour restreindre la visibilité aux membres de l'Espace. Avant cette modification, la tâche sera visible par chacun et les notifications concernant votre tâche pourront avoir été envoyées vers les canaux IRC publics connectés et aux abonnés individuels.

Les modèles MediaWiki et les liens

 * Vous pouvez créer des liens vers les tâches Phabricator dans les pages wiki en utilisant  et son abréviation , par exemple   génère le lien exemple.
 * Le modèle Template:Tracked a été mis à jour pour prendre en compte les liens vers les objets de Phabricator. Regardez sur la droite pour voir comment  est rendu.
 * Le modèle Template:Phabricator est également disponible  génère.

Les liens et modèles Bugzilla existants continueront à fonctionner, parce que ces liens continuent à pointer sur  qui s’occupera de les rediriger vers la tâche Phabricator correspondante.

Statistiques
Phabricator offre des tables montrant les tâches ouvertes triées par priorité, par utilisateur ou par projet. A part cela, Phabricator ne propose pas d'autres statistiques, ni métriques, graphiques, rapports (par exemple dans le temps) ou comme vous voudrez les appeler, qu'ils soient embarqués ou via une API. On every project page you also find a "Reports" link to a Burndown chart for that project. Apart from that, Phabricator doesn't support further statistics, metrics, charts, reports (e.g. over time) or however you may call them, whether built-in or via an API.

Phragile et Phlogiston sont d’autres outils optionnels de rapports d’activité pour Phabricator.

Exporting task data
The results of an Advanced Search query on maniphest/query/advanced/ can be exported to CSV and JSON formats. Use the "Use Results 🡒 Export Data" in the upper right corner. If you are on the workboard of a project, the column header dropdown menu allows you to "View Tasks as Query" per column.

Explorer le code (Diffusion)


Diffusion est le navigateur du dépôt de Phabricator. Une autre option consiste à utiliser les gitiles sur https://gerrit.wikimedia.org/r/plugins/gitiles/?format=HTML pour l'accès en lecture seule sur les mirroirs du dépôt. Actuellement, nous mettons en place certains miroirs des dépôts Git de Phabricator à des fins de démonstration.

Pour demander et configurer un nouveau dépôt pour le code, voir Gerrit/New repositories/Requests.

Champs par défaut (formulaires)


Phabricator autorise certaines personnalisations des champs affichés pour une tâche donnée. Ceci se fait par la fonctionalité Forms.

API (Conduit)
Conduit est le nom de l'API web. https://phabricator.wikimedia.org/conduit/ donne certaines explications et des exemples. Voir la documentation Conduit des versions. Et aussi les robots Phabricator.

Phatality
Phatality est un plugin utilisé afin de simplifier la création de tâches Phabricator pour les erreurs de productions sur les journaux des projets Wikimedia. See Introducing Phatality.

Autres liens

 * Autres
 * OAuth consumer phabricator-production, utilise Special:OAuthManageMyGrants pour la gestion des applications connectées
 * Étiquette sur Phabricator