بطاقة vCard

📅 آخر تحديث: ٢٠ يوليو ٢٠٢٦
✍️ نُشر في: ٢٠ يوليو ٢٠٢٦
الموسوعة الحرة

بطاقة vCard ، والمعروفة أيضًا باسم VCF (ملف جهة الاتصال الافتراضية)، هي معيار تنسيق ملفات لبطاقات العمل الإلكترونية . يمكن إرفاق بطاقات vCard برسائل البريد الإلكتروني ، وإرسالها عبر خدمة رسائل الوسائط المتعددة (MMS)، أو عبر شبكة الإنترنت العالمية ، أو الرسائل الفورية ، أو تقنية الاتصال قريب المدى (NFC) ، أو من خلال رمز الاستجابة السريعة (QR code ) . ويمكن أن تحتوي على معلومات الاسم والعنوان ، وأرقام الهواتف ، وعناوين البريد الإلكتروني ، وروابط المواقع الإلكترونية ، والشعارات ، والصور ، والمقاطع الصوتية.

تُستخدم بطاقة vCard كصيغة لتبادل البيانات في جهات اتصال الهواتف الذكية ، والمساعدات الرقمية الشخصية ، وأنظمة إدارة المعلومات الشخصية ، وأنظمة إدارة علاقات العملاء . ولإنجاز تطبيقات تبادل البيانات هذه، تم استخدام "متغيرات أخرى من بطاقة vCard" واقتراحها كمعايير بديلة، كل منها مُصمم لمجاله المحدد: تمثيل XML ، أو تمثيل JSON ، أو صفحات الويب .

ملخص

يختلف نوع الوسائط القياسي للإنترنت ( نوع MIME ) لبطاقة vCard باختلاف كل إصدار من المواصفات. [ 1 ]

يمكن تضمين بطاقات vCard في صفحات الويب .

يمكن استخدام RDFa مع vCard Ontology في HTML والعديد من لغات عائلة XML، مثل SVG و MathML.

ملحقات RFC 9554

يُعرّف RFC 9554 عدة خصائص جديدة لبطاقة vCard، وهي: ، ، ، ، ، و ، بالإضافة إلى بعض المعاملات الجديدة للخصائص الموجودة. كما قام بتحديث الخاصيتين و لدعم عناوين أكثر تفصيلاً وأسماء عائلة ثانوية على التوالي. يهدف هذا الامتداد إلى توحيد مجموعة الميزات بين تنسيقي JSContact و vCard. [ 2 ] CREATEDGRAMGENDERLANGUAGEPRONOUNSSOCIALPROFILEADRN

يُعدّ jCard، أو " تنسيق JSON لبطاقات vCard"، اقتراحًا قياسيًا لعام 2014 في RFC 7095. يصف RFC 7095 طريقةً غير ضائعة لتمثيل بيانات vCard بتنسيق JSON، باستخدام مصفوفات من أزواج العلامات والقيم المترابطة. وقد أُدمج jCard في العديد من البروتوكولات الأخرى، بما في ذلك RDAP ، وبروتوكول الوصول إلى قواعد بيانات المسافات البيضاء (PAWS، الموصوف في RFC 7545 )، و SIP ، الذي يستخدمه (عبر RFC 8688 ) لتوفير معلومات الاتصال لمشغل الوسيط الذي رفض المكالمة.   

hCard هو تنسيق مصغر يسمح بتضمين بطاقة vCard داخل صفحة HTML. يستخدم أسماء فئات CSS لتحديد كل خاصية من خصائص vCard. يمكن استخدام ترميز HTML العادي وأنماط CSS جنبًا إلى جنب مع أسماء فئات hCard دون التأثير على قدرة محلل hCard على تحليل صفحة الويب. h-card هو تحديث microformats2 لـ hCard.

MeCard هي نسخة معدلة من vCard طورتها شركة NTT DoCoMo للهواتف الذكية التي تستخدم رموز QR . تستخدم MeCard صيغة مشابهة جدًا، ولكن بطريقة أكثر اختصارًا نظرًا لمحدودية مساحة التخزين على رموز QR. كما أنها محدودة في كمية البيانات التي يمكن تخزينها، ليس فقط بسبب المعيار، بل أيضًا بسبب حجم رموز QR.

مثال

مثال على بطاقة vCard بسيطة (من RFC 6350 الصادر في أغسطس 2011، مختصرة):

ابدأ: بطاقة العمل الإصدار: 4.0 FN: سيمون بيرو ن: بيرو؛ سيمون؛؛؛ مهندس الابن، ماجستير العلوم. تاريخ الميلاد: 0203 الجنس: ذكر البريد الإلكتروني؛ النوع = العمل: simon.perreault@viagenie.ca نهاية: بطاقة افتراضية

هذه هي بطاقة vCard الخاصة بـ "سيمون بيرو" (مؤلف RFC 6350)، مع تاريخ ميلاده (مع حذف السنة)، وعنوان بريده الإلكتروني وجنسه.

ملكيات

يُعرّف vCard أنواع الخصائص التالية.

تبدأ جميع بطاقات vCard بـ BEGIN:VCARDوتنتهي بـ END:VCARD. يجب أن تحتوي جميع بطاقات vCard على VERSIONالخاصية التي تحدد إصدار vCard. VERSIONيجب أن تأتي الخاصية مباشرةً بعد BEGIN، باستثناء معياري vCard 2.1 و 3.0، اللذين يسمحان بوضعها في أي مكان في بطاقة vCard. بخلاف ذلك، يمكن تعريف الخصائص بأي ترتيب.

اسموجود العقاروصفمثال
الإصدار 2.1 [ 3 ]الإصدار 3.0الإصدار 4.0
ADRخياريخياريخياريتمثيل منظم لعنوان التسليم الفعلي لكائن vCard.ADR;TYPE=home:;;123 Main St.;Springfield;IL;12345;USA
AGENTخياريخياريغير محددمعلومات عن شخص آخر سيتصرف نيابةً عن بطاقة vCard. عادةً ما يكون هذا الشخص مسؤول منطقة أو مساعدًا أو سكرتيرًا للشخص المعني. يمكن أن يكون رابطًا أو بطاقة vCard مضمنة.AGENT:http://mi6.gov.uk/007
ANNIVERSARYغير محددغير محددخيارييحدد ذكرى ميلاد الشخص.ANNIVERSARY:19901021
BDAYخياريخياريخياريتاريخ ميلاد الشخص المرتبط ببطاقة vCard.BDAY:19700310
BEGINمطلوبمطلوبمطلوبيجب أن تبدأ جميع بطاقات vCard بهذه الخاصية.BEGIN:VCARD
CALADRURIغير محددغير محددخياريعنوان URL يُستخدم لإرسال طلب جدولة إلى تقويم الشخص.CALADRURI:http://example.com/calendar/jdoe
CALURIغير محددغير محددخياريرابط لتقويم الشخص.CALURI:http://example.com/calendar/jdoe
CATEGORIESغير محددخياريخياريقائمة بـ "الوسوم" التي يمكن استخدامها لوصف الكائن الذي تمثله هذه البطاقة الإلكترونية (vCard).CATEGORIES:swimmer,biker
CLASSغير محددخياريغير محدديصف مدى حساسية المعلومات الموجودة في بطاقة vCard.CLASS:public
CLIENTPIDMAPغير محددغير محددخياريتُستخدم لمزامنة الإصدارات المختلفة لنفس بطاقة vCard.CLIENTPIDMAP:1;urn:uuid:3df403f4-5924-4bb7-b077-3c711d9eb34b
CREATEDغير محددغير محدداختياري [ ملاحظة 1 ]الطابع الزمني الذي تم فيه إنشاء بطاقة vCard.CREATED:20220705T093412Z
EMAILخياريخياريخياريعنوان البريد الإلكتروني للتواصل مع كائن vCard.EMAIL:johndoe@hotmail.com
ENDمطلوبمطلوبمطلوبيجب أن تنتهي جميع بطاقات vCard بهذه الخاصية.END:VCARD
FBURLغير محددغير محددخيارييحدد عنوان URL الذي يُظهر متى يكون الشخص "متفرغًا" أو "مشغولًا" في تقويمه.FBURL:http://example.com/fb/jdoe
FNخياريمطلوبمطلوبسلسلة الاسم المنسقة المرتبطة بكائن vCard.FN:Dr. John Doe
GENDERغير محددغير محددخيارييحدد جنس الشخص.GENDER:F
GEOخياريخياريخيارييحدد خط العرض وخط الطول.2.1 ، 3.0 ، GEO:39.95;-75.16674.0 :GEO:geo:39.95,-75.1667
GRAMGENDERغير محددغير محدداختياري [ ملاحظة 1 ]يحدد الجنس النحوي الذي يفضل أن يُخاطب به الشخص أو يُشار إليه به في الكتابة أو الكلام.GRAMGENDER;LANGUAGE=de:feminine
IMPPغير محددربماخيارييُعرّف اسم مستخدم لبرنامج المراسلة الفورية.

تم تقديم هذه الخاصية في RFC منفصل عندما كان أحدث إصدار من vCard هو 3.0. لذلك، قد تستخدم بطاقات vCard 3.0 هذه الخاصية دون التصريح عنها بشكل آخر.

IMPP:aim:johndoe@aol.com
KEYخياريخياريخياريمفتاح التشفير العام المرتبط بكائن vCard. قد يشير إلى عنوان URL خارجي، أو قد يكون نصًا عاديًا، أو قد يكون مضمنًا في vCard ككتلة نصية مشفرة بنظام Base64 .2.1 : 2.1 : 3.0 : 3.0 : 4.0 : 4.0 :KEY;PGP:http://example.com/key.pgpKEY;PGP;ENCODING=BASE64:[base64-data]KEY;TYPE=PGP:http://example.com/key.pgpKEY;TYPE=PGP;ENCODING=b:[base64-data]KEY;MEDIATYPE=application/pgp-keys:http://example.com/key.pgpKEY:data:application/pgp-keys;base64,[base64-data]
KINDغير محددغير محددخيارييُحدد نوع الكيان الذي تُمثله هذه البطاقة الإلكترونية: "تطبيق"، أو "فرد"، أو "مجموعة"، أو "موقع"، أو "مؤسسة"؛ ويمكن استخدام القيم "x-*" لأغراض تجريبية. [ 4 ] [ 5 ]KIND:individual
LABELخياريخياريتأسست بدونيمثل النص الفعلي الذي يجب وضعه على ملصق البريد عند تسليم طرد مادي إلى الشخص/الكائن المرتبط ببطاقة vCard (المتعلقة بالعقار ADR).

غير مدعوم في الإصدار 4.0. بدلاً من ذلك، تُخزَّن هذه المعلومات في LABELمُعامل الخاصية ADR. مثال:ADR;TYPE=home;LABEL="123 Main St\nNew York, NY 12345":;;123 Main St;New York;NY;12345;USA

LABEL;TYPE=HOME:123 Main St.\nSpringfield, IL 12345\nUSA
LANGالمذكور [ 3 ] : 34غير محددخيارييحدد اللغة التي يتحدث بها الشخص.LANG:fr-CA
LANGUAGEغير محددغير محدداختياري [ ملاحظة 1 ]يحدد هذا الخيار اللغة الافتراضية التي يُفترض أن تُكتب بها قيم النصوص القابلة للقراءة البشرية في هذه البطاقة الإلكترونية.LANGUAGE:de-AT
PRONOUNSغير محددغير محدداختياري [ ملاحظة 1 ]الضمائر التي يختار الشخص الذي يتم التواصل معه استخدامها للإشارة إلى نفسه.PRONOUNS;LANGUAGE=en;PREF=1:xe/xirPRONOUNS;LANGUAGE=en;PREF=2:they/them
LOGOخياريخياريخياريصورة أو رسم لشعار المؤسسة المرتبطة بالشخص الذي تنتمي إليه بطاقة vCard. قد يشير إلى رابط خارجي أو قد يكون مضمنًا في بطاقة vCard كنص مشفر بنظام Base64 .2.1 : 2.1 : 3.0 : 3.0 : 4.0 : 4.0 :LOGO;PNG:http://example.com/logo.pngLOGO;PNG;ENCODING=BASE64:[base64-data]LOGO;TYPE=PNG:http://example.com/logo.pngLOGO;TYPE=PNG;ENCODING=b:[base64-data]LOGO;MEDIATYPE=image/png:http://example.com/logo.pngLOGO;ENCODING=BASE64;TYPE=PNG:[base64-data]
MAILERخياريخياريغير محددنوع برنامج البريد الإلكتروني المستخدم.MAILER:Thunderbird
MEMBERغير محددغير محددخيارييُحدد هذا الخيار عضوًا ينتمي إلى المجموعة التي تُمثلها بطاقة vCard هذه. تشمل القيم المقبولة ما يلي:
  • عنوان URL يبدأ بـ "mailto:" ويحتوي على عنوان بريد إلكتروني
  • معرّف فريد يشير إلى بطاقة vCard الخاصة بالعضو
يجب ضبط الخاصية KINDعلى "group" لاستخدام هذه الخاصية.		MEMBER:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af
Nمطلوبمطلوبخياريتمثيل منظم لاسم الشخص أو المكان أو الشيء المرتبط بكائن vCard. يتعرف النظام على البنية، مرتبةً ومفصولة بفواصل منقوطة: اسم العائلة، الاسم الأول، الأسماء الإضافية/الأسماء الوسطى، البادئات التشريفية، واللواحق التشريفية [ 6 ].N:Doe;John;;Dr;
NAMEغير محددخياريغير محدديوفر تمثيلاً نصياً للخاصية SOURCE.
NICKNAMEغير محددخياريخيارياسم واحد أو أكثر من الأسماء الوصفية/المألوفة للكائن الذي تمثله هذه البطاقة الإلكترونية (vCard).NICKNAME:Jon,Johnny
NOTEخياريخياريخيارييحدد معلومات إضافية أو تعليقًا مرتبطًا ببطاقة vCard.NOTE:I am proficient in Tiger-Crane Style,\nand I am more than proficient in the exquisite art of the Samurai sword.
ORGخياريخياريخيارياسم المؤسسة المرتبطة بكائن vCard، ووحداتها (اختياريًا). تعتمد هذه الخاصية على سمة اسم المؤسسة وسمة وحدة المؤسسة في معيار X.520.ORG:Google;GMail Team;Spam Detection Squad
PHOTOخياريخياريخياريصورة أو رسم للشخص المرتبط ببطاقة vCard. قد تشير إلى رابط خارجي أو قد تكون مضمنة في بطاقة vCard ككتلة نصية مشفرة بنظام Base64 .2.1 : 2.1 : 3.0 : 3.0 : 4.0 : 4.0 : [ 7 ]PHOTO;JPEG:http://example.com/photo.jpgPHOTO;JPEG;ENCODING=BASE64:[base64-data]PHOTO;TYPE=JPEG;VALUE=URI:http://example.com/photo.jpgPHOTO;TYPE=JPEG;ENCODING=b:[base64-data]PHOTO;MEDIATYPE=image/jpeg:http://example.com/photo.jpgPHOTO:data:image/jpeg;base64,[base64-data]
PRODIDغير محددخياريخياريالمعرف الخاص بالمنتج الذي أنشأ كائن vCard.PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN
PROFILEغير محددخياريغير محددينص على أن بطاقة vCard هي بطاقة vCard.PROFILE:VCARD
RELATEDغير محددغير محددخياريكيان آخر تربطه صلة قرابة بالشخص. تشمل القيم المقبولة ما يلي:
  • عنوان URL يبدأ بـ "mailto:" ويحتوي على عنوان بريد إلكتروني
  • معرّف فريد يشير إلى بطاقة vCard الخاصة بالشخص
  • قيمة نصية تُستخدم لتحديد المعلومات النصية
RELATED;TYPE=friend:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af
REVخياريخياريخياريطابع زمني لآخر مرة تم فيها تحديث بطاقة vCard.REV:20121201T134211Z
ROLEخياريخياريخياريالدور أو المهنة أو فئة العمل الخاصة بكائن vCard داخل المؤسسة.ROLE:Executive
SOCIALPROFILEغير محددغير محدداختياري [ ملاحظة 1 ]معرف الموارد الموحد (URI) أو اسم المستخدم لملفات تعريف وسائل التواصل الاجتماعي المرتبطة بالكائن الذي تمثله بطاقة vCard.SOCIALPROFILE:https://example.com/ietf
SORT-STRINGغير محددخياريتأسست بدونيحدد سلسلة نصية يجب استخدامها عندما يقوم تطبيق ما بفرز بطاقة vCard هذه بطريقة ما.

غير مدعوم في الإصدار 4.0. بدلاً من ذلك، يتم تخزين هذه المعلومات في SORT-ASمعلمات الخصائص Nو/أو ORG.

SORT-STRING:Doe
SOUNDخياريخياريخياريافتراضيًا، إذا لم يتم تجميع هذه الخاصية مع خصائص أخرى، فإنها تحدد طريقة نطقها FNفي كائن vCard. وقد تشير إلى عنوان URL خارجي أو قد تكون مضمنة في vCard ككتلة نصية مشفرة بنظام Base64 .2.1 : 2.1 : 3.0 : 3.0 : 4.0 : 4.0 :SOUND;OGG:http://example.com/sound.oggSOUND;OGG;ENCODING=BASE64:[base64-data]SOUND;TYPE=OGG:http://example.com/sound.oggSOUND;TYPE=OGG;ENCODING=b:[base64-data]SOUND;MEDIATYPE=audio/ogg:http://example.com/sound.oggSOUND:data:audio/ogg;base64,[base64-data]
SOURCEغير محددخياريخياريرابط URL يمكن استخدامه للحصول على أحدث إصدار من هذه البطاقة الإلكترونية (vCard).SOURCE:http://johndoe.com/vcard.vcf
TELخياريخياريخياريسلسلة الأرقام المتعارف عليها لرقم الهاتف المستخدم في الاتصال الهاتفي مع كائن vCard.TEL;TYPE=cell:(123) 555-5832
TITLEخياريخياريخيارييحدد المسمى الوظيفي أو المنصب الوظيفي أو وظيفة الفرد المرتبط بكائن vCard داخل المؤسسة.TITLE:V.P. Research and Development
TZخياريخياريخياريالمنطقة الزمنية لكائن vCard.2.1 ، 3.0 ، TZ:-05004.0 :TZ:America/New_York
UIDخياريخياريخيارييحدد قيمة تمثل معرفًا فريدًا عالميًا ودائمًا مرتبطًا بالكائن.UID:urn:uuid:da418720-3754-4631-a169-db89a02b831b
URLخياريخياريخياريرابط URL يشير إلى موقع ويب يمثل الشخص بطريقة ما. القيمة الافتراضية = "الصفحة الرئيسية"URL;TITLE:https://www.johndoe.com
VERSIONمطلوبمطلوبمطلوبإصدار مواصفات بطاقة vCard. في الإصدار 4.0، يجب أن يأتي هذا مباشرةً بعد BEGINالخاصية.VERSION:3.0
XMLغير محددغير محددخياريأي بيانات XML مرفقة ببطاقة vCard. يُستخدم هذا الخيار إذا تم ترميز بطاقة vCard باستخدام XML (معيار xCard) وكان مستند XML يحتوي على عناصر لا تُعد جزءًا من معيار xCard.XML:<b>Not an xCard XML element</b>

انظر أيضاً

ملحوظات

  1. 1 2 3 4 5 تمت إضافة هذه الخاصية في RFC 9554 [ 2 ] 

مراجع

  1. ↑ RFC 6350، القسم 10.1 "تسجيل نوع الوسائط"
  2. 1 2 ستيبانيك، روبرت؛ لوفردو، ماريو (مايو 2024). "امتدادات تنسيق vCard لـ JSContact" . فريق عمل هندسة الإنترنت.
  3. 1 2 "مواصفات vCard الإصدار 2.1" . اتحاد البريد الإلكتروني للإنترنت . الإصدار. 18-09-1996. مؤرشف من الأصل في 21 سبتمبر 2015. تم الاسترجاع في 31-08-2024 .
  4. ↑ "مواصفات تنسيق vCard: 6.1.4. KIND" . IETF . أغسطس 2011.
  5. ↑ "vCard KIND:application" . IETF. ديسمبر 2011.
  6. ↑ داوسون، فرانك؛ هاوز، تيم (سبتمبر 1998). "RFC 2426: دليل MIME لبطاقة vCard، القسم 3.1.2" .
  7. ↑ RFC 6350 § 6.2.4، datatracker.ietf.org، https://datatracker.ietf.org/doc/html/rfc6350#section-6.2.4