Phabricator/Ajuda

Phabricator is for software bug reports, feature requests, and planning work.

• To ask technical questions about Wikimedia projects, see m:Tech
• To ask technical questions about MediaWiki in non-WMF installations, see Project:Support desk

Caro utilizador do Phabricator, se tiver dúvidas, por favor, pergunte na página de 'Discussão'. Nós melhoramos a nossa documentação com base nas opiniões recebidas. Se quiser testar o Phabricator, utilize a instância dos 'Serviços da Nuvem'. (A instância de testes infelizmente nem sempre está on-line.)

Para uma visão geral básica do que o Phabricator é e pode fazer, veja os vídeos de tutoriais na Wikimédia Commons:

• Básicos e Ambiente
• Tarefas
• Projetos e Quadros de Trabalho
• Procurar e Listar Tarefas
• Produtividade Individual

See Phabricator/Help/For Wikimedians for the very basics. Ou continue a ler esta página para começar de imediato.

Criar a sua conta

You can connect your new Phabricator account to either your global Wikimedia wiki account or your Wikimedia developer account. In both cases, no separate password is needed.

Utilizar a sua conta wiki global =

• Primeiro, certifique-se que está autenticado na Wikimédia. ** Se ainda não tiver uma conta na Wikimédia, registe-se para uma.
• Vá para a página de autenticação no Phabricator.
• Clique no botão que diz "Iniciar sessão ou Registar-se - MediaWiki".
• O site MediaWiki.org irá pedir-lhe para aprovar a ligação à sua conta do Phabricator.
• O Phabricator irá pedir-lhe um nome de utilizador. Em caso de dúvidas, utilize o seu nome de utilizador da Wikimédia, mas note que os nomes de utilizador do Phabricator não podem conter carateres não ASCII, tais como العَرَبِيةُ ou 中华民族 ou Xï, nem espaços Em vez de um espaço, utilize um sublinhado $4. Instead of a space, use an underscore "_". Também terá de fornecer um endereço válido de correio eletrónico para verificação, mas o seu endereço não estará visível para os outros utilizadores.
• Clique em Gerir na barra de navegação à esquerda ou no menu suspenso por debaixo da imagem de perfil em branco (na barra superior, à esquerda do campo de procura).
• Clique em Editar Perfil e preencha o campo "Também Conhecido Como" (por exemplo, com o seu nome completo) para poder ser localizado mais facilmente.

Utilizar a sua conta de programador da Wikimédia

Se tiver uma conta de programador da Wikimédia – também conhecida como conta LDAP – também pode utilizá-la para se autenticar. O mesmo nome de utilizador do Phabricator pode estar ligado tanto a MediaWiki.org e LDAP. Isto pode funcionar como uma cópia de segurança na eventualidade de Wikimédia SUL (a sua conta wiki global) não estiver a funcionar. If you are WMF staff or contractor, please do also connect your Wikimedia SUL account (your global wiki account) created by WMF ITS.

Ligue as suas contas Wikimédia SUL e de programador a um único nome de utilizador do Phabricator! De outra forma, acabará por criar duas contas separadas do Phabricator.

Autenticação multifatorial

Nós desencorajamos a utilização da autenticação de multifatorial na Wikimédia Phabricator, exceto para os utilizadores que tenham acesso às tarefas de 'Segurança', tarefas que exigem ter um NDA em vigor, e administradores. Se ainda pretende utilizar a autenticação multifatorial, por favor, leia primeiro as linhas diretrizes e requisitos da autenticação multifatorial, e depois pode configurá-lo, se desejar.

Resolução de problemas

Aceder ao Phabricator

• Due to persistent abuse, some IPs from specific countries are blocked from accessing Phabricator. Some proxies, some VPNs and some Tor exit nodes are also blocked. When accessing Phabricator using these IPs, users will see an HTTP error (500 or 501). If your IP is blocked, and you cannot find a usable proxy to access Phabricator, you can contact securitywikimedia.org to request allowlisting your IP.

• If you find that your Phabricator account has been disabled, please add a note on Talk:Phabricator/Help.

Endereços de correio eletrónico

• Se não pode verificar a sua conta Phabricator porque inseriu um endereço de correio eletrónico incorreto, por favor, adicione uma nota em Discussão: Phrabricator/Nota. We can't correct your email address for you, but we can delete your account to allow you to register again.
• If you see the error "Email address already taken" when trying to create a Phabricator account on the page "Login or Register - MediaWiki", you have likely already registered a Phabricator account with such email address. Pode recuperar essa conta utilizando esta hiperligação.

Alteração de contas

• To change your Phabricator username, please add a note on Talk:Phabricator/Help and include a link to your Phabricator profile.
• You can change the global wiki account or developer account connected to your Phabricator account via the "Refresh account" button in your User Settings.

Phabricator MFA code triggers "invalid" error

• An "invalid" error for an entered MFA code can occur if your MFA device's time is out of sync with the device on which you are trying to authenticate. According to RFC 6238, the MFA device can be no more than 89 seconds out of sync with the authentication device.
• If you are using a phone as a MFA device, check that the phone's time is set automatically.

Receber atualizações e notificações

O Phabricator notifica-o das atividades relevantes, incluindo as suas próprias ações.

O Phabricator oferece várias formas de especificar as notificações que desejar receber.

• Se estiver interessado num único objeto (uma tarefa, um protótipo, etc.) clique apenas em Subscrever na respetiva página. Adicionar um comentário causa a subscrição automática do objeto.
• Se estiver interessado em todas as atividades de um projeto, pode clicar Vigiar projeto na página de resumo desse projeto. Existe informação adicional no guia do utilizador Projetos, secção «Vigiar projetos». Note that being a member of a project does not mean that you get notified about project activity.

See Phabricator/Help/Managing mail for reducing the amount of mail notifications and about filtering mail notifications.

Resolução de problemas

If you receive unexpected mail notifications for a task:

• You might be subscribed to the task.

• You might be a member of a project or of a subproject associated to that task. A list of all projects that you are a member of is available.

• You might watch a project associated to that task. A list of all projects that you watch is available.

• In your email preferences under "Maniphest Tasks", you might have enabled "One of a task's subtasks changes status".

• You might have a personal Herald rule set up.

Check the "X-Herald-Rules" message header field to see a list of all applied Herald rules.

• If nothing helps, check the "X-Phabricator-Stamps" message header field for further information.

See Phabricator/Help/Managing mail .

Criar regras mais complexas para as notificações (Herald)

É possível criar regras de notificação personalizadas (pessoal) na Wikimédia Phabricator Herald. Esta é uma opção avançada e não deverá ser utilziada devido a motivos de desempenho.

Criar uma tarefa

One of the Task creation forms. This is the "Simple Form".

Há várias formas de criar uma tarefa, dependendo da informação que quer que ela contenha:

• Uma tarefa nova: clique o botão com uma estrela, na barra de navegação no topo, à direita. A partir do menu descendente, escolha Criar tarefa. Obterá um formulário em branco.
• Um problema de segurança: clique no botão "Marcador" na barra de navegação no topo à direita. A partir do menu suspenso, escolha 'Reportar Problema de Segurança'. Irá ver um formulário pré-etiquetado de 'Segurança' e com uma hiperligação para instruções especiais para preenchimento sobre os erros de segurança.
• Uma subtarefa de uma tarefa existente: clique Editar Tarefas Relacionadas… > Criar Subtarefa na coluna direita da tarefa atual. A dependência entre ambas as tarefas será definida, e alguns dos valores da tarefa principal serão transportados por predefinição (Atribuída a, Subscritores, Prioridade, Projetos). A ligação entre as duas tarefas serão mostradas no "Gráfico de Tarefas". Please review and adjust the project tags and the subscribers before creating a subtask!

Preencha o formulário, deixando inalterados os campos de cujo significado esteja incerto.

Phabricator supports some formatting in text areas. See #Formatting and markup.

Use the live preview at the end of the page to check whether your text looks as you expect.

Selecionar projetos

Para relacionar uma tarefa com um projeto (uma etiqueta de projeto) que usa o Phabricator, só precisa de começar a escrever o nome do mesmo no campo Etiquetas e selecioná-lo da lista de projetos correspondentes (a lista só mostra cinco projetos correspondentes). Também pode pesquisar projetos e ler descrições breves dos mesmos clicando no ícone da lupa no campo Etiquetas. Pode acrescentar um ou mais projetos ao campo Etiquetas. Se estiver incerto, também pode deixar o campo vazio — o processo de triagem endereçará as tarefas que não tenham projeto definido. Está disponível uma (longa) lista de projetos. Clique Editar consulta para pesquisar projetos (esta lista também está disponível em Phabricator/Projetos). You can search for projects and read short project descriptions by clicking the magnifier icon in the Tags field. You can add one or more projects to the Tags field. If you are unsure, you can also leave it empty — triagers will take care of tasks that have no project set. There is a (long) list of projects available. Press Edit Query to search for projects. (This list is also available at Phabricator/Projects.)

Definir a prioridade da tarefa

A prioridade deveria geralmente ser definida pelos gestores do produto, mantenedores, ou programadores que pretendam trabalhar na tarefa, ou por um vigilante de erros ou pelos membros experientes da comunidade, e não pelo autor do relatório do erro nem pelos observadores externos. Para detalhes, consulte gestão de projetos no Phabricator.

Utilizar o correio eletrónico

Também pode criar tarefas enviando uma mensagem de correio eletrónico para task@phabricator.wikimedia.org. O assunto será utilizado como título da tarefa, o texto será utilizado diretamente como está, e os anexos serão incluídos na tarefa. Para definir um projeto, adicione o comando !projects correspondente e a respetiva hashtag no início do texto, por exemplo, !projects #mediawiki-general. Estão disponíveis comandos adicionais para definir o designatário da tarefa, prioridade ou estado via correio eletrónico.

Nota: se a assinatura do seu correio eletrónico não estiver formatada de acordo com o padrão vigente (incluindo «-- » para separá-la do corpo do texto), ela também será publicada. Encorajamos a remoção de informações privadas da sua assinatura à primeira tentativa, para evitar dissabores.

Passar certos valores no URL de criação de tarefa

A hiperligação Reportar um defeito no Phabricator pode passar muitos valores através de parâmetros de URL adicionados à hiperligação genérica para criação de uma tarefa.

Esta é uma funcionalidade muito avançada. Mais informação aqui.

Another option is to request a custom form for task creation which also supports setting a task subtype (e.g. "bug report" or "feature request"). See custom forms.

Estado da tarefa e ciclo de vida

See Bug report life cycle for the meaning of the Status field values.

To close a task as a duplicate of another task, select "Edit Related Tasks… > Close As Duplicate" in the side bar.

Atribuir uma tarefa a si mesmo

Para atribuir uma tarefa a si mesmo:

1. Vá para a tarefa
2. Clique em "Editar Tarefa" na barra lateral de 'Ações' à direita.
3. Adicione o seu nome de utilizador no campo "Atribuída a"
4. Clique em "Guardar Alterações" no fundo

Comentar e editar uma tarefa

Para responder, também precisa de ter uma conta. O Phabricator permite publicar e editar comentários e descrições utilizando a formatação de texto e inserindo imagens ou outros ficheiros; consulte 'Enviar anexos de ficheiros'. Pode utilizar a barra de ferramentas no topo da área de inserção de texto e pode utilizar a própria formatação do Phabricator.

Use the live preview at the end of the page to check whether your text looks as you expect.

To edit the description of a task, select "Edit Task" in the side bar.

Alterar um subtipo de tarefa

The subtype can be edited via the comment area's "actions" section:

Example of changing Phabricator ticket subtype

Formatação e marcação

Phabricator supports some formatting in text areas.

Note que a [$1 própria linguagem de marcação do Phabricator é diferente da marcação do MediaWiki.

A utilização popular de marcação inclui:

• Mencionar utilizadores como no @nome de utilizador irá criar uma hiperligação para os respetivos perfis e irá subscrevê-los à tarefa.
• Adicionar um número de tarefa, como em T123 irá criar uma hiperligação para a tarefa incluindo uma janela flutuante. {T123} insere o título da tarefa no seu texto.
• Adicionar um nome de projeto como no #Projetoirá criar uma hiperligação para a página principal do projeto.
• Se quiser citar um texto, pode simplesmente adicionar > no início. Se quer responder a um comentário incluindo-o como uma citação, clique na seta suspensa à direita no fim do comentário que pretende responder.
• Se quiser exibir um ficheiro de imagem simulado enviado, por exemplo, como M123, integrado no seu comentário, escreva {M123}.
• Se quiser criar uma hiperligação externa, por exemplo, [https://www.mediawiki.org example] em notação de texto wiki, use [example](https://www.mediawiki.org) incluindo os espaços em branco no Phabricator.
• Se você deseja adicionar um endereço da web (link de URL) em um comentário, por exemplo, para fornecer um caso de teste, copie e cole o endereço da web completo da barra de endereços do seu navegador, por exemplo, https://www.mediawiki.org/wiki/Project:Support_desk. Não utilize mw:Project:Support desk. Interwiki prefixes like mw: are not supported in Phabricator.

• If you want to paste lines of code, add a line with three backticks before and after the code: ```.

You can also indent two spaces. Or create a Paste and link to the Paste from the task.

• Use [] item to define list items with checkboxes in the task description.

Change it to [X] item to resolve a list item.

Enviar e anexos de ficheiro

You should upload patches for review to Gerrit , unless it is a security patch.

Aviso:

Phabricator file uploads inherit permissions from the tasks to which they are posted, which often makes them publicly-viewable. See below for more details.

Há várias formas de carregar ficheiros: pode adicionar um ficheiro (por exemplo, uma foto do ecrã) a um comentário ou à descrição de uma tarefa, arrastando-o com o rato. Os utilizadores também podem copiar e inserir imagens usando a área de transferência dos seus sistemas. You can also click the "cloud" icon while editing / creating / commenting on a task and use the dialog.

Se esta não existir no seu sistema, pode usar https://phabricator.wikimedia.org/file/upload/ e referir o número de ficheiro (como «123») que é mostrado depois do carregamento do ficheiro, escrevendo F123 num comentário. Isto criará uma hiperligação para o ficheiro. Para incluir o ficheiro no comentário, coloque o identificador entre chavetas: {F123}. This will create a link to the file. To include the file in the comment, enclose the ID in braces: {F123}. Por omissão, o ficheiro é incluído na forma de miniatura. Para mais opções de formatação, visite Referência de reformatação. Se tem de carregar ficheiros com frequência e considera as opções disponíveis atualmente desconfortáveis, também pode adicionar um painel de texto à sua página inicial com uma hiperligação direta.

The size of the uploaded files is limited to ~4 MB.

Visibilidade de ficheiro

Files uploaded through https://phabricator.wikimedia.org/file/upload/ always become public, visible to everyone. (Keep this in mind in case e.g. the file is related to a restricted security ticket.)

Files uploaded while editing/creating/commenting on a task are private, and visible to no one except the file's uploader, until they are attached to the task (at which point those who can see the task can also see the file).

Tracked in Phabricator
Task T310833

Attaching the file to the task usually happens automatically when you save your changes, but it is possible to bypass this by accident – for example, by uploading the files on one task, then cutting-and-pasting the resulting {F...} markup into another task. When this happens, you (the uploader) will still be able to see the file, but no one else will see it. To resolve this problem, find the "Referenced Files" section in the task's sidebar, then click "File Not Attached" on the files marked in red and follow the scary prompts to attach it.

• Steps to fix file visibility
• 
  Others can't view the file
• 
  You can view the file
• 
  Attaching dialog
• 
  Grant permission dialog
• 
  Confirmation on the task
• 
  Others can view the file now!

Gestão de ficheiros

Se alguma vez precisar de apagar um ficheiro que carregou, abra a lista dos ficheiros de sua autoria, selecione o ficheiro e clique Eliminar ficheiro na barra lateral.

You can also change the visibility of a file by viewing its page (such as https://phabricator.wikimedia.org/F35287447), then clicking "Edit File" in the sidebar and changing the "Visible To" field.

Segurança de acesso ao ficheiro

Note that anyone with the full URL to a file (such as https://phab.wmfusercontent.org/file/data/svlzontonhy6xxdjxwga/PHID-FILE-zbgqfq7jqirt2s24y5e3/red.png, not https://phabricator.wikimedia.org/F35287447) can download the file or share the link with others. There is no authentication protecting these file URLs from being accessed. Phabricator files rely entirely on security through obscurity; guessing the (pseudo-random) URL for any given file would be very difficult, if not impossible. If you need more protection for particularly sensitive files then you should consider a more secure alternative.

Gestão de projetos

Read Phabricator/Project management for essential information on maintaining and managing projects, e.g. on using project workboards, common practices, and agile workflows.

No Phabricator, os projetos são etiquetas e as etiquetas são projetos. Está disponível de fevereiro de 2016 a possibilidades de hierarquizar projetos usando subprojetos. Podem ser atribuídas tarefas a mais de um projeto, e estas também podem ser enviadas sem atribuí-las a qualquer projeto.

Solicitar um novo projeto

Consulte Phabricator/Solicitar um novo projeto.

Quando é que precisa de um projeto?

Em geral, precisa de um projeto...

• Quando tem uma equipa estabelecida a executar um ou mais projetos (comece por aqui, peça mais só quando precisar de mais).
• Quando precisa de um quadro de trabalhos (isto é, de um sprint).
• Quando precisa de uma etiqueta ou palavra-chave para organizar um tipo de tarefa que pode ser parte de qualquer projeto (por exemplo «Acessibilidade»).

Tarefas fonte e subtarefas

As tarefas podem ser uma tarefa fonte ou uma subtarefa de qualquer número de outras tarefas. Se a 'Tarefa A' não pode ser resolvida até que a 'Tarefa B' seja resolvida, então a 'Tarefa A' é a tarefa fonte e a 'tarefa B' é a subtarefa. Tais relações podem ser definidas via "Editar Tarefas relacionadas...". As tarefas fonte e as subtarefas são exibidas sob "Gráfico de Tarefas" na tarefa. Esta funcionalidade pode ser utilizada para realizar algumas coisas diferentes:

• Bloqueadores e Subtarefas. Uma tarefa (fonte) pode ser simplesmente bloqueada por outra (sub)tarefa, que representa uma dependência (consulte como adicionar uma subtarefa).
• Rastreio. Uma tarefa (fonte) "inativa" bloqueada por várias (sub)tarefas pode estar a rastrear uma coleção de (sub)tarefas dentro de um lançamento ou outro período de tempo. Note que 'Rastrear' tem aqui um significado diferente da etiqueta descontinuada #Tracking do Phabricator.
• Aprovação. Várias tarefas (mãe) (como os rascunhos dos objetivos de uma equipa) podem ser bloqueadas por uma única (sub)tarefa que representa as tarefas preliminares em processo de aprovação, após a qual os objetivos preliminares passam a ser objetivos reais.

NOTA: Existe uma funcionalidade «Editar tarefas relacionadas... > Criar subtarefa". Para além de definir corretamente a relação entre a tarefa mãe e a subtarefa, esta funcionalidade também transporta para a subtarefa a lista de subscritores.

Atribuição de prioridade

Consulte Phabricator/Project management#Setting task priorities

Atribuição

Consulte Phabricator/Project management#Assigning tasks

Tarefas de "Rastrear"

Este termo veio do Bugzilla, onde tinha um significado específico: uma tarefa que estava bloqueada por outras, mas que em si mesma não representava nenhum trabalho nem estava ligada a uma versão ou data específica. Um exemplo disto poderia ser uma tarefa chamada Limpar a documentação, que tenha uma variedade de subtarefas, cada uma das quais descreve um trabalho específico a ser feito. Estas tarefas de Rastreio tinham a tendência de ficar em aberto por muito tempo (ou para sempre), porque à medida que as suas subtarefas eram resolvidas outras novas eram criadas. No Phabricator, seria melhor criar um projeto (etiqueta) para categorizar este tipo de trabalho. An example might be a task named "Clean up the documentation", which might then have a variety of subtasks, each of which would describe specific work to be done. These "tracking" tasks tended to stick around for a long time (or forever), as their subtasks would get resolved but new ones would get created. In Phabricator, projects are favored over 'tracking tasks' with dependencies.

Note, contudo, que existem outros tipos de tarefas coordenadoras que continuam a fazer sentido no Phabricator. Em especial, as tarefas «Versão». Uma versão próxima pode ser representada por uma tarefa, que lista como subtarefas todas as tarefas respeitantes aos trabalhos que estão planeados para essa versão. Depois da nova versão ter sido publicada, pode ser marcada como resolvida. Um uso semelhante seria ter uma tarefa que representa os objetivos globais de uma equipa para um trimestre, e depois cada objetivo pode (ou não) vir a ser uma subtarefa bloqueante.

Procurar por itens

Contexto de procura (global vs. aplicação)

O Phabricator consiste em várias aplicações (sendo a gestão de tarefas no Maniphest uma delas e, no futuro, também Diffusion e Differential para revisão de código). O campo de pesquisa no canto superior direito permite efetuar pesquisas sobre todas estas aplicações. There are 2 different search forms:

• The global search at https://phabricator.wikimedia.org/search/query/advanced/.

This one is fairly simple. It is in the upper right corner. By default, it searches across all applications and hence all types of items (open tasks, closed tasks, code commits, etc…). You can change the default context using the arrow menu to the left of the search bar. If you are looking at a task, there is also an "In Maniphest Only" option. Tags specified are unioned (OR'd).

• Application specific search, for example at https://phabricator.wikimedia.org/maniphest/query/advanced/ for Maniphest. This one has more fields, and auto-completion that includes "Not in:..." (equivalent to NOT) and "In any:..." (equivalent to OR) (for example, type "echo" in the "Tags" field). There is also an application specific search for most other applications (e.g. phab:file/query/advanced for Files). To only search for tasks / bug reports, use the Maniphest Search. Tags specified are intersected (AND'd).

Inside Maniphest, custom, saved searches and search options are listed in the navigation bar on the left.

Termos de procura

Special care needs to be put in choosing correct search terms.

Some locally-valid properties for the "Query" field:

• Case insensitive: Edit is the same as eDIt
• phrase search works: "fatal error"
• basic tokenization is performed, e.g. to strip punctuation
• Stemming is performed: "edited" is also found when searching for edit. However, "edited" does not match edit as quoted text does not stem.
• Substring search is supported: ~amp matches example, but amp does not.
• ~"an examp" matches an example as quoted and substring-operator text uses substring search.
• Boolean queries to exclude certain terms are possible by using the - symbol before the unwanted term. E.g. use -non fatal error to exclude "non-fatal" errors from results.
• To only search in a task title but not in the task description or comments, use title:quick ferret which is the same as title:quick title:ferret. To search for one term in the task title and other terms anywhere in a task, use ferret title:quick or title:quick all:ferret. See https://we.phorge.it/book/phorge/article/search/ for more information.

The application search forms are not explicit about the logic but in general use AND between different fields.

You can exclude specific projects from the results by entering not(projectname) (equivalent to NOT) and combine several projects via any(projectname) (equivalent to OR) via the auto-completion suggestions.

There's a limit of 5 items in the maniphest autocomplete.

To increase this limit, see these userscripts for Chrome and for Firefox.

You can search for specific task IDs by leveraging a hidden "IDs" field, revealed when a search URL takes the following format:

https://phabricator.wikimedia.org/maniphest/?ids=1,2,3,4#R

After the field is revealed, while you can still get results by manipulating the URL directly, you can also input directly into the field. The format is the number of the task only (removing the typical T prefix), comma-separated. This can be useful if you are pasting tasks from another place, such as a spreadsheet or database.

Alternatives ways to find something

If you don't remember the exact words used in an item you are looking for you can follow one of these paths:

• use the activity feed and edit the query to be restricted to certain projects or timeframes
• use the activity feed to list all actions that you performed in a certain timeframe at phab:feed/query/EW2FwdAi.Kfz/
• use an external search engine;
• remove all search terms, refine the search only by project etc. and then scan all the possible results manually or use Ctrl+F to search specific strings (this might require setting "Page Size" to a high value to display more than only 100 results);
• file a new task, mentioning that a past report exists as well, and wait for someone to merge the new report to the old.

Selecting Dates and Date Ranges

This is only available in the application search.

Using the Date fields like "Created After" and "Created Before" allow entering absolute and relative dates. Note that Maniphest uses UTC.

To get a list of tasks which were created in the last 24 hours, set the "Created After" field to "-24 hours" or "-1 day". Note that "Updated Before" actually means "Last updated before" and that absolute date values like "2014-11-26" refer to UTC time while your time zone setting might be different.

The "Updated After" and "Updated Before" fields return any and all changes to a task.

For example, when a task is moved to another column in a board it registers as "updated". This may add noise to your search results.

Examples of how Maniphest interprets searches:

• "02/25/2015" – interpreted as "00:01 on February 25th, 2015" (UTC)
• "5 days ago" – interpreted as "00:01 on the fourth calendar day before today" (UTC)
• "2:45 AM 5 days ago" – interpreted as "02:45 on the fourth calendar day before today" (UTC)

The "X days ago" range can be confusing. Phabricator interprets today as part of any data set. Even if it is 12:30 UTC, Phabricator will interpret that as a potential day in the range.

Saving and Managing Searches/Queries

Queries can be saved and managed inside Maniphest.

Maniphest offers links to some predefined search queries in the navigation bar on the left. For example, click authored to get a list of tasks that you have created.

Search query addresses (URL) are stable so you can save and reuse them. You can share the address in your web browser's address bar with other people, e.g. via posting the link on a wikipage.

If you want to save a search, select the "Save Query" button at the bottom of the Search UI.

When looking at the navigation bar on the left in Maniphest, click on the "Edit Queries…" link. You will see a list of your saved queries. All users have a default set which can be deleted in this UI.

Some options in this UI:

• Use the line elements on the left to drag queries up and down in the list.

• The x will permanently delete a Query.

• The Pencil icon allows a user to edit the name of a query

• Clicking on the name of a Query will bring up the search options and results of that query

Once you save a query, you cannot change its parameters, but you can change its name. To edit a query, click on it's name, change parameters and save it as a new query. Also, Phabricator allows users to save multiple queries with the same name.

To make the user name dynamic (e.g. for "Tasks assigned to the person running this query") in searches that you'd like to share with others, select Authors > Magnify glass icon > Browse Users > "Current viewer".

Note that some common queries are also available in the "Activity" tabs on the Phabricator frontpage.

Finding the Maniphest task corresponding to a Bugzilla bug number

This is only available in the Maniphest application Search.

All Phabricator tasks migrated in 2014 from Bugzilla have a Reference field that contains a value bz followed by the number of the equivalent report in Bugzilla. If you want to search the task corresponding to a specific Bugzilla report, use the Reference field in the Maniphest application search or just add 2000.

Reporting spam or abuse

In case of spam or vandalism on Phabricator, the best place to report it is on the #wikimedia-releng ^connect IRC channel. (Wikimedia Foundation staff not on IRC can post in a relevant Slack channel like #engineering-all.)

In case of harassment or offensive behavior, follow the instructions at Code of Conduct#Report a problem .

Funcionalidades avançadas

Usar painéis

Painéis são páginas especialmente desenhadas que podem mostrar uma ampla variedade de informação. Estas podem ser criadas, geridas, e partilhadas entre utilizadores.

Clique aqui para ver uma descrição detalhada dos painéis do Maniphest.

Edições em massa

O Phabricator oferece a possibilidade de executar edições em massa de tarefas. No fim de qualquer consulta de pesquisa no Maniphest encontrará «Edição em Massa Selecionada» para editar todas as tarefas que tiver selecionado usando o Shift-Clique. Os utilizadores que pretendam utilizar esta funcionalidade precisam de se juntar ao grupo de triagem. At the end of any Maniphest search query you will find a "Batch Edit Selected" to edit all the tasks you have selected using Shift-click. Users wanting to use this feature need to join the acl*Batch-Editors group. Note: to see more than 100 tasks at a time, you can update Page Size in the query.

As edições em massa podem ser revertidas anotando o identificador do «Processo de edições em massa» que é gerado no início de uma edição em massa. Pode aceder-se a este identificador clicando «Detalhes» antes ou depois da execução. Na página seguinte, haverá uma entrada «Continuar» no menu à direita, que gera uma consulta de pesquisa no Maniphest de todas as tarefas afetadas.

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 tasks to send typical notifications, ask someone with CLI server access (anyone in the Equipa de Engenharia do Lançamento da Wikimédia , or people listed under phabricator-admin, phabricator-roots, or phabricator-bulk-manager) to silence that specific batch edit before running it, so no notifications will be sent for tasks in that batch edit. Silent batch-moves of tasks from one column to another column (via "Move tasks to column…" in the column header dropdown) on the same workboard are not supported.

Please be mindful about silencing a batch edit. For example, silencing is usually not appropriate for closing tasks as task subscribers would expect to get a notification.

Preferidos

O menu da estrela na barra de navegação ao topo pode ser personalizado com hiperligações para os seus formulários e operações preferidos. Consulte as instruções do Menu do perfil para mais informações.

Listas pessoais de sinalizadores

A funcionalidade «Sinalizar para depois» permite marcar objetos (como tarefas ou revisões) que gostaria de executar posteriormente. Estão disponíveis oito cores de sinalização. Os sinalizadores são pessoais e privados, portanto as suas listas não podem ser partilhadas com outros utilizadores. Os seus objetos sinalizados estão listados em [$flag sinalização]. Estes podem ser pesquisados por cor ou tipo de objeto, em contraste com os [$token símbolos]. Eight flag colors are available. Flags are personal and private so your lists cannot be shared with others. Your flagged objects are listed on flag. They can be searched by color or object type, in contrast to tokens.

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.

Restringir o acesso a tarefas

New tasks

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". This requires using a form which shows the "Visible To" field (for example the default advanced form). Note that setting "All Users" on a task will not restrict access to a task, as everybody can simply create an account and then still access a task with that visibility. To avoid vandalism, this "Visible To" field is only available to users who are members of some ACL projects or WMF-NDA. A list of all projects that you are a member of is available.

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".

Security issues

If you want to file a new Security issue, you must follow Reporting security bugs to make sure that the initial task is not public! An existing task can be converted into a Security issue via "Protect as security issue" in the side bar.

Existing tasks

Access to an existing task can be changed via "Edit Task" and then changing the "Visible To" field to something else than "Public". Note that setting "All Users" on a task will not restrict access to a task, as everybody can simply create an account and then still access a task with that visibility. To avoid vandalism, this "Visible To" field is only available to users who are members of some ACL projects or WMF-NDA. A list of all projects that you are a member of is available.

Apresentar e usar um espaço

Os espaços (documentação a montante) permitem restringir o acesso a grupos de objetos (como tarefas) permitindo só o acesso de membros de um grupo específico. Consulte Phabricator/Criar e alterar o nome de projetos#Restringir o acesso através das normas de espaços para aprender a configurá-los.

Se poder aceder a pelo menos dois espaços, vê um menu descendente adicional «Espaços» abaixo de «Visível para» ao criar e editar um objeto. Os utilizadores com acesso a apenas um espaço não verão este controlo.

Na vista de tarefa do Maniphest, o espaço também é mostrado em frente do resumo da tarefa. Pode editar em massa as tarefas para movê-las para um espaço diferente.

Note que continuará a ter de associar o projeto «público» correspondente (se este existir) a uma tarefa, para fazer com que uma tarefa num espaço restrito (à qual tem acesso) apareça nas consultas de pesquisa e no quadro de trabalhos do projeto. O projeto «público» pode ser automaticamente adicionado pedindo uma regra geral de notificação.

Ao criar tarefas em espaços, use a opção «Criar tarefa avançada» do submenu «Criar tarefa». Esta opção apresentará um menu descendente adicional «Espaços» abaixo de «Visível para» na interface de criação de tarefas, que lhe permite definir a visibilidade como o espaço para o qual esta tarefa deve ser visível.

Se, pelo contrário, criar uma tarefa através da opção «Criar tarefa simples» do menu descendente «Criar tarefa», então, depois de criá-la, terá de editar a tarefa para restringir a visibilidade, permitindo-a só aos membros do espaço. Antes desta edição, a tarefa será visível por qualquer pessoa e as notificações relacionadas com a sua tarefa poderão ter sido enviadas aos canais IRC públicos registados e a outros indivíduos subscritos.

• 
  Vista da criação de tarefas quando se tem acesso a pelo menos dois espaços.
• 
  Vista de tarefa quando a tarefa está num espaço que não é público.
• 
  Vista no quadro de trabalhos de duas tarefas num espaço que não é público.

Hiperligações e predefinições do MediaWiki

Main page: Help:Interwiki linking

Tracked in Phabricator
Task T177
Resolved

• * Pode criar hiperligações para tarefas do Phabricator nas páginas de uma wiki utilizando phabricator: e a versão mais reduzida phab:, por exemplo [[phab:T454|exemplo]] gera exemplo.

• Template:Tracked foi atualizado para incluir hiperligações para os objectos do Phabricator — veja à direita como {{Tracked|T177|resolvido}} é mostrado.

• Template:Phabricator também está disponível; {{Phabricator|T176}} gera T176.

As hiperligações e predefinições existentes do Bugzilla continuarão a funcionar, porque continuam a apontar para bugzilla.wikimedia.org que as redireciona para a respetiva tarefa convertida no Phabricator.

Estatísticas

On every project page you find a "Reports" link in the sidebar. This is mostly useful for team projects. It offers information on task throughput, age of tasks, workload per assignee, distribution of open tasks per workboard column, a burndown chart, and an activity chart. You can also filter the data for a certain time period.

Quanto a tudo o resto, o Phabricator não suporta quaisquer outras estatísticas, métricas, tabelas, relatórios nem o que queira chamar-lhes, quer de raiz quer através de uma API.

O Phabricator disponibiliza tabelas que mostram as tarefas abertas, listadas por prioridade e por utilizador ou projeto.

Some additional overall statistics can be found in the "Phabricator monthly statistics" emails sent to wikitech-l.

Exporting task data

The results of a search query on phab: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.

Diffusion

Further information: Phabricator/Diffusion

Diffusion é o navegador do repositório do Phabricator e a ferramenta de gestão do repositório. Pretendemos substituir eventualmente o Gerrit para revisão e gestão do código, e o gitblit para réplicas só de leitura do repositório. Neste momento, estamos a replicar alguns dos nossos repositórios do Git no Phabricator para fins de demonstração.

To request and set up a new code repository, see Gerrit/New repositories/Requests.

Formulários

Further information: Phabricator/Help/Forms

Phabricator allows some customization of the fields shown for a given task, prefilled values for fields, and setting a task subtype (e.g. "bug report" or "feature request"). These are handled via the Forms feature.

API (Conduit)

Conduit is the name of the web API. https://phabricator.wikimedia.org/conduit/ offers some explanation and examples. See the Conduit upstream documentation. See also Phabricator/Robôs .

Phatality

Phatality is a plugin for the Wikimedia production Logstash installation which makes it easier to create Phabricator tasks for production errors.

See Introducing Phatality.

Automated Regular Search Summaries

• You can get a regular email with the results of a saved Phabricator query.
• The emails are currently delivered by the PhabSearchEmail tool maintained by RhinosF1 on a weekly or monthly basis although, more frequenices can easily be added.
• To request a summary email, fill out this form and let RhinosF1 know your email.

Get Notified about new UBN Tasks

See Setup UBN Notifications

Outras hiperligações

• Outras subpáginas.

• Consumidor OAuth phabricator-production, use Special:OAuthManageMyGrants para gerir aplicações ligadas.

• Etiqueta no Phabricator.

Notes