Skip to content

Latest commit

 

History

History
113 lines (97 loc) · 5.32 KB

office365-contact-adapter.md

File metadata and controls

113 lines (97 loc) · 5.32 KB
Raw
title description ms.custom ms.date ms.service ms.reviewer ms.suite ms.topic
Use the Office 365 Outlook Contact adapter
Send messages using the Office 365 Outlook Contact adapter in BizTalk Server. To do this, create a send port using the Outlook adapter, and use a sample XML message to create a contact in Office 365 Outlook account.
biztalk-2020
01/10/2020
biztalk-server
article

Create a contact using the Office 365 Outlook Contact adapter - BizTalk Server

Use the Office 365 Outlook Contact adapter in BizTalk Server to create contacts in your Office 365 Outlook.

Create a contact using a send port

  1. In the BizTalk Server Administration console, right-click Send Ports, select New, and select Static One-way send port.

    Create a Send Port provides some guidance.

  2. Enter a Name. In Transport, set the Type to Office 365 Outlook Contact, and select Configure.

  3. Select Sign in …, and sign in to your Office 365 Account. The account is auto-populated with your email address.

  4. Allow BizTalk Server approval for permission to access:

    Office 365 Contact permissions

  5. Select Ok to save your changes.

Test the send port

You can use a simple File receive port and location to create an event on your Office 365 Outlook Contact adapter.

  1. Create a receive port using the File adapter. Within your receive location, set the Receive folder to C:\Temp\In\, and set the file mask to *.xml.

  2. In your Office 365 Outlook Contact adapter send port properties, set the Filters to BTS.ReceivePortName == <Receive Port Name>.

  3. Paste the following into a text editor, and save the file as Office365Contact.xml. This is your sample message.

        <ns0:Contact xmlns:ns0="http://schemas.microsoft.com/BizTalk/Office365OutlookContacts/Send">
        <categories>categories_0</categories>
        <categories>categories_1</categories>
        <categories>categories_2</categories>
        <birthday>1999-05-31T13:20:00.000-05:00</birthday>
        <fileAs>fileAs_0</fileAs>
        <displayName>displayName_0</displayName>
        <givenName>givenName_0</givenName>
        <initials>initials_0</initials>
        <middleName>middleName_0</middleName>
        <nickName>nickName_0</nickName>
        <surname>surname_0</surname>
        <title>title_0</title>
        <yomiGivenName>yomiGivenName_0</yomiGivenName>
        <yomiSurname>yomiSurname_0</yomiSurname>
        <yomiCompanyName>yomiCompanyName_0</yomiCompanyName>
        <generation>generation_0</generation>
        <jobTitle>jobTitle_0</jobTitle>
        <companyName>companyName_0</companyName>
        <department>department_0</department>
        <officeLocation>officeLocation_0</officeLocation>
        <profession>profession_0</profession>
        <businessHomePage>businessHomePage_0</businessHomePage>
        <assistantName>assistantName_0</assistantName>
        <manager>manager_0</manager>
        <homePhones>homePhones_0</homePhones>
        <homePhones>homePhones_1</homePhones>
        <mobilePhone>mobilePhone_0</mobilePhone>
        <businessPhones>businessPhones_0</businessPhones>
        <businessPhones>businessPhones_1</businessPhones>
        <spouseName>spouseName_0</spouseName>
        <personalNotes>personalNotes_0</personalNotes>
        <children>children_0</children>
        <children>children_1</children>
        <children>children_2</children>
        <emailAddresses>
            <name>name_0</name>
            <address>address_0</address>
        </emailAddresses>
        <emailAddresses>
            <name>name_0</name>
            <address>address_0</address>
        </emailAddresses>
        <homeAddress>
            <city>city_0</city>
            <countryOrRegion>countryOrRegion_0</countryOrRegion>
            <postalCode>10000</postalCode>
            <state>state_0</state>
            <street>street_0</street>
        </homeAddress>
        <businessAddress>
            <city>city_0</city>
            <countryOrRegion>countryOrRegion_0</countryOrRegion>
            <postalCode>11111</postalCode>
            <state>state_0</state>
            <street>street_0</street>
        </businessAddress>
        <otherAddress>
            <city>city_0</city>
            <countryOrRegion>countryOrRegion_0</countryOrRegion>
            <postalCode>21222</postalCode>
            <state>state_0</state>
            <street>street_0</street>
        </otherAddress>
    </ns0:Contact>

    The XML schema is provided as part of the SDK inside < BizTalk Installation Folder\SDK\Schemas >

  4. Start the File receive location and the Office 365 Outlook Contact adapter send port.

  5. Copy Office365Contact.xml sample message into the receive folder (C:\Temp\In\). The send port creates a contact in your Office 365 Outlook account based on the xml.

Next steps

See all the Office 365 adapters.