Eltern eines Datensatzes (Parents)

Wählen Sie bei einer Map den Typ Eltern, um Eltern-Beziehungen der konfigurierten Relations-Tabelle zu verarbeiten.

Liste der Eltern-Datensätze holen

GET

Ressource
/rest/v5/{identifier}/{childId}

identifier: Identifikator der Page
childId: ID des Kind-Datensatzes

Parameter

Parameter	Beschreibung	Mögliche Werte	optional

Parameter	Beschreibung	Mögliche Werte	optional
withTranslations	Auslieferung der Ergebnisse mit aktiven Fremdsprachen	Zahlen 0 oder 1; Erklärung s.u. *	ja
locale	Auslieferung der Ergebnisse in dieser Kollation	Zeichenkette; Locale einer aktiven Kollation. Standardwert ist de_DE	ja

Response

Array von JSON-Objekten aus Key-Value-Paaren mit Key = Map-Datensatz-Label, Value = gemappter Wert

** Auslieferung des Ergebnisses mit Fremdsprachen

Wird der Parameter withTranslations gesetzt, enthält jedes Objekt einen zusätzlichen Key translations.

Dieser enthält wiederum eine Liste von Objekten mit

Key = Collation-Name (z.B. de_DE)
Value: Objekt aus Key-Value-Paaren mit Key = Map-Datensatz-Label, Value = gemappter Sprach-Wert

Beispiel

[
	{
		"shopArticleSku": "00001",
		"shopArticleName": "Visitenkarte allgemein",
		"shopArticleDescription": "",
		"shopArticleActive": true,
		"meta": {
			"id": 1,
			"userID": 2,
			"userTable": "Administrator",
			"createTime": 1531780172,
			"changeTime": 1670232447
		},
		"translations": {
			"en_GB": {
				"shopArticleName": "Business Card",
				"shopArticleDescription": ""
			},
			"fr_DE": {
				"shopArticleName": "Carte de visite",
				"shopArticleDescription": null
			}
		},
		"links": [
			"/rest/v5/parentsGroupArticle/1",
			"/rest/v5/shopArticleCard/1"
		]
	},
	{
		"shopArticleSku": "00002",
		"shopArticleName": "Visitenkarte Business",
		"shopArticleDescription": "",
		"shopArticleActive": false,
		"meta": {
			"id": 6,
			"userID": 8,
			"userTable": "Administrator",
			"createTime": 1531780172,
			"changeTime": 1670232437
		},
		"translations": {
			"en_GB": {
				"shopArticleName": "Business Card",
				"shopArticleDescription": null
			},
			"fr_DE": {
				"shopArticleName": null,
				"shopArticleDescription": null
			}
		},
		"links": [
			"/rest/v5/parentsGroupArticle/6",
			"/rest/v5/shopArticleCard/6"
		]
	}
]

Datensätze als Eltern verknüpfen

POST

Ressource
/rest/v5/{identifier}/{childId}

identifier: Identifikator der Page
childId: ID des Kind-Datensatzes

Parameter

Parameter	Beschreibung	Mögliche Werte	optional

Parameter	Beschreibung	Mögliche Werte	optional
parentIds[]	Array aus Eltern-Datensatz-IDs	Gültige IDs der in der Page referenzierten Eltern-Tabelle	nein

Hinweise

Ungültige IDs werden ignoriert
Werden keine gültigen IDs übergeben, antwortet der Service mit einem Fehler 103 (fehlende Parameter)
Werden bereits verknüpfte IDs übergeben, antwortet der Service nicht mit einem Fehler

Response

true bei Erfolg, sonst false

Beispiel

true

Datensätze als Eltern neu anordnen

put

Ressource
/rest/v5/{identifier}/{childId}

identifier: Identifikator der Page
childId: ID des Kind-Datensatzes

Parameter

Parameter	Beschreibung	Mögliche Werte	optional

Parameter	Beschreibung	Mögliche Werte	optional
parentIds[]	Array aus Eltern-Datensatz-IDs	Gültige IDs der in der Page referenzierten Eltern-Tabelle	nein

Hinweise

Die übergebenen IDs werden ent- und danach in der übergebenen Reihenfolge neu verknüpft
Ungültige IDs werden ignoriert
Werden keine gültigen IDs übergeben, antwortet der Service mit einem Fehler 103 (fehlende Parameter)
Werden bereits verknüpfte IDs übergeben, antwortet der Service nicht mit einem Fehler
Die Anordnung von Eltern hat in der Praxis praktisch keine Relevanz

Response

true bei Erfolg, sonst false

Beispiel

true

Verküpfungen zu Eltern-Datensätzen entfernen

DELETE

Ressource
/rest/v5/{identifier}/{childId}

identifier: Identifikator der Page
childId: ID des Kind-Datensatzes

Parameter

Parameter	Beschreibung	Mögliche Werte	optional

Parameter	Beschreibung	Mögliche Werte	optional
parentIds[]	Array aus Kind-Datensatz-IDs	Gültige IDs der in der Page referenzierten Eltern-Tabelle	nein

Response

true bei Erfolg, sonst false