معلومات الاتصال

استخدِم ContactInformation لتحديد معلومات الاتصال الخاصة بأشياء مثل الأشخاص ومجالس السلطات والمؤسسات.

يُستخدم هذا الكيان بشكل أساسي لتوفير معرّفات الموارد المنتظمة (URI) التي تتضمّن تعليقات توضيحية والمرتبطة بالعناصر التالية: Election وElectionAdministration وPerson وGpUnit وOffice.

السمات

يعرض الجدول التالي سمات ContactInformation:

السمة مطلوب؟ Type الوصف
label إجراء اختياري string سمة اختيارية لمعلومات الاتصال يمكن أن تشير إلى التصنيف الأصلي للمعلومات. على سبيل المثال، إذا كانت معلومات الاتصال واردة من ملف CSV، قد تشير السمة label إلى رقم تعريف صف.
language إجراء اختياري language تحدّد اللغة المستخدَمة لتقديم معلومات الاتصال.

العناصر

يعرض الجدول التالي عناصر ContactInformation:

عنصر التعددية Type الوصف
AddressLine 0 أو أكثر string

يربط عنوان بجهة الاتصال. يجب أن يحتوي AddressLine على السطور التي يمكن أن يُدخلها المستخدم في خدمة خرائط الويب، مثل "خرائط Google" للعثور على العنوان على الخريطة. وهذا يعني أنّ قيمة الحقل تحتاج إلى ترميز موقع جهة الاتصال جغرافيًا.

لتضمين عنوان لجهة الاتصال، استخدِم مواضع ورود متعددة للسمة AddressLine. ونتوقّع أن يكون الاستخدام الأول للسمة AddressLine هو الاسم أو المؤسسة. نتوقع أن تكون الاستخدامات اللاحقة هي عنوان الشارع أو المدينة أو الرمز البريدي أو المدينة أو الولاية (أو ما يعادلها في الولاية أو اختياري) بالترتيب والتنسيق المحددَين للبلد.
Directions 0 أو 1 InternationalizedText يقدّم هذا الخيار معلومات عن الاتجاهات بالإضافة إلى معلومات العنوان. ويمكن استخدام الاتجاهات لتوفير أي معلومات إضافية متعلقة بالعنوان قد تظهر بلغات متعددة.
Email 0 أو أكثر AnnotatedString يربط عنوان بريد إلكتروني بجهة الاتصال. وفي حال توفُّر أكثر من حقل Email واحد، يمكنك تضمين التعليقات التوضيحية لإعلام المستخدمين بالغرض من كل حقل.
Fax 0 أو أكثر AnnotatedString ربط رقم فاكس بجهة الاتصال. وفي حال توفُّر أكثر من حقل Fax واحد، يمكنك تضمين التعليقات التوضيحية لإعلام المستخدمين بالغرض من كل حقل.
LatLng 0 أو 1 LatLng ربط معلومات خطوط الطول والعرض الاختيارية بعنوان جهة اتصال.
Name 0 أو 1 string لربط اسم بجهة الاتصال. استخدِم هذا الحقل للمعلومات بدون العنوان التي يمكن أن تساعد المستخدم في التواصل مع ذلك الشخص أو المؤسسة. على سبيل المثال، "مكتب وزير الخارجية، إدارة الانتخابات".
Phone 0 أو أكثر AnnotatedString ربط رقم هاتف بجهة الاتصال. وفي حال توفُّر أكثر من حقل Phone واحد، يمكنك تضمين التعليقات التوضيحية لإعلام المستخدمين بالغرض من كل حقل.
Uri 0 أو أكثر AnnotatedUri يربط عنوان URL بجهة الاتصال.

أمثلة

XML

    <ContactInformation>
      <Uri Annotation="personal-facebook">https://www.facebook.com/tedcruzpage</Uri>
      <Uri Annotation="personal-twitter">https://twitter.com/tedcruz</Uri>
      <Uri Annotation="personal-website">https://www.tedcruz.org/</Uri>
      <Uri Annotation="wikipedia">https://en.wikipedia.org/wiki/Ted_Cruz</Uri>
    </ContactInformation>
<ContactInformation label="ci60001" language=”es”>
      <AddressLine>Viad. Tlalpan 100</AddressLine>
      <AddressLine>Arenal Tepepan</AddressLine>
      <AddressLine>14610 Ciudad de México, CDMX</AddressLine>
      <AddressLine>Mexico</AddressLine>
      <Name>Instituto Nacional Electoral</Name>
      <Phone annotation="domestic">01 800 433 2000</Phone>
      <Phone annotation="usa">1 (866) 986 8306</Phone>
      <Phone annotation="collect">+52 (55) 5481 9897</Phone>
      <Uri Annotation="official-website">https://www.ine.mx/</Uri>
      <Uri Annotation="official-twitter">https://twitter.com/INEMexico</Uri>
      <Uri Annotation="official-facebook">https://www.facebook.com/INEMexico</Uri>
 </ContactInformation>
<ContactInformation label="ci10861a" language=”en”>
      <AddressLine>1600 Pennsylvania Ave</AddressLine>
      <AddressLine>Washington, DC 20006</AddressLine>
      <Email>president@whitehouse.gov</Email>
      <Phone>202-456-1111</Phone>
      <Phone annotation="TDD">202-456-6213</Phone>
      <Uri Annotation="official-website">http://www.whitehouse.gov</Uri>
      <Uri Annotation="official-facebook">https://www.facebook.com/WhiteHouse</Uri>
      <Uri Annotation="official-twitter">https://twitter.com/WhiteHouse</Uri>
</ContactInformation>

JSON

    "ContactInformation": {
      "Uri": [
        "Annotation": "personal-facebook"
        "value": "https://www.facebook.com/tedcruzpage"
      ],
      "Uri": [
        "Annotation": "personal-twitter"
        "value": "https://twitter.com/tedcruz"
      ],
      "Uri": [
        "Annotation": "personal-website"
        "value": "https://www.tedcruz.org/"
      ],
      "Uri": [
        "Annotation": "wikipedia"
        "value": "https://en.wikipedia.org/wiki/Ted_Cruz"
      ]
    }
    "ContactInformation": {
      "language": "es",
      "label": "ci60001",
      "AddressLine": [
        "Viad. Tlalpan 100",
        "Arenal Tepepan",
        "14610 Ciudad de México, CDMX",
        "Mexico"
      ],
      "Name": "Instituto Nacional Electoral",
      "Phone": [
        {
          "annotation": "domestic",
          "value": "01 800 433 2000"
        },
        {
          "annotation": "usa",
          "value": "1 (866) 986 8306"
        },
        {
          "annotation": "collect",
          "value": "+52 (55) 5481 9897"
        }
      ],
      "Uri": [
        "Annotation": "official-website"
        "value": "https://www.ine.mx/"
      ],
      "Uri": [
        "Annotation": "official-twitter"
        "value": "https://twitter.com/INEMexico"
      ],
      "Uri": [
        "Annotation": "official-facebook"
        "value": "https://www.facebook.com/INEMexico"
      ]
    }
    "ContactInformation": {
      "label": "ci10861a",
      "language": "en",
      "AddressLine": [
        "1600 Pennsylvania Ave",
        "Washington, DC 20006"
      ],
      "Email": "president@whitehouse.gov",
      "Phone": [
        {
          "value": "202-456-1111"
        },
        {
          "annotation": "TDD",
          "value": "202-456-6213"
        }
      ],
      "Uri": [
        "Annotation": "official-website"
        "value": "http://www.whitehouse.gov"
      ],
      "Uri": [
        "Annotation": "official-facebook"
        "value": "https://www.facebook.com/WhiteHouse"
      ],
      "Uri": [
        "Annotation": "official-twitter"
        "value": "https://twitter.com/WhiteHouse"
      ]
    }