Bekerja dengan Tugas di Server Exchange

Bekerja dengan Tugas

Aspose.Email mendukung pemrosesan tugas di Exchange menggunakan ExchangeTask kelas. Berbagai properti yang diekspos oleh ExchangeTask, seperti Subject, Status, Tanggal Jatuh Tempo, dan Prioritas, dapat digunakan untuk mengonfigurasi tugas pada Exchange. The EWSClient kelas mengekspos fungsi seperti createTask, updateTask, dan deleteTask yang digunakan untuk memproses tugas pada Exchange. Artikel ini menunjukkan cara:

Buat tugas baru.
Atur zona waktu tugas.
Perbarui sebuah tugas.
Hapus sebuah tugas.
Kirim Permintaan Tugas
Simpan Tugas ke Disk

Buat Tugas Baru

Potongan kode berikut menunjukkan cara membuat tugas baru.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Create Exchange task object
ExchangeTask task = new ExchangeTask();

// Set task subject and status to In progress
task.setSubject("New-Test");
task.setStatus(ExchangeTaskStatus.InProgress);
client.createTask(client.getMailboxInfo().getTasksUri(), task);

Menentukan Zona Waktu

The IEWSClient antarmuka dan ExchangeTask menyediakan properti TimeZoneId untuk mengatur informasi zona waktu saat membuat tugas. Potongan kode berikut menunjukkan cara menentukan Zona Waktu.

client.setTimezoneId("Central Europe Standard Time");

Perbarui Tugas

Potongan kode berikut menunjukkan cara memperbarui tugas pada server Exchange.

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get all tasks info collection from exchange
ExchangeMessageInfoCollection tasks = client.listMessages(client.getMailboxInfo().getTasksUri());

// Parse all the tasks info in the list
for (ExchangeMessageInfo info : (Iterable<ExchangeMessageInfo>) tasks) {
    // Fetch task from exchange using current task info
    ExchangeTask task = client.fetchTask(info.getUniqueUri());

    // Update the task status to NotStarted
    task.setStatus(ExchangeTaskStatus.NotStarted);

    // Set the task due date
    SimpleDateFormat sdf = new SimpleDateFormat("dd/MM/yyyy HH:mm:ss");
    task.setDueDate(sdf.parse("26/02/2013 00:00:00"));

    // Set task priority
    task.setPriority(MailPriority.Low.getValue());

    // Update task on exchange
    client.updateTask(task);
}

Hapus Tugas

Potongan kode berikut menunjukkan cara menghapus tugas pada server Exchange.

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get all tasks info collection from exchange
ExchangeMessageInfoCollection tasks = client.listMessages(client.getMailboxInfo().getTasksUri());

// Parse all the tasks info in the list
for (ExchangeMessageInfo info : (Iterable<ExchangeMessageInfo>) tasks) {
    // Fetch task from exchange using current task info
    ExchangeTask task = client.fetchTask(info.getUniqueUri());

    // Check if the current task fulfills the search criteria
    if (task.getSubject().equals("test")) {
        // Delete task from exchange
        client.deleteItem(task.getUniqueUri(), DeletionOptions.getDeletePermanently());
    }
}

Mengirim Permintaan Tugas

Layanan Aspose.Email Exchange menyediakan kemampuan untuk mengirim permintaan tugas mirip Outlook. Potongan kode berikut menunjukkan cara memuat pesan permintaan tugas dari disk dan mengirimnya menggunakan IEWSClient.

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

MsgLoadOptions options = new MsgLoadOptions();
options.setPreserveTnefAttachments(true);

// load task from .msg file
MailMessage eml = MailMessage.load(dataDir + "task.msg", options);
eml.setFrom(MailAddress.to_MailAddress("firstname.lastname@domain.com"));
eml.getTo().clear();
eml.getTo().addMailAddress(new MailAddress("firstname.lastname@domain.com"));
client.send(eml);

Menyimpan Tugas ke Disk

Aspose.Email juga memungkinkan penyimpanan Tugas Exchange ke disk dalam format Outlook MSG. Potongan kode berikut menunjukkan cara menyimpan tugas ke disk.

ExchangeTask task = new ExchangeTask();
task.setSubject("TASK-ID - " + UUID.randomUUID());
task.setStatus(ExchangeTaskStatus.InProgress);

Calendar cal = Calendar.getInstance();
task.setStartDate(cal.getTime());
cal.add(Calendar.DATE, 3);
task.setDueDate(cal.getTime());
task.save(dstEmail);

Menyebutkan Tugas dari Server Exchange

IEWSClient menyediakan listTasks metode yang dapat digunakan untuk mengambil tugas dari Exchange Web Service. Ia memiliki beberapa overload yang dapat digunakan untuk mengambil daftar tugas dari folder tertentu atau dengan beberapa kriteria pencarian. Contoh kode di bawah mengilustrasikan pengambilan semua atau tugas tertentu dari folder Tasks.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

// Listing Tasks from Server
client.setTimezoneId("Central Europe Standard Time");
TaskCollection taskCollection = client.listTasks(client.getMailboxInfo().getTasksUri());

// print retrieved tasks' details
int iTasksCount = taskCollection.size();
for (int i = 0; i < iTasksCount; i++) {
    ExchangeTask task = (ExchangeTask) taskCollection.get_Item(i);
    System.out.println(task.getSubject());
    System.out.println(task.getStartDate());
    System.out.println(task.getDueDate());
}

// Listing Tasks from server based on Query - Completed and In-Progress
Integer[] selectedStatuses = new Integer[] { ExchangeTaskStatus.Completed, ExchangeTaskStatus.InProgress };
ExchangeQueryBuilder queryBuilder = new ExchangeQueryBuilder();
queryBuilder.getTaskStatus().in(Arrays.asList(selectedStatuses));
MailQuery query = queryBuilder.getQuery();

taskCollection = client.listTasks(client.getMailboxInfo().getTasksUri(), query);

// print retrieved tasks' details
iTasksCount = taskCollection.size();
for (int i = 0; i < iTasksCount; i++) {
    ExchangeTask task = (ExchangeTask) taskCollection.get_Item(i);
    System.out.println(task.getSubject());
    System.out.println(task.getStartDate());
    System.out.println(task.getDueDate());
}

Menyaring Tugas dari Server Exchange

Aspose.Email menyediakan kemampuan untuk mengambil tugas spesifik dari server alih-alih mengambil semua tugas. API dapat digunakan untuk mengambil tugas berdasarkan status tugas seperti Completed, Deferred, In Progress, Not started, atau Waiting on others. ExchangeQueryBuilder kelas dapat digunakan untuk menentukan kriteria yang diinginkan dengan memanfaatkan properti Status. Ini juga memungkinkan penentuan beberapa kondisi untuk mengambil tugas yang diinginkan dari Server Exchange. Hal ini ditunjukkan oleh contoh kode berikut.

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Set timezone for tasks
client.setTimezoneId("Central Europe Standard Time");

// We use these status values for specifying in queries
Integer[] values = new Integer[] { ExchangeTaskStatus.Completed, ExchangeTaskStatus.Deferred, ExchangeTaskStatus.InProgress, ExchangeTaskStatus.NotStarted,
        ExchangeTaskStatus.WaitingOnOthers };

messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri());

// Now retrieve the tasks with specific statuses
for (int status : values) {
    queryBuilder = new ExchangeQueryBuilder();
    queryBuilder.getTaskStatus().equals(status);
    query = queryBuilder.getQuery();
    messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);
    fetchedTask = client.fetchTask(messageInfoCol.get_Item(0).getUniqueUri());
}

// retrieve all other than specified
for (int status : values) {
    queryBuilder = new ExchangeQueryBuilder();
    queryBuilder.getTaskStatus().notEquals((int) status);
    query = queryBuilder.getQuery();
    messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);
}

// specifying multiple criterion
Integer[] selectedStatuses = new Integer[] { ExchangeTaskStatus.Completed, ExchangeTaskStatus.InProgress };

queryBuilder = new ExchangeQueryBuilder();
queryBuilder.getTaskStatus().in(Arrays.asList(selectedStatuses));
query = queryBuilder.getQuery();
messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);

// list all those which are not in our specified statuses
queryBuilder = new ExchangeQueryBuilder();
queryBuilder.getTaskStatus().notIn(Arrays.asList(selectedStatuses));
query = queryBuilder.getQuery();
messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);

Bekerja dengan Aturan di Exchange Server Bekerja dengan Konfigurasi Pengguna di Server

Bekerja dengan Tugas di Server Exchange