GraphQLRepositoriescustomEntityRelation
entities.customEntityRelation
Read custom entity relation records with the customEntityRelation repository.
- 7 queries
- 0 mutations
Queries
Fields of entities { customEntityRelation { … } }.
| Kind | Field | Returns |
|---|---|---|
| QUERY | getById(entityId: ID!)Returns the record with the given id, or null when there is none. Deleted records are returned as well. | CustomEntityRelationEntity |
| QUERY | getByIds(entityIds: [ID!]!)Returns the records with the given ids; ids without a record are left out. Deleted records are returned as well. | [CustomEntityRelationEntity!]! |
| QUERY | getAll(limit: Int, offset: Int, filter: CustomEntityRelationFilterInput, orderBy: [CustomEntityRelationOrderByInput!], includeDeleted: Boolean)Returns the records that match the filter, paged with limit and offset. | [CustomEntityRelationEntity!]! |
| QUERY | getByCriteria(filter: CustomEntityRelationFilterInput, orderBy: [CustomEntityRelationOrderByInput!], includeDeleted: Boolean, before: String, after: String, first: Int, last: Int)Returns the records that match the filter as a cursor-paginated connection. | CustomEntityRelationEntityConnection |
| QUERY | getPublished(limit: Int, offset: Int, filter: CustomEntityRelationFilterInput, orderBy: [CustomEntityRelationOrderByInput!], includeDeleted: Boolean)Returns the published records that match the filter, paged with limit and offset. | [CustomEntityRelationEntity!]! |
| QUERY | getDrafts(filter: CustomEntityRelationFilterInput, orderBy: [CustomEntityRelationOrderByInput!])Returns the records that match the filter, with pending unpublished changes applied where a draft exists. | [CustomEntityRelationEntity!]! |
| QUERY | getDraftById(entityId: ID!)Returns the record with the given id, with its pending unpublished changes applied when a draft exists. | CustomEntityRelationEntity! |
Types
The types this repository uses, each with its fields and their descriptions. Types several repositories share, such as PageInfo and the filter fields, are in the types index.
CustomEntityRelationEntity object 22 fields: isDeleteProtected, hasDraft, id, …
Custom relation that links records of two entities through a pair of relation fields, one on each side.
| Field | Type | Description |
|---|---|---|
isDeleteProtected | Boolean! | True when the record is protected against deletion because it must always exist in the space. Deleting a record that is not protected can still fail on other checks. Read-only. |
hasDraft | Boolean | True when the record has unpublished draft changes, including pending translation changes, that can be published. |
id | ID! | Unique identifier of entity. |
isDeleted | Boolean | Specifies if the entity is considered deleted. |
modified | DateTime | Last modification time. |
created | DateTime | Creation time. |
field1 | FieldEntity | Lookup field on the first side of the custom relation: the lookup field the relation was created from. |
field2 | FieldEntity | Lookup field on the second side of the custom relation, created automatically on the linked entity. |
entityFilter1 | JSONString | Condition limiting which records of the field_1 entity can be selected in field_2, as a JSON object conforming to the FieldFilter type; empty for no restriction. |
entityFilter2 | JSONString | Condition limiting which records of the field_2 entity can be selected in field_1, as a JSON object conforming to the FieldFilter type; empty for no restriction. |
field1Id | ID! | Id of the lookup field on the first side of the custom relation. |
field2Id | ID! | Id of the lookup field on the second side of the custom relation. |
hasIsPrimary | Boolean | When true, one of the records linked through the relation can be marked as primary. Cannot be switched back to false once enabled. |
showRelated1 | Boolean | When true, field2 offers only records related to the record being edited. Not supported yet; must be false. |
showRelated2 | Boolean | When true, field1 offers only records related to the record being edited (e.g. the contacts of its account). |
showTab1 | Boolean! | When true, the records linked through field1 are shown in a tab named tabName1. |
showTab2 | Boolean! | When true, the records linked through field2 are shown in a tab named tabName2. |
tabName1 | String! | Name of the tab that shows the records linked through field1. |
tabName2 | String! | Name of the tab that shows the records linked through field2. |
isPublished | Boolean | True when the entity configuration is published; false while it exists only as an unpublished draft. |
revision | Int | Revision when entity was lastly changed. |
instancePermissions | [EntityPermsEnum!]! (1 args) | Permissions the current user has on this record, out of the requested ones. |
CustomEntityRelationEntityConnection object pageInfo: PageInfo!, edges: [CustomEntityRelationEntityEdge]!, totalCount: Int
Paginated list of CustomEntityRelation records.
| Field | Type | Description |
|---|---|---|
pageInfo | PageInfo! | Pagination data for this connection. |
edges | [CustomEntityRelationEntityEdge]! | Contains the nodes in this connection. |
totalCount | Int | Total number of items in the connection. |
CustomEntityRelationEntityEdge object node: CustomEntityRelationEntity, cursor: String!
A Relay edge containing a CustomEntityRelationEntity and its cursor.
| Field | Type | Description |
|---|---|---|
node | CustomEntityRelationEntity | The item at the end of the edge |
cursor | String! | A cursor for use in pagination |
CustomEntityRelationFilterInput input AND, OR, NOT, globalSearchQuery, one condition per field
Filter conditions for CustomEntityRelation records. Conditions on different fields are combined with AND; use OR, AND and NOT for other combinations.
| Input field | Type | Description |
|---|---|---|
OR | [CustomEntityRelationFilterInput!] | Matches records that meet at least one of the listed filters. |
AND | [CustomEntityRelationFilterInput!] | Matches records that meet all of the listed filters. |
NOT | CustomEntityRelationFilterInput | Matches records that do not meet this filter. |
globalSearchQuery | String | Search term matched against the fields that the global search covers for this entity. |
id | EntityFilterStringField | Unique identifier of entity. |
isDeleted | Boolean | Specifies if the entity is considered deleted. |
modified | EntityFilterDateTimeField | Last modification time. |
created | EntityFilterDateTimeField | Creation time. |
field1Id | EntityFilterStringField | Id of the lookup field on the first side of the custom relation. |
field2Id | EntityFilterStringField | Id of the lookup field on the second side of the custom relation. |
hasIsPrimary | Boolean | When true, one of the records linked through the relation can be marked as primary. Cannot be switched back to false once enabled. |
showRelated1 | Boolean | When true, field2 offers only records related to the record being edited. Not supported yet; must be false. |
showRelated2 | Boolean | When true, field1 offers only records related to the record being edited (e.g. the contacts of its account). |
showTab1 | Boolean | When true, the records linked through field1 are shown in a tab named tabName1. |
showTab2 | Boolean | When true, the records linked through field2 are shown in a tab named tabName2. |
tabName1 | EntityFilterStringField | Name of the tab that shows the records linked through field1. |
tabName2 | EntityFilterStringField | Name of the tab that shows the records linked through field2. |
isPublished | Boolean | True when the entity configuration is published; false while it exists only as an unpublished draft. |
revision | EntityFilterNumberField | Revision when entity was lastly changed. |
field1 | FieldFilterInput | Lookup field on the first side of the custom relation: the lookup field the relation was created from. Matches records where a related record meets these conditions. |
field2 | FieldFilterInput | Lookup field on the second side of the custom relation, created automatically on the linked entity. Matches records where a related record meets these conditions. |
CustomEntityRelationOrderByInput input Asc or Desc per field
Sorting of CustomEntityRelation records. Set exactly one field in each item; list several items to sort by more fields, in order of priority.
| Input field | Type | Description |
|---|---|---|
id | OrderByEnum | Unique identifier of entity. |
isDeleted | OrderByEnum | Specifies if the entity is considered deleted. |
modified | OrderByEnum | Last modification time. |
created | OrderByEnum | Creation time. |
field1 | [FieldOrderByNestedInput!] | Lookup field on the first side of the custom relation: the lookup field the relation was created from. Sorts by fields of the related record, listed in order of priority. |
field2 | [FieldOrderByNestedInput!] | Lookup field on the second side of the custom relation, created automatically on the linked entity. Sorts by fields of the related record, listed in order of priority. |
field1Id | OrderByEnum | Id of the lookup field on the first side of the custom relation. |
field2Id | OrderByEnum | Id of the lookup field on the second side of the custom relation. |
hasIsPrimary | OrderByEnum | When true, one of the records linked through the relation can be marked as primary. Cannot be switched back to false once enabled. |
showRelated1 | OrderByEnum | When true, field2 offers only records related to the record being edited. Not supported yet; must be false. |
showRelated2 | OrderByEnum | When true, field1 offers only records related to the record being edited (e.g. the contacts of its account). |
showTab1 | OrderByEnum | When true, the records linked through field1 are shown in a tab named tabName1. |
showTab2 | OrderByEnum | When true, the records linked through field2 are shown in a tab named tabName2. |
tabName1 | OrderByEnum | Name of the tab that shows the records linked through field1. |
tabName2 | OrderByEnum | Name of the tab that shows the records linked through field2. |
isPublished | OrderByEnum | True when the entity configuration is published; false while it exists only as an unpublished draft. |
revision | OrderByEnum | Revision when entity was lastly changed. |