نشر موصل Microsoft SharePoint On-Prem

يمكنك إعداد Google Cloud Search لعرض النتائج من محتوى SharePoint الخاص بمؤسستك، بالإضافة إلى محتوى Google Workspace. يمكنك استخدام موصل SharePoint On-Prem في Google Cloud Search وإعداده للوصول إلى مصدر بيانات SharePoint محدد.

اعتبارات مهمة

إعدادات Honored SharePoint

يستخدم موصل Cloud Search SharePoint في المؤسسة دائمًا إعداد مستوى رؤية البحث على SharePoint، والذي لا يمكن تجاوزه. بالنسبة إلى مسودات المستندات، تتحكّم الأذونات في حساب المستخدم (التي يستخدمها الموصِّل للوصول إلى SharePoint Online) في مسودات المستندات التي تتم فهرستها وعرضها. إذا كان الحساب يحتوي على أذونات "القراءة الكاملة" فقط، سيتّبع الموصل إعدادات "رؤية عنصر المسودة" في SharePoint.

يمكنك أيضًا ضبط الموصل لفرض قيود على النتائج بناءً على الوصول إلى حساب المستخدم. يمكنك استخدام مبادئ Google الرئيسية والخارجية لتحديد قوائم التحكم في الوصول. لتطبيق قطع الأمان على محتوى SharePoint، عليك مزامنة الهويات الخارجية التالية مع "دليل Google":

  • مستخدمو Active Directory
  • مجموعات Active Directory
  • مجموعات SharePoint المحلية (مع مستخدمي Active Directory ومجموعاته كأعضاء)

لمزامنة المستخدمين والمجموعات في AD، يمكنك استخدام أداة مزامنة دليل Google Cloud، مع تفعيل المجموعات التي تم تحديد الهوية لها. لمزامنة مجموعات SharePoint المحلية، يمكنك استخدام SharePoint Identity Connector.

يحتاج الموصل أيضًا إلى إجراء بحث باستخدام AD لجلب معلومات إضافية لمزامنة العناصر الرئيسية. على سبيل المثال، يتيح البحث باستخدام AD للموصل إجراء ما يلي:

  • اربط معرّف SID لمجموعة نطاقات باسم sAMAccountName المقابل.
  • عليك ربط sAMAccountName لمستخدم بعنوان البريد الإلكتروني لاشتراكات المجموعات المحلية في SharePoint.

تحسين البحث

يمكنك تحسين تجربة المستخدمين من خلال ضبط الموصل لعرض نتائج بحث أكثر صلة.

لاستخدام واجهة برمجة التطبيقات، عليك ضبط قيم لمَعلمات إنشاء HTML في ملف إعداد موصل SharePoint Online. تتيح لك هذه المَعلمات تحديد الحقول التي لها تأثير أعلى أو أقل في المطابقات.

لإعداد مخطط، اتّبِع التعليمات الواردة في المقالة إنشاء مخطط وتسجيله. عند إعداد مخطط:

  • لتعيين أسماء أنواع محتوى SharePoint إلى تعريفات الكائنات المقابلة، يضبط الموصل أسماء أنواع المحتوى من خلال استبعاد الأحرف غير المتوافقة. بالنسبة إلى تعريفات العناصر، تتيح واجهة برمجة التطبيقات Cloud Search API استخدام الأحرف A-Z وa-z و0-9 فقط كأحرف صالحة. على سبيل المثال، يتمّ ربط نوع المحتوى "الإشعارات" بتعريف الكائن "الإعلانات". يتم ربط نوع المحتوى "مقالة إخبارية" إلى "NewsArticle" (بدون مسافة).

  • عندما يتعذّر على الموصِّل مطابقة تعريف كائن مع تعريف عنصر، يستخدم الموصل نوع العنصر الاحتياطي (itemMetadata.objectType). يمكنك الاطّلاع على مزيد من المعلومات حول مَعلمات ضبط البيانات الوصفية.

  • لربط أسماء مواقع SharePoint بتعريفات المواقع، يضبط الموصل أسماء المواقع من خلال فك ترميز الأحرف السداسية ذات الترميز وإزالة بادئات "ows_"، ثم استبعاد الأحرف غير المتوافقة (جميع الأحرف باستثناء A-Z وa-z و0-9 كأحرف صالحة).

التعامل مع الرسائل في Microsoft Outlook

عندما يصادف الموصل ملفات Microsoft Outlook. أثناء فهرسة المحتوى، يلغي نوع الوسائط لهذه الملفات ويفهرسها كـ application/vnd.ms-outlook..

إعدادات خاصة بالمستأجرين المتعددين

إذا كان SharePoint عبارة عن نشر متعدد المستخدمين، حيث تتم استضافة مواقع إلكترونية متعددة للعملاء على تطبيق الويب نفسه، عليك ضبط وضع جمع المواقع الإلكترونية في ملف الإعداد. في عمليات النشر لعدة مستخدمين، يمكنك الحصول على أذونات لمجموعة المواقع الإلكترونية فقط ولا يمكنك الحصول على أذونات القراءة الكاملة، وفقًا لما يتطلّبه موصل SharePoint On-Prem.

لتفعيل وضع جمع المواقع الإلكترونية:

  • امنح حساب مستخدم الموصِّل أذونات مشرف مجموعة المواقع الإلكترونية.
  • اضبط sharepoint.server في ملف ضبط الموصِّل على عنوان URL لمجموعة المواقع الإلكترونية، مثل http://sharepoint.example.com/sites/sitecollection. لا يحتاج عنوان URL إلى استخدام الحالة نفسها كما في SharePoint.
  • اضبط sharepoint.siteCollectionOnly في ملف ضبط الموصِّل على true.

إذا كانت لديك مجموعات مواقع إلكترونية متعددة تريد فهرستها في بيئة تضم أجهزة متعددة، عليك ضبط مثيل موصل واحد لكل مجموعة من مجموعات المواقع الإلكترونية.

قيود الموصل المعروفة

  • يزداد الوقت الذي يستغرقه الموصل لاكتشاف التغييرات على العناصر في قواعد البيانات مع زيادة عدد قواعد البيانات التي يراقبها الموصل.
  • يزداد استهلاك الذاكرة مع زيادة عدد المستخدمين والمجموعات الفريدة التي تستخدمها في قوائم التحكم بالوصول (ACL) لكل مجموعة مواقع إلكترونية.
  • يمكنك ضبط الموصل باستخدام هويات من نطاق واحد فقط على Active Directory.
  • لا تتوافق بعض عناصر Active Directory وWindows الرئيسية الشائعة، مثل Everyone وBUILTIN\Users وAll Authenticated Users.
  • لا يحدث حذف الإشعارات بشكل فوري، وقد يستغرق الموصِّل أكثر من 4 ساعات للتعرّف على أنّ المستخدم حذف المحتوى من مستودع المصدر.

متطلبات النظام

متطلبات النظام
نظام التشغيل
  • خادم Windows 2016
  • Ubuntu
  • الإصدار 5.0 من Red Hat Enterprise Linux
  • SUSE Enterprise Linux 10 (64 بت)
البرامج
  • خادم SharePoint
    • خادم SharePoint 2016
    • خادم SharePoint 2013
  • تم تثبيت Java JRE 1.8 على جهاز الكمبيوتر الذي سيشغل موصل Google Cloud Search SharePoint On-Prem.
المصادقة
  • NTLM
  • Kerberos
  • بروتوكول HTTP الأساسي
  • ألعاب المحاكاة الرياضية اليومية (ADFS)

نشر الموصل

المتطلبات الأساسية

  1. أنشئ مفتاحًا خاصًا في Google Workspace يحتوي على رقم تعريف حساب الخدمة. للتعرّف على كيفية الحصول على مفتاح خاص، يُرجى الانتقال إلى ضبط الوصول إلى Google Cloud Search API.

  2. على مشرف Google Workspace إضافة مصدر بيانات للبحث. سجِّل رقم تعريف مصدر البيانات.

  3. إذا عرض الموصِّل النتائج استنادًا إلى قوائم التحكم بالوصول (ACLs) (النتائج ليست علنية)، على مشرف Google Workspace إنشاء مصدري هوية وتقديم أرقام التعريف الخاصة بهما:

    • مصدر هوية لمزامنة مستخدمي ومجموعات Active Directory.
    • مصدر هوية للمجموعات المحلية في SharePoint

    وعلى المشرف أيضًا الحصول على الرقم التعريفي لعميل Google Workspace الخاص بمؤسستك ومنحه لك.

    تعرَّف على كيفية الحصول على هذه القيم في قسم ربط هويات المستخدمين في Cloud Search.

  4. عليك إعداد حساب مستخدم للموصل الذي لديه أذونات القراءة الكاملة لتطبيق ويب SharePoint في سياسة المستخدم.

  5. إذا لم يكن تطبيق SharePoint على الويب يحتوي على مجموعة مواقع جذر، أنشئ مجموعة.

  6. إذا كانت أي مجموعات مواقع إلكترونية محظورة، سجِّل الدخول إلى خادم SharePoint باستخدام حساب لديه امتيازات المشرف وشغِّل النص البرمجي لـ PrepareWriteLockedSites.ps1.

  7. للحصول على مقاييس مصدر البيانات اللازمة لإعداد الموصل، سجِّل الدخول إلى خادم SharePoint باستخدام حساب يمتلك امتيازات إدارة المزرعة وشغِّل diagnose_sp.ps1.

    تشير المخرجات إلى عدد تطبيقات الويب والمستندات وعضويات مجموعة المستخدمين. ويمكنك استخدام هذه المعلومات لتقدير عدد نُسخ الموصل التي تحتاجها ومتطلبات الذاكرة وعدد المستندات.

الخطوة 1. ثبِّت برنامج موصِّل Google Cloud Search SharePoint On-Prem.

  1. استنسِخ مستودع الموصِّلات من GitHub.

    $ git clone https://github.com/google-cloudsearch/sharepoint-connector.git
    $ cd sharepoint-connector
  2. تحقق من الإصدار المطلوب من الموصل:

    $ git checkout tags/latest_version

    المكان: latest_version = قيمة مثل v1-0.0.5

  3. بناء الموصل.

    $ mvn package

    لتخطّي الاختبارات عند إنشاء الموصل، يمكنك تشغيل mvn package -DskipTests بدلاً من mvn package.

  4. انسخ الملف المضغوط للموصل إلى دليل التثبيت المحلي:

    $ cp target/google-cloudsearch-sharepoint-connector-latest_version.zip installation-dir
    $ cd installation-dir
    $ unzip google-cloudsearch-sharepoint-connector-latest_version.zip
    $ cd google-cloudsearch-sharepoint-connector-latest_version

الخطوة 2. إنشاء ملف إعداد موصل SharePoint On-Prem

  1. في الدليل نفسه الذي تثبيت الموصل به، أنشئ ملفًا. تنصح Google بتسمية الملف باسم connector-config.properties بحيث لا يلزم استخدام معلَمات سطر أوامر إضافية لتشغيل الموصِّل. إذا كنت تخطط لتشغيل العديد من مثيلات الموصل، فأضف تفاصيل إلى الاسم لتمييزه.

  2. أضِف معلَمات كأزواج مفتاح/قيمة إلى محتوى الملف، كما في المثال التالي:

    ### Sharepoint On-Prem Connector configuration ###
    
    # Required parameters for data source access
    api.sourceId=08ef8becd116faa4546b8ca2c84b2879
    api.serviceAccountPrivateKeyFile=service_account.json
    api.identitySourceId=08ef8becd116faa475de26d9b291fed9
    
    # Required parameters for SharePoint on-premises access
    sharepoint.server=http://sp-2016:32967/sites/doc-center-site-collection
    sharepoint.siteCollectionOnly=true
    sharepoint.username=contoso\\admin
    sharepoint.password=pa$sw0rd
    sharepoint.stripDomainInUserPrincipals=true
    
    # Required parameters for AD lookup
    adLookup.host=dc.contoso.com
    adLookup.username=contoso\\admin
    adLookup.password=pa$sw0rd
    api.referenceIdentitySources=CONTOSO,contoso
    api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa
    api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa
    
    # Optional parameters for schema mapping
    contentTemplate.sharepointItem.title=Title
    contentTemplate.sharepointItem.unmappedColumnsMode=APPEND
    

    للحصول على أوصاف تفصيلية لكل مَعلمة، انتقِل إلى مرجع مَعلمات الإعدادات.

  3. (اختياري) اضبط مَعلمات الموصِّل الإضافية، حسب الحاجة. لمعرفة التفاصيل، انتقِل إلى مَعلمات الموصِّلات التي توفّرها Google.

الخطوة 3. بالنسبة إلى HTTPS، أضِف SharePoint كمضيف موثوق به

إذا تم ضبط SharePoint لاستخدام HTTPS، احصل على شهادة SharePoint لإضافتها كمضيف موثوق به للموصل.

  1. على الكمبيوتر الذي سيُشغِّل الموصل، افتح متصفّحًا وانتقِل إلى SharePoint.

  2. في صفحة التحذير التي تفتح، انقر على أفهم المخاطر وإضافة استثناء. تعرض الصفحة رسالة مثل "هذا الاتصال غير موثوق به" لأن الشهادة موقَّعة ذاتيًا وليست موقَّعة من مرجع تصديق موثوق به.

  3. عندما يصبح الزر عرض متاحًا، انقر عليه.

  4. انتقِل إلى علامة التبويب التفاصيل وانقر على تصدير.

  5. احفظ الشهادة في دليل الموصِّل بالاسم sharepoint.crt.

  6. انقر على إغلاق، ثم إلغاء لإغلاق النوافذ.

  7. افتح موجِّه الأوامر وأدخِل الأمر التالي:

    $ keytool -importcert -keystore cacerts.jks -storepass changeit -file sharepoint.crt -alias sharepoint

    عندما يُطلَب منك السؤال "هل تثق بهذه الشهادة؟"، يمكنك الإجابة بـ نعم.

الخطوة 4. إعداد التسجيل

  1. في الدليل الذي يحتوي على البرنامج الثنائي للموصل، أنشِئ مجلدًا باسم logs.

  2. في الدليل نفسه (وليس logs)، أنشِئ ملفًا بترميز Latin1 باسم logging.properties.

  3. أضِف النص التالي إلى logging.properties:

    handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler
    # Default log level
    .level = INFO
    # uncomment line below to increase logging level for SharePoint APIsa
    #com.google.enterprise.cloudsearch.sharepoint.level=FINE
    
    # uncomment line below to increase logging level to enable API trace
    #com.google.api.client.http.level = FINE
    java.util.logging.ConsoleHandler.level = INFO
    java.util.logging.FileHandler.pattern=logs/connector-sharepoint.%g.log
    java.util.logging.FileHandler.limit=10485760
    java.util.logging.FileHandler.count=10
    java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
    

الخطوة الخامسة. ضبط موصل هوية SharePoint On-Prem

هذه الخطوة مطلوبة لتطبيق قوائم التحكم في الوصول المستندة إلى الهوية في SharePoint على نتائج البحث. في حالة إعداد الموصل باستخدام قوائم التحكم بالوصول العامة، يمكنك تخطي هذه الخطوة.

  1. في الدليل نفسه الذي تم تثبيت موصل SharePoint Online به، أنشِئ ملفًا وحدِّد اسمه sharepoint-onprem-identity-connector.config.

  2. أضِف معلَمات كأزواج مفتاح/قيمة إلى محتوى الملف، كما في المثال التالي:

    ### SharePoint On-prem identity connector configuration ###
    
    # Required parameters for data source access
    api.customerId=C05d3djk8
    api.serviceAccountPrivateKeyFile=service_account.json
    api.identitySourceId=08ef8becd116faa475de26d9b291fed9
    
    # Required parameters for SharePoint access
    sharepoint.server=http://sp-2016:32967/sites/doc-center-site-collection
    sharepoint.siteCollectionOnly=true
    sharepoint.username=contoso\\admin
    sharepoint.password=pa$sw0rd
    sharepoint.stripDomainInUserPrincipals=true
    
    # Required parameters for AD lookup
    adLookup.host=dc.contoso.com
    adLookup.username=contoso\\admin
    adLookup.password=pa$sw0rd
    api.referenceIdentitySources=CONTOSO,contoso
    api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa
    api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa
    

    تكون القيم مماثلة تقريبًا لموصل SharePoint On-Prem، باستثناء أنه بدلاً من api.sourceId، تكون المعلَمة هي api.customerId. قيمة api.customerId هي الرقم التعريفي للعميل الذي حصلت عليه من مشرف Google Workspace.

الخطوة السادسة. تشغيل موصل SharePoint On-Prem

في الخطوات التالية، يمكنك ربط العناصر الرئيسية في كل من Active Directory داخل المؤسسة ومجموعة مواقع SharePoint بالهويات في خدمة Cloud Identity. وتتم هذه المزامنة باستخدام "أداة مزامنة دليل Google Cloud" وأداة ربط هوية SharePoint On-Prem.

بعد أن تزامن "أداة مزامنة دليل Google Cloud" المستخدمين والمجموعات، لمزامنة مجموعات مجموعة المواقع الإلكترونية في SharePoint، شغِّل موصل هوية SharePoint On-Prem. أخيرًا، يمكنك تشغيل موصل SharePoing On-Prem لفهرسة النتائج وعرضها لمستخدمي Cloud Search.

  1. اضبط أداة مزامنة دليل Google Cloud وشغِّلها، إذا لم تكن قد فعلت ذلك من قبل. تأكَّد من تفعيل المجموعات التي تم تحديد هويتها.

  2. شغِّل موصل هوية SharePoint On-Prem:

    $ java -Djava.util.logging.config.file=logging.properties -cp "google-cloudsearch-sharepoint-connector-version.jar" com.google.enterprise.cloudsearch.sharepoint.SharePointIdentityConnector -Dconfig=sharepoint-onprem-identity-connector.config
  3. شغِّل موصل SharePoint On-Prem. استخدِم بنية الأوامر لأمان موقعك الإلكتروني على SharePoint:

    • HTTP (لا يُشترط وجود مضيف موثوق به):

      $ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-version.jar
    • HTTPS (أضِف SharePoint كمضيف موثوق به):

      $ java -Djavax.net.ssl.trustStore=cacerts.jks -Djavax.net.ssl.trustStoreType=jks -Djavax.net.ssl.trustStorePassword=changeit -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-version.jar

مرجع مَعلمات الإعدادات

الوصول إلى مصدر البيانات

الإعدادات المَعلمة
رقم تعريف مصدر البيانات api.sourceId=1234567890abcdef

مطلوبة. رقم تعريف مصدر بيانات Google Cloud Search الذي أعدّه مشرف Google Workspace.

المسار إلى ملف المفتاح الخاص لحساب الخدمة api.serviceAccountPrivateKeyFile=PrivateKey.json

مطلوبة. المسار إلى ملف مفتاح حساب خدمة Google Cloud Search.

الوصول داخل المؤسسة في SharePoint

الإعدادات المَعلمة
عنوان URL لخادم SharePoint sharepoint.server=http://yoursharepoint.example.com/

مطلوبة. عنوان URL لخادم SharePoint كاسم مضيف مؤهل بالكامل، مثل http://yoursharepoint.example.com/. وإذا لم يكن اسم المضيف مؤهَّلاً بالكامل، يجب ضبط إلغاء نظام أسماء النطاقات على مضيف الموصل.

اسم مستخدم SharePoint sharepoint.username=YOURDOMAIN\\ConnectorUser

مطلوب عند تشغيل الموصل على نظام التشغيل Linux أو على جهاز يعمل بنظام Windows ليس جزءًا من نطاق SharePoint Server AD.

كلمة مرور SharePoint sharepoint.password=user_password

مطلوب عند تشغيل الموصل على نظام التشغيل Linux أو على جهاز يعمل بنظام Windows ليس جزءًا من نطاق SharePoint Server AD.

استخدام المصادقة المباشرة للاتصال بخدمة SharePoint sharepoint.username=AdaptorUser Live Authentication Id

sharepoint.password uS3R_passWoRD

sharepoint.formsAuthenticationMode=LIVE

استخدام مصادقة ADFS للاتصال بخدمة SharePoint sharepoint.username=AdaptorUser@yourdomain.com

sharepoint.password=uS3R_passWoRD

sharepoint.sts.endpoint=https://adfs.example.com/adfs/services/trust/2005/usernamemixed

sharepoint.sts.realm=urn:myserver:sharepoint أو https://yoursharepoint.example.com/_trust

sharepoint.formsAuthenticationMode=ADFS

فهرسة جمع المواقع الإلكترونية

الإعدادات المَعلمة
نوع الفهرس sharepoint.siteCollectionOnly=boolean

اختياري، باستثناء عمليات نشر SharePoint متعددة المستخدمين (مزيد من المعلومات). اضبط القيمة على "صحيح" ليكون فهرس الموصِّل sharepoint.server كمجموعة مواقع إلكترونية بدلاً من كخادم افتراضي. القيمة التلقائية هي قيمة فارغة (تم رصدها تلقائيًا).

ربط هوية SharePoint

الإعدادات المَعلمة
رقم تعريف مصدر الهوية api.identitySourceId=1234567890abcdef

مطلوبة. رقم تعريف مصدر الهوية لمزامنة المجموعات المحلية في SharePoint.رقم تعريف مصدر Google Cloud Search الذي أعدّه مشرف Google Workspace، كما هو موضَّح في مقالة إضافة مصدر بيانات إلى البحث.

مصادر الهوية المرجعية api.referenceIdentitySources=CONTOSO,contoso

قائمة بمصادر الهوية المرجعية، مفصولة بفواصل، للعناصر الرئيسية النشطة في الدليل تتطابق القيمة مع اسم NETBIOS لـ Active Directory لمبادئ الدليل النشط المرجعية.

معرّفات مصادر الهوية المرجعية المرجعية api.referenceIdentitySource.DOMAIN.id=identity-source-id

مطلوبة. رقم تعريف مصدر الهوية لمزامنة العناصر الرئيسية في Active Directory.

البحث في Active Directory

الإعدادات المَعلمة
مضيف Active Directory adLookup.host=host

مطلوبة. اسم مضيف الدليل النشط، مثل dc.conoso.com أو عنوان IP.

منفذ بحث Active Directory adLookup.port=port

اختياريّ. القيمة التلقائية هي 389. استخدام 686 لطبقة المقابس الآمنة.

طريقة بحث Active Directory adLookup.method=value

اختياريّ. الإعداد التلقائي هو "عادي". وبالنسبة إلى اتصالات HTTPS، يتم ضبطها على "ssl".

مستخدم بحث Active Directory adLookup.username=CONTOSO\user1

مطلوبة. تم تفويض المستخدم لإجراء عمليات بحث في الدليل النشط.

كلمة مرور البحث في Active Directory adLookup.password=password123

مطلوبة. تم تحديد كلمة مرور المستخدم بواسطة adLookup.user.

إنشاء محتوى HTML

الإعدادات المَعلمة
حقل عنوان نموذج HTML contentTemplate.sharePointItem.title=Title

حقل SharePoint المطلوب استخدامه كعنوان نموذج HTML لتنسيق HTML الذي تم إنشاؤه.

حقول جودة البحث العالية لمحتوى HTML contentTemplate.sharePointItem.quality.high=highField1[,highField2,...]

قائمة بالحقول مفصولة بفواصل لتضمينها في رمز HTML الذي تم إنشاؤه كحقول عالية الجودة عندما تتطابق عبارات البحث مع هذه الحقول، يتم ترتيب النتائج في ترتيب أعلى.

حقول جودة البحث في وسيط محتوى HTML contentTemplate.sharePointItem.quality.medium=mediumField1[,mediumField2,...]

قائمة بالحقول مفصولة بفواصل كي يتم تضمينها في رمز HTML الذي تم إنشاؤه كحقول متوسطة الجودة.

حقول جودة البحث المنخفضة لمحتوى HTML contentTemplate.sharePointItem.quality.low=lowField1[,lowField2,...]

قائمة بالحقول مفصولة بفواصل لتضمينها في رمز HTML الذي تم إنشاؤه كحقول منخفضة الجودة

لم يتم ربط أعمدة محتوى HTML. contentTemplate.sharepointItem.unmappedColumnsMode=APPEND

كيفية معالجة الموصِّل للأعمدة التي لم يتم ربطها. القيمة هي APPEND (التلقائية) أو IGNORE.

  • APPEND: يُنشئ الموصِّل محتوى HTML يحتوي على جميع الحقول، بما في ذلك الحقول التي لم يتم ضبطها بمستوى جودة (مرتفع أو متوسط أو منخفض).
  • تجاهُل: يُنشئ الموصِّل محتوى HTML باستخدام الحقول التي تم ربطها فقط.