NOT: Sharepoint online tarafında sharepoint üzerinden mail atma işlemlerinde dışarı kullanıcılarına hiç bir şekilde mail gönderimi yapılamamaktadır. Sharepoint içinde tanımlı olan kullanıcılara sadece mail gönderimi yapılabilmektedir.

İlk olarak console uygulamamızı açıyoruz ve aşağıdaki referansları projemize ekliyoruz.

• Microsoft.SharePoint.Client – Version: 16.0.0.0
• Microsoft.SharePoint.Client.Runtime – Version: 16.0.0.0
• System.configuration – Version: 4.0.0.0

Yukarıdaki referansları ekledikten sonra ilk önce app config tarafında sharepoint tarafında sitemize bağlanacağımız bilgilerimizi statik alabilmek için site adresi kullanıcı mail adresi ve şifresini appSettings olarak ekliyoruz.

<appSettings>
   <add key="siteUrl" value="" />
   <add key="userEmail" value="" />
   <add key="userPassword" value=""/>
</appSettings>

Daha sonra Program.cs de Main içine geliyoruz ve sitemize bağlantı yapacağımız kodu ekliyoruz. Bu konuyu anlattığım makeleye ulaşmak için tıklayınız.

ClientContext clientContext = new ClientContext(ConfigurationManager.AppSettings["siteUrl"].ToString());

clientContext.AuthenticationMode = ClientAuthenticationMode.Default;

string password = ConfigurationManager.AppSettings["userPassword"].ToString();
System.Security.SecureString passwordChar = new System.Security.SecureString();
foreach (char ch in password)
    passwordChar.AppendChar(ch);

clientContext.Credentials = new SharePointOnlineCredentials(ConfigurationManager.AppSettings["userEmail"].ToString(), passwordChar);

Daha sonra EmailProperties kullanarak göndereceğimiz mailin detaylarını ekliyoruz.

var emailp = new EmailProperties();
emailp.To = new List<string> { "yunusemrearac@yunusemrearac.onmicrosoft.com" };
emailp.Body = "Yunus Emre Araç test email";
emailp.Subject = "Yunus Emre Araç sitesi için deneme mail gönderimidir.";

Burada to kısmında liste şeklinde yapma sebebim virgül ekleyerek birden fazla kullanıcı tanımlanabilir bir yapı olması içindir. Tüm parametre değerlerini sizin mail detaylarınız ile güncelleyebilirsiniz.

En son aşamada ise Utility SendEmail kullanarak clientcontext ve email bilgilerimizi yolluyoruz ve ExecuteQuery diyoruz.

Utility.SendEmail(clientContext, emailp);
clientContext.ExecuteQuery();

Bu işlemlerden sonra uygulama tamamlanmış olacaktır ve mail gönderme işlemini yapabileceksiniz.

Kodun tamamı aşağıdaki gibidir.

ClientContext clientContext = new ClientContext(ConfigurationManager.AppSettings["siteUrl"].ToString());

clientContext.AuthenticationMode = ClientAuthenticationMode.Default;

string password = ConfigurationManager.AppSettings["userPassword"].ToString();
System.Security.SecureString passwordChar = new System.Security.SecureString();
foreach (char ch in password)
    passwordChar.AppendChar(ch);

clientContext.Credentials = new SharePointOnlineCredentials(ConfigurationManager.AppSettings["userEmail"].ToString(), passwordChar);

var emailp = new EmailProperties();
emailp.To = new List<string> { "yunusemrearac@yunusemrearac.onmicrosoft.com" };
emailp.Body = "Yunus Emre Araç test email";
emailp.Subject = "Yunus Emre Araç sitesi için deneme mail gönderimidir.";

Utility.SendEmail(clientContext, emailp);
clientContext.ExecuteQuery();

Projenin çalışır halinin tamamını aşağıdan github adresimden indirip app config ve mail bilgilerini güncelleyerek kullanabilirsiniz.

The post SharePoint Online’da Konsol Uygulamasında ClientContext Kullanarak Mail Gönderme İşlemi appeared first on Yunus Emre Araç.

Tabi ki çoğu şeyde olduğu gibi bu taraftada sharepoint server side tarafa göre değişikşikler yer almaktadır.

Visual studio üzerinde projemizi oluşturuyoruz. İlk olarak oluşturmuş olduğumuz projeye aşağıdaki referansları eklememiz gerekiyor.

• Microsoft.SharePoint.Client ( Version : 16.0.0.0 )
• Microsoft.SharePoint.Client.Runtime ( Version : 16.0.0.0 )
• Microsoft.SharePoint.Client.UserProfiles ( Version: 16.0.0.0 )
• System.Configuration ( Version : 4.0.0.0 ) — Bu referans ise App.config dosyasından AppSettings ile online  erişim bilgilerimizi dinamik olarak alabilmemiz için.

Bu referansları projemize dahil ettikten sonra her zamanki gibi sharepoint online tarafında login olamız için static şekilde verilere erişebilmemiz daha rahat olacağı için App.config tarafında erişim bilgilerimizi alacağız.

NOT: Yalnız burada bir farkımız olacak bu da sharepoint online tarafta biz user profile kısmından kullanıcılar erişmemiz gerekeceği için bizim sharepoint online sitemize değil sharepoint online administrator tarafına bağlanmamız gerekecektir ve bağlanılacak kullanıcı bilgisinin tanent admin gibi burada değişiklik yapabilme yetkilerine sahip olması gerekiyor. Site adresi olarak ise “https://yunusemrearac-admin.sharepoint.com/” şeklinde admin adresi olacaktır.

<appSettings>
    <add key="TenantAdministrationUrl" value=""/>
    <add key="TenantAdminLoginName" value=""/>
    <add key="TenantAdminPassword" value=""/>
  </appSettings>

App config tarafında yukarıdaki gibi tanımlamalarımızı dediğim şartlara uygun şekilde yaparak değerlerimizi giriyoruz ve bunları kod tarafında okumamız gerekecektir.

string tenantAdministrationUrl = ConfigurationManager.AppSettings["TenantAdministrationUrl"].ToString();
string tenantAdminLoginName = ConfigurationManager.AppSettings["TenantAdminLoginName"].ToString();
string tenantAdminPassword = ConfigurationManager.AppSettings["TenantAdminPassword"].ToString();

Kod tarafında yukarıdaki gibi bu app config tarafına tanımladığımız değerleri alarak değişkenlerimize atama yapıyoruz. Daha sonra bu bilgiler ile sisteme giriş yapıyoruz.

using (ClientContext clientContext = new ClientContext(tenantAdministrationUrl))
{
    SecureString passWord = new SecureString();

    foreach (char c in tenantAdminPassword.ToCharArray()) passWord.AppendChar(c);

    clientContext.Credentials = new SharePointOnlineCredentials(tenantAdminLoginName, passWord);
}

Daha sonra bu aldığımız bilgiler ile ClientContext kullanarak sisteme giriş yapıyoruz. Bu konu ile ilgili detaylı yazımı okumak için tıklayınız.

Bu kısımda değişiklik yapacağımız kullanıcının User Account Name bilgisi gerekmektedir. Bu kısımda aslında kullanıcının mail adresinin başına “i:0#.f|membership|” tanımlamasının eklenmesi yapılarak oluşturulmuş bir değerdir. Bundan dolayı da değişiklik yapmak istenilen kullanıcının sadece mail adresi üzerinden gidilebilir.

string UserAccountName = "i:0#.f|membership|" + email;

Kod kısmında kullanıcının mail adresini account name olarak çevirebileceğim bir tanımlamayı da yukarıdaki gibi ekliyorum.

Daha sonra da PeopleManager  üzerinde yer alan SetSingleValueProfileProperty metodunu kullanarak kullanıcı account name, property adı ve değerini yollayarak gerekli güncellememizi yapıyoruz.

PeopleManager peopleManager = new PeopleManager(clientContext);

peopleManager.SetSingleValueProfileProperty(UserAccountName, property, value);

clientContext.ExecuteQuery();

Bu kısımda daha kolay bir şekilde ilerleyebilmek için tüm bu işlemleri ben bir method haline getirdim ve hepsini bir araya topladığımda aşağıdaki gibi bir method oluşmaktadır.

public static bool UpdateSharepointOnlineUserProfileProperty(string email, string property, string value)
{
    bool updateResult = false;
    try
    {
        string tenantAdministrationUrl = ConfigurationManager.AppSettings["TenantAdministrationUrl"].ToString();
        string tenantAdminLoginName = ConfigurationManager.AppSettings["TenantAdminLoginName"].ToString();
        string tenantAdminPassword = ConfigurationManager.AppSettings["TenantAdminPassword"].ToString();

        string UserAccountName = "i:0#.f|membership|" + email;

        using (ClientContext clientContext = new ClientContext(tenantAdministrationUrl))
        {
            SecureString passWord = new SecureString();

            foreach (char c in tenantAdminPassword.ToCharArray()) passWord.AppendChar(c);

            clientContext.Credentials = new SharePointOnlineCredentials(tenantAdminLoginName, passWord);

            PeopleManager peopleManager = new PeopleManager(clientContext);

            peopleManager.SetSingleValueProfileProperty(UserAccountName, property, value);

            clientContext.ExecuteQuery();

            updateResult = true;
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine("Sharepoint User Property güncellenirken hata oluştu. User Email : " + email + " Error : ");
        Console.WriteLine(ex.Message);
        Console.WriteLine(ex.StackTrace);
    }

    return updateResult;
}

Bunun yanı sıra kodun çalışan hali için aşağıdaki güthub adresinden indirebilirsiniz.

The post SharePoint Online’da Konsol Uygulaması Kullanarak Kullanıcı Profillerini ( User Profile ) Güncelleme appeared first on Yunus Emre Araç.

İlk olarak Visual Studio muzda “New Project…” diyerek gelen ekranda “Console Application” seçerek proje adımızı girip “OK” butonu ile projemizi oluşturuyoruz.

Açılan projemizde ilk olarak SharePoint kullanabilmek için projemiz içinde yer alan “References” a sağ tıklıyoruz ve “Add Reference…” a tıklıyoruz.

Bu kısımda bizim Sharepoint tarafına bağlanmamızı sağlayan “Microsoft.SharePoint.Client” ve “Microsoft.SharePoint.Client.Runtime” referanslarının “16.0.0.0” versiyonlarını projemize ekliyoruz.

Burada ben site adresi ve bilgilerini de app config tarafından okuyabilmek için “System.configuration” referansını da ekliyorum projeme ve referans ekleme işlemi tamamlanmış oluyor.

Son durumda projemde aşağıdaki referanslar yer alması gerekmektedir.

Projemize aşağıdaki kod ile clientcontext kullanıp login oluyoruz ve sitemizde istediğimiz gibi işlemler yapabiliriz.

try
{
ClientContext clientContext = new ClientContext(ConfigurationManager.AppSettings["siteUrl"].ToString());

clientContext.AuthenticationMode = ClientAuthenticationMode.Default;

string password = ConfigurationManager.AppSettings["userPassword"].ToString();
System.Security.SecureString passwordChar = new System.Security.SecureString();
foreach (char ch in password)
passwordChar.AppendChar(ch);

clientContext.Credentials = new SharePointOnlineCredentials(ConfigurationManager.AppSettings["userEmail"].ToString(), passwordChar);

Web web = clientContext.Web;
clientContext.Load(web);
clientContext.ExecuteQuery();

Console.WriteLine("Connect to " + web.Url);
Console.ReadLine();
}
catch (Exception ex)
{
Console.WriteLine("Connect error to site. Error : " + ex.Message);
Console.ReadLine();
}

Kodun çalışır haldeki projesini de Github adresinden indirebilirsiniz.

The post SharePoint Online Siteye Console Uygulaması Kullanarak Bağlanmak appeared first on Yunus Emre Araç.