From f2e7009baa162bfd8deabbc331fa58cb2037d3b6 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 1 Jul 2026 15:36:39 +0200 Subject: [PATCH] i18n - docs translations (#22400) Created by Github action Review in cubic Co-authored-by: github-actions --- .../developers/extend/apps/data/objects.mdx | 21 +++++++++++++++++++ .../developers/extend/apps/data/objects.mdx | 21 +++++++++++++++++++ .../developers/extend/apps/data/objects.mdx | 21 +++++++++++++++++++ .../developers/extend/apps/data/objects.mdx | 21 +++++++++++++++++++ .../developers/extend/apps/data/objects.mdx | 21 +++++++++++++++++++ .../developers/extend/apps/data/objects.mdx | 21 +++++++++++++++++++ .../developers/extend/apps/data/objects.mdx | 21 +++++++++++++++++++ .../developers/extend/apps/data/objects.mdx | 21 +++++++++++++++++++ .../developers/extend/apps/data/objects.mdx | 21 +++++++++++++++++++ .../developers/extend/apps/data/objects.mdx | 21 +++++++++++++++++++ .../developers/extend/apps/data/objects.mdx | 21 +++++++++++++++++++ .../developers/extend/apps/data/objects.mdx | 21 +++++++++++++++++++ .../developers/extend/apps/data/objects.mdx | 21 +++++++++++++++++++ 13 files changed, 273 insertions(+) diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/data/objects.mdx index 7e959018b8..48ad8a5709 100644 --- a/packages/twenty-docs/l/ar/developers/extend/apps/data/objects.mdx +++ b/packages/twenty-docs/l/ar/developers/extend/apps/data/objects.mdx @@ -97,6 +97,27 @@ export default defineObject({ ينطبق نفس الاصطلاح على الحقول الفرعية النصية للقيم الافتراضية المركّبة (على سبيل المثال `{ source: "'MANUAL'" }` في حقل `ACTOR`) وكذلك على قيم `SELECT`/`MULTI_SELECT`. سيتسبّب ترك قيمة افتراضية نصية حرفية بدون علامات اقتباس في ظهور تحذير عند إنشاء التطبيق. +## قابلية قبول NULL + +`isNullable` تتحكم في ما إذا كان الحقل يقبل `NULL`. القيمة الافتراضية هي `true` — يمكنك حذفها من الحقول الاختيارية. عيِّن `isNullable: false` لجعل الحقل مطلوبًا على مستوى قاعدة البيانات. + +يتم تطبيق التغييرات على `isNullable` في كل عملية مزامنة، بما في ذلك عمليات المزامنة التي تحدّث حقلًا موجودًا — وبالتالي يمكنك تبديل قابلية الحقل لقبول NULL عن طريق تعديل ملف manifest وإعادة المزامنة. + + +**جعل حقل موجود غير قابل لأن يكون فارغًا يتطلب قيمة افتراضية.** عندما تغيّر حقلًا إلى `isNullable: false`، يجب أيضًا توفير `defaultValue` غير فارغ. القيمة الافتراضية تملأ أي صفوف موجودة تحتوي على `NULL` قبل تطبيق القيد `NOT NULL`؛ من دونها تفشل المزامنة مع الخطأ `Default value cannot be null for non-nullable fields`. حقول العلاقات وحقول `TS_VECTOR` تكون دائمًا قابلة لأن تكون فارغة، لذلك لا يكون لـ `isNullable` أي تأثير عليها. + + +```ts +{ + universalIdentifier: 'b1a7c0de-1234-4f00-9abc-000000000000', + name: 'reference', + type: FieldType.TEXT, + label: 'Reference', + isNullable: false, + defaultValue: "'N/A'", +} +``` + ## ماذا بعد؟ * **اربط هذا الكائن بغيره من الكائنات** — راجع صفحة [Relations](/l/ar/developers/extend/apps/data/relations) لمعرفة نمط العلاقة ثنائية الاتجاه. diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/data/objects.mdx index ca0d4cffc7..5dcd4855f7 100644 --- a/packages/twenty-docs/l/cs/developers/extend/apps/data/objects.mdx +++ b/packages/twenty-docs/l/cs/developers/extend/apps/data/objects.mdx @@ -97,6 +97,27 @@ Neuzavřené (necitované) řetězce jsou vyhrazené pro vypočítané výchozí Stejná konvence platí pro řetězcová podpola složených výchozích hodnot (např. `{ source: "'MANUAL'" }` u pole `ACTOR`) a pro hodnoty `SELECT`/`MULTI_SELECT`. Doslovná řetězcová výchozí hodnota ponechaná bez uvozovek vyvolá při sestavení aplikace varování. +## Možnost hodnoty NULL + +`isNullable` určuje, zda pole přijímá `NULL`. Výchozí hodnota je `true` — pro volitelná pole ji můžete vynechat. Nastavte `isNullable: false`, aby bylo pole vyžadováno na úrovni databáze. + +Změny `isNullable` se použijí při každé synchronizaci, včetně těch, které aktualizují existující pole — takže můžete změnit, zda pole přijímá hodnotu NULL, úpravou manifestu a opětovnou synchronizací. + + +**Změna existujícího pole tak, aby neumožňovalo hodnotu NULL, vyžaduje výchozí hodnotu.** Když změníte pole na `isNullable: false`, musíte také zadat nenulovou hodnotu `defaultValue`. Výchozí hodnota doplní všechny existující řádky s hodnotou `NULL` ještě předtím, než se uplatní omezení `NOT NULL`; bez ní synchronizace selže s chybou `Default value cannot be null for non-nullable fields`. Relační pole a pole typu `TS_VECTOR` vždy umožňují hodnotu NULL, takže na ně `isNullable` nemá žádný efekt. + + +```ts +{ + universalIdentifier: 'b1a7c0de-1234-4f00-9abc-000000000000', + name: 'reference', + type: FieldType.TEXT, + label: 'Reference', + isNullable: false, + defaultValue: "'N/A'", +} +``` + ## Co dál * **Propojte tento objekt s ostatními** — vzor obousměrných vztahů najdete v části [Relations](/l/cs/developers/extend/apps/data/relations). diff --git a/packages/twenty-docs/l/de/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/de/developers/extend/apps/data/objects.mdx index 3b45f7ab12..0a5de81c57 100644 --- a/packages/twenty-docs/l/de/developers/extend/apps/data/objects.mdx +++ b/packages/twenty-docs/l/de/developers/extend/apps/data/objects.mdx @@ -97,6 +97,27 @@ Nicht in Anführungszeichen gesetzte Zeichenfolgen sind für berechnete Standard Dieselbe Konvention gilt für Zeichenketten-Unterfelder zusammengesetzter Standardwerte (z. B. `{ source: "'MANUAL'" }` in einem `ACTOR`-Feld) und für `SELECT`-/`MULTI_SELECT`-Werte. Ein wörtlicher Zeichenfolgen-Standardwert, der nicht in Anführungszeichen gesetzt ist, löst beim Build deiner App eine Warnung aus. +## Nullbarkeit + +`isNullable` steuert, ob ein Feld `NULL` akzeptiert. Standardmäßig ist es `true` – lasse es für optionale Felder weg. Setze `isNullable: false`, um ein Feld auf Datenbankebene erforderlich zu machen. + +Änderungen an `isNullable` werden bei jedem Sync angewendet, einschließlich Syncs, die ein vorhandenes Feld aktualisieren – so kannst du die Nullbarkeit eines Feldes ändern, indem du das Manifest bearbeitest und erneut synchronisierst. + + +**Das Ändern eines vorhandenen Feldes in nicht nullbar erfordert einen Standardwert.** Wenn du ein Feld auf `isNullable: false` änderst, musst du auch einen `defaultValue` angeben, der nicht `NULL` ist. Der Standardwert füllt alle vorhandenen `NULL`-Zeilen auf, bevor die `NOT NULL`-Einschränkung angewendet wird; ohne ihn schlägt die Synchronisierung mit `Default value cannot be null for non-nullable fields` fehl. Relationsfelder und `TS_VECTOR`-Felder sind immer nullbar, daher hat `isNullable` keine Auswirkung auf sie. + + +```ts +{ + universalIdentifier: 'b1a7c0de-1234-4f00-9abc-000000000000', + name: 'reference', + type: FieldType.TEXT, + label: 'Reference', + isNullable: false, + defaultValue: "'N/A'", +} +``` + ## Was kommt als Nächstes * **Verbinden Sie dieses Objekt mit anderen** – siehe [Relationen](/l/de/developers/extend/apps/data/relations) für das bidirektionale Relationsmuster. diff --git a/packages/twenty-docs/l/es/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/es/developers/extend/apps/data/objects.mdx index d0cc6cd232..8a03becda1 100644 --- a/packages/twenty-docs/l/es/developers/extend/apps/data/objects.mdx +++ b/packages/twenty-docs/l/es/developers/extend/apps/data/objects.mdx @@ -97,6 +97,27 @@ Las cadenas sin comillas se reservan para valores predeterminados calculados, ev La misma convención se aplica a los subcampos de tipo cadena de los valores predeterminados compuestos (por ejemplo, `{ source: "'MANUAL'" }` en un campo `ACTOR`) y a los valores de `SELECT`/`MULTI_SELECT`. Un valor predeterminado de tipo cadena literal dejado sin comillas genera una advertencia cuando se compila tu aplicación. +## Nulabilidad + +`isNullable` controla si un campo acepta `NULL`. Su valor predeterminado es `true` — omítelo para campos opcionales. Configura `isNullable: false` para hacer que un campo sea obligatorio a nivel de base de datos. + +Los cambios en `isNullable` se aplican en cada sincronización, incluidas las sincronizaciones que actualizan un campo existente; de este modo, puedes cambiar la nulabilidad de un campo editando el manifiesto y sincronizando de nuevo. + + +**Hacer que un campo existente no acepte valores nulos requiere un valor predeterminado.** Cuando cambies un campo a `isNullable: false`, también debes proporcionar un `defaultValue` no nulo. El valor predeterminado rellena cualquier fila `NULL` existente antes de que se aplique la restricción `NOT NULL`; sin él, la sincronización falla con `Default value cannot be null for non-nullable fields`. Los campos de relación y los campos `TS_VECTOR` siempre aceptan valores nulos, por lo que `isNullable` no tiene ningún efecto en ellos. + + +```ts +{ + universalIdentifier: 'b1a7c0de-1234-4f00-9abc-000000000000', + name: 'reference', + type: FieldType.TEXT, + label: 'Reference', + isNullable: false, + defaultValue: "'N/A'", +} +``` + ## ¿Qué sigue? * **Conecta este objeto con otros**: consulta [Relaciones](/l/es/developers/extend/apps/data/relations) para el patrón de relación bidireccional. diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/data/objects.mdx index ba20c8262a..d5943b68de 100644 --- a/packages/twenty-docs/l/fr/developers/extend/apps/data/objects.mdx +++ b/packages/twenty-docs/l/fr/developers/extend/apps/data/objects.mdx @@ -97,6 +97,27 @@ Les chaînes sans guillemets sont réservées aux valeurs par défaut calculées La même convention s’applique aux sous-champs de type chaîne des valeurs par défaut composites (par exemple `{ source: "'MANUAL'" }` sur un champ `ACTOR`) ainsi qu’aux valeurs `SELECT`/`MULTI_SELECT`. Une valeur par défaut littérale de type chaîne laissée sans guillemets génère un avertissement lors de la compilation de votre application. +## Nullabilité + +`isNullable` détermine si un champ accepte `NULL`. Sa valeur par défaut est `true` — omettez-le pour les champs facultatifs. Définissez `isNullable: false` pour rendre un champ obligatoire au niveau de la base de données. + +Les modifications de `isNullable` sont appliquées à chaque synchronisation, y compris celles qui mettent à jour un champ existant — vous pouvez donc modifier la nullabilité d’un champ en éditant le manifeste puis en relançant la synchronisation. + + +**Rendre un champ existant non nullable nécessite une valeur par défaut.** Lorsque vous modifiez un champ avec `isNullable: false`, vous devez également fournir une `defaultValue` non nulle. La valeur par défaut remplit rétroactivement toutes les lignes `NULL` existantes avant que la contrainte `NOT NULL` ne soit appliquée ; sans cela, la synchronisation échoue avec `Default value cannot be null for non-nullable fields`. Les champs de relation et les champs `TS_VECTOR` sont toujours nullables, donc `isNullable` n’a aucun effet sur eux. + + +```ts +{ + universalIdentifier: 'b1a7c0de-1234-4f00-9abc-000000000000', + name: 'reference', + type: FieldType.TEXT, + label: 'Reference', + isNullable: false, + defaultValue: "'N/A'", +} +``` + ## Et après * **Connectez cet objet aux autres** — voir [Relations](/l/fr/developers/extend/apps/data/relations) pour le modèle de relation bidirectionnelle. diff --git a/packages/twenty-docs/l/it/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/it/developers/extend/apps/data/objects.mdx index 2d3d4f869b..61e8b0f634 100644 --- a/packages/twenty-docs/l/it/developers/extend/apps/data/objects.mdx +++ b/packages/twenty-docs/l/it/developers/extend/apps/data/objects.mdx @@ -97,6 +97,27 @@ Le stringhe senza virgolette sono riservate ai valori predefiniti calcolati, val La stessa convenzione si applica ai sotto-campi stringa dei valori compositi predefiniti (ad es. `{ source: "'MANUAL'" }` su un campo `ACTOR`) e ai valori `SELECT`/`MULTI_SELECT`. Una stringa letterale predefinita lasciata senza virgolette genera un avviso quando la tua app viene compilata. +## Nullabilità + +`isNullable` controlla se un campo accetta `NULL`. Il valore predefinito è `true` — omettilo per i campi facoltativi. Imposta `isNullable: false` per rendere un campo obbligatorio a livello di database. + +Le modifiche a `isNullable` vengono applicate a ogni sincronizzazione, incluse quelle che aggiornano un campo esistente — quindi puoi cambiare la nullabilità di un campo modificando il manifest e rieseguendo la sincronizzazione. + + +**Rendere un campo esistente che non ammette `NULL` richiede un valore predefinito.** Quando imposti `isNullable: false` per un campo, devi anche fornire un `defaultValue` non nullo. Il valore predefinito esegue il backfill di tutte le righe `NULL` esistenti prima che venga applicato il vincolo `NOT NULL`; senza di esso la sincronizzazione non riesce con l'errore `Default value cannot be null for non-nullable fields`. I campi di relazione e i campi `TS_VECTOR` ammettono sempre `NULL`, quindi `isNullable` non ha alcun effetto su di essi. + + +```ts +{ + universalIdentifier: 'b1a7c0de-1234-4f00-9abc-000000000000', + name: 'reference', + type: FieldType.TEXT, + label: 'Reference', + isNullable: false, + defaultValue: "'N/A'", +} +``` + ## Cosa c'è dopo * **Collega questo oggetto ad altri** — vedi [Relazioni](/l/it/developers/extend/apps/data/relations) per il pattern di relazione bidirezionale. diff --git a/packages/twenty-docs/l/ja/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/ja/developers/extend/apps/data/objects.mdx index f89b54d305..f569b4ffc2 100644 --- a/packages/twenty-docs/l/ja/developers/extend/apps/data/objects.mdx +++ b/packages/twenty-docs/l/ja/developers/extend/apps/data/objects.mdx @@ -97,6 +97,27 @@ export default defineObject({ 同じ規則が、複合デフォルトの文字列サブフィールド（例: `ACTOR` フィールド上の `{ source: "'MANUAL'" }`）および `SELECT` / `MULTI_SELECT` の値にも適用されます。 引用符で囲まれていないリテラル文字列のデフォルト値がある場合、アプリのビルド時に警告が発生します。 +## NULL 許容性 + +`isNullable` は、フィールドが `NULL` を受け付けるかどうかを制御します。 デフォルトは `true` で、任意のフィールドでは省略できます。 データベースレベルでフィールドを必須にするには、`isNullable: false` を設定します。 + +`isNullable` への変更は、既存フィールドを更新する同期を含め、すべての同期で適用されます。そのため、マニフェストを編集して再同期することで、フィールドの NULL 許容性を切り替えることができます。 + + +**既存のフィールドを NULL 非許容にするには、デフォルト値が必要です。** フィールドを `isNullable: false` に変更する場合は、NULL ではない `defaultValue` も指定する必要があります。 デフォルト値は、`NOT NULL` 制約が適用される前に既存の `NULL` 行をすべてバックフィルします。これがない場合、同期は `Default value cannot be null for non-nullable fields` というエラーで失敗します。 リレーションフィールドおよび `TS_VECTOR` フィールドは常に NULL を許容するため、`isNullable` はそれらには影響しません。 + + +```ts +{ + universalIdentifier: 'b1a7c0de-1234-4f00-9abc-000000000000', + name: 'reference', + type: FieldType.TEXT, + label: 'Reference', + isNullable: false, + defaultValue: "'N/A'", +} +``` + ## 次のステップ * **このオブジェクトを他のオブジェクトに接続する** — 双方向リレーションパターンについては [Relations](/l/ja/developers/extend/apps/data/relations) を参照してください。 diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/data/objects.mdx index 14a0d165f2..d737f36e5b 100644 --- a/packages/twenty-docs/l/ko/developers/extend/apps/data/objects.mdx +++ b/packages/twenty-docs/l/ko/developers/extend/apps/data/objects.mdx @@ -97,6 +97,27 @@ export default defineObject({ 동일한 규칙이 복합 기본값의 문자열 하위 필드(예: `ACTOR` 필드의 `{ source: "'MANUAL'" }`)와 `SELECT`/`MULTI_SELECT` 값에도 적용됩니다. 따옴표로 감싸지 않은 리터럴 문자열 기본값은 앱을 빌드할 때 경고를 발생시킵니다. +## Null 허용 여부 + +`isNullable`는 필드가 `NULL`을 허용하는지 여부를 제어합니다. 기본값은 `true`이며, 선택적 필드의 경우 생략하면 됩니다. 데이터베이스 수준에서 필드를 필수로 만들려면 `isNullable: false`로 설정하세요. + +`isNullable`에 대한 변경 사항은 기존 필드를 업데이트하는 동기화를 포함해 모든 동기화 시 적용되므로, 매니페스트를 수정하고 다시 동기화하여 필드의 Null 허용 여부를 전환할 수 있습니다. + + +**기존 필드를 널 불가(non-nullable)로 변경하려면 기본값이 필요합니다.** 필드를 `isNullable: false`로 변경할 때는 널이 아닌 `defaultValue`도 함께 제공해야 합니다. 기본값은 `NOT NULL` 제약 조건이 적용되기 전에 기존의 `NULL` 행들을 모두 채웁니다. 기본값이 없으면 동기화가 실패하며 `Default value cannot be null for non-nullable fields` 오류가 발생합니다. 릴레이션 필드와 `TS_VECTOR` 필드는 항상 널 허용이므로 `isNullable` 설정이 이들 필드에는 영향을 주지 않습니다. + + +```ts +{ + universalIdentifier: 'b1a7c0de-1234-4f00-9abc-000000000000', + name: 'reference', + type: FieldType.TEXT, + label: 'Reference', + isNullable: false, + defaultValue: "'N/A'", +} +``` + ## 다음 단계 * **이 개체를 다른 개체와 연결** — 양방향 관계 패턴은 [Relations](/l/ko/developers/extend/apps/data/relations)를 참조하세요. diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/data/objects.mdx index 8febcecf86..bbb3f557b8 100644 --- a/packages/twenty-docs/l/pt/developers/extend/apps/data/objects.mdx +++ b/packages/twenty-docs/l/pt/developers/extend/apps/data/objects.mdx @@ -97,6 +97,27 @@ Strings sem aspas são reservadas para valores padrão computados, avaliados qua A mesma convenção se aplica a subcampos de string de valores padrão compostos (por exemplo, `{ source: "'MANUAL'" }` em um campo `ACTOR`) e a valores de `SELECT`/`MULTI_SELECT`. Uma string literal padrão deixada sem aspas gera um aviso quando seu app é compilado. +## Nulabilidade + +`isNullable` controla se um campo aceita `NULL`. O valor padrão é `true` — omita-o para campos opcionais. Defina `isNullable: false` para tornar um campo obrigatório no nível do banco de dados. + +Alterações em `isNullable` são aplicadas em todas as sincronizações, incluindo sincronizações que atualizam um campo existente — assim, você pode alternar a nulabilidade de um campo editando o manifesto e sincronizando novamente. + + +**Tornar um campo existente obrigatório requer um valor padrão.** Quando você altera um campo para `isNullable: false`, também deve fornecer um `defaultValue` não nulo. O valor padrão preenche retroativamente quaisquer linhas `NULL` existentes antes de a restrição `NOT NULL` ser aplicada; sem ele a sincronização falha com `Default value cannot be null for non-nullable fields`. Campos de relação e campos `TS_VECTOR` sempre aceitam nulos, portanto `isNullable` não tem efeito sobre eles. + + +```ts +{ + universalIdentifier: 'b1a7c0de-1234-4f00-9abc-000000000000', + name: 'reference', + type: FieldType.TEXT, + label: 'Reference', + isNullable: false, + defaultValue: "'N/A'", +} +``` + ## O que vem depois * **Conecte este objeto a outros** — veja [Relações](/l/pt/developers/extend/apps/data/relations) para o padrão de relação bidirecional. diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/data/objects.mdx index 29990d4ae3..ad568266cb 100644 --- a/packages/twenty-docs/l/ro/developers/extend/apps/data/objects.mdx +++ b/packages/twenty-docs/l/ro/developers/extend/apps/data/objects.mdx @@ -97,6 +97,27 @@ Valorile implicite de tip șir literal trebuie să fie încadrate în ghilimele Aceeași convenție se aplică și subcâmpurilor de tip șir de caractere ale valorilor implicite compuse (de ex. `{ source: "'MANUAL'" }` pe un câmp `ACTOR`) și valorilor `SELECT`/`MULTI_SELECT`. O valoare implicită literală de tip șir de caractere lăsată neîncadrată în ghilimele generează un avertisment atunci când aplicația este construită. +## Acceptarea valorii NULL + +`isNullable` controlează dacă un câmp acceptă `NULL`. Valoarea sa implicită este `true` — omiteți-l pentru câmpurile opționale. Setați `isNullable: false` pentru a face un câmp obligatoriu la nivel de bază de date. + +Modificările aduse proprietății `isNullable` sunt aplicate la fiecare sincronizare, inclusiv la sincronizările care actualizează un câmp existent — astfel încât puteți schimba nullabilitatea unui câmp editând manifestul și resincronizând. + + +**Transformarea unui câmp existent în non-nullable necesită o valoare implicită.** Atunci când modificați un câmp la `isNullable: false`, trebuie să furnizați și un `defaultValue` nenul. Valoarea implicită completează retroactiv orice rânduri `NULL` existente înainte ca restricția `NOT NULL` să fie aplicată; fără aceasta, sincronizarea eșuează cu mesajul `Default value cannot be null for non-nullable fields`. Câmpurile de relație și câmpurile `TS_VECTOR` sunt întotdeauna nullable, astfel încât `isNullable` nu are niciun efect asupra lor. + + +```ts +{ + universalIdentifier: 'b1a7c0de-1234-4f00-9abc-000000000000', + name: 'reference', + type: FieldType.TEXT, + label: 'Reference', + isNullable: false, + defaultValue: "'N/A'", +} +``` + ## Ce urmează * **Conectați acest obiect la altele** — consultați [Relații](/l/ro/developers/extend/apps/data/relations) pentru modelul de relație bidirecțională. diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/data/objects.mdx index a20da89832..0e2a71b5b1 100644 --- a/packages/twenty-docs/l/ru/developers/extend/apps/data/objects.mdx +++ b/packages/twenty-docs/l/ru/developers/extend/apps/data/objects.mdx @@ -97,6 +97,27 @@ export default defineObject({ Та же конвенция применяется к строковым подполям составных значений по умолчанию (например, `{ source: "'MANUAL'" }` в поле `ACTOR`) и к значениям `SELECT`/`MULTI_SELECT`. Строковый литерал по умолчанию, оставленный без кавычек, вызывает предупреждение при сборке приложения. +## Допустимость значения NULL + +`isNullable` определяет, допускает ли поле значение `NULL`. По умолчанию установлено значение `true` — опускайте этот параметр для необязательных полей. Установите `isNullable: false`, чтобы сделать поле обязательным на уровне базы данных. + +Изменения `isNullable` применяются при каждой синхронизации, включая синхронизации, которые обновляют существующее поле, — таким образом, вы можете изменить допустимость значения NULL для поля, отредактировав манифест и повторно выполнив синхронизацию. + + +**Чтобы сделать существующее поле не допускающим значение NULL, требуется значение по умолчанию.** Когда вы изменяете поле на `isNullable: false`, вы также должны предоставить значение `defaultValue`, отличное от `NULL`. Значение по умолчанию заполняет все существующие строки с `NULL` перед применением ограничения `NOT NULL`; без него синхронизация завершится с ошибкой `Default value cannot be null for non-nullable fields`. Поля связей и поля `TS_VECTOR` всегда допускают значение NULL, поэтому параметр `isNullable` на них не влияет. + + +```ts +{ + universalIdentifier: 'b1a7c0de-1234-4f00-9abc-000000000000', + name: 'reference', + type: FieldType.TEXT, + label: 'Reference', + isNullable: false, + defaultValue: "'N/A'", +} +``` + ## Что дальше * **Свяжите этот объект с другими** — см. [Relations](/l/ru/developers/extend/apps/data/relations) для двунаправленного шаблона связей. diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/data/objects.mdx index 62a51706c8..c11d9809fc 100644 --- a/packages/twenty-docs/l/tr/developers/extend/apps/data/objects.mdx +++ b/packages/twenty-docs/l/tr/developers/extend/apps/data/objects.mdx @@ -97,6 +97,27 @@ Tırnak içine alınmamış dizeler, bir kayıt oluşturulduğunda değerlendiri Aynı kural, bileşik varsayılanların string alt alanları için (örneğin bir `ACTOR` alanında `{ source: "'MANUAL'" }`) ve `SELECT`/`MULTI_SELECT` değerleri için de geçerlidir. Tırnak içine alınmamış bir sabit string varsayılan, uygulamanız oluşturulurken bir uyarıya neden olur. +## Boş değer atanabilirliği + +`isNullable`, bir alanın `NULL` kabul edip etmediğini kontrol eder. Varsayılan değeri `true`'dur — isteğe bağlı alanlar için bunu belirtmeyin. Bir alanı veritabanı düzeyinde zorunlu yapmak için `isNullable: false` olarak ayarlayın. + +`isNullable` değişiklikleri, mevcut bir alanı güncelleyenler de dahil olmak üzere her senkronizasyonda uygulanır — bu nedenle manifesti düzenleyip yeniden senkronize ederek bir alanın boş değer atanabilirliğini değiştirebilirsiniz. + + +**Var olan bir alanı boş değer kabul etmeyecek (non-nullable) hale getirmek için bir varsayılan değer gereklidir.** Bir alanı `isNullable: false` olarak değiştirdiğinizde, ayrıca boş olmayan (non-null) bir `defaultValue` sağlamanız gerekir. Varsayılan değer, `NOT NULL` kısıtlaması uygulanmadan önce mevcut `NULL` satırlarını doldurur; bu olmadan senkronizasyon, `Default value cannot be null for non-nullable fields` hatasıyla başarısız olur. İlişki alanları (relation fields) ve `TS_VECTOR` alanları her zaman boş değere izin verir (nullable), bu yüzden `isNullable` bunlar üzerinde hiçbir etkiye sahip değildir. + + +```ts +{ + universalIdentifier: 'b1a7c0de-1234-4f00-9abc-000000000000', + name: 'reference', + type: FieldType.TEXT, + label: 'Reference', + isNullable: false, + defaultValue: "'N/A'", +} +``` + ## Sırada ne var * **Bu nesneyi diğerlerine bağlayın** — çift yönlü ilişki modeli için [İlişkiler](/l/tr/developers/extend/apps/data/relations) bölümüne bakın. diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/data/objects.mdx index bc12bda751..e1ea7108f4 100644 --- a/packages/twenty-docs/l/zh/developers/extend/apps/data/objects.mdx +++ b/packages/twenty-docs/l/zh/developers/extend/apps/data/objects.mdx @@ -97,6 +97,27 @@ export default defineObject({ 同样的约定也适用于复合默认值的字符串子字段（例如 `ACTOR` 字段上的 `{ source: "'MANUAL'" }`）以及 `SELECT`/`MULTI_SELECT` 值。 在构建应用时，未加引号的字面字符串默认值会触发警告。 +## 可空性 + +`isNullable` 控制字段是否接受 `NULL`。 它默认是 `true` —— 对可选字段可以省略。 将 `isNullable` 设为 `false`，可在数据库层面将字段设为必填。 + +对 `isNullable` 的更改会在每次同步时应用，包括更新现有字段的同步——因此你可以通过编辑 manifest 并重新同步来切换字段的可空性。 + + +**将现有字段改为不可为空时需要提供默认值。** 当你将字段更改为 `isNullable: false` 时，还必须提供一个非空的 `defaultValue`。 在应用 `NOT NULL` 约束之前，默认值会为所有现有的 `NULL` 行进行回填；如果没有默认值，同步将失败，并出现错误：`Default value cannot be null for non-nullable fields`。 关系字段和 `TS_VECTOR` 字段始终可为空，因此 `isNullable` 对它们不起作用。 + + +```ts +{ + universalIdentifier: 'b1a7c0de-1234-4f00-9abc-000000000000', + name: 'reference', + type: FieldType.TEXT, + label: 'Reference', + isNullable: false, + defaultValue: "'N/A'", +} +``` + ## 接下来 * **将此对象与其他对象关联**——关于双向关系模式，参见 [Relations](/l/zh/developers/extend/apps/data/relations)。