Documentation – עבודה עם Microsoft Graph Client

Java: הגדרת Azure AD ואימות Microsoft Graph - Aspose.Email for Java

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for Java מציע אינטגרציה מלאה עם Microsoft Graph, מאפשר למפתחים לנהל הודעות, אנשי קשר, לוחות שנה ומשימות מחשבונות Microsoft 365. מדריך זה יוביל אותך בתהליך יצירת אפליקציית Azure AD והגדרת אימות כדי להתחיל לתכנת עם Aspose.Email GraphClient.

לפני השימוש בממשקי ה-API של Microsoft Graph עם Aspose.Email, עליך לרשום אפליקציה ב-Azure Active Directory (Azure AD) ולהגדיר אימות. דף זה מכסה:

יצירת אפליקציית Azure AD (פרויקט).
הקצאת הרשאות Microsoft Graph הנדרשות.
יצירת פרטי זיהוי (client ID, client secret, tenant ID).
אימות ב-Java באמצעות ספקי אסימונים של Aspose.Email.

לאחר השלמת התהליך, תהיה מוכן לתקשר עם Microsoft Graph מתוך אפליקציית Java שלך.

1. יצירת אפליקציית Azure AD

עקוב אחרי הצעדים הבאים כדי לרשום את האפליקציה שלך בפורטל Azure:

היכנס אל פורטל Azure.
נווט אל Azure Active Directory → App Registrations → New Registration.

הזן Name עבור האפליקציה שלך (למשל, AsposeEmailGraphApp).
בחר סוגי חשבונות נתמכים:
- שוכר יחיד (אם רק הארגון שלך ישתמש בו)
- רב‑שוכרת (אם מספר ארגונים צריכים גישה)
אופציונלי, הגדר Redirect URI (נדרש לאימות אינטראקטיבי או אינטרנטי).
לחץ על Register.

2. יצירת סוד לקוח

לאחר הרישום, עבור אל Certificates & Secrets → New Client Secret.
הוסף תיאור ומשך תוקף.

העתק את ערך הסוד שנוצר - לא תראה אותו שוב.

שמור את client secret באופן מאובטח; הוא נדרש לאימות לקוח סודי.

אתה צריך לראות את הלוח של האפליקציות שנרשמו לאחרונה.

3. קביעת הרשאות Microsoft Graph

נווט אל API Permissions → Add a Permission → Microsoft Graph.
בחר את סוג ההרשאות: Delegated או Application, בהתאם לתרחיש שלך.
הוסף את ההרשאות הנדרשות לפעולות Aspose.Email:
- Contacts.ReadWrite – לניהול אנשי קשר
- Calendars.ReadWrite – לניהול לוחות שנה
- Mail.ReadWrite – לקריאת והעברת הודעות
- Tasks.ReadWrite – לניהול משימות
לחץ על Grant Admin Consent אם נדרש.

4. אפשר זרימות של לקוחות ציבוריים

ציין האם האפליקציה היא לקוח ציבורי. מתאים לאפליקציות המשתמשות בזרימות הענקת אסימונים שאינן משתמשות ב-URI הפניה.

5. אימות Microsoft Graph

שיטות אימות נתמכות ב-Aspose.Email

אימות באמצעות לקוח סודי

השתמש ב- AzureConfidentialTokenProvider לאימות כאשר יש לך client ID, client secret ו-tenant ID:

AzureConfidentialTokenProvider provider = new AzureConfidentialTokenProvider(
    tenantId,
    clientId,
    clientSecret
);

IGraphClient client = GraphClient.getClient(provider, tenantId);
client.setResource(ResourceType.Users);
client.setResourceId(username);
client.setEndpoint("https://graph.microsoft.com");

זה מגדיר IGraphClient מאומת במלואו ומוכן לתקשר עם Microsoft Graph.

אימות באמצעות ROPC (שם משתמש וסיסמה)

במקרים שבהם יש לך שם משתמש וסיסמה, השתמש ב- AzureROPCConfiguration:

AzureROPCConfiguration ropcConfig = new AzureROPCConfiguration(
    tenantId,
    clientId,
    clientSecret,
    username,
    password
);

IGraphClient client = GraphClient.getClient(ropcConfig, tenantId);
client.setResource(ResourceType.Users);
client.setResourceId(username);
client.setEndpoint("https://graph.microsoft.com");

ספקי אסימונים מותאמים אישית ל-Microsoft Graph

Aspose.Email for Java משולב עם Microsoft Graph דרך IGraphClient ממשק. כדי לאמת בקשות, מימוש של ITokenProvider נדרש. בעוד מרבית המפתחים ישתמשו בספקי אימות מובנים, יש מצבים שבהם תרצה ליצור ספק משלך, לדוגמה, כאשר עובדים עם זרימת Resource Owner Password Credentials (ROPC).

1. מימוש ITokenProvider באמצעות AzureROPCTokenProvider

מחלקה זו מספקת מימוש של ITokenProvider באמצעות זרימת Azure Resource Owner Password Credentials (ROPC). הדוגמה הבאה היא לצרכי הדגמה בלבד. בייצור, אנו ממליצים להשתמש בזרימות מאובטחות יותר כגון אישורי לקוח או קוד אימות עם PKCE.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

/**
 * <p>
 * Azure resource owner password credential (ROPC) token provider
 * https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
 * https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth
 * https://portal.azure.com
 * https://developer.microsoft.com/en-us/graph/graph-explorer/#
 * token parser https://jwt.io
 * </p>
 */
class AzureROPCTokenProvider implements ITokenProvider {

    private static final String GRANT_TYPE = "password";

    private final String clientId;
    private final String clientSecret;
    private final String userName;
    private final String password;
    private final String tenant;
    private final String scope;

    private OAuthToken token;

    public AzureROPCTokenProvider(String tenant, String clientId, String clientSecret,
                                  String userName, String password, String[] scopeAr) {
        this.tenant = tenant;
        this.clientId = clientId;
        this.clientSecret = clientSecret;
        this.userName = userName;
        this.password = password;
        this.scope = joinToStr(scopeAr, " ");
    }

    public synchronized OAuthToken getAccessToken(boolean ignoreExistingToken) {
        if (this.token != null && !this.token.getExpired() && !ignoreExistingToken)
            return this.token;
        token = null;

        Map<String, String> tokenArgs = getToken();

        java.util.Calendar c = java.util.Calendar.getInstance();
        c.add(java.util.Calendar.SECOND, Integer.parseInt(tokenArgs.get("expires_in")));
        token = new OAuthToken(tokenArgs.get("access_token"), TokenType.AccessToken, c.getTime());
        return token;
    }

    public final OAuthToken getAccessToken() {
        return getAccessToken(false);
    }

    public void dispose() {
    }

    private String getEncodedParameters() {
        return "client_id=" + urlEncode(clientId) + "&scope=" + urlEncode(scope) + "&username=" + urlEncode(userName)
                + "&password=" + urlEncode(password) + "&grant_type="
                + urlEncode(GRANT_TYPE);
    }

    private String getUri() {
        if (tenant == null || tenant.trim().isEmpty())
            return "https://login.microsoftonline.com/common/oauth2/v2.0/token";
        else
            return "https://login.microsoftonline.com/" + tenant + "/oauth2/v2.0/token";
    }

    private Map<String, String> getToken() {
        try {
            HttpURLConnection connection = (HttpURLConnection) new URL(getUri()).openConnection();
            connection.setRequestMethod("POST");

            byte[] requestData = getEncodedParameters().getBytes(StandardCharsets.UTF_8);

            connection.setUseCaches(false);
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            connection.setRequestProperty("Content-Length", "" + requestData.length);

            final OutputStream st = connection.getOutputStream();
            try {
                st.write(requestData, 0, requestData.length);
            } finally {
                st.flush();
                st.close();
            }

            connection.connect();

            if (connection.getResponseCode() >= HttpURLConnection.HTTP_BAD_REQUEST) {
                throw new IllegalAccessError("Operation failed: " + connection.getResponseCode() + "/" +
                        connection.getResponseMessage() + "\r\nDetails:\r\n{2}"
                        + readInputStream(connection.getErrorStream()));
            }

            String responseText = readInputStream(connection.getInputStream());

            Map<String, String> result = new HashMap<>();
            String[] fromJsonToKeyValue = responseText.replace("{", "").replace("}", "")
                    .replace("\"", "").replace("\r", "")
                    .replace("\n", "").split(",");
            for (String keyValue : fromJsonToKeyValue) {
                String[] pair = keyValue.split(":");
                String name = pair[0].trim().toLowerCase();
                String value = urlDecode(pair[1].trim());
                result.put(name, value);
            }

            return result;
        } catch (IOException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlEncode(String value) {
        try {
            return URLEncoder.encode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlDecode(String value) {
        try {
            return URLDecoder.decode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String readInputStream(InputStream is) {
        if (is == null)
            return "";

        BufferedReader reader = new BufferedReader(new InputStreamReader(is));
        StringBuilder result = new StringBuilder();
        String line;
        try {
            while ((line = reader.readLine()) != null) {
                result.append(line);
            }
        } catch (IOException e) {
            // ignore
        }
        return result.toString();
    }

    static String joinToStr(String[] arr, String sep) {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            if (i > 0)
                sb.append(sep);
            sb.append(arr[i]);
        }
        return sb.toString();
    }
}

2. יצירת אובייקט ITokenProvider

ה IGraphClient הממשק אחראי לבנייה של בקשות, שליחתן ל-Microsoft Graph, וטיפול בתגובות. כדי ליצור מופע של IGraphClient, עליך לספק מימוש של ITokenProvider. ספק האסימונים מאמת בקשות על ידי אספקת אסימון גישה תקף של OAuth.

דוגמת הקוד הבאה מדגימה כיצד ליצור מימוש פנימי בסיסי של ITokenProvider ממשק, הנדרש לאימות בקשות Microsoft Graph:

ITokenProvider tokenProvider = new ITokenProvider() {
    Date expirationDate = null;

    @Override
    public void dispose() {
        // Clean up resources if necessary
    }

    @Override
    public OAuthToken getAccessToken(boolean ignoreExistingToken) {
        // Retrieve an OAuth access token.
        // If ignoreExistingToken is true, always request a new token.
        // Otherwise, return the existing token if it is valid, or request a new one.
        return null;
    }

    @Override
    public OAuthToken getAccessToken() {
        // Return a valid OAuth token.
        // If no valid token exists, request a new one.
        return new OAuthToken("token", expirationDate);
    }
};

3. שימוש בספק אסימון מותאם אישית

לאחר שה ITokenProvider מוגדר, ניתן ליצור GraphClient מופע. לקוח זה ישתמש במספק הטוקן שסופק לאימות בעת קריאה ל‑Microsoft Graph.

ITokenProvider provider = new AzureROPCTokenProvider(
        tenantId,
        clientId,
        clientSecret,
        userName,
        password,
        new String[] {"https://graph.microsoft.com/.default"}
);

IGraphClient client = GraphClient.getClient(provider, tenantId);
client.setResource(ResourceType.Users);
client.setResourceId(userName);
client.setEndpoint("https://graph.microsoft.com");

// Now you can call Microsoft Graph APIs
var folders = client.listFolders(null);
for (GraphFolderInfo folder : folders) {
    System.out.println(folder.getDisplayName());
}

לאחר יצירת הלקוח והאמתתו, ניתן להתחיל לבצע בקשות לשירותי Microsoft Graph.

Java: עבודה עם Microsoft Graph ב-Aspose.Email for Java

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for Java מספק אינטגרציה אמינה עם Microsoft Graph, המאפשרת למפתחים לגשת ולנהל נתוני תיבת דואר כגון הודעות, תיקיות, אנשי קשר, לוחות שנה ומשימות. בעזרת ה- IGraphClient באמצעות ה-API, ניתן לאמת, לבצע שאילתות ולבצע פעולות על חשבונות Microsoft 365 ישירות מיישומי ה-Java שלך.

הקטעים הבאים מכסים היבטים שונים של עבודה עם Microsoft Graph ב-Aspose.Email for Java:

אימות עם Microsoft Graph

שימוש בשאילתות OData ב-Microsoft Graph

ניהול אנשי קשר של Microsoft Graph

ניהול לוחות שנה של Microsoft Graph

ניהול משימות Microsoft Graph

כל עמוד כולל הסברים מפורטים, שיטות API זמינות, ודוגמאות קוד.

Java: תכונות שימושיות של Microsoft Graph

Mon, 01 Jan 0001 00:00:00 +0000

יצירת פרויקט במרכז ניהול Azure Active Directory

פרויקט צריך להיווצר במרכז ניהול Azure Active Directory עבור משתמש בעל חשבון MS Office.

צעדים ליצירת פרויקט במרכז ניהול Azure Active Directory

להלן מדריך צעד‑אחר‑צעד ליצירת פרויקט במרכז ניהול Azure Active Directory.

1. עבור ל-Azure Active Directory והתחבר באמצעות פרטי ה-MSO שלך.

Azure Active Directory קישור - https://aad.portal.azure.com/

2. צור אפליקציית Azure AD במנשיך.

בחלונית הצד השמאלית לחץ על התווית Azure Active Directory. פעולה זאת תפתח את הלוח של Azure Active Directory. במסך זה תראה את התווית App registrations. זוהי נקודת ההתחלה לרישום אפליקציית Azure AD. לוח זה יאפשר לך ליצור אפליקציה חדשה עבור Azure AD.

לחץ על הכפתור New registration ליצירת אפליקציה חדשה.

3. כעת תראה את לוח הרישום של האפליקציה החדשה.

Name זה יהיה שם האפליקציה שלך.
סוגי חשבונות נתמכים חלק זה יגביל את הגישה.

לחץ על כפתור Register.

4. עליך לראות את הלוח של האפליקציות שנרשמו לאחרונה.

Application (client) ID מזהה האפליקציה שלך.
Directory (tenant) ID מזהה השוכר של Azure AD.

5. מתן הרשאות ל-API של Microsoft Graph.

לחץ על תגית API permissions.

ל-Azure כבר ניתנו לך הרשאות User.Read מועדפות עבור האפליקציה שלך. הרשאה זו תאפשר לנו לקרוא מידע על משתמש מחובר. אלו הן הרשאות של API של Microsoft Graph, ובצד השני אפשר לכנותן Scopes.

הרשימה המלאה של סקופים ל-API של Microsoft Graph - https://docs.microsoft.com/en-us/graph/permissions-reference.

לחץ על כפתור + Add a permission ובחר Microsoft Graph.

לחץ על Delegated permissions. כעת אתה רואה רשימת הרשאות זמינות ל-API של Microsoft Graph.

בחר את ההרשאות הדרושות, לחץ על כפתור Add permissions.

לחץ על כפתור Grant admin consent.

6. אפשר זרימות של לקוח ציבורי.

מציין האם האפליקציה היא לקוח ציבורי. מתאים לאפליקציות המשתמשות בזרימות הענקת אסימונים שאינן משתמשות ב-Redirect URI.

7. יצירת מפתח עבור האפליקציה

מחלקות מסייעות

המחלקות העוזרות הבאות נדרשות להרצת הקוד בחלק זה. מחלקות אלה נועדו לפשט את ההדגמה בלבד.

מחלקת AzureROPCTokenProvider

מופע של IGraphClient המחלקה מטפלת בבניית בקשות, שליחתן ל-API של Microsoft Graph, ועיבוד התגובות. כדי ליצור מופע חדש של מחלקה זו, עליך לספק מופע של ITokenProvider, שיכול לאמת בקשות ל-Microsoft Graph.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

/**
 * <p>
 * Azure resource owner password credential (ROPC) token provider
 * https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
 * https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth
 * https://portal.azure.com
 * https://developer.microsoft.com/en-us/graph/graph-explorer/#
 * token parser https://jwt.io
 * </p>
 */
class AzureROPCTokenProvider implements ITokenProvider {

    private static final String GRANT_TYPE = "password";

    private final String clientId;
    private final String clientSecret;
    private final String userName;
    private final String password;
    private final String tenant;
    private final String scope;

    private OAuthToken token;

    public AzureROPCTokenProvider(String tenant, String clientId, String clientSecret,
                                  String userName, String password, String[] scopeAr) {
        this.tenant = tenant;
        this.clientId = clientId;
        this.clientSecret = clientSecret;
        this.userName = userName;
        this.password = password;
        this.scope = joinToStr(scopeAr, " ");
    }

    public synchronized OAuthToken getAccessToken(boolean ignoreExistingToken) {
        if (this.token != null && !this.token.getExpired() && !ignoreExistingToken)
            return this.token;
        token = null;

        Map<String, String> tokenArgs = geToken();

        java.util.Calendar c = java.util.Calendar.getInstance();
        c.add(java.util.Calendar.SECOND, Integer.parseInt(tokenArgs.get("expires_in")));
        token = new OAuthToken(tokenArgs.get("access_token"), TokenType.AccessToken, c.getTime());
        return token;
    }

    public final OAuthToken getAccessToken() {
        return getAccessToken(false);
    }

    public void dispose() {
    }

    private String getEncodedParameters() {
        return "client_id=" + urlEncode(clientId) + "&scope=" + urlEncode(scope) + "&username=" + urlEncode(userName)
                + "&password=" + urlEncode(password) + "&grant_type="
                + urlEncode(GRANT_TYPE);
    }

    private String getUri() {
        if (tenant == null || tenant.trim().isEmpty())
            return "https://login.microsoftonline.com/common/oauth2/v2.0/token";
        else
            return "https://login.microsoftonline.com/" + tenant + "/oauth2/v2.0/token";
    }

    private Map<String, String> geToken() {
        try {
            HttpURLConnection connection = (HttpURLConnection) new URL(getUri()).openConnection();
            connection.setRequestMethod("POST");

            byte[] requestData = getEncodedParameters().getBytes(StandardCharsets.UTF_8);

            connection.setUseCaches(false);
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            connection.setRequestProperty("Content-Length", "" + requestData.length);

            final OutputStream st = connection.getOutputStream();
            try {
                st.write(requestData, 0, requestData.length);
            } finally {
                st.flush();
                st.close();
            }

            connection.connect();

            if (connection.getResponseCode() >= HttpURLConnection.HTTP_BAD_REQUEST) {
                throw new IllegalAccessError("Operation failed: " + connection.getResponseCode() + "/" +
                        connection.getResponseMessage() + "\r\nDetails:\r\n{2}"
                        + readInputStream(connection.getErrorStream()));
            }

            String responseText = readInputStream(connection.getInputStream());

            Map<String, String> result = new HashMap<>();
            String[] fromJsonToKeyValue = responseText.replace("{", "").replace("}", "")
                    .replace("\"", "").replace("\r", "")
                    .replace("\n", "").split(",");
            for (String keyValue : fromJsonToKeyValue) {
                String[] pair = keyValue.split(":");
                String name = pair[0].trim().toLowerCase();
                String value = urlDecode(pair[1].trim());
                result.put(name, value);
            }

            return result;
        } catch (IOException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlEncode(String value) {
        try {
            return URLEncoder.encode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlDecode(String value) {
        try {
            return URLDecoder.decode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String readInputStream(InputStream is) {
        if (is == null)
            return "";

        BufferedReader reader = new BufferedReader(new InputStreamReader(is));
        StringBuilder result = new StringBuilder();
        String line;
        try {
            while ((line = reader.readLine()) != null) {
                result.append(line);
            }
        } catch (IOException e) {
            // ignore
        }
        return result.toString();
    }

    static String joinToStr(String[] arr, String sep) {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            if (i > 0)
                sb.append(sep);
            sb.append(arr[i]);
        }
        return sb.toString();
    }
}

Java: כיצד להשתמש ב-GraphClient עבור Microsoft Graph

Mon, 01 Jan 0001 00:00:00 +0000

עבודה עם GraphClient

מופע של IGraphClient מחלקה זו מטפלת בבניית בקשות, שליחתן ל-Microsoft Graph API, ועיבוד התגובות.

יצירת אובייקט ITokenProvider

כדי ליצור מופע חדש של IGraphClient מחלקה, עליך לספק מופע של ITokenProvider, שיכול לאמת בקשות ל-Microsoft Graph.

ITokenProvider tokenProvider = new ITokenProvider() {
    Date expirationDate = null;

    @Override
    public void dispose() {
    }

    @Override
    public OAuthToken getAccessToken(boolean ignoreExistingToken) {
        // Gets oAuth access token.
        // If ignoreExistingToken is true, requests new token from a server. Otherwise behavior is depended on whether token exists or not.
        // If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        return null;
    }

    @Override
    public OAuthToken getAccessToken() {
        // Gets oAuth access token.
        // If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        return new OAuthToken("token", expirationDate);
    }
};

קבלת אובייקט GraphClient

לאחר שהגדרת את TokenProvider, עליך לקבל IGraphClient אובייקט לבצע בקשות לשירות. אחרי שיש לך IGraphClient לאחר שהוא מאומת, ניתן להתחיל לבצע קריאות לשירות.

IGraphClient client = GraphClient.getClient(tokenProvider);

עבודה עם תיקיות באמצעות Microsoft Graph

רשימת תיקיות

GraphFolderInfoCollection folders = client.listFolders();
for (GraphFolderInfo folderInfo : folders) {
    System.out.println(folderInfo.getDisplayName());
    for (KeyValuePair<Long, MapiProperty> prop : folderInfo.getProperties()) {
        System.out.println(prop.getValue().getDescriptor().toString() + " " + prop.getValue().getString());
    }
}

רשימת תתי‑תיקיות מתיקיית Inbox

GraphFolderInfoCollection inboxFolders = client.listFolders(GraphKnownFolders.Inbox);

יצירת תיקיית שורש

GraphFolderInfo newFolder = client.createFolder("TEST_FOLDER");

יצירת תת-תיקייה

GraphFolderInfo inboxTestSubFolder1 = client.createFolder(GraphKnownFolders.Inbox, "TEST_SUBFOLDER_1");
GraphFolderInfo inboxTestSubFolder2 = client.createFolder(newFolder.getItemId(), "TEST_SUBFOLDER_2");

קבל תיקייה

GraphFolderInfo sentItemsFolder = client.getFolder(GraphKnownFolders.SentItems);

עדכון תיקייה

GraphFolderInfo originalFolder = client.createFolder("TEST_FOLDER");
originalFolder.setDisplayName("NEW_TEST_FOLDER");
GraphFolderInfo updatedFolder = client.updateFolder(originalFolder);

העתקת תיקייה ותוכן

GraphFolderInfo parentFolder = client.createFolder("PARENT_FOLDER");
GraphFolderInfo testFolder = client.createFolder("TEST_FOLDER");
GraphFolderInfo testSubFolder = client.createFolder(testFolder.getItemId(), "TEST_SUBFOLDER");

MapiMessage message = new MapiMessage();
message.setSubject("Test subject");
message.setBody("Test body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");
MapiMessage createdMessage = client.createMessage(testSubFolder.getItemId(), message);

GraphFolderInfo folderCopy = client.copyFolder(parentFolder.getItemId(), testFolder.getItemId());

GraphFolderInfoCollection folderColl = client.listFolders(parentFolder.getItemId());
// TEST_FOLDER
System.out.println(folderColl.get(0).getDisplayName());

folderColl = client.listFolders(folderColl.get(0).getItemId());
// TEST_SUBFOLDER
System.out.println(folderColl.get(0).getDisplayName());

GraphMessageInfoCollection listMessages = client.listMessages(folderColl.get(0).getItemId());
// Test subject
System.out.println(listMessages.get(0).getSubject());

הזזת תיקייה ותוכן

GraphFolderInfo folder = client.moveFolder(parentFolder.getItemId(), testFolder.getItemId());

מחיקת תיקייה

client.delete(testFolder.getItemId());

רשימת הודעות באמצעות Microsoft Graph

GraphMessageInfoCollection messageInfoColl = client.listMessages(GraphKnownFolders.Inbox);
for (GraphMessageInfo messageInfo : messageInfoColl) {
    MapiMessage message = client.fetchMessage(messageInfo.getItemId());
}

רשימת הודעות לפי תאריך שליחה

ה OrderBy התכונה משמשת לציון שההודעות צריכות להיות ממותגות בסדר עולה לפי תאריך השליחה שלהן. זאת מאפשרת ללקוח לאחזר את רשימת ההודעות מה- GraphKnownFolders.Inbox תיקייה בסדר ספציפי, במקרה זה על בסיס תאריך השליחה.

דוגמת הקוד הבאה מדגימה איך ליצור שאילתה שמציינת מיון הודעות לפי תאריך שליחה, ולאחר מכן להשתמש בשאילתה זו כדי לאחזר דף של הודעות מתיקיית Inbox באמצעות Graph API:

// create orderby messages query 'ASC'
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.getSentDate().orderBy(true);
MailQuery query = builder.getQuery();

GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(10), query);

אחזור הודעה

GraphMessageInfo messageInfo = messageInfoColl.get(0);
MapiMessage fetchedMessage = client.fetchMessage(messageInfo.getItemId());

דפדוף ברשימת הודעות

ה-API מספק תמיכה בדפדוף וסינון עבור רשימת הודעות. זה מאד מועיל כאשר לתיבת דואר מספר גדול של הודעות וצריך זמן רב לאחזור מידע סיכומי עליהן. דוגמת הקוד שלמטה תראה איך להשתמש בדפדוף עבור קבוצות הודעות גדולות כאשר רושמים הודעות מ-Exchange Server באמצעות IGraphClient:

// send ping test messages
for (int i = 0; i < 5; i++) {
    MailMessage eml = new MailMessage(user.EMail, user.EMail, "ping" + i, "test body");
    client.send(MapiMessage.fromMailMessage(eml));
}
// waiting for inbox
Thread.sleep(10000);

// paging option
int itemsPerPage = 2;
// create unread messages filter
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.isRead().equals(false);
MailQuery query = builder.getQuery();

// list messages
GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(itemsPerPage), query);
GraphMessageInfoCollection messages = pageInfo.getItems();
while (!pageInfo.getLastPage())
{
    pageInfo = client.listMessages(GraphKnownFolders.Inbox, pageInfo.getNextPage(), query);
    // add next page items to common collection
    messages.addRange(pageInfo.getItems());
}

// set messages state as read
for (GraphMessageInfo message : messages) {
    client.setRead(message.getItemId());
}

יצירת הודעה

MapiMessage message = new MapiMessage();
message.setSubject("Subject");
message.setBody("Body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");

MapiMessage createdMessage = client.createMessage(GraphKnownFolders.Inbox, message);

עדכון הודעה

fetchedMessage.setSubject("Update message");
MapiMessage updatedMessage = client.updateMessage(fetchedMessage);

שליחת הודעה

client.send(message);

שליחת הודעת טיוטה

MapiMessage draftMessage = client.createMessage(GraphKnownFolders.Drafts, message);
client.send(draftMessage.getItemId());

העתקת הודעה

MapiMessage copiedMessage = client.copyMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());

העברת הודעה

MapiMessage movedMessage = client.moveMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());

קבצים מצורפים להודעה

MapiAttachmentCollection attachments = client.listAttachments(fetchedMessage.getItemId());
for (MapiAttachment att : attachments) {
    client.deleteAttachment(att.getItemId());
}

מחיקת הודעה

client.delete(message.getItemId());

Categories API

String categoryName = "Test Category";
int preset = CategoryPreset.Preset10;
OutlookCategory category = client.createCategory(categoryName, preset);
OutlookCategory fetchedCategory = client.fetchCategory(category.getId());

List<OutlookCategory> categories = client.listCategories();

fetchedCategory.setDisplayName("Update Category");
fetchedCategory.setPreset(CategoryPreset.Preset11);
OutlookCategory updatedCategory = client.updateCategory(fetchedCategory);

client.delete(category.getId());

Overrides API

int focusedType = ClassificationType.Focused;
ClassificationOverride override = client.createOrUpdateOverride(new MailAddress("testUser@host.com", "testUser"), focusedType);

List<ClassificationOverride> list = client.listOverrides();
for (ClassificationOverride item : list)
    System.out.println(item.getSender().getAddress());

ClassificationOverride fetchedOverride = list.get(0);
fetchedOverride.setClassifyAs(ClassificationType.Other);
fetchedOverride.getSender().setDisplayName("testUser_1");

ClassificationOverride updatedOverride = client.createOrUpdateOverride(fetchedOverride);

fetchedOverride.setClassifyAs(ClassificationType.Focused);
updatedOverride = client.updateOverride(fetchedOverride);

client.delete(updatedOverride.getId());

Rules API

InboxRule rule = new InboxRule();
rule.setDisplayName("Test rule");
rule.setPriority(1);
rule.setEnabled(true);
rule.setConditions(new RulePredicates());
rule.getConditions().containsSenderStrings(new StringCollection());
rule.getConditions().containsSenderStrings().addItem("testUser");
rule.setActions(new RuleActions());
rule.getActions().setForwardToRecipients(new MailAddressCollection());
rule.getActions().getForwardToRecipients().addMailAddress(new MailAddress("testUser@host.com", "testUser", true));
rule.getActions().setStopProcessingRules(true);

InboxRule createdRule = client.createRule(rule);

List<InboxRule> listedRules = client.listRules();
for (InboxRule item : listedRules)
    System.out.println(item.getDisplayName());

InboxRule fetchedRule = client.fetchRule(createdRule.getRuleId());

createdRule.setDisplayName("Test rule 1");
createdRule.setEnabled(false);
InboxRule updatedRule = client.updateRule(createdRule);

client.delete(createdRule.getRuleId());

שימוש ב-Resource לתמיכה בתיבות דואר מרובות

сlient.setResource(ResourceType.Users);
сlient.setResourceId("mailbox");
сlient.listMessages("mailfolder")
// back to the current mailbox
сlient.setResource(ResourceType.Me);

Java: ניהול אנשי קשר ב-Microsoft Graph עם Aspose.Email for Java

Mon, 01 Jan 0001 00:00:00 +0000

הפנה ל הגדרת Azure AD ואימות Microsoft Graph מאמר ללמוד כיצד לשלב את היישום שלך עם Microsoft Graph.

Aspose.Email for Java מציע תמיכה בניהול אנשי קשר דרך Microsoft Graph. ניתן לרשום, לאחזר, ליצור ולעדכן אנשי קשר ישירות מתיקיות אנשי קשר.

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

listContacts(String id) — מקבל אוסף של אנשי קשר מהתיקייה שצוינה.
fetchContact(String id) — מקבל איש קשר לפי המזהה שלו.
createContact(String folderId, MapiContact contact) — יוצר איש קשר חדש בתיקייה.
updateContact(MapiContact contact) — מעדכן איש קשר קיים.

IGraphClient graphClient = null;

// List Contacts
MapiContactCollection contacts = graphClient.listContacts("contactFolderId");

// Fetch Contact
MapiContact contact = graphClient.fetchContact("contactId");

// Create Contact
MapiContact newContact = new MapiContact("Jane Smith", "jane.smith@example.com", "XYZ Corporation", "777-888-999");
MapiContact createdContact = graphClient.createContact("contactFolderId", newContact);

// Update Contact
createdContact.getTelephones().setPrimaryTelephoneNumber("888-888-999");
MapiContact updatedContact = graphClient.updateContact(createdContact);

Java: ניהול משימות ב-Microsoft Graph עם Aspose.Email for Java

Mon, 01 Jan 0001 00:00:00 +0000

הפנה ל הגדרת Azure AD ואימות Microsoft Graph מאמר ללמוד כיצד לשלב את היישום שלך עם Microsoft Graph.

Aspose.Email for Java מציע תמיכה בניהול משימות דרך Microsoft Graph. ניתן למנות רשימות משימות, ליצור או למחוק אותן, ולנהל משימות עם אפשרויות עדכון גמישות.

דוגמת הקוד למטה מציגה כיצד לנהל רשימות משימות ומשימות באמצעות השיטות הבאות של GraphClient מחלקה:

listTaskLists() — מקבל את כל רשימות המשימות.
getTaskList(String id) — מקבל רשימת משימות ספציפית.
deleteTaskList(String id) — מוחק רשימת משימות.
listTasks(String id) — מקבל משימות עבור רשימת משימות נתונה.
fetchTask(String id) — מקבל משימה לפי המזהה שלה.
createTask(MapiTask task, String taskListUri) — יוצר משימה ברשימת משימות ספציפית.
updateTask(MapiTask task) — מעדכן משימה קיימת.
updateTask(MapiTask task, UpdateSettings updateSettings) — מעדכן משימה עם הגדרות עדכון ספציפיות.

// List Task Lists
GraphTaskListInfoCollection taskLists = graphClient.listTaskLists();
for (GraphTaskListInfo tList : taskLists) {
    System.out.println("Task List: " + tList.getDisplayName());
}

// Get Task List
GraphTaskListInfo taskList = graphClient.getTaskList("taskListId");

// Delete Task List
graphClient.deleteTaskList("taskListId");

// List Tasks in a Task List
MapiTaskCollection tasks = graphClient.listTasks("taskListId");

// Fetch Task
MapiTask task = graphClient.fetchTask("taskId");

// Create Task
MapiTask newTask = new MapiTask();
newTask.setSubject("New Task");
newTask.setDueDate(new Date());
newTask.setStatus(MapiTaskStatus.NotStarted);

MapiTask createdTask = graphClient.createTask(newTask, "taskListUri");

// Update Task
createdTask.setSubject("Updated Task Subject");
MapiTask updatedTask = graphClient.updateTask(createdTask);

// Update Task with UpdateSettings
UpdateSettings updateSettings = new UpdateSettings();
updateSettings.setSkipAttachments(true);
MapiTask updatedTaskWithSettings = graphClient.updateTask(createdTask, updateSettings);

Java: ניהול פריטי לוח שנה ב-Microsoft Graph

Mon, 01 Jan 0001 00:00:00 +0000

הפנה ל הגדרת Azure AD ואימות Microsoft Graph מאמר ללמוד כיצד לשלב את היישום שלך עם Microsoft Graph.

Aspose.Email for Java מציע תמיכה בניהול פריטי יומן דרך Microsoft Graph. ניתן לרשום יומנים, לעבוד עם אירועי יומן ולעדכן פריטים עם או ללא הגדרות עדכון.

דוגמת הקוד למטה מציגה כיצד לנהל פריטי יומן באמצעות השיטות הבאות של GraphClient מחלקה:

listCalendars() — מקבל אוסף של יומנים זמינים.
listCalendarItems(String id) — מקבל פריטי יומן עבור יומן ספציפי.
fetchCalendarItem(String id) — מאחזר פריט לוח שנה לפי מזהה שלו.
createCalendarItem(String calId, MapiCalendar mapiCalendar) — יוצר פריט לוח שנה חדש.
updateCalendarItem(MapiCalendar mapiCalendar) — מעדכן פריט לוח שנה קיים.
updateCalendarItem(MapiCalendar mapiCalendar, UpdateSettings updateSettings) — מעדכן פריט לוח שנה עם הגדרות עדכון מותאמות.

// List Calendars
GraphCalendarInfoCollection calendars = graphClient.listCalendars();

// List Calendar Items
MapiCalendarCollection calendarItems = graphClient.listCalendarItems("calendarId");

// Fetch Calendar Item
MapiCalendar calendarItem = graphClient.fetchCalendarItem("calendarItemId");

// Create Calendar Item
MapiCalendar newCalendarItem = new MapiCalendar();
newCalendarItem.setLocation("Conference Room");
newCalendarItem.setSubject("Team Meeting");
newCalendarItem.setBody("Discuss project status and updates.");
newCalendarItem.setStartDate(startDate);
newCalendarItem.setEndDate(endDate);

MapiCalendar createdCalendarItem = graphClient.createCalendarItem("calendarId", newCalendarItem);

// Update Calendar Item
createdCalendarItem.setLocation("Zoom Meeting");
MapiCalendar updatedCalendarItem = graphClient.updateCalendarItem(createdCalendarItem);

Java: ניהול תיבת דואר עם Microsoft Graph

Mon, 01 Jan 0001 00:00:00 +0000

בנוסף לעבודה עם הודעות, תיקיות וקבצים מצורפים, Aspose.Email for Java מאפשר גם לנהל תכונות ברמת תיבת דואר כגון קטגוריות, Overrides של תיבת דואר ממוקדת, וכללים. ניתן גם לעבוד עם תיבות דואר מרובות על ידי החלפת הקשר המשאב. פעולות אלו זמינות דרך אינטגרציית Graph API.

כיצד לעבוד עם קטגוריות Outlook

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

String categoryName = "Test Category";
int preset = CategoryPreset.Preset10;

// create a new category
OutlookCategory category = client.createCategory(categoryName, preset);

// fetch a category
OutlookCategory fetchedCategory = client.fetchCategory(category.getId());

// list categories
List<OutlookCategory> categories = client.listCategories();

// update a category
fetchedCategory.setDisplayName("Update Category");
fetchedCategory.setPreset(CategoryPreset.Preset11);
OutlookCategory updatedCategory = client.updateCategory(fetchedCategory);

// delete a category
client.delete(category.getId());

כיצד לעבוד עם Overrides

החלפות (Overrides) משנות איך הודעות ממשלחים מסוימים מטופלות בתיבת הדואר הממוקדת. לדוגמה, ניתן להכתיב שהודעות ממשלח ספציפי תמיד יופיעו בתצוגה הממוקדת.

int focusedType = ClassificationType.Focused;

// create or update an override for a sender
ClassificationOverride override = client.createOrUpdateOverride(
    new MailAddress("testUser@host.com", "testUser"), focusedType
);

// list overrides
List<ClassificationOverride> list = client.listOverrides();
for (ClassificationOverride item : list)
    System.out.println(item.getSender().getAddress());

// update override classification
ClassificationOverride fetchedOverride = list.get(0);
fetchedOverride.setClassifyAs(ClassificationType.Other);
fetchedOverride.getSender().setDisplayName("testUser_1");
ClassificationOverride updatedOverride = client.createOrUpdateOverride(fetchedOverride);

// reset classification
fetchedOverride.setClassifyAs(ClassificationType.Focused);
updatedOverride = client.updateOverride(fetchedOverride);

// delete override
client.delete(updatedOverride.getId());

כיצד לעבוד עם כללי Outlook

כללי תיבת הדואר מאפשרים אוטומציה של פעולות כגון הפניית הודעות או סינון על פי תנאים. ה-Graph API מאפשר ליצור, לאחזר, לעדכן, לרשום ולמחוק כללי תיבת דואר נכנסת.

// create a new rule
InboxRule rule = new InboxRule();
rule.setDisplayName("Test rule");
rule.setPriority(1);
rule.setEnabled(true);
rule.setConditions(new RulePredicates());
rule.getConditions().containsSenderStrings(new StringCollection());
rule.getConditions().containsSenderStrings().addItem("testUser");

// define actions
rule.setActions(new RuleActions());
rule.getActions().setForwardToRecipients(new MailAddressCollection());
rule.getActions().getForwardToRecipients()
    .addMailAddress(new MailAddress("testUser@host.com", "testUser", true));
rule.getActions().setStopProcessingRules(true);

InboxRule createdRule = client.createRule(rule);

// list rules
List<InboxRule> listedRules = client.listRules();
for (InboxRule item : listedRules)
    System.out.println(item.getDisplayName());

// fetch and update a rule
InboxRule fetchedRule = client.fetchRule(createdRule.getRuleId());
createdRule.setDisplayName("Test rule 1");
createdRule.setEnabled(false);
InboxRule updatedRule = client.updateRule(createdRule);

// delete rule
client.delete(createdRule.getRuleId());

עבודה עם תיבות דואר מרובות - החלפת הקשר תיבת הדואר

בברירת מחדל, הפעולות מתבצעות על תיבת הדואר של המשתמש הנוכחי. ניתן להחליף את ההקשר לתיבת דואר אחרת (למשל, כדי לרשום הודעות מתיבת דואר משותפת) על ידי קביעת סוג המשאב וזהות המשאב.

// switch to another mailbox
client.setResource(ResourceType.Users);
client.setResourceId("mailbox");
client.listMessages("mailfolder");

// switch back to the current user mailbox
client.setResource(ResourceType.Me);

שאילתות OData עם Microsoft Graph

Aspose.Email for Java מספק תמיכה בשאילתות OData בעת עבודה עם Microsoft Graph. היא מאפשרת לבצע סינון מתקדם, מיון, בחירה, דפדוף והרחבה בעת אחזור משאבים כגון תיקיות, הודעות, אנשי קשר ופריטי לוח שנה. ה- ODataQueryBuilder מחלקה זו מאפשרת לבנות פרמטרי שאילתות OData בצורה מובנית וניתנת למימוש חוזר במקום לבנות מחרוזות שאילתה ידנית. השיטות הבאות ניתנות לשימוש לספירה וחיפוש במערכי נתונים גדולים:

Select לאחזר רק את המאפיינים שהינך צריך.
Filter להחלת פילטרים.
OrderBy למיון תוצאות.
Top ו Skip לדפדוף.
Expand להרחיב ישויות קשורות בשאילתה אחת.

מספר GraphClient השיטות מקבלות אופציונלי ODataQueryBuilder פרמטר ליישום שאילתות OData, כולל:

listFolders
listMessages
listContacts
listCalendarItems
listAttachments
listCategories
listOverrides
listRules
listTaskLists
listTasks
listNotebooks

דוגמת הקוד הבאה מראה איך להשתמש ב- ODataQueryBuilder כדי לבצע שאילתות על תיקיות ולאחזר הודעות עם פילטרים מתקדמים ודפדוף:

IGraphClient client = GraphClient.GetClient();

client.setResource(ResourceType.Users);
client.setResourceId(username);
client.setEndpoint("https://graph.microsoft.com");

// Example 1: List folders ordered by name
ODataQueryBuilder builder = new ODataQueryBuilder();
builder.setOrderBy("name asc");

GraphFolderInfoCollection folders = client.listFolders(builder);
for (GraphFolderInfo folder : folders) {
    System.out.println(folder.getDisplayName());
}

String folderId = folders.get(0).getItemId();

// Example 2: Retrieve filtered and paged messages
builder = new ODataQueryBuilder();
{
    builder.setFilter("startswith(name,'A')");
    builder.setOrderBy("name asc");
    builder.setTop(10);
    builder.setSkip(5);
    builder.setSelect(new String[]{"name", "age"});
    builder.setExpand(new String[]{"children", "parents"});
    builder.setCount(true);
    builder.setSearch("\"John Doe\"");
    builder.setFormat("json");
};

GraphMessageInfoCollection msgs = client.listMessages(folderId, builder);
for (GraphMessageInfo msg : msgs) {
    System.out.println(msg.getSubject());
}

Java: עבודה עם הודעות באמצעות Microsoft Graph

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for Java מספק סט עשיר של API לניהול הודעות דרך Microsoft Graph. ניתן לרשום, לאחזר, ליצור, לעדכן, להעביר, להעתיק ולמחוק הודעות, וכן להתמודד עם דפדוף וקבצים מצורפים. דוגמאות הקוד שלהלן הן דוגמאות לפעולות הנפוצות ביותר.

רשימת הודעות

ניתן לאחזר הודעות מתיקייה מסוימת, כמו תיבת דואר נכנס, ולאחזר את התוכן המלא שלהם:

GraphMessageInfoCollection messageInfoColl = client.listMessages(GraphKnownFolders.Inbox);
for (GraphMessageInfo messageInfo : messageInfoColl) {
    MapiMessage message = client.fetchMessage(messageInfo.getItemId());
}

רשימת הודעות לפי תאריך שליחה

כדי למיין הודעות לפי תאריך שליחה בסדר עולה, ניתן להשתמש ב- OrderBy תכונה של GraphQueryBuilder:

// create orderby messages query 'ASC'
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.getSentDate().orderBy(true);
MailQuery query = builder.getQuery();

GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(10), query);

אחזור הודעה

ברגע שיש לך הפנייה להודעה, אתה יכול לאחזר את התוכן המלא שלה:

GraphMessageInfo messageInfo = messageInfoColl.get(0);
MapiMessage fetchedMessage = client.fetchMessage(messageInfo.getItemId());

עדכון הודעה

לאחר אחזור הודעה, ניתן לשנות את תוכנה ולעדכן אותה בשרת:

fetchedMessage.setSubject("Update message");
MapiMessage updatedMessage = client.updateMessage(fetchedMessage);

דפדוף ברשימת הודעות

בעת עבודה עם תיבות דואר גדולות, ניתן להשתמש בדפדוף כדי לאחזר הודעות בחלקים. הדוגמא שלמטה מדגימה רשימת הודעות שלא נקראו בדפים של שני פריטים כל אחד:

// send ping test messages
for (int i = 0; i < 5; i++) {
    MailMessage eml = new MailMessage(user.EMail, user.EMail, "ping" + i, "test body");
    client.send(MapiMessage.fromMailMessage(eml));
}
// waiting for inbox
Thread.sleep(10000);

// paging option
int itemsPerPage = 2;
// create unread messages filter
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.isRead().equals(false);
MailQuery query = builder.getQuery();

// list messages
GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(itemsPerPage), query);
GraphMessageInfoCollection messages = pageInfo.getItems();
while (!pageInfo.getLastPage())
{
    pageInfo = client.listMessages(GraphKnownFolders.Inbox, pageInfo.getNextPage(), query);
    // add next page items to common collection
    messages.addRange(pageInfo.getItems());
}

// set messages state as read
for (GraphMessageInfo message : messages) {
    client.setRead(message.getItemId());
}

יצירת הודעה

ניתן ליצור הודעות חדשות עם נושא, גוף ופרמטרים:

MapiMessage message = new MapiMessage();
message.setSubject("Subject");
message.setBody("Body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");

MapiMessage createdMessage = client.createMessage(GraphKnownFolders.Inbox, message);

שליחת הודעה

ניתן לשלוח הודעה ישירות:

client.send(message);

או שלח הודעת טיוטה לאחר יצירתה בתיקיית טיוטות:

MapiMessage draftMessage = client.createMessage(GraphKnownFolders.Drafts, message);
client.send(draftMessage.getItemId());

העתקה והעברה של הודעות

ניתן להעתיק או להעביר הודעות בין תיקיות:

MapiMessage copiedMessage = client.copyMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());
MapiMessage movedMessage = client.moveMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());

ניהול קבצים מצורפים

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

MapiAttachmentCollection attachments = client.listAttachments(fetchedMessage.getItemId());
for (MapiAttachment att : attachments) {
    client.deleteAttachment(att.getItemId());
}

מחיקת הודעה

לבסוף, ניתן למחוק הודעה לצמיתות:

client.delete(message.getItemId());

Java: עבודה עם תיקיות באמצעות Microsoft Graph

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for Java מאפשרת לבצע מגוון פעולות על תיקיות ב‑Microsoft Graph, כגון רישום, יצירה, עדכון, העתקה, הזזה ומחיקה של תיקיות. להלן דוגמאות לתרחישים נפוצים.

רשימת תיקיות

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

GraphFolderInfoCollection folders = client.listFolders();
for (GraphFolderInfo folderInfo : folders) {
    System.out.println(folderInfo.getDisplayName());
    for (KeyValuePair<Long, MapiProperty> prop : folderInfo.getProperties()) {
        System.out.println(prop.getValue().getDescriptor().toString() + " " + prop.getValue().getString());
    }
}

רשימת תתי‑תיקיות מתיקיית Inbox

ניתן גם לרשום תתי‑תיקיות תחת תיקייה ספציפית, כגון Inbox:

GraphFolderInfoCollection inboxFolders = client.listFolders(GraphKnownFolders.Inbox);

יצירת תיקיות

ניתן ליצור תיקיות ברמת השורש וגם תתי‑תיקיות.

צור תיקיית שורש

GraphFolderInfo newFolder = client.createFolder("TEST_FOLDER");

צור תתי‑תיקיות

קוד הדוגמה הבא מציג כיצד ליצור תת‑תיקייה תחת תיקיית Inbox:

GraphFolderInfo inboxTestSubFolder1 = client.createFolder(GraphKnownFolders.Inbox, "TEST_SUBFOLDER_1");
GraphFolderInfo inboxTestSubFolder2 = client.createFolder(newFolder.getItemId(), "TEST_SUBFOLDER_2");

קבל תיקייה

קוד הדוגמה הבא מדגים כיצד לאחזר תיקייה ספציפית, כגון פריטים נשלחים:

GraphFolderInfo sentItemsFolder = client.getFolder(GraphKnownFolders.SentItems);

עדכון תיקייה

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

GraphFolderInfo originalFolder = client.createFolder("TEST_FOLDER");
originalFolder.setDisplayName("NEW_TEST_FOLDER");
GraphFolderInfo updatedFolder = client.updateFolder(originalFolder);

העתקת תיקייה והקבצים שלה

הדוגמה הבאה מציגה כיצד להעתיק תיקייה יחד עם תתי‑תיקיות והודעות:

GraphFolderInfo parentFolder = client.createFolder("PARENT_FOLDER");
GraphFolderInfo testFolder = client.createFolder("TEST_FOLDER");
GraphFolderInfo testSubFolder = client.createFolder(testFolder.getItemId(), "TEST_SUBFOLDER");

MapiMessage message = new MapiMessage();
message.setSubject("Test subject");
message.setBody("Test body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");
MapiMessage createdMessage = client.createMessage(testSubFolder.getItemId(), message);

GraphFolderInfo folderCopy = client.copyFolder(parentFolder.getItemId(), testFolder.getItemId());

GraphFolderInfoCollection folderColl = client.listFolders(parentFolder.getItemId());
// TEST_FOLDER
System.out.println(folderColl.get(0).getDisplayName());

folderColl = client.listFolders(folderColl.get(0).getItemId());
// TEST_SUBFOLDER
System.out.println(folderColl.get(0).getDisplayName());

GraphMessageInfoCollection listMessages = client.listMessages(folderColl.get(0).getItemId());
// Test subject
System.out.println(listMessages.get(0).getSubject());

הזזת תיקייה ותוכן שלה

ניתן גם להעביר תיקייה עם כל תוכנה למיקום אחר:

GraphFolderInfo folder = client.moveFolder(parentFolder.getItemId(), testFolder.getItemId());

מחיקת תיקייה

השתמש בקוד הבא כדי למחוק תיקייה לצמיתות:

client.delete(testFolder.getItemId());