Skip to content

The open alternative to Salesforce, designed for AI.

i18n - docs translations (#29351)

twenty-pr[bot]fa3e082c498f
diff --git a/packages/twenty-docs/ar/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/ar/developers/extend/apps/config/roles.mdx
index 96ac5c71560..efdddf5441b 100644
--- a/packages/twenty-docs/ar/developers/extend/apps/config/roles.mdx
+++ b/packages/twenty-docs/ar/developers/extend/apps/config/roles.mdx
@@ -216,12 +216,12 @@ export default defineApplicationRole({
* يُسمح بوجود **استدعاء واحد فقط** لـ `defineApplicationRole(...)` لكل تطبيق — سيفشل إنشاء بيان التطبيق (manifest) إذا عثر على أكثر من واحد.
* استخدم `defineRole()` (وليس `defineApplicationRole()`) لأي أدوار **إضافية** يأتي بها تطبيقك.
-* لا يزال تعيين `defaultRoleUniversalIdentifier` صراحةً على `defineApplication()` مدعومًا للتوافق مع الإصدارات السابقة، ولكنه مُهمَل لصالح `defineApplicationRole()`. يجب أن يتطابق المعرّف مع دور يحدده تطبيقك، وإلا فسيفشل الإصدار.
+* لا يزال تعيين `defaultRoleUniversalIdentifier` صراحةً على `defineApplication()` مدعومًا للتوافق مع الإصدارات السابقة، ولكنه مُهمَل لصالح `defineApplicationRole()`. يمكنه أيضًا تسمية دور لا يعرّفه تطبيقك، مثل الدور الافتراضي المضمّن للتطبيق المخصص لمساحة العمل الذي يحتفظ به `twenty app pull`؛ وعندئذٍ لا يمكن لعملية البناء التحقق من ذلك الدور، لذا يجب أن يكون موجودًا في مساحة العمل المستهدفة.
* يُعد الدور الذي يمكن إسناده إلى أعضاء مساحة العمل أو مفاتيح API (`canBeAssignedToUsers` أو `canBeAssignedToApiKeys`، وكلاهما `true` عند حذفه) دورًا مخصصًا، ويتطلب **خطة Organization أو أعلى**: في الخطط الأخرى يُرفض التثبيت. أبقِ كليهما `false` في الأدوار التي لا يعمل بها سوى تطبيقك ووكلائه.
### أدوار الوكلاء
-دور التطبيق هو ما تراجعه مساحة العمل عند تثبيت تطبيقك، لذا يجب أن يغطي كل ما يمكن للتطبيق نفسه القيام به. يجب ألا يمنح أي دور تُسنده إلى وكيل عبر `roleUniversalIdentifier` في `defineAgent()` صلاحيات أكثر من دور التطبيق: فلا إجراء على كائن، ولا وصول إلى حقل، ولا علامة إذن، ولا نطاق على مستوى الصف يفتقر إليه دور التطبيق. إذا حدث ذلك، يفشل الإصدار مع ظهور خطأ يسرد الصلاحيات الزائدة. لا تخضع الأدوار التي يوفرها تطبيقك لأعضاء مساحة العمل أو مفاتيح API لهذه القاعدة، لأن التطبيق لا يعمل بها مطلقًا.
+دور التطبيق هو ما تراجعه مساحة العمل عند تثبيت تطبيقك، لذا يجب أن يغطي كل ما يمكن للتطبيق نفسه القيام به. يجب ألا يمنح أي دور تُسنده إلى وكيل عبر `roleUniversalIdentifier` في `defineAgent()` صلاحيات أكثر من دور التطبيق: فلا إجراء على كائن، ولا وصول إلى حقل، ولا علامة إذن، ولا نطاق على مستوى الصف يفتقر إليه دور التطبيق. إذا حدث ذلك، يفشل الإصدار مع ظهور خطأ يسرد الصلاحيات الزائدة. لا تخضع الأدوار التي يوفرها تطبيقك لأعضاء مساحة العمل أو مفاتيح API لهذه القاعدة، لأن التطبيق لا يعمل بها مطلقًا. يتطلب التحقق دور التطبيق في مصدر تطبيقك، لذا يتم تخطيه عندما يُعرَّف الدور الافتراضي في مكان آخر.
## أفضل الممارسات
diff --git a/packages/twenty-docs/ar/developers/extend/apps/data/overview.mdx b/packages/twenty-docs/ar/developers/extend/apps/data/overview.mdx
index 359e0a174e6..f543fe83443 100644
--- a/packages/twenty-docs/ar/developers/extend/apps/data/overview.mdx
+++ b/packages/twenty-docs/ar/developers/extend/apps/data/overview.mdx
@@ -57,8 +57,9 @@ import { CardTitle } from "/snippets/card-title.mdx"
| **علاقة** | ارتباط ثنائي الاتجاه بين كائنين — يُصرّح عن كلا الجانبين كحقول | `defineField()` مع `FieldType.RELATION` |
| **الفهرس** | فهرس قاعدة بيانات لتسريع استعلام متكرر على أحد الكائنات لديك | `defineIndex()` |
| **نوع نشاط الجدول الزمني** | حدث تدقيق تلقائي أو حدث مجال صريح يظهر في المخططات الزمنية للسجلات | `defineTimelineActivityType()` |
+| **مسار السجل المرتبط** | سلسلة تضم ما يصل إلى ثلاث علاقات يمتد عبرها الوصول إلى سجل ليشمل سجلاته المرتبطة | `defineRelatedRecordPath()` |
-يكتشف CLI هذه العناصر عبر تحليل AST أثناء وقت البناء، لذا تنظيم الملفات يعود إليك — القاعدة المتّبعة هي `src/objects/` و `src/fields/` و `src/indexes/` و `src/timeline-activity-types/`. معرّفات UUID ثابتة من نوع `universalIdentifier` تربط كل شيء معًا عبر عمليات النشر.
+تكتشف واجهة سطر الأوامر هذه العناصر عبر تحليل AST أثناء وقت البناء، لذا تنظيم الملفات يعود إليك — القاعدة المتّبعة هي `src/objects/` و `src/fields/` و `src/indexes/` و `src/timeline-activity-types/` و `src/related-record-paths/`. معرّفات UUID ثابتة من نوع `universalIdentifier` تربط كل شيء معًا عبر عمليات النشر.
## الفهارس (اختياري)
@@ -104,6 +105,37 @@ defineIndex({
رتّب مصفوفة `fields` بالطريقة التي ينبغي على Postgres استخدامها — العمود في أقصى اليسار أولًا، مثل دليل الهاتف. الفهارس ليست مجانية: كل عملية كتابة في الجدول تقوم بتحديثها. أضِف واحدًا فقط عندما يكون لديك استعلام يحتاج إليه.
+## مسارات السجلات المرتبطة (اختياري)
+
+<Warning>
+ مسارات السجلات المرتبطة متاحة في المعاينة: تتزامن مع تطبيقك، لكن أذونات
+ السجلات لا تستخدمها بعد. عند فرضها، تتطلب
+ **خطة Organization أو أعلى**، مثل
+ [الأمان على مستوى الصف](/ar/developers/extend/apps/config/roles#row-level-security).
+</Warning>
+
+يبدأ مسار سجل مرتبط على كائن ويتبع ما يصل إلى ثلاثة حقول علاقة، يكون كل منها على الكائن الذي وصل إليه الحقل السابق. تستخدم أذونات السجلات هذه المسارات لتوسيع الوصول من سجل إلى سجلاته المرتبطة.
+
+* يُطبَّق المسار **المتأصل** (`isInherent: true`) كلما كان السجل الابتدائي قابلاً للقراءة، مهما كانت طريقة منح ذلك الوصول. استخدمه للسجلات التي تنتمي إلى أصلها، مثل مرفقات بطاقة منشور.
+* يُطبَّق المسار **العادي** فقط عندما يأتي الوصول إلى السجل الابتدائي مباشرةً من دور، بحيث تختار مساحات العمل المسارات التي تعتمد عليها.
+
+```ts src/related-record-paths/post-card-attachments.related-record-path.ts
+import { defineRelatedRecordPath } from 'twenty-sdk/define';
+
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { ATTACHMENTS_ON_POST_CARD_UNIVERSAL_IDENTIFIER } from '../fields/attachments-on-post-card.field';
+
+export default defineRelatedRecordPath({
+ universalIdentifier: 'c1b8f0d2-7e4a-4b6c-9a1d-3f5e2b7c8d90',
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ firstFieldMetadataUniversalIdentifier:
+ ATTACHMENTS_ON_POST_CARD_UNIVERSAL_IDENTIFIER,
+ isInherent: true,
+});
+```
+
+أضف `secondFieldMetadataUniversalIdentifier` و`thirdFieldMetadataUniversalIdentifier` للمسارات الأطول. يجب أن تكون كل قفزة علاقة نشطة على الكائن الذي تم الوصول إليه حتى الآن، ولا يمكن لمسار أن يزور الكائن نفسه مرتين، ولا يمكن لمسارين استخدام القفزات نفسها.
+
<Note>
هل تبحث عن **Application Config** أو **Roles & Permissions**؟ هذه تصف التطبيق نفسه بدلًا من البيانات التي يضيفها — وتوجد ضمن [Config](/ar/developers/extend/apps/config/overview). هل تبحث عن **Connections** (Linear, GitHub, Slack OAuth)؟ هذه وُجِدت ليتم استدعاؤها *من* دوال المنطق وتوجد ضمن [Logic](/ar/developers/extend/apps/logic/connections).
</Note>
diff --git a/packages/twenty-docs/ar/developers/extend/apps/logic/workflows.mdx b/packages/twenty-docs/ar/developers/extend/apps/logic/workflows.mdx
index 2f8e9fad0ee..8e2f029c388 100644
--- a/packages/twenty-docs/ar/developers/extend/apps/logic/workflows.mdx
+++ b/packages/twenty-docs/ar/developers/extend/apps/logic/workflows.mdx
@@ -101,7 +101,7 @@ export default defineWorkflow({
## الخطوات
-تدعم سير العمل في التطبيق أنواع الخطوات التالية: `LOGIC_FUNCTION`، `AI_AGENT`، `HTTP_REQUEST`، `CLASSIFY`، `CREATE_RECORD`، `UPDATE_RECORD`، `UPSERT_RECORD`، `DELETE_RECORD`، `FIND_RECORDS`، `PICK_RECORD`، `FILTER`، `IF_ELSE`، `ITERATOR`، `FORM`، `DELAY`، `WAIT_FOR_EVENT`، `SEND_EMAIL`، `DRAFT_EMAIL`، `CREATE_CALENDAR_EVENT`، و`EMPTY`.
+تدعم سير عمل التطبيق أنواع الخطوات التالية: `LOGIC_FUNCTION`، `AI_AGENT`، `HTTP_REQUEST`، `CLASSIFY`، `CREATE_RECORD`، `UPDATE_RECORD`، `UPSERT_RECORD`، `DELETE_RECORD`، `FIND_RECORDS`، `PICK_RECORD`، `FILTER`، `IF_ELSE`، `ITERATOR`، `FORM`، `DELAY`، `WAIT_FOR_EVENT`، `SEND_EMAIL`، `DRAFT_EMAIL`، `CREATE_CALENDAR_EVENT`، `SEND_CHAT_MESSAGE` و`EMPTY`.
تتطابق مدخلاتها مع خطوات [منشئ سير العمل](/ar/user-guide/workflows/capabilities/workflow-actions)، مع استخدام المعرّفات العامة بدلًا من الأسماء:
@@ -117,6 +117,7 @@ export default defineWorkflow({
* `connectedAccountId`: متغير، مثل `{{trigger.properties.after.connectedAccountId}}`. تتطلب خطوات البريد الإلكتروني أيضًا معرّف عضو مساحة العمل، مثل `{{trigger.properties.after.assigneeId}}`، والذي يُحل إلى أول حساب لذلك العضو قادر على الإرسال.
عيّن واحدًا فقط من الاثنين.
+* ينشر `SEND_CHAT_MESSAGE` في صندوق الوارد لعضو مساحة العمل، والذي يُحدَّد باستخدام `workspaceMemberId`. تكون معرّفات الأعضاء محلية لكل مساحة عمل أيضًا، لذا يمرر التطبيق متغيرًا، مثل `{{trigger.properties.after.assigneeId}}`.
## بعد التثبيت
diff --git a/packages/twenty-docs/es/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/es/developers/extend/apps/config/roles.mdx
index b5a9cac76b0..edb09014ecf 100644
--- a/packages/twenty-docs/es/developers/extend/apps/config/roles.mdx
+++ b/packages/twenty-docs/es/developers/extend/apps/config/roles.mdx
@@ -216,12 +216,12 @@ Notas:
* Se permite exactamente **una** llamada a `defineApplicationRole(...)` por aplicación; la compilación del manifiesto fallará si encuentra más de una.
* Usa `defineRole()` (no `defineApplicationRole()`) para cualquier rol **adicional** que distribuya tu aplicación.
-* Configurar `defaultRoleUniversalIdentifier` explícitamente en `defineApplication()` sigue siendo compatible por motivos de retrocompatibilidad, pero está en desuso en favor de `defineApplicationRole()`. El identificador debe coincidir con un rol que defina tu aplicación; de lo contrario, la compilación falla.
+* Configurar `defaultRoleUniversalIdentifier` explícitamente en `defineApplication()` sigue siendo compatible por motivos de retrocompatibilidad, pero está en desuso en favor de `defineApplicationRole()`. También puede nombrar un rol que su aplicación no define, como el rol predeterminado integrado de la aplicación personalizada del espacio de trabajo que conserva `twenty app pull`; en ese caso, la compilación no puede comprobar ese rol, por lo que debe existir en el espacio de trabajo de destino.
* Un rol al que se pueden asignar miembros del espacio de trabajo o claves de API (`canBeAssignedToUsers` o `canBeAssignedToApiKeys`, ambos `true` cuando se omiten) es un rol personalizado y requiere el **plan Organization o superior**: en otros planes, se rechaza la instalación. Mantén ambos en `false` en los roles que solo tu aplicación y sus agentes asumen.
### Roles de Agente
-El rol de aplicación es lo que un espacio de trabajo revisa al instalar tu aplicación, por lo que debe abarcar todo lo que la propia aplicación puede hacer. Cualquier rol que asignes a un agente mediante `roleUniversalIdentifier` en `defineAgent()` no debe otorgar más que el rol de aplicación: ninguna acción de objeto, acceso a campos, indicador de permiso o ámbito de nivel de fila que el rol de aplicación no tenga. Si lo hace, la compilación falla con un error que enumera las concesiones excedentes. Los roles que tu aplicación distribuye para miembros del espacio de trabajo o claves de API no están sujetos a esta regla, ya que la aplicación nunca se ejecuta con ellos.
+El rol de aplicación es lo que un espacio de trabajo revisa al instalar tu aplicación, por lo que debe abarcar todo lo que la propia aplicación puede hacer. Cualquier rol que asignes a un agente mediante `roleUniversalIdentifier` en `defineAgent()` no debe otorgar más que el rol de aplicación: ninguna acción de objeto, acceso a campos, indicador de permiso o ámbito de nivel de fila que el rol de aplicación no tenga. Si lo hace, la compilación falla con un error que enumera las concesiones excedentes. Los roles que tu aplicación distribuye para miembros del espacio de trabajo o claves de API no están sujetos a esta regla, ya que la aplicación nunca se ejecuta con ellos. La comprobación necesita el rol de aplicación en el código fuente de su aplicación, por lo que se omite cuando el rol predeterminado se define en otro lugar.
## Mejores prácticas
diff --git a/packages/twenty-docs/es/developers/extend/apps/data/overview.mdx b/packages/twenty-docs/es/developers/extend/apps/data/overview.mdx
index 5587ed486e5..1cbd2c0fa18 100644
--- a/packages/twenty-docs/es/developers/extend/apps/data/overview.mdx
+++ b/packages/twenty-docs/es/developers/extend/apps/data/overview.mdx
@@ -57,8 +57,9 @@ La **capa de datos** de una aplicación de Twenty es el conjunto de datos que tu
| **Relación** | Un vínculo bidireccional entre dos objetos: ambos lados se declaran como campos | `defineField()` con `FieldType.RELATION` |
| **Índice** | Un índice de base de datos para acelerar una consulta recurrente sobre uno de tus objetos | `defineIndex()` |
| **Tipo de actividad de la cronología** | Un evento de auditoría automático o un evento de dominio explícito mostrado en las líneas de tiempo de los registros | `defineTimelineActivityType()` |
+| **Ruta de registros relacionados** | Una cadena de hasta tres relaciones a través de las cuales el acceso a un registro se extiende a sus registros relacionados | `defineRelatedRecordPath()` |
-La CLI detecta estos mediante análisis AST en tiempo de compilación, por lo que la organización de archivos depende de ti; la convención es `src/objects/`, `src/fields/`, `src/indexes/` y `src/timeline-activity-types/`. Los UUID `universalIdentifier` estables vinculan todo a través de los despliegues.
+El CLI detecta estas mediante análisis AST en tiempo de compilación, por lo que la organización de archivos depende de ti; la convención es `src/objects/`, `src/fields/`, `src/indexes/`, `src/timeline-activity-types/` y `src/related-record-paths/`. Los UUID `universalIdentifier` estables vinculan todo a través de los despliegues.
## Índices (opcional)
@@ -104,6 +105,34 @@ defineIndex({
Ordena el arreglo `fields` de la forma en que Postgres debería usarlo: la columna más a la izquierda primero, como en una guía telefónica. Los índices no son gratuitos: cada escritura en la tabla los actualiza. Añade uno solo cuando tengas una consulta que lo necesite.
+## Rutas de registros relacionados (opcional)
+
+<Warning>
+ Las rutas de registros relacionados están en vista previa: se sincronizan con tu aplicación, pero los permisos de registros aún no las usan. Una vez aplicadas, requieren el **plan Organization o superior**, como la [seguridad a nivel de fila](/es/developers/extend/apps/config/roles#row-level-security).
+</Warning>
+
+Una ruta de registros relacionados comienza en un objeto y sigue hasta tres campos de relación, cada uno en el objeto al que llegó el anterior. Los permisos de registros usan estas rutas para ampliar el acceso de un registro a sus registros relacionados.
+
+* Una ruta **inherente** (`isInherent: true`) se aplica siempre que se pueda leer el registro inicial, independientemente de cómo se haya concedido ese acceso. Úsala para los registros que pertenecen a su elemento principal, como los archivos adjuntos de una tarjeta de publicación.
+* Una ruta **regular** se aplica solo cuando el acceso al registro inicial proviene directamente de un rol, por lo que los espacios de trabajo eligen en cuáles basarse.
+
+```ts src/related-record-paths/post-card-attachments.related-record-path.ts
+import { defineRelatedRecordPath } from 'twenty-sdk/define';
+
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { ATTACHMENTS_ON_POST_CARD_UNIVERSAL_IDENTIFIER } from '../fields/attachments-on-post-card.field';
+
+export default defineRelatedRecordPath({
+ universalIdentifier: 'c1b8f0d2-7e4a-4b6c-9a1d-3f5e2b7c8d90',
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ firstFieldMetadataUniversalIdentifier:
+ ATTACHMENTS_ON_POST_CARD_UNIVERSAL_IDENTIFIER,
+ isInherent: true,
+});
+```
+
+Agrega `secondFieldMetadataUniversalIdentifier` y `thirdFieldMetadataUniversalIdentifier` para rutas más largas. Cada salto debe ser una relación activa en el objeto al que se ha llegado hasta el momento, una ruta no puede visitar el mismo objeto dos veces y dos rutas no pueden usar los mismos saltos.
+
<Note>
¿Buscas **Application Config** o **Roles & Permissions**? Esos describen la propia aplicación en lugar de los datos que agrega; se encuentran en [Config](/es/developers/extend/apps/config/overview). ¿Buscas **Connections** (Linear, GitHub, Slack OAuth)? Estas existen para ser llamadas *desde* las funciones lógicas y se encuentran en [Logic](/es/developers/extend/apps/logic/connections).
</Note>
diff --git a/packages/twenty-docs/es/developers/extend/apps/logic/workflows.mdx b/packages/twenty-docs/es/developers/extend/apps/logic/workflows.mdx
index c69fb991c70..eb959f170f0 100644
--- a/packages/twenty-docs/es/developers/extend/apps/logic/workflows.mdx
+++ b/packages/twenty-docs/es/developers/extend/apps/logic/workflows.mdx
@@ -101,7 +101,7 @@ Un flujo de trabajo de webhook escucha en `https://\<your-twenty-domain>/webhook
## Pasos
-Los flujos de trabajo de la aplicación admiten estos tipos de pasos: `LOGIC_FUNCTION`, `AI_AGENT`, `HTTP_REQUEST`, `CLASSIFY`, `CREATE_RECORD`, `UPDATE_RECORD`, `UPSERT_RECORD`, `DELETE_RECORD`, `FIND_RECORDS`, `PICK_RECORD`, `FILTER`, `IF_ELSE`, `ITERATOR`, `FORM`, `DELAY`, `WAIT_FOR_EVENT`, `SEND_EMAIL`, `DRAFT_EMAIL`, `CREATE_CALENDAR_EVENT` y `EMPTY`.
+Los flujos de trabajo de la aplicación admiten estos tipos de pasos: `LOGIC_FUNCTION`, `AI_AGENT`, `HTTP_REQUEST`, `CLASSIFY`, `CREATE_RECORD`, `UPDATE_RECORD`, `UPSERT_RECORD`, `DELETE_RECORD`, `FIND_RECORDS`, `PICK_RECORD`, `FILTER`, `IF_ELSE`, `ITERATOR`, `FORM`, `DELAY`, `WAIT_FOR_EVENT`, `SEND_EMAIL`, `DRAFT_EMAIL`, `CREATE_CALENDAR_EVENT`, `SEND_CHAT_MESSAGE` y `EMPTY`.
Sus entradas coinciden con los pasos del [generador de flujos de trabajo](/es/user-guide/workflows/capabilities/workflow-actions), con identificadores universales en lugar de nombres:
@@ -117,6 +117,7 @@ Sus entradas coinciden con los pasos del [generador de flujos de trabajo](/es/us
* `connectedAccountId`: una variable, como `{{trigger.properties.after.connectedAccountId}}`. Los pasos de correo electrónico también aceptan un id de miembro del espacio de trabajo, como `{{trigger.properties.after.assigneeId}}`, que se resuelve en la primera cuenta de ese miembro que puede enviar.
Establece exactamente uno de los dos.
+* `SEND_CHAT_MESSAGE` publica en la bandeja de entrada de un miembro del espacio de trabajo, configurado con `workspaceMemberId`. Los ID de miembro también son locales para cada espacio de trabajo, por lo que una aplicación pasa una variable, como `{{trigger.properties.after.assigneeId}}`.
## Después de la instalación
diff --git a/packages/twenty-docs/it/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/it/developers/extend/apps/config/roles.mdx
index 948be32b574..c9120fc31e4 100644
--- a/packages/twenty-docs/it/developers/extend/apps/config/roles.mdx
+++ b/packages/twenty-docs/it/developers/extend/apps/config/roles.mdx
@@ -222,12 +222,12 @@ Note:
* È consentita esattamente **una** chiamata a `defineApplicationRole(...)` per app — la build del manifest avrà esito negativo se ne trova più di una.
* Usa `defineRole()` (non `defineApplicationRole()`) per qualsiasi ruolo **aggiuntivo** fornito dalla tua app.
-* L’impostazione esplicita di `defaultRoleUniversalIdentifier` in `defineApplication()` è ancora supportata per retrocompatibilità, ma è deprecata a favore di `defineApplicationRole()`. L'identificatore deve corrispondere a un ruolo definito dall'app, altrimenti la build non riesce.
+* L’impostazione esplicita di `defaultRoleUniversalIdentifier` in `defineApplication()` è ancora supportata per retrocompatibilità, ma è deprecata a favore di `defineApplicationRole()`. Può anche indicare un ruolo che la tua app non definisce, come il ruolo predefinito integrato dell'applicazione personalizzata dello spazio di lavoro mantenuto da `twenty app pull`; la compilazione non può quindi verificare quel ruolo, perciò deve esistere nello spazio di lavoro di destinazione.
* Un ruolo a cui possono essere assegnati membri dello spazio di lavoro o chiavi API (`canBeAssignedToUsers` o `canBeAssignedToApiKeys`, entrambi `true` se omessi) è un ruolo personalizzato e richiede il **piano Organization o superiore**: con altri piani l'installazione viene rifiutata. Mantieni entrambi su `false` per i ruoli che vengono eseguiti solo dalla tua app e dai relativi agenti.
### Ruoli agente
-Il ruolo dell'applicazione è ciò che un workspace esamina quando installa la tua app, quindi deve coprire tutto ciò che l'app stessa può fare. Qualsiasi ruolo assegnato a un agente tramite `roleUniversalIdentifier` in `defineAgent()` non deve concedere più del ruolo dell'applicazione: nessuna azione su oggetti, accesso ai campi, flag di autorizzazione o ambito a livello di riga che il ruolo dell'applicazione non possiede. In caso contrario, la compilazione non riesce e viene visualizzato un errore che elenca le concessioni in eccesso. I ruoli che la tua app fornisce per i membri del workspace o le chiavi API non sono soggetti a questa regola, poiché l'app non viene mai eseguita con essi.
+Il ruolo dell'applicazione è ciò che un workspace esamina quando installa la tua app, quindi deve coprire tutto ciò che l'app stessa può fare. Qualsiasi ruolo assegnato a un agente tramite `roleUniversalIdentifier` in `defineAgent()` non deve concedere più del ruolo dell'applicazione: nessuna azione su oggetti, accesso ai campi, flag di autorizzazione o ambito a livello di riga che il ruolo dell'applicazione non possiede. In caso contrario, la compilazione non riesce e viene visualizzato un errore che elenca le concessioni in eccesso. I ruoli che la tua app fornisce per i membri del workspace o le chiavi API non sono soggetti a questa regola, poiché l'app non viene mai eseguita con essi. Il controllo richiede il ruolo dell'applicazione nel codice sorgente della tua app, quindi viene ignorato quando il ruolo predefinito è definito altrove.
## Migliori Pratiche
diff --git a/packages/twenty-docs/it/developers/extend/apps/data/overview.mdx b/packages/twenty-docs/it/developers/extend/apps/data/overview.mdx
index 4f6ed52dad1..77e8cfa2e74 100644
--- a/packages/twenty-docs/it/developers/extend/apps/data/overview.mdx
+++ b/packages/twenty-docs/it/developers/extend/apps/data/overview.mdx
@@ -57,8 +57,9 @@ Il **data layer** di un'app Twenty è l'insieme dei dati che la tua app *aggiung
| **Relazione** | Un collegamento bidirezionale tra due oggetti — entrambi i lati sono dichiarati come campi | `defineField()` con `FieldType.RELATION` |
| **Indice** | Un indice di database per velocizzare una query ricorrente su uno dei tuoi oggetti | `defineIndex()` |
| **Tipo di attività della timeline** | Un evento di audit automatico o un evento di dominio esplicito visualizzato nelle timeline dei record | `defineTimelineActivityType()` |
+| **Percorso del record correlato** | Una catena di un massimo di tre relazioni attraverso la quale l'accesso a un record si estende ai record correlati | `defineRelatedRecordPath()` |
-La CLI rileva questi elementi tramite analisi AST in fase di build, quindi l'organizzazione dei file dipende da te — la convenzione è `src/objects/`, `src/fields/`, `src/indexes/` e `src/timeline-activity-types/`. Gli UUID `universalIdentifier` stabili collegano tutto tra le varie distribuzioni.
+La CLI rileva questi elementi tramite analisi AST in fase di build, quindi l'organizzazione dei file dipende da te — la convenzione è `src/objects/`, `src/fields/`, `src/indexes/`, `src/timeline-activity-types/` e `src/related-record-paths/`. Gli UUID `universalIdentifier` stabili collegano tutto tra le varie distribuzioni.
## Indici (facoltativi)
@@ -104,6 +105,34 @@ defineIndex({
Ordina l'array `fields` nel modo in cui Postgres dovrebbe usarlo — la colonna più a sinistra per prima, come in un elenco telefonico. Gli indici non sono gratuiti: ogni scrittura sulla tabella li aggiorna. Aggiungine uno solo quando hai una query che ne ha bisogno.
+## Percorsi dei record correlati (opzionale)
+
+<Warning>
+ I percorsi di record correlati sono in anteprima: si sincronizzano con la tua app, ma le autorizzazioni dei record non li utilizzano ancora. Una volta applicati, richiedono il **piano Organization o superiore**, come la [sicurezza a livello di riga](/it/developers/extend/apps/config/roles#row-level-security).
+</Warning>
+
+Un percorso di record correlato inizia su un oggetto e segue fino a tre campi di relazione, ciascuno sull'oggetto raggiunto dal precedente. Le autorizzazioni dei record utilizzano questi percorsi per estendere l'accesso da un record ai relativi record correlati.
+
+* Un percorso **intrinseco** (`isInherent: true`) si applica ogni volta che il record iniziale è leggibile, indipendentemente da come sia stato concesso l'accesso. Usalo per i record che appartengono al relativo elemento padre, come gli allegati di una scheda di post.
+* Un percorso **normale** si applica solo quando l'accesso al record iniziale deriva direttamente da un ruolo, quindi gli spazi di lavoro scelgono su quali fare affidamento.
+
+```ts src/related-record-paths/post-card-attachments.related-record-path.ts
+import { defineRelatedRecordPath } from 'twenty-sdk/define';
+
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { ATTACHMENTS_ON_POST_CARD_UNIVERSAL_IDENTIFIER } from '../fields/attachments-on-post-card.field';
+
+export default defineRelatedRecordPath({
+ universalIdentifier: 'c1b8f0d2-7e4a-4b6c-9a1d-3f5e2b7c8d90',
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ firstFieldMetadataUniversalIdentifier:
+ ATTACHMENTS_ON_POST_CARD_UNIVERSAL_IDENTIFIER,
+ isInherent: true,
+});
+```
+
+Aggiungi `secondFieldMetadataUniversalIdentifier` e `thirdFieldMetadataUniversalIdentifier` per percorsi più lunghi. Ogni passaggio deve essere una relazione attiva sull'oggetto raggiunto fino a quel momento, un percorso non può visitare lo stesso oggetto due volte e due percorsi non possono utilizzare gli stessi passaggi.
+
<Note>
Cerchi **Application Config** o **Roles & Permissions**? Quelli descrivono l'app in sé piuttosto che i dati che aggiunge — si trovano sotto [Config](/it/developers/extend/apps/config/overview). Cerchi **Connections** (Linear, GitHub, Slack OAuth)? Quelle esistono per essere chiamate *dalle* funzioni di logica e si trovano sotto [Logic](/it/developers/extend/apps/logic/connections).
</Note>
diff --git a/packages/twenty-docs/it/developers/extend/apps/logic/workflows.mdx b/packages/twenty-docs/it/developers/extend/apps/logic/workflows.mdx
index 415f43583b7..ae0288479ba 100644
--- a/packages/twenty-docs/it/developers/extend/apps/logic/workflows.mdx
+++ b/packages/twenty-docs/it/developers/extend/apps/logic/workflows.mdx
@@ -101,7 +101,7 @@ Un workflow webhook resta in ascolto su `https://\<your-twenty-domain>/webhooks/
## Passaggi
-I workflow dell'applicazione supportano questi tipi di passaggio: `LOGIC_FUNCTION`, `AI_AGENT`, `HTTP_REQUEST`, `CLASSIFY`, `CREATE_RECORD`, `UPDATE_RECORD`, `UPSERT_RECORD`, `DELETE_RECORD`, `FIND_RECORDS`, `PICK_RECORD`, `FILTER`, `IF_ELSE`, `ITERATOR`, `FORM`, `DELAY`, `WAIT_FOR_EVENT`, `SEND_EMAIL`, `DRAFT_EMAIL`, `CREATE_CALENDAR_EVENT` e `EMPTY`.
+I workflow dell'applicazione supportano questi tipi di passaggio: `LOGIC_FUNCTION`, `AI_AGENT`, `HTTP_REQUEST`, `CLASSIFY`, `CREATE_RECORD`, `UPDATE_RECORD`, `UPSERT_RECORD`, `DELETE_RECORD`, `FIND_RECORDS`, `PICK_RECORD`, `FILTER`, `IF_ELSE`, `ITERATOR`, `FORM`, `DELAY`, `WAIT_FOR_EVENT`, `SEND_EMAIL`, `DRAFT_EMAIL`, `CREATE_CALENDAR_EVENT`, `SEND_CHAT_MESSAGE` e `EMPTY`.
I relativi input corrispondono ai passaggi del [generatore di workflow](/it/user-guide/workflows/capabilities/workflow-actions), con identificatori universali al posto dei nomi:
@@ -117,6 +117,7 @@ I relativi input corrispondono ai passaggi del [generatore di workflow](/it/user
* `connectedAccountId`: una variabile, ad esempio `{{trigger.properties.after.connectedAccountId}}`. I passaggi Email accettano anche un ID membro dell'area di lavoro, ad esempio `{{trigger.properties.after.assigneeId}}`, che viene risolto nel primo account di quel membro in grado di inviare.
Imposta esattamente uno dei due.
+* `SEND_CHAT_MESSAGE` invia un messaggio alla posta in arrivo di un membro del workspace, impostato con `workspaceMemberId`. Anche gli ID dei membri sono locali a ciascun workspace, quindi un'app passa una variabile, ad esempio `{{trigger.properties.after.assigneeId}}`.
## Dopo l'installazione
diff --git a/packages/twenty-docs/ro/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/ro/developers/extend/apps/config/roles.mdx
index e798b7e3feb..27fe38b03b7 100644
--- a/packages/twenty-docs/ro/developers/extend/apps/config/roles.mdx
+++ b/packages/twenty-docs/ro/developers/extend/apps/config/roles.mdx
@@ -226,12 +226,12 @@ Notițe:
* Exact **un** `defineApplicationRole(...)` este permis per aplicație — build-ul manifestului va eșua dacă găsește mai mult de unul.
* Utilizați `defineRole()` (nu `defineApplicationRole()`) pentru orice roluri **suplimentare** cu care este livrată aplicația.
-* Setarea explicită a `defaultRoleUniversalIdentifier` în `defineApplication()` este în continuare acceptată pentru compatibilitate retroactivă, dar este considerată învechită în favoarea `defineApplicationRole()`. Identificatorul trebuie să corespundă unui rol definit de aplicația dvs., altfel compilarea eșuează.
+* Setarea explicită a `defaultRoleUniversalIdentifier` în `defineApplication()` este în continuare acceptată pentru compatibilitate retroactivă, dar este considerată învechită în favoarea `defineApplicationRole()`. De asemenea, poate denumi un rol pe care aplicația dvs. nu îl definește, cum ar fi rolul implicit integrat al aplicației personalizate din spațiul de lucru, păstrat de `twenty app pull`; compilarea nu poate verifica acel rol, așadar acesta trebuie să existe în spațiul de lucru țintă.
* Un rol căruia îi pot fi alocați membri ai spațiului de lucru sau chei API (`canBeAssignedToUsers` sau `canBeAssignedToApiKeys`, ambele `true` când sunt omise) este un rol personalizat și necesită **planul Organization sau unul superior**: pe alte planuri, instalarea este refuzată. Păstrează-le pe ambele ca `false` pentru rolurile pe care rulează doar aplicația ta și agenții acesteia.
### Roluri agent
-Rolul aplicației este cel pe care un spațiu de lucru îl examinează atunci când îți instalează aplicația, deci trebuie să acopere tot ceea ce poate face aplicația însăși. Orice rol pe care îl atribui unui agent prin `roleUniversalIdentifier` în `defineAgent()` nu trebuie să acorde mai mult decât rolul aplicației: nicio acțiune asupra obiectelor, niciun acces la câmpuri, niciun indicator de permisiune sau domeniu de aplicare la nivel de rând pe care rolul aplicației nu le are. Dacă o face, compilarea eșuează cu o eroare care enumeră permisiunile acordate în exces. Rolurile pe care aplicația ta le furnizează pentru membrii spațiului de lucru sau cheile API nu sunt supuse acestei reguli, deoarece aplicația nu rulează niciodată cu acestea.
+Rolul aplicației este cel pe care un spațiu de lucru îl examinează atunci când îți instalează aplicația, deci trebuie să acopere tot ceea ce poate face aplicația însăși. Orice rol pe care îl atribui unui agent prin `roleUniversalIdentifier` în `defineAgent()` nu trebuie să acorde mai mult decât rolul aplicației: nicio acțiune asupra obiectelor, niciun acces la câmpuri, niciun indicator de permisiune sau domeniu de aplicare la nivel de rând pe care rolul aplicației nu le are. Dacă o face, compilarea eșuează cu o eroare care enumeră permisiunile acordate în exces. Rolurile pe care aplicația ta le furnizează pentru membrii spațiului de lucru sau cheile API nu sunt supuse acestei reguli, deoarece aplicația nu rulează niciodată cu acestea. Verificarea necesită rolul aplicației în sursa aplicației dvs., așadar este omisă atunci când rolul implicit este definit în altă parte.
## Cele mai bune practici
diff --git a/packages/twenty-docs/ro/developers/extend/apps/data/overview.mdx b/packages/twenty-docs/ro/developers/extend/apps/data/overview.mdx
index 886da0f6b84..39c13edf9f6 100644
--- a/packages/twenty-docs/ro/developers/extend/apps/data/overview.mdx
+++ b/packages/twenty-docs/ro/developers/extend/apps/data/overview.mdx
@@ -57,8 +57,9 @@ Stratul de **date** al unei aplicații Twenty reprezintă datele pe care aplica
| **Relație** | O legătură bidirecțională între două obiecte — ambele părți declarate ca câmpuri | `defineField()` cu `FieldType.RELATION` |
| **Indice** | Un indice de bază de date pentru a accelera o interogare recurentă asupra unuia dintre obiectele tale | `defineIndex()` |
| **Tip de activitate a cronologiei** | Un eveniment automat de audit sau un eveniment explicit de domeniu afișat în cronologiile înregistrărilor | `defineTimelineActivityType()` |
+| **Cale de înregistrări asociate** | Un lanț de până la trei relații prin care accesul la o înregistrare se extinde la înregistrările sale asociate | `defineRelatedRecordPath()` |
-CLI-ul le detectează prin analiza AST la momentul build-ului, astfel încât organizarea fișierelor ține de tine — convenția este `src/objects/`, `src/fields/`, `src/indexes/` și `src/timeline-activity-types/`. UUID-urile stabile `universalIdentifier` leagă totul în toate implementările.
+CLI-ul detectează acestea prin analiza AST la momentul build-ului, astfel încât organizarea fișierelor ține de tine — convenția este `src/objects/`, `src/fields/`, `src/indexes/`, `src/timeline-activity-types/` și `src/related-record-paths/`. UUID-urile stabile `universalIdentifier` leagă totul în toate implementările.
## Indici (opțional)
@@ -104,6 +105,36 @@ defineIndex({
Ordonează array-ul `fields` în modul în care Postgres ar trebui să îl folosească — coloana din stânga prima, ca într-o agendă telefonică. Indicii nu sunt gratuiți: fiecare scriere în tabel îi actualizează. Adaugă unul doar atunci când ai o interogare care are nevoie de el.
+## Căi de înregistrări asociate (opțional)
+
+<Warning>
+ Căile către înregistrări asociate sunt în previzualizare: se sincronizează cu aplicația dvs., însă permisiunile pentru înregistrări nu le folosesc încă. După ce sunt aplicate, necesită
+ **planul Organization sau unul superior**, la fel ca
+ [securitatea la nivel de rând](/ro/developers/extend/apps/config/roles#row-level-security).
+</Warning>
+
+O cale către înregistrări asociate începe pe un obiect și urmează până la trei câmpuri de relație, fiecare pe obiectul la care a ajuns cel precedent. Permisiunile pentru înregistrări folosesc aceste căi pentru a extinde accesul de la o înregistrare la înregistrările sale asociate.
+
+* O cale **inerentă** (`isInherent: true`) se aplică ori de câte ori înregistrarea de început poate fi citită, indiferent de modul în care a fost acordat acel acces. Folosiți-o pentru înregistrările care aparțin părintelui lor, cum ar fi atașamentele unui card de postare.
+* O cale **obișnuită** se aplică numai atunci când accesul la înregistrarea de început provine direct dintr-un rol, astfel încât spațiile de lucru aleg pe care să se bazeze.
+
+```ts src/related-record-paths/post-card-attachments.related-record-path.ts
+import { defineRelatedRecordPath } from 'twenty-sdk/define';
+
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { ATTACHMENTS_ON_POST_CARD_UNIVERSAL_IDENTIFIER } from '../fields/attachments-on-post-card.field';
+
+export default defineRelatedRecordPath({
+ universalIdentifier: 'c1b8f0d2-7e4a-4b6c-9a1d-3f5e2b7c8d90',
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ firstFieldMetadataUniversalIdentifier:
+ ATTACHMENTS_ON_POST_CARD_UNIVERSAL_IDENTIFIER,
+ isInherent: true,
+});
+```
+
+Adăugați `secondFieldMetadataUniversalIdentifier` și `thirdFieldMetadataUniversalIdentifier` pentru căi mai lungi. Fiecare salt trebuie să fie o relație activă pe obiectul atins până în acel moment, o cale nu poate vizita același obiect de două ori, iar două căi nu pot folosi aceleași salturi.
+
<Note>
Căutați **Application Config** sau **Roles & Permissions**? Acestea descriu aplicația în sine, mai degrabă decât datele pe care le adaugă — se află la [Config](/ro/developers/extend/apps/config/overview). Căutați **Connections** (Linear, GitHub, Slack OAuth)? Acestea există pentru a fi apelate *din* funcții de logică și se află la [Logic](/ro/developers/extend/apps/logic/connections).
</Note>
diff --git a/packages/twenty-docs/ro/developers/extend/apps/logic/workflows.mdx b/packages/twenty-docs/ro/developers/extend/apps/logic/workflows.mdx
index 928fa98d2af..cdd341c9b7b 100644
--- a/packages/twenty-docs/ro/developers/extend/apps/logic/workflows.mdx
+++ b/packages/twenty-docs/ro/developers/extend/apps/logic/workflows.mdx
@@ -101,7 +101,7 @@ Un flux de lucru webhook ascultă la `https://\<your-twenty-domain>/webhooks/wor
## Pași
-Fluxurile de lucru ale aplicației acceptă aceste tipuri de pași: `LOGIC_FUNCTION`, `AI_AGENT`, `HTTP_REQUEST`, `CLASSIFY`, `CREATE_RECORD`, `UPDATE_RECORD`, `UPSERT_RECORD`, `DELETE_RECORD`, `FIND_RECORDS`, `PICK_RECORD`, `FILTER`, `IF_ELSE`, `ITERATOR`, `FORM`, `DELAY`, `WAIT_FOR_EVENT`, `SEND_EMAIL`, `DRAFT_EMAIL`, `CREATE_CALENDAR_EVENT` și `EMPTY`.
+Fluxurile de lucru ale aplicației acceptă aceste tipuri de pași: `LOGIC_FUNCTION`, `AI_AGENT`, `HTTP_REQUEST`, `CLASSIFY`, `CREATE_RECORD`, `UPDATE_RECORD`, `UPSERT_RECORD`, `DELETE_RECORD`, `FIND_RECORDS`, `PICK_RECORD`, `FILTER`, `IF_ELSE`, `ITERATOR`, `FORM`, `DELAY`, `WAIT_FOR_EVENT`, `SEND_EMAIL`, `DRAFT_EMAIL`, `CREATE_CALENDAR_EVENT`, `SEND_CHAT_MESSAGE` și `EMPTY`.
Intrările lor corespund pașilor din [constructorul de fluxuri de lucru](/ro/user-guide/workflows/capabilities/workflow-actions), cu identificatori universali în locul numelor:
@@ -117,6 +117,7 @@ Intrările lor corespund pașilor din [constructorul de fluxuri de lucru](/ro/us
* `connectedAccountId`: o variabilă, cum ar fi `{{trigger.properties.after.connectedAccountId}}`. Pașii de e-mail acceptă, de asemenea, un ID de membru al spațiului de lucru, cum ar fi `{{trigger.properties.after.assigneeId}}`, care se rezolvă la primul cont al acelui membru care poate trimite.
Setează exact unul dintre cele două.
+* `SEND_CHAT_MESSAGE` publică în căsuța de primire a unui membru al spațiului de lucru, setată cu `workspaceMemberId`. ID-urile membrilor sunt, de asemenea, locale pentru fiecare spațiu de lucru, astfel încât o aplicație transmite o variabilă, cum ar fi `{{trigger.properties.after.assigneeId}}`.
## După instalare
diff --git a/packages/twenty-docs/ru/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/ru/developers/extend/apps/config/roles.mdx
index 2220d30710b..2cb6806dc60 100644
--- a/packages/twenty-docs/ru/developers/extend/apps/config/roles.mdx
+++ b/packages/twenty-docs/ru/developers/extend/apps/config/roles.mdx
@@ -219,12 +219,12 @@ export default defineApplicationRole({
* Допускается ровно **один** вызов `defineApplicationRole(...)` на приложение — сборка манифеста завершится с ошибкой, если будет найдено более одного.
* Используйте `defineRole()` (а не `defineApplicationRole()`) для любых **дополнительных** ролей, которые ставятся вместе с вашим приложением.
-* Явная установка `defaultRoleUniversalIdentifier` в `defineApplication()` всё ещё поддерживается для обратной совместимости, но считается устаревшей по сравнению с `defineApplicationRole()`. Идентификатор должен соответствовать роли, определённой вашим приложением, иначе сборка завершится с ошибкой.
+* Явная установка `defaultRoleUniversalIdentifier` в `defineApplication()` всё ещё поддерживается для обратной совместимости, но считается устаревшей по сравнению с `defineApplicationRole()`. Он также может указывать роль, которую ваше приложение не определяет, например встроенную роль по умолчанию пользовательского приложения рабочего пространства, сохраняемую командой `twenty app pull`; в таком случае сборка не может проверить эту роль, поэтому она должна существовать в целевом рабочем пространстве.
* Роль, которую можно назначать участникам рабочего пространства или ключам API (`canBeAssignedToUsers` или `canBeAssignedToApiKeys`, оба значения `true`, если они не указаны), является пользовательской ролью и требует **план Organization или выше**: на других планах установка отклоняется. Оставьте оба значения `false` для ролей, от имени которых работают только ваше приложение и его агенты.
### Роли агентов
-Роль приложения — это то, что рабочее пространство проверяет при установке вашего приложения, поэтому она должна охватывать всё, что может делать само приложение. Любая роль, которую вы назначаете агенту через `roleUniversalIdentifier` в `defineAgent()`, не должна предоставлять больше прав, чем роль приложения: никаких действий с объектами, доступа к полям, флагов разрешений или областей действия на уровне строк, которых нет у роли приложения. Если это не так, сборка завершается с ошибкой, в которой перечислены избыточные предоставленные права. Роли, которые ваше приложение предоставляет для участников рабочего пространства или ключей API, не подпадают под это правило, поскольку приложение никогда не запускается с ними.
+Роль приложения — это то, что рабочее пространство проверяет при установке вашего приложения, поэтому она должна охватывать всё, что может делать само приложение. Любая роль, которую вы назначаете агенту через `roleUniversalIdentifier` в `defineAgent()`, не должна предоставлять больше прав, чем роль приложения: никаких действий с объектами, доступа к полям, флагов разрешений или областей действия на уровне строк, которых нет у роли приложения. Если это не так, сборка завершается с ошибкой, в которой перечислены избыточные предоставленные права. Роли, которые ваше приложение предоставляет для участников рабочего пространства или ключей API, не подпадают под это правило, поскольку приложение никогда не запускается с ними. Для проверки необходима роль приложения в исходном коде вашего приложения, поэтому она пропускается, когда роль по умолчанию определена в другом месте.
## Лучшие практики
diff --git a/packages/twenty-docs/ru/developers/extend/apps/data/overview.mdx b/packages/twenty-docs/ru/developers/extend/apps/data/overview.mdx
index 0d51daa9a5e..cfb5a1c8f95 100644
--- a/packages/twenty-docs/ru/developers/extend/apps/data/overview.mdx
+++ b/packages/twenty-docs/ru/developers/extend/apps/data/overview.mdx
@@ -57,8 +57,9 @@ import { CardTitle } from "/snippets/card-title.mdx"
| **Связь** | Двусторонняя связь между двумя объектами — обе стороны объявлены как поля | `defineField()` с `FieldType.RELATION` |
| **Индекс** | Индекс базы данных для ускорения повторяющегося запроса к одному из ваших объектов | `defineIndex()` |
| **Тип действия на временной шкале** | Автоматическое событие аудита или явное событие домена, отображаемое на временных шкалах записей | `defineTimelineActivityType()` |
+| **Путь к связанной записи** | Цепочка из не более чем трех связей, по которым доступ к записи распространяется на связанные с ней записи | `defineRelatedRecordPath()` |
-CLI обнаруживает их с помощью анализа AST во время сборки, поэтому организация файлов остается на ваше усмотрение — по соглашению используются `src/objects/`, `src/fields/`, `src/indexes/` и `src/timeline-activity-types/`. Стабильные UUID `universalIdentifier` связывают все воедино между развертываниями.
+CLI обнаруживает их с помощью анализа AST во время сборки, поэтому организация файлов остается на ваше усмотрение — по соглашению используются `src/objects/`, `src/fields/`, `src/indexes/`, `src/timeline-activity-types/` и `src/related-record-paths/`. Стабильные UUID `universalIdentifier` связывают все воедино между развертываниями.
## Индексы (необязательно)
@@ -104,6 +105,37 @@ defineIndex({
Упорядочьте массив `fields` в том порядке, в котором Postgres должен его использовать — сначала самый левый столбец, как в телефонной книге. Индексы не бесплатны: при каждой записи в таблицу они обновляются. Добавляйте индекс только тогда, когда у вас есть запрос, которому он действительно нужен.
+## Пути к связанным записям (необязательно)
+
+<Warning>
+ Пути связанных записей находятся в предварительной версии: они синхронизируются с вашим приложением, но разрешения записей
+ пока их не используют. После включения им требуется
+ **тариф Organization или выше**, как и для
+ [безопасности на уровне строк](/ru/developers/extend/apps/config/roles#row-level-security).
+</Warning>
+
+Путь связанной записи начинается на объекте и проходит не более чем по трём полям связей, каждое из которых находится на объекте, достигнутом предыдущим полем. Разрешения записей используют эти пути для расширения доступа от записи к связанным с ней записям.
+
+* **Неотъемлемый** путь (`isInherent: true`) применяется всегда, когда начальная запись доступна для чтения, независимо от того, как был предоставлен этот доступ. Используйте его для записей, принадлежащих родительской записи, например для вложений карточки публикации.
+* **Обычный** путь применяется только тогда, когда доступ к начальной записи предоставляется непосредственно ролью, поэтому рабочие пространства выбирают, на какие из них полагаться.
+
+```ts src/related-record-paths/post-card-attachments.related-record-path.ts
+import { defineRelatedRecordPath } from 'twenty-sdk/define';
+
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+import { ATTACHMENTS_ON_POST_CARD_UNIVERSAL_IDENTIFIER } from '../fields/attachments-on-post-card.field';
+
+export default defineRelatedRecordPath({
+ universalIdentifier: 'c1b8f0d2-7e4a-4b6c-9a1d-3f5e2b7c8d90',
+ objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+ firstFieldMetadataUniversalIdentifier:
+ ATTACHMENTS_ON_POST_CARD_UNIVERSAL_IDENTIFIER,
+ isInherent: true,
+});
+```
+
+Добавьте `secondFieldMetadataUniversalIdentifier` и `thirdFieldMetadataUniversalIdentifier` для более длинных путей. Каждый переход должен быть активной связью на достигнутом к этому моменту объекте, путь не может посещать один и тот же объект дважды, и два пути не могут использовать одни и те же переходы.
+
<Note>
Ищете **Application Config** или **Roles & Permissions**? Они описывают само приложение, а не данные, которые оно добавляет, — их можно найти в разделе [Config](/ru/developers/extend/apps/config/overview). Ищете **Connections** (Linear, GitHub, Slack OAuth)? Они существуют для вызова *из* логических функций и находятся в разделе [Logic](/ru/developers/extend/apps/logic/connections).
</Note>
diff --git a/packages/twenty-docs/ru/developers/extend/apps/logic/workflows.mdx b/packages/twenty-docs/ru/developers/extend/apps/logic/workflows.mdx
index 1c8f0192f42..802e8d8712d 100644
--- a/packages/twenty-docs/ru/developers/extend/apps/logic/workflows.mdx
+++ b/packages/twenty-docs/ru/developers/extend/apps/logic/workflows.mdx
@@ -101,7 +101,7 @@ export default defineWorkflow({
## Шаги
-Рабочие процессы приложения поддерживают следующие типы шагов: `LOGIC_FUNCTION`, `AI_AGENT`, `HTTP_REQUEST`, `CLASSIFY`, `CREATE_RECORD`, `UPDATE_RECORD`, `UPSERT_RECORD`, `DELETE_RECORD`, `FIND_RECORDS`, `PICK_RECORD`, `FILTER`, `IF_ELSE`, `ITERATOR`, `FORM`, `DELAY`, `WAIT_FOR_EVENT`, `SEND_EMAIL`, `DRAFT_EMAIL`, `CREATE_CALENDAR_EVENT` и `EMPTY`.
+Рабочие процессы приложения поддерживают следующие типы шагов: `LOGIC_FUNCTION`, `AI_AGENT`, `HTTP_REQUEST`, `CLASSIFY`, `CREATE_RECORD`, `UPDATE_RECORD`, `UPSERT_RECORD`, `DELETE_RECORD`, `FIND_RECORDS`, `PICK_RECORD`, `FILTER`, `IF_ELSE`, `ITERATOR`, `FORM`, `DELAY`, `WAIT_FOR_EVENT`, `SEND_EMAIL`, `DRAFT_EMAIL`, `CREATE_CALENDAR_EVENT`, `SEND_CHAT_MESSAGE` и `EMPTY`.
Их входные данные соответствуют шагам [конструктора рабочих процессов](/ru/user-guide/workflows/capabilities/workflow-actions), но вместо имён используются универсальные идентификаторы:
@@ -117,6 +117,7 @@ export default defineWorkflow({
* `connectedAccountId`: переменная, например `{{trigger.properties.after.connectedAccountId}}`. Шаги электронной почты также принимают идентификатор участника рабочего пространства, например `{{trigger.properties.after.assigneeId}}`, который разрешается в первую учетную запись этого участника, способную отправлять сообщения.
Задайте ровно один из двух.
+* `SEND_CHAT_MESSAGE` отправляет сообщение во входящие участника рабочего пространства, заданного с помощью `workspaceMemberId`. Идентификаторы участников также локальны для каждого рабочего пространства, поэтому приложение передаёт переменную, например `{{trigger.properties.after.assigneeId}}`.
## После установки