How to: Create an Entity Using the Administration Object Model

Entities are the business objects, such as customer and sales order, in a business application. This topic shows how to use the Administration object model to create an entity. The example also creates an identifier for the new entity.

This topic shows how to create an entity using the object model. Replace EnterYourSSPNameHere in the code with your Shared Services Provider (SSP) name. Also, create an LobSystem instance and set connection parameters as shown in How to: Create an LobSystem Using the Administration Object Model.

Example

This example creates an entity called ProductModel from the AdventureWorks2000 database.

Prerequisites

Project References

Add the following Project References in your console application code project before running this sample:

  • Microsoft.SharePoint

  • Microsoft.SharePoint.Portal

  • Microsoft.Office.Server

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.Office.Server.ApplicationRegistry.Administration;
using Microsoft.Office.Server.ApplicationRegistry.Infrastructure;
using WSSAdmin = Microsoft.SharePoint.Administration;
using OSSAdmin = Microsoft.Office.Server.Administration;

namespace Microsoft.SDK.SharePointServer.Samples
{
    class GetStartedAndCreateSystem
    {
        const string yourSSPName ="EnterYourSSPNameHere";

        static void Main(string[] args)
        {
            SetupBDC();
            CreateEntity();
            Console.WriteLine("Press any key to exit...");
            Console.Read();
        }
        static void SetupBDC()
        {
            SqlSessionProvider.Instance().SetSharedResourceProviderToUse(yourSSPName);
        }
        static void CreateEntity()
        {
            LobSystemInstance mySysInstance = null;
            LobSystemInstanceCollection sysInsCollection = ApplicationRegistry.Instance.GetLobSystemInstancesLikeName("AdventureWorksSampleFromCode");
            foreach (LobSystemInstance sysInstance in sysInsCollection)
            {
                if (sysInstance.Name == "AdventureWorksSampleFromCode")
                {
                    mySysInstance = sysInstance;
                    break;
                }
            }
            IList<Entity> entityCollection = new List<Entity>(mySysInstance.LobSystem.Entities);
            Entity newEntity = mySysInstance.LobSystem.Entities.Create("ProductModel", true);
            EntityCollection entityColl = mySysInstance.LobSystem.Entities;
            foreach (Entity entity in entityColl)
            {
                if (entity.Name == "ProductModel")
                {
                    entity.Identifiers.Create("ProductModelID", true, "System.Int32");
                    break;
                }
            }
            Console.WriteLine("Created the entity successfully.");
        }
    }
}

See Also

Concepts

Business Data Catalog: Metadata Model