Entity Filtering - Quick Reference

Filter Expression Syntax

SELECTOR OPERATOR VALUE

Selectors

Selector Description Example

entity[TYPE].attribute[ATTR]

Filter main entity by type and attribute

entity[VPMReference].attribute[Name]

relationship[*].entity[TYPE].attribute[ATTR]

Filter relationship target by type and attribute

relationship[*].entity[Document].attribute[Title]

relationship[RELATIONSHIP].entity[TYPE].attribute[ATTR]

Filter specific relationship target

relationship[Related Document].entity[Document].attribute[State]

file.name

Filter files by filename directly

file.name contains "Specification"

entity[TYPE].file.name

Filter files by parent entity type

entity[VPMReference].file.name endsWith ".xml"

relationship[*].entity[TYPE].file.name

Filter files with relationship context

relationship[*].entity[Document].file.name startsWith "DOC"

Operators

Operator Description Example

==

Equals (wildcards)

== "DOC-*"

!=

Not equals (wildcards)

!= "TEMP-*"

contains

Contains text

contains "draft"

!contains

Not contains

!contains "obsolete"

startsWith

Starts with

startsWith "DOC"

endsWith

Ends with

endsWith ".pdf"

Common Attributes

  • Title - Entity title

  • Name - Entity name

  • Description - Entity description

  • State - Entity state

  • Type - Entity type

Entity Types

For 3DEXPERIENCE → TX transfers: * Document - Documents * VPMReference - Parts/Assemblies * Drawing - Technical drawings

For TX → 3DEXPERIENCE transfers: * Item - Parts/Assemblies * Document - Documents

Quick Examples

Exclude Documents Starting with "DOC-"

relationship[*].entity[Document].attribute[Title] != "DOC-*"

Exclude Temporary Parts

entity[VPMReference].attribute[Name] != "TEMP-*"

Exclude Released Documents

relationship[*].entity[Document].attribute[State] != "Released"

Exclude Files by Name Pattern

file.name contains "Specification"

Exclude XML Files from Documents

relationship[*].entity[Document].file.name endsWith ".xml"

Exclude Temporary Files from Parts

relationship[*].entity[VPMReference].file.name startsWith "temp_"

Multiple Filters (semicolon separated)

relationship[*].entity[Document].attribute[Title] != "DOC-*";file.name endsWith ".tmp";entity[VPMReference].attribute[Name] != "TEMP-*"

Configuration

Configure filtering through the TIF Cloud Administration UI:

  1. Navigate to your extension configuration

  2. Go to Include in Structure > Entity Filtering

  3. Check Enable Entity Filtering

  4. Add filters in the appropriate direction fields:

    • 3DX → TX Filters: Use 3DEXPERIENCE entity types (VPMReference, Document, Drawing)

    • TX → 3DX Filters: Use TECHNIA Exchange entity types (Item, Document)

Example Configuration

3DX → TX Filters:

relationship[*].entity[Document].attribute[Title] startsWith "DOC-"

TX → 3DX Filters:

entity[Item].attribute[Name] startsWith "TEMP-"