View source for Note:5

{{Note
|title=Querying Phabricator using Conduit
|tags=Phabricator
}}
Motivation: I would like to be able to visualize the relationships between a set of tasks in Phabricator. That is, for a set of tasks, I want a directed graph showing the parent task/subtask relationships. Bonus if it also shows the tags and/or status on each task.

It should be straightforward to display that in a force-directed graph using [https://d3js.org/ D3] ([http://www.coppelia.io/2014/07/an-a-to-z-of-extra-features-for-the-d3-force-layout/ examples] and [http://bl.ocks.org/MoritzStefaner/1377729 example]) with information queried using the Conduit Phabricator API. The following shows how the required data would be queried.

Visit https://phabricator.wikimedia.org/conduit/method/maniphest.search/. In the query form, fill in:

{| class="wikitable"
! constraints
| {"parentIDs": [174043]}
|-
! attachments
| {"projects": true}
|}

This finds all of the subtasks of T174043 and lists their information including the internal ids of the project tags, which could then also be queried.

The names of the projects can then be found by visiting https://phabricator.wikimedia.org/conduit/method/project.search/. In the query form, fill in:

{| class="wikitable"
! constraints
| {{"phids": ["PHID-PROJ-m7f7bw4ri4xwgnzi7vnt"]}
|}

where the phids are taken from the project tag ids in the results of the previous query.

To create a Coduit API token to be able to make the queries above from scripts or programmatically, visit https://phabricator.wikimedia.org/settings/user/<phabricator user id>/page/apitokens/.

A PHP program to perform the query above is:

<pre>
<?php

define('__ROOT__', '/usr/share/libphutil/src/');
require_once(__ROOT__.'__phutil_library_init__.php');


$api_token = "<insert Conduit API token here>";
$api_parameters = [
	  'constraints' => [
		      'phids' => [
			            'PHID-PROJ-m7f7bw4ri4xwgnzi7vnt'
			],
		],
	];

$client = new ConduitClient('https://phabricator.wikimedia.org/');
$client->setConduitToken($api_token);

$result = $client->callMethodSynchronous('project.search', $api_parameters);
</pre>