# PUT /v2/layout/{id}/table Tabellenlayout ändern Ändert Name, Leerzeilen, Zeilenmaße oder Spalten des Tabellenlayouts. Bei columns wird die vollständige neue Spaltenliste übergeben und strikt anhand der Spaltenstruktur validiert. Ein nicht leeres data mit einem beschreibbaren Feld ist erforderlich. - Operation-ID: put_v2_layout_id_table - Dokumentation: /docs/api/v2/operations/put-v2-layout-id-table-249b3a596077/ - OpenAPI-Version: 3.2.1 - Vollständige Spezifikation: /docs/api/v2/openapi.json - Dokumentationsstatus: reviewed - Ändert Zustand: ja - Für Automation freigegeben: nein ## Server Serverwerte stammen unverändert aus der Datei. Eine lokale Entwicklungsadresse ist keine bestätigte Produktionsadresse. `API_ORIGIN` muss auf die passende Instanz gesetzt werden. ```json [ { "url": "https://app2.edoobox.com", "description": "edoobox API" } ] ``` ## Authentifizierung Eine der folgenden Alternativen genügt (ODER). Innerhalb einer Alternative müssen alle Verfahren gemeinsam erfüllt sein (UND). 1. **bearerAuth** (HTTP bearer) — Existing edoobox v2 access token. Never substitute API key/secret headers. **UND** **accountContext** (header: edid) — Selected login/account context from the JWT, not a database primary key. Required even for a JWT with one account. 2. **sessionCookie** (cookie: _edlogin) — Existing browser login session, with the same permission checks as Bearer authentication. **UND** **accountContext** (header: edid) — Selected login/account context from the JWT, not a database primary key. Required even for a JWT with one account. ### Wirksame Security Requirements und vollständige Verfahren ```json { "security": [ { "bearerAuth": [], "accountContext": [] }, { "sessionCookie": [], "accountContext": [] } ], "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Existing edoobox v2 access token. Never substitute API key/secret headers." }, "accountContext": { "type": "apiKey", "in": "header", "name": "edid", "description": "Selected login/account context from the JWT, not a database primary key. Required even for a JWT with one account." }, "sessionCookie": { "type": "apiKey", "in": "cookie", "name": "_edlogin", "description": "Existing browser login session, with the same permission checks as Bearer authentication." } } } ``` ## Parameter | Name | Ort | Pflicht | Beschreibung | | --- | --- | --- | --- | | id | path | ja | Öffentliche v2-ID des ausgewählten Objekts. | | X-Edoobox-If-Revision | header | nein | Optional account mutation revision from a preceding authenticated auth-context snapshot. The dispatcher compares it while holding the account lock; mismatch409 requires a new review. | ### Vollständige wirksame Parameterdefinitionen ```json [ { "name": "id", "in": "path", "required": true, "description": "Öffentliche v2-ID des ausgewählten Objekts.", "schema": { "type": "string", "pattern": "^layouttable_[a-f0-9]{12}_-?[0-9]+$", "description": "Öffentliche v2-ID aus diesem Konto; keine Datenbank-ID. Beispiel ist synthetisch.", "examples": [ "layouttable_012345abcdef_123456" ] } }, { "name": "X-Edoobox-If-Revision", "in": "header", "required": false, "schema": { "type": "string", "pattern": "^[a-f0-9]{32}$", "examples": [ "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ] }, "description": "Optional account mutation revision from a preceding authenticated auth-context snapshot. The dispatcher compares it while holding the account lock; mismatch409 requires a new review." } ] ``` ## Anfrage ```json { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "properties": { "id": false, "status": { "x-edoobox-schemaStatus": "source-inferred", "x-edoobox-sourceLine": 229, "x-edoobox-canonicalType": "boolean", "x-edoobox-normalization": "PHP coercion/normalization is applied by the Structure getter; its return type is not a rejecting wire-input type restriction.", "examples": [ false ] }, "name": { "x-edoobox-canonicalType": "string", "x-edoobox-maxStoredLength": 150, "x-edoobox-normalization": "The aP getter trims text, replaces newlines and limits the legacy escaped storage representation to maxStoredLength UTF-8 characters without splitting escape pairs; aQ decodes the stored representation. Non-string input becomes empty text. This getter limit is normalization, not a rejecting input maxLength or proof of a custom action hook or database column capacity.", "examples": [ "Example" ], "x-edoobox-requiredOnCreate": true, "x-edoobox-sourceLine": 238 }, "empty_rows_top": { "x-edoobox-requiredOnCreate": true, "x-edoobox-schemaStatus": "source-inferred", "x-edoobox-sourceLine": 251, "x-edoobox-canonicalType": "integer", "x-edoobox-normalization": "PHP coercion/normalization is applied by the Structure getter; its return type is not a rejecting wire-input type restriction.", "examples": [ 1 ] }, "empty_rows_bottom": { "x-edoobox-requiredOnCreate": true, "x-edoobox-schemaStatus": "source-inferred", "x-edoobox-sourceLine": 264, "x-edoobox-canonicalType": "integer", "x-edoobox-normalization": "PHP coercion/normalization is applied by the Structure getter; its return type is not a rejecting wire-input type restriction.", "examples": [ 1 ] }, "row_minheight_header": { "x-edoobox-requiredOnCreate": true, "x-edoobox-schemaStatus": "source-inferred", "x-edoobox-sourceLine": 277, "x-edoobox-canonicalType": "integer", "x-edoobox-normalization": "PHP coercion/normalization is applied by the Structure getter; its return type is not a rejecting wire-input type restriction.", "examples": [ 1 ] }, "row_minheight_body": { "x-edoobox-requiredOnCreate": true, "x-edoobox-schemaStatus": "source-inferred", "x-edoobox-sourceLine": 290, "x-edoobox-canonicalType": "integer", "x-edoobox-normalization": "PHP coercion/normalization is applied by the Structure getter; its return type is not a rejecting wire-input type restriction.", "examples": [ 1 ] }, "columns": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "default": "" }, "name": { "type": "string" }, "header_display_names": { "type": "string" }, "header_text_vertical": { "type": "boolean", "default": false }, "header_display_css_class": { "type": "string", "default": "" }, "amount_of_entries": { "type": "integer", "default": 1 }, "type": { "x-edoobox-knownInputs": [ "dates_all", "dates_next", "participation", "custom" ], "x-edoobox-normalization": "Reviewed hook uses PHP loose in_array; these are canonical values, not an exhaustive JSON input enum.", "examples": [ "dates_all" ] }, "type_row_data": { "type": "string" }, "row_text_vertical": { "type": "boolean", "default": false }, "type_row_css_class": { "type": "string", "default": "" }, "width": { "type": "integer" } }, "required": [ "name", "header_display_names", "type", "type_row_data", "width" ], "additionalProperties": true } }, { "type": "object", "additionalProperties": { "type": "object", "properties": { "id": { "type": "string", "default": "" }, "name": { "type": "string" }, "header_display_names": { "type": "string" }, "header_text_vertical": { "type": "boolean", "default": false }, "header_display_css_class": { "type": "string", "default": "" }, "amount_of_entries": { "type": "integer", "default": 1 }, "type": { "x-edoobox-knownInputs": [ "dates_all", "dates_next", "participation", "custom" ], "x-edoobox-normalization": "Reviewed hook uses PHP loose in_array; these are canonical values, not an exhaustive JSON input enum.", "examples": [ "dates_all" ] }, "type_row_data": { "type": "string" }, "row_text_vertical": { "type": "boolean", "default": false }, "type_row_css_class": { "type": "string", "default": "" }, "width": { "type": "integer" } }, "required": [ "name", "header_display_names", "type", "type_row_data", "width" ], "additionalProperties": true } } ], "description": "Column array validated by native _before_addTable and _update_table_columns. Per-column required fields and scalar rejection types are derived from TableColumns. Unknown column keys are dropped by the native validator. Both lists and keyed objects are iterable native inputs; each value is validated as one column.", "x-edoobox-hookDefinition": { "class": "Layoutfunc", "property": "TableColumns", "validator": "validateColumns", "description": "Column array validated by native _before_addTable and _update_table_columns. Per-column required fields and scalar rejection types are derived from TableColumns. Unknown column keys are dropped by the native validator. Both lists and keyed objects are iterable native inputs; each value is validated as one column." }, "x-edoobox-sourceLine": 303 }, "last_change": false }, "additionalProperties": true } }, "additionalProperties": true }, "examples": { "rename": { "summary": "Synthetic supported request; replace all IDs with values read from this account.", "value": { "data": { "name": "Renamed layout" } } } } } } } ``` ## Antworten HTTP-Status und Antwortinhalt gemeinsam auswerten. Die folgenden Beschreibungen und Schemata sind die Angaben der Quelldatei. ```json { "200": { "description": "data.id und update melden, ob das ausgewählte Layout geändert wurde.", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": [ "boolean", "string" ] }, "error_code": { "type": "string" }, "data": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^layouttable_[a-f0-9]{12}_-?[0-9]+$", "description": "Öffentliche v2-ID aus diesem Konto; keine Datenbank-ID. Beispiel ist synthetisch.", "examples": [ "layouttable_012345abcdef_123456" ] }, "update": { "type": "boolean" } }, "additionalProperties": true, "required": [ "id", "update" ] }, "type": { "type": "string" } }, "additionalProperties": true }, "examples": { "updated": { "value": { "error": false, "data": { "update": true, "id": "layouttable_012345abcdef_123456" } } }, "reviewed": { "value": { "error": false, "data": { "id": "layouttable_012345abcdef_123456", "update": true } } } } } }, "headers": { "X-Edoobox-Revision": { "schema": { "type": "string", "pattern": "^[a-f0-9]{32}$" }, "description": "Rotated account revision supplied for the next action in one reviewed sequence." } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "example": { "success": false, "error": "ED40006" } } } }, "401": { "description": "Missing/expired token, missing account context, account paused or model-specific authorization failure.", "content": { "application/json": { "example": { "success": false, "error": "ED40103" } } } }, "402": { "description": "Missing/invalid action data or subscription/operation restriction.", "content": { "application/json": { "example": { "success": false, "error": "ED80100" } } } }, "403": { "description": "Permission denied. Browser CORS rejection may have an empty body.", "content": { "application/json": { "example": { "success": false, "error": "ED40340" } } } }, "404": { "description": "Unknown resource/action or unsupported method.", "content": { "application/json": { "example": { "success": false, "error": "ED80019" } } } }, "409": { "description": "The account changed after the reviewed read. No domain operation is dispatched; obtain fresh state and review again.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "error": "ED40901", "error_code": "mutation_revision_conflict" } } } }, "422": { "description": "Validation failed.", "content": { "application/json": { "example": { "success": false, "error": "ED80020" } } } }, "429": { "description": "Request/login rate limit exceeded. Honor Retry-After when supplied; legacy rate-limit paths may omit it. Retry only proven reads within a bounded deadline; a mutation is never automatically replayed after an ambiguous response.", "content": { "application/json": { "example": { "success": false, "error": "ED42902" } } }, "headers": { "Retry-After": { "description": "Optional server delay in whole seconds or an HTTP date. Absence is not permission for an immediate retry.", "schema": { "type": "string", "examples": [ "30" ] } } } }, "502": { "description": "Server-side operation failed.", "content": { "application/json": { "example": { "success": false, "error": "ED50201" } } } }, "503": { "description": "The account mutation lock or revision store is unavailable. No unprotected fallback is executed.", "headers": { "Retry-After": { "schema": { "type": "integer", "const": 1 } } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "error": "ED50301", "error_code": "mutation_revision_busy" } } } } } ``` ## Aufrufbeispiele Anpassen vor dem Ausführen. Platzhalter und veröffentlichte Beispiele sind synthetisch. Die Beispiele senden hier keine Anfrage; sie ergänzen keine unbekannten Pflichtfelder. ### cURL ```sh # Zeigt Authentifizierungsalternative 1; alle Verfahren dieser Alternative sind gemeinsam erforderlich. # Request Body: synthetisches Beispiel aus der Spezifikation; Werte und Vollständigkeit vor Verwendung prüfen. # cURL: PATH_* bereits URL-kodiert setzen. JavaScript/Python kodieren die unveränderten Pfadwerte selbst. : "${API_ORIGIN:?API_ORIGIN setzen}" : "${AUTH_BEARERAUTH:?AUTH_BEARERAUTH setzen}" : "${AUTH_ACCOUNTCONTEXT:?AUTH_ACCOUNTCONTEXT setzen}" : "${PATH_ID:?PATH_ID setzen}" cat > payload.json <<'EDOOBOX_JSON_EXAMPLE' { "data": { "name": "Renamed layout" } } EDOOBOX_JSON_EXAMPLE curl --request 'PUT' \ --url "${API_ORIGIN%/}"'/v2/layout/'"${PATH_ID}"'/table' \ --header 'Authorization: Bearer '"${AUTH_BEARERAUTH}" \ --header 'edid: '"${AUTH_ACCOUNTCONTEXT}" \ --header 'Content-Type: application/json' \ --data-binary '@payload.json' ``` ### JavaScript (Node.js) ```javascript // Zeigt Authentifizierungsalternative 1; alle Verfahren dieser Alternative sind gemeinsam erforderlich. // Request Body: synthetisches Beispiel aus der Spezifikation; Werte und Vollständigkeit vor Verwendung prüfen. const required = (name) => { const value = process.env[name]; if (!value) throw new Error(`Set ${name}`); return value; }; let path = "/v2/layout/{id}/table"; path = path.replaceAll("{id}", encodeURIComponent(required("PATH_ID"))); const origin = required('API_ORIGIN'); const url = new URL((origin.endsWith('/') ? origin.slice(0, -1) : origin) + path); const headers = {}; headers["Authorization"] = "Bearer " + required("AUTH_BEARERAUTH"); headers["edid"] = "" + required("AUTH_ACCOUNTCONTEXT"); headers['Content-Type'] = "application/json"; const body = JSON.stringify({ "data": { "name": "Renamed layout" } }); const response = await fetch(url, { method: "PUT", headers, body, redirect: 'manual' }); const text = await response.text(); console.log(response.status, text); // HTTP-Status und dokumentierte error/success-Felder gemeinsam prüfen. ``` ### Python ```python # Zeigt Authentifizierungsalternative 1; alle Verfahren dieser Alternative sind gemeinsam erforderlich. # Request Body: synthetisches Beispiel aus der Spezifikation; Werte und Vollständigkeit vor Verwendung prüfen. import os import urllib.parse import urllib.request import urllib.error path = "/v2/layout/{id}/table" path = path.replace("{id}", urllib.parse.quote(os.environ["PATH_ID"], safe="")) url = os.environ["API_ORIGIN"].rstrip("/") + path headers = {} headers["Authorization"] = "Bearer " + os.environ["AUTH_BEARERAUTH"] headers["edid"] = "" + os.environ["AUTH_ACCOUNTCONTEXT"] headers["Content-Type"] = "application/json" body = "{\"data\":{\"name\":\"Renamed layout\"}}".encode("utf-8") # Redirects nicht automatisch verfolgen. class NoRedirect(urllib.request.HTTPRedirectHandler): def redirect_request(self, req, fp, code, msg, headers, newurl): return None request = urllib.request.Request(url, headers=headers, method="PUT", data=body) try: response = urllib.request.build_opener(NoRedirect).open(request, timeout=30) except urllib.error.HTTPError as error: response = error print(response.status, response.read().decode("utf-8", errors="replace")) # HTTP-Status und dokumentierte error/success-Felder gemeinsam prüfen. ``` ## Vollständige Operationsdefinition und edoobox-Hinweise Alle Originalfelder einschliesslich `x-edoobox-*`, requestBody und responses bleiben erhalten. Teilweise dokumentierte Schemata sind kein vollständiger Validierungsvertrag. ```json { "operationId": "put_v2_layout_id_table", "summary": "Tabellenlayout ändern", "description": "Ändert Name, Leerzeilen, Zeilenmaße oder Spalten des Tabellenlayouts. Bei columns wird die vollständige neue Spaltenliste übergeben und strikt anhand der Spaltenstruktur validiert. Ein nicht leeres data mit einem beschreibbaren Feld ist erforderlich.", "tags": [ "layout" ], "security": [ { "bearerAuth": [], "accountContext": [] }, { "sessionCookie": [], "accountContext": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Öffentliche v2-ID des ausgewählten Objekts.", "schema": { "type": "string", "pattern": "^layouttable_[a-f0-9]{12}_-?[0-9]+$", "description": "Öffentliche v2-ID aus diesem Konto; keine Datenbank-ID. Beispiel ist synthetisch.", "examples": [ "layouttable_012345abcdef_123456" ] } }, { "name": "X-Edoobox-If-Revision", "in": "header", "required": false, "schema": { "type": "string", "pattern": "^[a-f0-9]{32}$", "examples": [ "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ] }, "description": "Optional account mutation revision from a preceding authenticated auth-context snapshot. The dispatcher compares it while holding the account lock; mismatch409 requires a new review." } ], "responses": { "200": { "description": "data.id und update melden, ob das ausgewählte Layout geändert wurde.", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": [ "boolean", "string" ] }, "error_code": { "type": "string" }, "data": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^layouttable_[a-f0-9]{12}_-?[0-9]+$", "description": "Öffentliche v2-ID aus diesem Konto; keine Datenbank-ID. Beispiel ist synthetisch.", "examples": [ "layouttable_012345abcdef_123456" ] }, "update": { "type": "boolean" } }, "additionalProperties": true, "required": [ "id", "update" ] }, "type": { "type": "string" } }, "additionalProperties": true }, "examples": { "updated": { "value": { "error": false, "data": { "update": true, "id": "layouttable_012345abcdef_123456" } } }, "reviewed": { "value": { "error": false, "data": { "id": "layouttable_012345abcdef_123456", "update": true } } } } } }, "headers": { "X-Edoobox-Revision": { "schema": { "type": "string", "pattern": "^[a-f0-9]{32}$" }, "description": "Rotated account revision supplied for the next action in one reviewed sequence." } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "example": { "success": false, "error": "ED40006" } } } }, "401": { "description": "Missing/expired token, missing account context, account paused or model-specific authorization failure.", "content": { "application/json": { "example": { "success": false, "error": "ED40103" } } } }, "402": { "description": "Missing/invalid action data or subscription/operation restriction.", "content": { "application/json": { "example": { "success": false, "error": "ED80100" } } } }, "403": { "description": "Permission denied. Browser CORS rejection may have an empty body.", "content": { "application/json": { "example": { "success": false, "error": "ED40340" } } } }, "404": { "description": "Unknown resource/action or unsupported method.", "content": { "application/json": { "example": { "success": false, "error": "ED80019" } } } }, "409": { "description": "The account changed after the reviewed read. No domain operation is dispatched; obtain fresh state and review again.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "error": "ED40901", "error_code": "mutation_revision_conflict" } } } }, "422": { "description": "Validation failed.", "content": { "application/json": { "example": { "success": false, "error": "ED80020" } } } }, "429": { "description": "Request/login rate limit exceeded. Honor Retry-After when supplied; legacy rate-limit paths may omit it. Retry only proven reads within a bounded deadline; a mutation is never automatically replayed after an ambiguous response.", "content": { "application/json": { "example": { "success": false, "error": "ED42902" } } }, "headers": { "Retry-After": { "description": "Optional server delay in whole seconds or an HTTP date. Absence is not permission for an immediate retry.", "schema": { "type": "string", "examples": [ "30" ] } } } }, "502": { "description": "Server-side operation failed.", "content": { "application/json": { "example": { "success": false, "error": "ED50201" } } } }, "503": { "description": "The account mutation lock or revision store is unavailable. No unprotected fallback is executed.", "headers": { "Retry-After": { "schema": { "type": "integer", "const": 1 } } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "error": "ED50301", "error_code": "mutation_revision_busy" } } } } }, "x-edoobox-mutates-state": true, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "properties": { "id": false, "status": { "x-edoobox-schemaStatus": "source-inferred", "x-edoobox-sourceLine": 229, "x-edoobox-canonicalType": "boolean", "x-edoobox-normalization": "PHP coercion/normalization is applied by the Structure getter; its return type is not a rejecting wire-input type restriction.", "examples": [ false ] }, "name": { "x-edoobox-canonicalType": "string", "x-edoobox-maxStoredLength": 150, "x-edoobox-normalization": "The aP getter trims text, replaces newlines and limits the legacy escaped storage representation to maxStoredLength UTF-8 characters without splitting escape pairs; aQ decodes the stored representation. Non-string input becomes empty text. This getter limit is normalization, not a rejecting input maxLength or proof of a custom action hook or database column capacity.", "examples": [ "Example" ], "x-edoobox-requiredOnCreate": true, "x-edoobox-sourceLine": 238 }, "empty_rows_top": { "x-edoobox-requiredOnCreate": true, "x-edoobox-schemaStatus": "source-inferred", "x-edoobox-sourceLine": 251, "x-edoobox-canonicalType": "integer", "x-edoobox-normalization": "PHP coercion/normalization is applied by the Structure getter; its return type is not a rejecting wire-input type restriction.", "examples": [ 1 ] }, "empty_rows_bottom": { "x-edoobox-requiredOnCreate": true, "x-edoobox-schemaStatus": "source-inferred", "x-edoobox-sourceLine": 264, "x-edoobox-canonicalType": "integer", "x-edoobox-normalization": "PHP coercion/normalization is applied by the Structure getter; its return type is not a rejecting wire-input type restriction.", "examples": [ 1 ] }, "row_minheight_header": { "x-edoobox-requiredOnCreate": true, "x-edoobox-schemaStatus": "source-inferred", "x-edoobox-sourceLine": 277, "x-edoobox-canonicalType": "integer", "x-edoobox-normalization": "PHP coercion/normalization is applied by the Structure getter; its return type is not a rejecting wire-input type restriction.", "examples": [ 1 ] }, "row_minheight_body": { "x-edoobox-requiredOnCreate": true, "x-edoobox-schemaStatus": "source-inferred", "x-edoobox-sourceLine": 290, "x-edoobox-canonicalType": "integer", "x-edoobox-normalization": "PHP coercion/normalization is applied by the Structure getter; its return type is not a rejecting wire-input type restriction.", "examples": [ 1 ] }, "columns": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "default": "" }, "name": { "type": "string" }, "header_display_names": { "type": "string" }, "header_text_vertical": { "type": "boolean", "default": false }, "header_display_css_class": { "type": "string", "default": "" }, "amount_of_entries": { "type": "integer", "default": 1 }, "type": { "x-edoobox-knownInputs": [ "dates_all", "dates_next", "participation", "custom" ], "x-edoobox-normalization": "Reviewed hook uses PHP loose in_array; these are canonical values, not an exhaustive JSON input enum.", "examples": [ "dates_all" ] }, "type_row_data": { "type": "string" }, "row_text_vertical": { "type": "boolean", "default": false }, "type_row_css_class": { "type": "string", "default": "" }, "width": { "type": "integer" } }, "required": [ "name", "header_display_names", "type", "type_row_data", "width" ], "additionalProperties": true } }, { "type": "object", "additionalProperties": { "type": "object", "properties": { "id": { "type": "string", "default": "" }, "name": { "type": "string" }, "header_display_names": { "type": "string" }, "header_text_vertical": { "type": "boolean", "default": false }, "header_display_css_class": { "type": "string", "default": "" }, "amount_of_entries": { "type": "integer", "default": 1 }, "type": { "x-edoobox-knownInputs": [ "dates_all", "dates_next", "participation", "custom" ], "x-edoobox-normalization": "Reviewed hook uses PHP loose in_array; these are canonical values, not an exhaustive JSON input enum.", "examples": [ "dates_all" ] }, "type_row_data": { "type": "string" }, "row_text_vertical": { "type": "boolean", "default": false }, "type_row_css_class": { "type": "string", "default": "" }, "width": { "type": "integer" } }, "required": [ "name", "header_display_names", "type", "type_row_data", "width" ], "additionalProperties": true } } ], "description": "Column array validated by native _before_addTable and _update_table_columns. Per-column required fields and scalar rejection types are derived from TableColumns. Unknown column keys are dropped by the native validator. Both lists and keyed objects are iterable native inputs; each value is validated as one column.", "x-edoobox-hookDefinition": { "class": "Layoutfunc", "property": "TableColumns", "validator": "validateColumns", "description": "Column array validated by native _before_addTable and _update_table_columns. Per-column required fields and scalar rejection types are derived from TableColumns. Unknown column keys are dropped by the native validator. Both lists and keyed objects are iterable native inputs; each value is validated as one column." }, "x-edoobox-sourceLine": 303 }, "last_change": false }, "additionalProperties": true } }, "additionalProperties": true }, "examples": { "rename": { "summary": "Synthetic supported request; replace all IDs with values read from this account.", "value": { "data": { "name": "Renamed layout" } } } } } } }, "x-edoobox-action-contract": { "review": "layout-table-put", "status": "source-reviewed-partial", "sources": [ { "file": "application/models/v2/Layout.php", "sha256": "d5bf4faf862da921710d9d2f553b14778a2b78eb8281a2f195dd5d52f9886eaf", "methods": [ "__construct", "setStructure_Table", "postLayout", "updateLayout" ] }, { "file": "application/models/v2/API_DATA.php", "sha256": "c0e15d26a7a4f3fb3c25e35557d4420ad395b2af3925caec292de08e32ebf44c", "methods": [ "return_insert_data", "return_update_data" ] }, { "file": "application/models/v2/Layoutfunc.php", "sha256": "04d3a25db87fd8c8e5f6fd8b6ec9cb899bf3d0bafcc7f286b76381c9e28afdc1", "methods": [ "_before_addTable", "_update_table_columns", "validateColumns" ] } ], "preconditions": [ "Only the selected account owns or changes the layout; placeholder and template expansion use native account context." ], "errors": [ { "error": "ED80100", "meaning": "Required create fields, rejected getter value, or native write validation failed." }, { "error": "ED80023", "meaning": "Generic batch create exceeds 100 records." }, { "error": "ED80100", "error_code": "columns_structure_error" } ], "unresolved": [ "Template placeholders, account data, signed ID integrity and rendering output remain native. Scalar getter coercion is documented without inventing rejecting wire limits." ] }, "x-edoobox-runtimeMutationGuard": true, "x-edoobox-documentationReview": { "file": "docs/openapi/operation-contracts/07-layout-files.json", "notes": [] }, "x-edoobox-source": { "file": "application/models/v2/Layout.php", "method": "updateLayout", "line": 531 }, "x-edoobox-documentationStatus": "reviewed", "x-edoobox-readOnly": false, "x-edoobox-safeForAutomation": false, "x-edoobox-permission": { "resource": "layout", "short": "lyot", "checkedByDispatcher": true, "levels": [ 3, 4 ], "description": "Resource permission mapping from APIPermissions(), Authfunc::_getCheckJWT. Additional model/admin/plugin checks may apply; resources absent from api_permission do not acquire a fictitious scope." } } ```