使用Asana事件API进行任务监控

Question

我正在尝试使用Asana事件API来跟踪我们的项目之一中的更改，更具体地讲讲各部分之间的任务移动。 我们的工作流程如下：

1. 我们有一个项目，分为几个部分。
2. 每个部分代表过程中的一个步骤。 完成一个步骤后，任务将移至下面的部分。
3. 当给定任务到达特定步骤时，我们要将其传递给外部系统。 它不一定是完整的信息-基本的东西+ url就足够了。

我的想法是使用https://asana.com/developers/api-reference/events实施基于请求的机制，以获取任务中的最新更改。

我的问题是：

1. 事件API似乎会产生很多信息，但不会产生有用的信息。 在各部分之间移动一项任务会生成3个事件（2个“已更改”操作，一个“已添加”操作标记为“系统”）。 在工作期间，许多任务将在许多部分之间移动，但是我对某一特定部分感兴趣。 我如何找到移入该部分的项目？ 我知道这里有一个resource-> text字段，但是它给了我类似的东西， 从X移到Y（ProjectName） ，这很可能是人类可读的消息，将来可能会改变
2. 根据文档， 资源密钥应包含任务数据，但是我看到的唯一信息是id和name ，这不足以满足我的情况。 是否可以使用事件API来控制代码？ 还是任何其他可以使我们对系统中的任务进行分类的数据？
3. 我可以监听特定部分的事件，而不是跟踪整个项目吗？

欢迎提出想法或建议。 谢谢

Answer 1

简而言之：

1. 是的，请在下面回答。
2. 是的，请在下面回答。
3. 不幸的是，部分实际上是具有一些额外功能的任务。 当前，API通过任务的memberships字段（而不是其他方式）来表示节与其中的任务之间的关系。

我认为，这应该可以帮助您实现所需的目标。

假设您有一个包含两个部分的Novice和Expert Ninja Pipeline项目。 请记住，部分实际上只是名称以:字符结尾的任务，其中的一些附加功能可以属于它们。

从孩子到父母的事件“冒泡”； 因此，当您在此项目中的Wombat任务形成Expert的“ Novice部分时，将获得3个事件。 从最高层开始，依次为：

• Ninja Pipeline项目已更改。
• Wombat任务已更改。
• 一个故事被添加到Wombat任务中。

对于您的用例，最有趣的事件是有关任务更改的第二个事件。 现在，您真正想知道的数据是任务已更改任务上的memberships字段的值。 如果它现在是您感兴趣的部分的成员，请采取措施，否则将其忽略。

默认情况下，API中的许多资源以紧凑形式表示，通常只包含id和name 。 使用输入/输出选项以扩展对象或选择所需的特定字段。

在这种情况下，最好的选择是在项目上轮询事件时包括查询参数opt_expand=resource 。 这将扩展有效负载中的所有resource对象。 对于type: "task"事件，然后如果resource.memberships[0].section.id=<id_of_the_section>为true，则采取措施，否则忽略。