Part 1… Consuming the External Content Type through SharePoint Designer in Microsoft Outlook 2010
Part 2… Consuming the External Data List Columns inside Microsoft Word 2010 through Form Fields
Teaser…Extending @ToddBaginski blog where he creates a .NET assembly connector and an External Content Type
In this blog we will demonstrate the following:
- Create a Database Table from a SQL AdventureWorks Database
- Use SharePoint Designer 2010 to create and configure an External Content Type on the newly created Table
- Create an External List in SharePoint Browser User Interface (UX)
- Test – Read, Update External List Item from UX
- Connect to Outlook from the Browser UX
- Test – Read, Update from Outlook UX
- Teaser – Create a Document Library and include Library Columns from the External List LOB Data
- Pre Teaser – Build out Todd Baginski’s Blog by associating a Flat File External Content Type and SQL LOB System
We begin the process by identifying a Test Site in our SharePoint environment to host our External List and creating a Table within the AdventureWorks Database to surface data from in our LOB System.
Above we are looking at our SharePoint Designer and our test site. Various information may be ascertained from this view above, please review.
In preparation, we will create a table called “FabianAWContacts” from a few tables in the AdventurWorks database as our Target LOB System Data
To verify our data, we do a select statement against our newly created database…
Above we have the initial steps of creating an External Content Type; in this phase we begin by providing a name, the Office Item Type (we will get to this later and is the crux of our work in this blog), and define the Connection to the External System. Below you will see how we make a connection and identify the LOB System Objects we will be surfacing data from. It is here also where we will be making our CRUD Methods and assigning permissions.
The screen shot above displays the database and the table we created earlier. By right-clicking on the data table we will be selecting the option “Create All Operations” which in essence defines what and how we will interact with the data in the LOB System. You can see from here also there remains the possibility to do other actions including associating to other LOB systems and establishing relationships with other disparate databases.
Once we choose the operation (Method) we will be taking on our External Content Type (CRUD) if we are undertaking Microsoft Office Outlook Off-lining then we need to make mappings between the LOB system and the Office Client, see below. You will also notice that the different data types are associated with different mappings.
Once we have completed the mappings, click “Finish” and the new methods will be created as seen below.
As seen above or below, once the process of provisioning is complete you see and Identifier is associated (Primary Key and value that is used to trigger custom actions in the Browser UX. The green arrow below indicates that the association we make by selecting “Contact” in the ‘Office Item Type’ has the requisite mappings to enable it in MS Outlook.
After saving off our External Content Type we will next go to the SharePoint Browser UX and create an External List and point it to the External Content Type recently created. See below
The steps taken in the above three screen shots demonstrates how to create a new External List and associate it to an External Content Type. I have decided to create an External List called Company Contacts [actually AW Company Contacts, I changed the name after my screen shot], and I have associated it to my Company Contact LOB List. Once the configuration and nomenclature is complete I click Create and the List is displayed below.
So lets begin the verification process. We will target Contact ID 1003 – Michael Sullivan
Let us first check in SQL what the dataset should look like since it is the Source of Record… see below
So in the External List we will edit the ID 1003 for Michael Sullivan. Now because in our Methods Operation we elected to do Method Updates, when we click on the custom actions we will see an Edit menu, by selecting it we will see the window below.
Let us go ahead and do the following to M Sullivan
- Knight him
- and make him the third in his generation
Below you see the complete changes we will attempt to commit to the LOB System.
After clicking “Save”, we can already see in the Browser UX that the changes have been adopted
Next we check the same SQL Statement and we can also see our changes persisted to the database. Also from this window we will make the connection now to Microsoft Outlook 2010 since we have already identified this External List as a Microsoft Office Contact Type. By clicking the “Connect to Outlook” in the ribbon above it begins the process as we will see in two screen shots below.
After we click “Connect to Outlook” we will see that the process “Preparing External List for Synchronization with Outlook” begins
Once the above process concludes we can look below and see that the AW Company Contact External List (middle of the screen Left Hand Side) and also demonstrated by the Business Cards that the LOB External List is now available in MS Outlook 2010.
Hope you enjoyed this blog, Have fun with your SharePoint 2010 and BCS! I love it, hope you do too….
So my good buddy Todd Baginski who I met for the first time at SharePoint Conference 2009 LOL 🙂 he created a great blog entry on HOW TO: Create a Searchable SharePoint 2010 BDC .NET Assembly Connector Which Reads From A Flat File which is very inspiring. I took his solution and used it as the foundation for what I will be doing in my Part 3/ Teaser to this Blog. In Todd’s example he took you up to the point of reading the External Content Type in an External List in SharePoint. this all being done in Visual Studio from scratch so YES finally WE WILL CODE!
I will take it a few steps further…
- Make the list CRUD enabled i.e. create methods for Create, Update and Delete, we already have Read
- Making an association to a Table in a SQL LOB system and the Flat File so we can demonstrate two disparate systems coming together in SharePoint where they were previously not related
I am well on my way, I have the solution already created in Visual Studio and i will go in detail into the code of the CRUD Methods, for the lead up please see Todd’s Blog, he does a much better job of explaining
Screen clipping taken: 11/25/2009 1:12 AM
Error/Resolution: SharePoint 2010 Office 2010 when using Connect to Outlook from External List in BCS
After creating an external list of contacts in SharePoint from a LOB System and clicking the Link to “Connect to Outlook” you get a dialog box indicating:
“The Microsoft Office 2010 feature Business Connectivity Services are not installed on this computer…” this is in-fact incorrect as it is installed and functioning. I have my Outlook fully configured and it has my Mysite already in SharePoint lists
Screen shot Below
Proof Positive that the Feature is Installed…
I sent an email to Rolando Jimenez from the Microsoft Product Team for BCS and for the first problem we found out that i experienced that error because my browser was in the “Internet Zone” once i moved it into the “Intranet Zone” my ‘initial’ problem subsided
Now I am getting a “Microsoft Office 2010 component has stopped Working” Error tied to the Common Language Runtime on the bcssync.exe… more help needed here
So, thank you Microsoft Product Team for BCS for helping me with this. I wanted to close out our email thread by summarizing how we got here
· All x64 [obvious but just
· Installed WIN 2008 Server
· Installed and Configured Active Directory and DNS, IIS, Server Roles
· Installed SQL Server 2008 SP1 CU2
· Installed SP 2010 Beta 2
· Installed Office 2010, SPD 2010 and Visio 2010 Beta
· Installed Visual Studio 2010 Beta 2
· Installed AdventureWorks Database for testing LOB systems
So after using SPD 2010 Beta to create an External List I was able to consume it in the browser but when I did connect to outlook I got the error outlined here in my blog
So the steps taken with Rolando’s and Alex’s help ( I will show what worked with excepts of what didn’t inline)
1. After Repair Outlook Failed to fix the issue and After Uninstall yielded the same results
2. I followed Alex’s recommendations below
a. Actually I think I know what’s going on. I suspect the issue is because you have dev10 installed on your machine which comes with a newer version of SQLCE. Unfortunatelly the version in dev10 comes with is x86 only. You need to install SQLCE SP2 x64 from downloads. Here is the link:
b. When I did I still had the same issue but I went one step further
3. I Uninstalled the following Programs and Rebooted
a. SQL Compact x86
b. SQL Compact x64
c. SQL Compact SP1 View and Tools (something like that)
4. I installed the x64 from Alex’s link HOWEVER it told me to installed the x86 first, so I did, and I am up and running with BCS “Connect to Outlook”
Thanks again Rolando, thanks Alex
Here is the link to Microsoft Office 2010 and Microsoft Office 2010 Professional Plus
You may experience issues opening documents direclty from libraries using Office 2010, here is a work around to the error below:
set up a fake proxy (127.0.0.1) in Internet Explorer with an exception for *.*. Still don’t know why this works, but it has allowed me to actually check out, edit, and upload/check-in documents from our libraries.