ניהול אנשי קשר של Outlook בקבצי PST

יצירת, שמירה וקריאת אנשי קשר

Aspose.Email מאפשרת ליצור ולעבד אנשי קשר של Outlook. ה- MapiContact מחלקה מספקת את כל המאפיינים הקשורים לאנשי קשר הדרושים ליצירה ולניהול של איש קשר Outlook. מאמר זה מציג כיצד ליצור, לשמור ולקרוא איש קשר Outlook באמצעות MapiContact מחלקה.

צור ושמור אנשי קשר של Outlook

ליצירת איש קשר ולשמור אותו בכונן, פעל לפי הצעדים הבאים:

  1. צור מופע חדש של ה‑ MapiContact מחלקה.
  2. הזן מידע על מאפייני האיש קשר.
  3. הוסף נתוני תמונה (אם קיימים).
  4. שמור את האיש קשר בפורמט MSG או VCard.

קטע הקוד הבא מציג כיצד ליצור ולשמור איש קשר של Outlook:

import aspose.email as ae

data_dir = "path/to/data/directory"

contact = ae.mapi.MapiContact()
contact.name_info = ae.mapi.MapiContactNamePropertySet("Bertha", "A.", "Buell")
contact.professional_info = ae.mapi.MapiContactProfessionalPropertySet("Awthentikz", "Social work assistant")
contact.personal_info.personal_home_page = "B2BTies.com"
contact.physical_addresses.work_address.address = "Im Astenfeld 59 8580 EDELSCHROTT"
contact.electronic_addresses.email1 = ae.mapi.MapiContactElectronicAddress("Experwas", "SMTP", "BerthaABuell@armyspy.com")
contact.telephones = ae.mapi.MapiContactTelephonePropertySet("06605045265")
contact.personal_info.children = ["child1", "child2", "child3"]
contact.categories = ["category1", "category2", "category3"]
contact.mileage = "Some test mileage"
contact.billing = "Test billing information"
contact.other_fields.journal = True
contact.other_fields.private = True
contact.other_fields.reminder_topic = "Test topic"
contact.other_fields.user_field1 = "ContactUserField1"
contact.other_fields.user_field2 = "ContactUserField2"
contact.other_fields.user_field3 = "ContactUserField3"
contact.other_fields.user_field4 = "ContactUserField4"

# Add a photo
with open(data_dir + "Desert.jpg", "rb") as file:
    buffer = file.read()
    contact.photo = ae.mapi.MapiContactPhoto(buffer, ae.mapi.MapiContactPhotoImageFormat.JPEG)

# Save the Contact in MSG format
contact.save(data_dir + "MapiContact_out.msg", ae.mapi.ContactSaveFormat.MSG)

# Save the Contact in VCF format
contact.save(data_dir + "MapiContact_out.vcf", ae.mapi.ContactSaveFormat.V_CARD)

שמור אנשי קשר בפורמט VCF גרסה 3

כדי לשמור איש קשר בפורמט VCF גרסה 3, השתמש במאפיין version של VCardSaveOptions מחלקה.

  1. צור מופע חדש של ה‑ VCardSaveOptions מחלקה.
  2. הגדר את מאפיין הגרסה של אובייקט VCardSaveOptions ל‑VCardVersion.V30. פעולה זו מגדירה את גרסת ה‑vCard ל‑3.0.
  3. הפעל את שמירה מתודה של האובייקט MapiContact, מעבירה את שם הקובץ "contact.vcf" ואת אובייקט VCardSaveOptions כפרמטרים. זה שומר את איש הקשר כקובץ vCard עם שם הקובץ והאפשרויות שצוינו.

קטע הקוד הבא מציג כיצד לשמור איש קשר בפורמט VCF גרסה 3:

import aspose.email as ae

contact = ae.mapi.MapiContact()
contact.name_info = ae.mapi.MapiContactNamePropertySet("Bertha", "A.", "Buell")
options = ae.personalinfo.vcard.VCardSaveOptions()
options.version = ae.personalinfo.vcard.VCardVersion.V30
contact.save("contact.vcf", options)

טען אנשי קשר מקבצים MSG או VCard

ה MapiContact מחלקה שניתן להשתמש בה לטעון אנשי קשר בפורמט Outlook MSG וגם VCard.

כדי לטעון איש קשר מ‑MSG, השתמשו בדוגמת הקוד למטה:

כדי לטעון איש קשר מ‑VCard, השתמשו בדוגמת הקוד הבאה:

טעינת אנשי קשר עם קידוד מוגדר

קטע הקוד הבא מציג כיצד לטעון איש קשר מ‑vcard עם קידוד מוגדר.

שמור קבצי VCard עם קידוד תווים מותאם

בעת שמירת קובץ vCard, ניתן להגדיר את קידוד התווים כדי להבטיח תאימות לתווים שאינם ASCII. לדוגמה, קביעת מאפיין preferred_text_encoding של VCardSaveOptions הגדרת האובייקט ל‑"utf-8" מבטיחה קידוד נכון של טקסט שאינו ASCII. תכונה זו שימושית במיוחד לטיפול בנתוני אנשי קשר רב-לשוניים. להלן דוגמה כיצד לקבוע ולשמור קובץ vCard עם קידוד תו מותאם:

import aspose.email as ae

contact = ae.mapi.MapiContact()
contact.name_info = ae.mapi.MapiContactNamePropertySet("Bertha", "A.", "Buell")
options = ae.personalinfo.vcard.VCardSaveOptions()
options.preferred_text_encoding = "utf-8"
contact.save("contact.vcf", options)

שמור קבצי VCard עם תכונות מורוחבות

בנוסף לשדות vCard הסטנדרטיים, ניתן לשפר את קבצי ה‑vCard על ידי הוספת תכונות מורוחבות. אלו תכונות נוספות שלא נכללות במפרט ה‑vCard הסטנדרטי, מאפשרות התאמה אישית רחבה יותר. כדי לאפשר זאת, הגדר את מאפיין use_extensions של VCardSaveOptions הגדרת המחלקה ל‑True. זה מועיל במיוחד להוספת מטא‑נתונים מותאמים או ספציפיים לאפליקציה. הנה כיצד ניתן לשמור קובץ vCard עם תכונות מורחבות מופעלות:

import aspose.email as ae

contact = ae.mapi.MapiContact()
contact.name_info = ae.mapi.MapiContactNamePropertySet("Bertha", "A.", "Buell")
options = ae.personalinfo.vcard.VCardSaveOptions()
options.use_extensions = True
contact.save("contact.vcf", options)

קריאת מספר אנשי קשר בפורמט VCard

כדי לקבל את כל אנשי הקשר מ‑VCard, ניתן להשתמש ב‑ מתודות:

  • is_multi_contacts קובעת האם לזרם יש מספר אנשי קשר.
  • load_as_multiple(file_path) טוענת רשימה של כל אנשי הקשר מקובץ VCard.
  • load_as_multiple(stream) טוענת רשימה של כל אנשי הקשר מזרם VCard.

קוד הקטע שלהלן מציג את תהליך קריאת מספר אנשי קשר מקובץ VCard:

import aspose.email as ae

contact = ae.mapi.MapiContact()
contact.name_info = ae.mapi.MapiContactNamePropertySet("Bertha", "A.", "Buell")
options = ae.personalinfo.vcard.VCardSaveOptions()
options.use_extensions = True
contact.save("contact.vcf", options)

if ae.personalinfo.vcard.VCardContact.is_multi_contacts("contact.vcf"):
    ae.personalinfo.vcard.VCardContact.load_as_multiple("contact.vcf")

הצגת מידע איש קשר ל‑MHTML

ניתן להמיר איש קשר Outlook ל‑MHTML באמצעות Aspose.Email API. דוגמת הקוד הבאה מציגה כיצד לייצר קובץ MHTML שמכיל מידע מפורט על איש הקשר במקור מקובץ MSG:

  1. טען את קובץ ה‑MSG כ- MapiMessage אובייקט.
  2. המר את ההודעה לפורמט EML.
  3. הכן אפשרויות שמירת MHT:
    • הפעל קידוד תוכן הגוף ושמור את הגבולות המקוריים.
    • הגדר את אפשרויות פורמט MHT לכתיבת כותרות והצגת מידע vCard.
  4. הגדר שדות לייצוא ב‑MHT.
  5. שמור את קובץ ה‑EML כקובץ MHTML.
ניהול פריטי לוח השנה של Outlook ניהול פתקיות Outlook