> For the complete documentation index, see [llms.txt](https://docs.ngsurvey.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ngsurvey.com/ar/form-management/form-designer/idraj-albyanat/text-data-piping.md).

# إدراج النص / البيانات

## 📋 ما هو توجيه النص / البيانات (text / data piping)؟

تسمح تقنية التوجيه بإدراج قيمة نصية تُسمى علامة الأنابيب (pipe tag) في أي من عناصر نص الاستبيان الخاصة بك، [رسالة الدعوة](/ar/form-management/campaigns/campaign/invitation-message.md)أو [الاكتمال](/ar/form-management/tasks/task-items/completion-alert.md)[ التنبيهات](/ar/form-management/tasks/task-items/completion-alert.md) والتي سيتم استبدالها عند تشغيل الاستبيان بمحتوى ديناميكي ليشعر المستجيب أن الاستبيان مُخصص له فقط.

على سبيل المثال، يمكنك أن تطلب من المستجيب اسمه ثم إعادة استخدام اسمه في أي مكان في استبيانك لجعله أكثر شخصية.

## ➕ إدراج علامة أنبوب

يمكن اختيار علامات الأنبوب في أي مكان باستخدام **أيقونة محدد علامة الأنبوب**.

![أيقونة محدد علامة الأنبوب](https://848173432-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M8fLhS0bmfBRyq0HdUm%2F-MBoCSkMWVUlD6Y6YLwW%2F-MBoDNxtk-nF78mbMCGv%2Fimage.png?alt=media\&token=2f72864c-e4a1-40a2-b144-cdb7b19b0095)

## 🚰 **توجيه نص من إجابة**

يسمح التوجيه من إجابة بتوجيه أي قيمة نصية أدخلها المستجيب إلى أي مكان في استبيانك. 

لتوجيه قيمة الإجابة المدخلة يجب أولاً تعيين **pipe alias** للإجابة في [خصائص الإجابة](/ar/form-management/form-designer/answers/answer-properties.md) . بمجرد الانتهاء يمكنك إما اختيار علامة الأنبوب باستخدام محدد علامة الأنبوب أو باستخدام العلامة التالية **\[\[youranswerpipealias]].** سيتم استبدال علامة الأنبوب هذه وقت التشغيل أثناء أداء المستجيب للاستبيان بالقيمة الفعلية لإجابة المستجيب.

![](https://848173432-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M8fLhS0bmfBRyq0HdUm%2F-MBoHIH6APzHIVLELV7g%2F-MBoJ5flk5tFD_LFvQlS%2Fcaptured%20\(17\)-min.gif?alt=media\&token=e8791eab-84db-4165-8673-16c1c691d201)

## 🚰 توجيه سؤال **إجابات الاختيارات المحددة**

يمكنك أيضاً توجيه الإجابات المحددة (أزرار الاختيار، مربعات الاختيار) لسؤال. لتوجيه الإجابة المحددة لسؤال يجب أولاً تعيين **pipe alias** للسؤال في [خصائص السؤال](/ar/form-management/form-designer/questions/question-properties.md) . بمجرد الانتهاء يمكنك إما اختيار علامة الأنبوب باستخدام محدد علامة الأنبوب أو باستخدام العلامة التالية **\[\[yourpipealiasquestion]].**

![](https://848173432-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M8fLhS0bmfBRyq0HdUm%2F-MBoHIH6APzHIVLELV7g%2F-MBoMYUfHlROQKpgDZj0%2Fcaptured%20\(18\)-min.gif?alt=media\&token=664ac429-072b-48b3-8504-e0c683781156)

## 🚰 توجيه سمات المشارك (panelist)

إذا كان استبيانك يستخدم [بند أمان panelist](/ar/form-management/security/security-items/panel-security.md) قد تتمكن من توجيه أيٍ من بيانات الـ [سمات أعضاء اللوحة](/ar/panels/untitled.md) المسجل دخوله إلى أي مكان في نصوص محتوى الاستبيان أو [قيم الافتراضية للحقل](/ar/form-management/form-designer/answers/answer-properties/field-properties.md) باستخدام علامة الأنبوب التالية **++yourpanelisattribute++** 

## 🚰 توجيه قيم متغيرات سلسلة الاستعلام (querystring)

يمكنك أيضاً توجيه القيم من متغيرات سلسلة استعلام المتصفح إلى أي مكان في نصوص محتوى الاستبيان باستخدام علامة الأنبوب التالية **##variablename##**

{% hint style="info" %}
يمكنك متابعة [walkthrough ](/ar/walkthroughs/capture-value-from-querystring.md)لتعلّم المزيد حول كيفية حفظ قيمة من سلسلة الاستعلام.
{% endhint %}

## 🚰 توجيه سمات بيانات عناصر الأمان

إذا قمت بتفعيل بعض [security items](/ar/form-management/security/security-items.md) على استبيانك فقد تتمكن من توجيه [data attributes](/ar/form-management/security/data-attributes.md) خاصة بهم إلى أي مكان في نصوص محتوى الاستبيان باستخدام علامة الأنبوب التالية **\_\_dataattributeid\_\_** 

{% hint style="info" %}
نظرًا لأن قيم [سمة بيانات](/ar/form-management/security/data-attributes.md) تعتمد على [عنصر أمني](/ar/form-management/security/security-items.md) التي قمت بتفعيلها، يمكنك الرجوع إلى [التوثيق](/ar/form-management/security/security-items.md) لتعلّم المزيد أي [data attributes](/ar/form-management/security/data-attributes.md) يتشاركونه للتوجيه.  
{% endhint %}

## 🚰 **علامات أنبوب نظامية مدمجة**

يوفر ngSurvey أيضاً علامات أنبوب التالية التي سيتم استبدالها ديناميكياً بقيمها المقابلة.

* **`{{date}}`** التاريخ المحلي الفعلي للمستجيب.
* **`{{datetime}}`** التاريخ والوقت المحلي الفعلي للمستجيب.
* **`{{utcdatetime}}`** الوقت العالمي الفعلي. 
* **`{{surveyid}}`** معرّف الاستبيان الحالي.
* **`{{score}}`** المجموع الكلي لدرجات المستجيب إذا كان استبيانًا [مصنّفًا](/ar/form-management/form-designer/scoring.md) .
* **`{{vuid}}`** معرّف المستجيب.
* **`{{changeuid}}`** رمز فريد يُستخدم لاستعادة إجابات المستجيب من أجل [تحديث](/ar/form-management/form-designer/form-settings/progress-completion/respondent-answers-update.md). 
* **`{{resumeuid}}`** رمز فريد يُستخدم لاستئناف [جلسة المستجيب](/ar/form-management/form-designer/form-settings/progress-completion.md).
* **`{{languagecode}}`** رمز اللغة المُحدد.
* **`{{useragent}}`** عامل المستخدم (user agent) لجهاز المستجيب.
* **`{{islamicdate}}`** يوجه التاريخ الحالي بناءً على تقويم أم القرى الإسلامي.  

 


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ngsurvey.com/ar/form-management/form-designer/idraj-albyanat/text-data-piping.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.