Opportunity Object

Outlook Developer Reference
Opportunity Object

The Opportunity object represents a record designed to maximize product and service sales.

Version Information
 Version Added:  Outlook 2007

Requirements

Business Contact Manager for Outlook

Remarks

You must link an Opportunity object with exactly one Account or Business Contact object; an Opportunity cannot exist without an Account or Business Contact. You can add some communication history items—appointments, business notes, files, and tasks—to an opportunity record. When you create an opportunity programmatically, you must reload the Opportunity object before the Account or Business Contact link will display in the Opportunity form.

By using the Outlook object model, you can programmatically:

  • Create a new opportunity associated with an Account or Business Contact.
  • Select an existing Opportunity.
  • Edit Opportunity properties.
  • Delete an Opportunity.

The Opportunities folder contains Opportunity records. You cannot programmatically copy Opportunity records to any other folder.

Example

The following C# and Visual Basic for Applications (VBA) code examples show how to create a new object instance of type IPM.Task.BCM.Opportunity.

C#
  
Outlook.TaskItem newOpportunity = (Outlook.TaskItem)opportunities.Items.Add("IPM.Task.BCM.Opportunity");
Visual Basic for Applications
  
Set newOpportunity = bcmOppFolder.Items.Add("IPM.Task.BCM.Opportunity")

Properties

Close Date, Competitors, Created By, DeliveryDate, Expected Revenue, ExpirationDate, Grand Parent Entity EntryID, Modified By, Opportunity Product, Opportunity Status, Opportunity Type, Parent Entity EntryID, ParentDisplayName, PaymentTerms, Probability, Sales Stage, Source of Lead, Total Discount, Total Value

Parent Objects

TaskItem Object

For more information, see the Outlook 2007 Developer Reference by going to the MSDN Office Developer Center Web site.

See Also

About Communication History Items | Create an Opportunity linked to a BCM Account | Create an Opportunity linked to a Business Contact | Select an Opportunity | Edit an Opportunity | Delete an Opportunity