How to filter by outlinks

[Ridermansb]

Context

I have several tasks across my Valt like this:

- [x] #Finance/Paid [value::4] for [[PersonA]] about #Rent » 📎 [[2024-12-09 Comprovante Pensão.pdf]] ✅ 2024-12-09

Goal

I have a note called Rent.md where I want to list all the tasks completed for a person (in this case for PersonA.

Tried

# Paied to PersonA
```tasks
preset hide_query_elements
tags includes #Finance/Paid
sort by done desc
group by function task.done.format("yyyy MMM")
filter by function task.outlinks.some( link => link === '[[PersonA]]') 
tags includes #Rent
```

Resources that I use to search about it

• https://publish.obsidian.md/tasks/Queries/Combining+Filters
• https://publish.obsidian.md/tasks/Queries/Filters
• https://publish.obsidian.md/tasks/Scripting/Custom+Filters
• https://publish.obsidian.md/tasks/Getting+Started/Links

Problem

This is not working:
Nothing appear and I do have some tasks

I want to filter tasks that have a specific link, in this case, PersonA.

Question

How to filter tasks that have one or more associated links?

[claremacrae]

(I've edited the query so the sample text has a Copy button)

[claremacrae]

Indeed, this is not the finest of the Tasks documentation...

I've tested with your examples, and these are the easiest options:

If your Tasks query is PersonA.md then either of these will work:

filter by function task.outlinks.some(link => link.linksTo(query.file))
filter by function task.outlinks.some(link => link.destinationPath === query.file.path)

These are good because you don't need to remember to modify the query if you rename the file.

If your Tasks query is in a different file than where the required link goes to, you will have to specify the filename or path in the filter, for example:

filter by function task.outlinks.some(link => link.destinationPath.includes('PersonA'))

[Ridermansb]

Awesome @claremacrae thanks!