@@ -3,350 +3,241 @@ Yammer uses <a href="http://oauth.net/" target="_blank">OAuth</a> to authenticate clients. This allows applications to securely access data on a user's behalf without storing or needing the user's password. Before you can use Yammer.Net, you must first obtain a client key and secret from Yammer. To do this, log into Yammer and navigate to <a href="https://www.yammer.com/client_applications/new" target="_blank">https://www.yammer.com/client_applications/new</a>. This form will allow you to register your application. Once you complete and submit the form you will be provided with your client key and secret. Make a note of these; you'll need them to make use of the library. -Now that you have your client key and secret you are ready to being using the framework. Create a new project and add references to the OAuth and Yammer assemblies. Yammer.Net uses a settings file to persist authorization information between your application sessions. This file is stored in the user's Application Data folder under Yammer\Data. The first thing you should do when your application loads is check if this file exists: +Now that you have your client key and secret you are ready to being using the framework. Create a new project and add references to the OAuth and Yammer assemblies. The oAuth dance has been simplified from previous versions. To get started using the wrapper, now you just need to handle a few events and call Session.Start(): -<pre><code>using System; -using System.Collections.Generic; -using System.Linq; -using System.Text; -namespace YammerNetExample +<pre><code>static void Menu_Connect(object sender, EventArgs e) { - class Program - { - const string CONSUMER_KEY = "myConsumerKey"; - const string CONSUMER_SECRET = "myConsumerSecret"; - static void Main(string[] args) - { - Yammer.Settings settings = Yammer.Settings.CheckConfiguration(); - if (settings == null) - { - //Need to configure client - } - else - { - //Client already configured, use persisted settings - } - } - } -} -</code></pre> - -Configuring your client for first time use is a three step process. First, you must obtain a request token from Yammer using your client key and secret. The Yammer.Auth.GetRequestToken member accepts three arguments: proxy, consumerKey and consumerSecret . If your client won't be behind a proxy, you can pass in a null for this argument. After obtaining the request token you can allow the user to authorize your application. If you would like the user to be redirected to your website after authorizing with Yammer, you can provide a value for the callbackUrl argument of the Yammer.Auth.Authorize member. - -<pre><code>private static Yammer.Auth GetRequestToken() -{ - Yammer.Auth auth = Yammer.Auth.GetRequestToken(null, CONSUMER_KEY, CONSUMER_SECRET); - if (auth != null) - { - auth.Authorize(null); - Console.WriteLine("We've opened up a browser so you can authenticate this application with Yammer."); - Console.WriteLine("Once you've authenticated, press any key to continue."); - Console.ReadLine(); - } - return auth; -} -</code></pre> - -The framework will open a browser and allow the user to authorize your application. Once the user authorizes through the Yammer website, your application can request its permanent access key and secret: - -<pre><code>private static void GetAccessToken(Yammer.Auth auth) -{ - if (auth != null) - auth.GetAccessToken(); - - if (auth.Success) - { - Console.WriteLine("Welcome to my Yammer application!"); - Console.ReadLine(); - } + Console.WriteLine("You will need to authorize this appliction to continue.\r\nWe'll open a browser window where you can login to\r\nYammer to complete the authorization.\r\nPress any key to continue"); + Console.Read(); + Yammer.Session.ReceiveRequestToken += new EventHandler(Session_ReceiveRequestToken); + Yammer.Session.AuthorizationComplete += new EventHandler(Session_AuthorizationComplete); + Yammer.Session.Start(); + Console.ReadLine(); } </code></pre> -After performing these three steps (GetRequestToken(), Authorize(), and GetAccessToken()), your application will be configured to communicate with Yammer. The next step is to start making calls to the Yammer API. To continue with my console example, I've added some code to handle a few menu options: +Now you'll need to set up the even handlers: -<pre><code>public static void ReadMessages(List<Yammer.Message> messages) +<pre><code>static void Session_AuthorizationComplete(object sender, EventArgs e) { - Console.WriteLine(); - foreach (Yammer.Message msg in messages) - { - string body = msg.Body.Plain; - string timeStamp = msg.CreatedAt; - - Yammer.User sender = null; - Yammer.Guide guide = null; - Yammer.Message repliedToMessage = null; - Yammer.User repliedToUser = null; - - //if message sent from user, store user information - if (msg.SenderType.ToUpper() == Yammer.SenderType.USER.ToString()) - sender = msg.References.Users.Find(delegate(Yammer.User u) { return u.Id == msg.SenderId.ToString(); }); - - //if message sent from guide, store guid information - if (msg.SenderType.ToUpper() == Yammer.SenderType.SYSTEM.ToString()) - guide = msg.References.Guide; - - //if message is a reply, store replied-to-message - if (msg.RepliedToId != null && msg.RepliedToId != string.Empty) - repliedToMessage = msg.References.Messages.Find(delegate(Yammer.Message m) { return m.Id == msg.RepliedToId; }); - - //if reply-to-message exists, store replied-to-user - if(repliedToMessage != null) - repliedToUser = msg.References.Users.Find(delegate(Yammer.User u) { return int.Parse(u.Id) == repliedToMessage.SenderId; }); - - StringBuilder sb = new StringBuilder(); - //Write sender name - if(sender != null) - sb.Append(sender.FullName); - //Write guid name - if (guide != null) - sb.Append(guide.FullName); - //Write replied-to-user name - if (repliedToUser != null) - sb.Append(" in-reply-to: " + repliedToUser.FullName); - sb.AppendLine(); - - //Write message body - sb.AppendLine(body); - - //Write attachments - if (msg.Attachments.Count > 0) - foreach (Yammer.Attachment attachment in msg.Attachments) - sb.AppendLine(attachment.Name); - - //Write timestamp - sb.AppendLine(timeStamp); - - Console.WriteLine(sb.ToString()); - } + if (Yammer.Session.Auth.Success) + { + Console.WriteLine("Connected, Please enter a command:"); + Menu.Display(false); + } } - -public static void PostMessage(string input, Yammer.Session session) +static void Session_ReceiveRequestToken(object sender, EventArgs e) { - //parse message - string pattern = "-m\\s\"+.+?\""; - System.Text.RegularExpressions.Regex regex = new System.Text.RegularExpressions.Regex(pattern, System.Text.RegularExpressions.RegexOptions.Singleline); - System.Text.RegularExpressions.Match message = regex.Match(input); - string body = string.Empty; - if (message != null) - body = message.Value.Replace("-m", "").Trim().Replace("\"",""); - - //parse attachments - pattern = "-a\\s\"+.+?\""; - regex = new System.Text.RegularExpressions.Regex(pattern, System.Text.RegularExpressions.RegexOptions.Singleline); - List<string> attachmentList = new List<string>(); - if (regex.IsMatch(input)) - { - message = regex.Match(input); - attachmentList.AddRange(message.Value.Replace("-a", "").Trim().Replace("\"", "").Split(';')); - } - - //post message - Yammer.ApiWrapper.PostMessage(body, session, attachmentList); + string message = "Once you've logged in and authorized this application via your browser, please \r\nenter the provided code and press enter to start using Yammer."; + Console.WriteLine(message); + string code = Console.ReadLine(); + if (Yammer.Session.Auth != null) + Yammer.Session.Auth.GetAccessToken(code); } </code></pre> -The Yammer.ApiWrapper.PostMessage member accepts a list of attachments. This list should be a string of paths to attach with the message. - -The following is the complete source for the example console app used to illustrate these steps: +That's about it for authorization, now you can start making calls to the Yammer API. The following sample source illustrates various calls to the API. The complete code is available in the project source: <pre><code>using System; using System.Collections.Generic; using System.Linq; using System.Text; -using System.Net; +using System.Reflection; -namespace YammerNetExample +namespace TestConsole { - /// <summary> + /// <summary> /// Yammer.Net example - /// </summary> - /// <example> + /// </summary> + /// <example> /// yam myfeed + /// yam sent /// yam post -m "this is a sample post" /// yam post -m "this is a sample post with an attachment" -a "c:\myImage.gif" /// yam post -m "this is a sample post with multiple attachments" -a "c:\myImage.gif;c:\myText.txt" - /// </example> + /// yam viewuser -uid "kevin" + /// yam viewuser -all + /// yam currentuser + /// yam updateuser -uid "kevin" -params "MobilePhone=602-555-5555" + /// yam updateuser -uid "kevin" -params "MobilePhone=602-555-1111;Location=Phoenix" + /// yam deleteuser -uid "elisabeth-poo-waller" + /// </example> class Program { - const string CONSUMER_KEY = "myConsumerKey"; - const string CONSUMER_SECRET = "myConsumerSecret"; - const string RETRIEVE_MY_FEED = "yam myfeed"; - const string POST_MESSAGE = "yam post"; static void Main(string[] args) { - Yammer.Settings settings = Yammer.Settings.CheckConfiguration(); - if (settings == null) - { - Yammer.Auth auth = GetRequestToken(); - GetAccessToken(auth); - } - else - Menu(true, ConfigureClient(settings), null, null); + Menu.Connect += new EventHandler(Menu_Connect); + Menu.RetrieveFeed += new EventHandler(Menu_RetrieveFeed); + Menu.PostMessage += new InputEventHandler(Menu_PostMessage); + Menu.ViewUser += new InputEventHandler(Menu_ViewUser); + Menu.CurrentUser += new InputEventHandler(Menu_CurrentUser); + Menu.UpdateUser += new InputEventHandler(Menu_UpdateUser); + Menu.DeleteUser += new InputEventHandler(Menu_DeleteUser); + Menu.Display(true); } - private static OAuth.OAuthKey ConfigureClient(Yammer.Settings settings) + static void Menu_Connect(object sender, EventArgs e) { - OAuth.OAuthKey key = new OAuth.OAuthKey(CONSUMER_KEY, CONSUMER_SECRET, settings.OAuth.TokenKey, settings.OAuth.TokenSecret); - WebProxy proxy = null; - if (settings.Proxy.Enable) - { - proxy = new System.Net.WebProxy(); - proxy.Address = new Uri(settings.Proxy.Address + ":" + settings.Proxy.Port); - proxy.Credentials = new NetworkCredential(settings.Proxy.Id, settings.Proxy.Password); - } - return key; + Console.WriteLine("You will need to authorize this appliction to continue.\r\nWe'll open a browser window where you can login to\r\nYammer to complete the authorization.\r\nPress any key to continue"); + Console.Read(); + Yammer.Session.ReceiveRequestToken += new EventHandler(Session_ReceiveRequestToken); + Yammer.Session.AuthorizationComplete += new EventHandler(Session_AuthorizationComplete); + Yammer.Session.Start(); + Console.ReadLine(); } - public static Yammer.Auth GetRequestToken() - { - Yammer.Auth auth = Yammer.Auth.GetRequestToken(null, CONSUMER_KEY, CONSUMER_SECRET); - if (auth != null) + static void Menu_RetrieveFeed(object sender, EventArgs e) { - auth.Authorize(null); - Console.WriteLine("We've opened up a browser so you can authenticate this application with Yammer."); - Console.WriteLine("Once you've authenticated, press any key to continue."); + foreach (Yammer.Message msg in Menu.Messages) + { + object[] args = null; + + if (msg.Sender != null) + args = new object[] { msg.Sender.Name, msg.Body.Plain, msg.CreatedAt }; + else + { + if (msg.Guide != null) + args = new object[] { msg.Guide.Name, msg.Body.Plain, msg.CreatedAt }; + } + + Console.WriteLine(string.Format("{0}\r\n{1}\r\n{2}\r\n", args)); + } Console.ReadLine(); } - return auth; - } - public static void GetAccessToken(Yammer.Auth auth) + static void Menu_PostMessage(InputEventArgs e) { - if (auth != null) - auth.GetAccessToken(); + MatchPattern[] patterns = new MatchPattern[] { new MatchPattern("-m", true), new MatchPattern("-a", true) }; + + Dictionary<string, string> parameters = Menu.ParseInput(e.Input, patterns); + + string body = string.Empty; + if (parameters.ContainsKey("-m")) + body = parameters["-m"]; - if (auth.Success) - Menu(true, auth.Key, null, null); + List<string> attachmentList = new List<string>(); + if (parameters.ContainsKey("-a")) + attachmentList.AddRange(parameters["-a"].Split(';')); + //post message + Yammer.Message.PostMessage(body, attachmentList); } - public static void Menu(bool welcome, OAuth.OAuthKey key, WebProxy proxy, Yammer.Session session) + static void Menu_ViewUser(InputEventArgs e) { - if(session == null) - session = new Yammer.Session(key, proxy); - - if (welcome) + MatchPattern[] patterns = new MatchPattern[] { new MatchPattern("-uid", true), new MatchPattern("-all", false) }; + Dictionary<string, string> parameters = Menu.ParseInput(e.Input, patterns); + string uid = string.Empty; + if (parameters.ContainsKey("-uid")) { - Console.WriteLine("Welcome to my Yammer application!"); - welcome = false; + uid = parameters["-uid"]; + Yammer.User user = Yammer.User.GetUserByUserName(uid); + if (user != null) + { + object[] args = new object[] { user.Name, user.JobTitle, user.MugshotUrl, user.WebUrl, user.Contact.PhoneNumbers[0].Number, user.Location }; + Console.WriteLine(string.Format("UserName:{0}\r\nTitle:{1}\r\nAvatar:{2}\r\nUrl:{3}\r\nMobilePhone:{4}\r\nLocation:{5}", args)); + } + else + Console.WriteLine("User not found"); } - - string input = Console.ReadLine(); - string option = ParseInput(input); - - switch (option) + else if (parameters.ContainsKey("-all")) { - case RETRIEVE_MY_FEED: - ReadMessages(Yammer.ApiWrapper.GetFollowingMessages(session)); - break; - case POST_MESSAGE: - PostMessage(input, session); - break; + List<Yammer.User> users = Yammer.User.GetAllUsers(); + foreach (Yammer.User u in users) + { + object[] args = new object[] { u.Name, u.JobTitle, u.MugshotUrl, u.WebUrl, u.Contact.PhoneNumbers.Count > 0 ? u.Contact.PhoneNumbers[0].Number : string.Empty, u.Location }; + Console.WriteLine(string.Format("UserName:{0}\r\nTitle:{1}\r\nAvatar:{2}\r\nUrl:{3}\r\nMobilePhone:{4}\r\n\r\nLocation:{5}", args)); + } } - Menu(welcome, key, proxy, session); + } + static void Menu_CurrentUser(InputEventArgs e) + { + string input = e.Input; + Yammer.User user = Yammer.User.GetCurrentUser(); + object[] args = new object[] { user.Name, user.JobTitle, user.MugshotUrl, user.WebUrl, user.Contact.PhoneNumbers[0].Number, user.Location }; + Console.WriteLine(string.Format("UserName:{0}\r\nTitle:{1}\r\nAvatar:{2}\r\nUrl:{3}\r\nMobilePhone:{4}\r\nLocation:{5}", args)); } - public static string ParseInput(string input) + static void Menu_UpdateUser(InputEventArgs e) { - if (input.ToLower().Contains(RETRIEVE_MY_FEED)) - return RETRIEVE_MY_FEED; + MatchPattern[] patterns = new MatchPattern[] { new MatchPattern("-uid", true), new MatchPattern("-params", true) }; + Dictionary<string, string> parameters = Menu.ParseInput(e.Input, patterns); - if (input.ToLower().Contains(POST_MESSAGE)) - return POST_MESSAGE; + string uid = string.Empty; + if (parameters.ContainsKey("-uid")) + uid = parameters["-uid"]; - return null; - } + Yammer.User user = null; + if (uid != null && uid != string.Empty) + user = Yammer.User.GetUserByUserName(uid); - public static void ReadMessages(List<Yammer.Message> messages) - { - Console.WriteLine(); - foreach (Yammer.Message msg in messages) + string attributes = string.Empty; + Yammer.UserParameters userParams = null; + List<PropertyInfo> properties = null; + string[] props = null; + + if (parameters.ContainsKey("-params")) { - string body = msg.Body.Plain; - string timeStamp = msg.CreatedAt; - - Yammer.User sender = null; - Yammer.Guide guide = null; - Yammer.Message repliedToMessage = null; - Yammer.User repliedToUser = null; - - //if message sent from user store user information - if (msg.SenderType.ToUpper() == Yammer.SenderType.USER.ToString()) - sender = msg.References.Users.Find(delegate(Yammer.User u) { return u.Id == msg.SenderId.ToString(); }); - - //if message sent from guide store guid information - if (msg.SenderType.ToUpper() == Yammer.SenderType.SYSTEM.ToString()) - guide = msg.References.Guide; - - //if message is a reply, store replied-to-message - if (msg.RepliedToId != null && msg.RepliedToId != string.Empty) - repliedToMessage = msg.References.Messages.Find(delegate(Yammer.Message m) { return m.Id == msg.RepliedToId; }); - - //if reply-to-message exists, store replied-to-user - if(repliedToMessage != null) - repliedToUser = msg.References.Users.Find(delegate(Yammer.User u) { return int.Parse(u.Id) == repliedToMessage.SenderId; }); - - StringBuilder sb = new StringBuilder(); - //Write sender name - if(sender != null) - sb.Append(sender.FullName); - //Write guid name - if (guide != null) - sb.Append(guide.FullName); - //Write replied-to-user name - if (repliedToUser != null) - sb.Append(" in-reply-to: " + repliedToUser.FullName); - sb.AppendLine(); - - //Write message body - sb.AppendLine(body); - - //Write attachments - if (msg.Attachments.Count > 0) - foreach (Yammer.Attachment attachment in msg.Attachments) - sb.AppendLine(attachment.Name); - - //Write timestamp - sb.AppendLine(timeStamp); - - Console.WriteLine(sb.ToString()); + attributes = parameters["-params"]; + props = attributes.Split(';'); + userParams = new Yammer.UserParameters(); + properties = new List<PropertyInfo>(userParams.GetType().GetProperties()); + } + + foreach (string prop in props) + { + string[] hash = prop.Split('='); + + PropertyInfo property = properties.Find(delegate(PropertyInfo p) { return p.Name == hash[0]; }); + if (property != null) + property.SetValue(userParams, hash[1], null); } + + if(user != null) + user.Save(userParams); + } + static void Menu_DeleteUser(InputEventArgs e) + { + MatchPattern[] patterns = new MatchPattern[] { new MatchPattern("-uid", true) }; + Dictionary<string, string> parameters = Menu.ParseInput(e.Input, patterns); + string uid = string.Empty; + if (parameters.ContainsKey("-uid")) + uid = parameters["-uid"]; + + if(uid != null && uid != string.Empty) + Yammer.User.GetUserByUserName(uid).Delete(); + } - public static void PostMessage(string input, Yammer.Session session) + static void Session_AuthorizationComplete(object sender, EventArgs e) { - //parse message - string pattern = "-m\\s\"+.+?\""; - System.Text.RegularExpressions.Regex regex = new System.Text.RegularExpressions.Regex(pattern, System.Text.RegularExpressions.RegexOptions.Singleline); - System.Text.RegularExpressions.Match message = regex.Match(input); - string body = string.Empty; - if (message != null) - body = message.Value.Replace("-m", "").Trim().Replace("\"",""); - - //parse attachments - pattern = "-a\\s\"+.+?\""; - regex = new System.Text.RegularExpressions.Regex(pattern, System.Text.RegularExpressions.RegexOptions.Singleline); - List<string> attachmentList = new List<string>(); - if (regex.IsMatch(input)) + if (Yammer.Session.Auth.Success) { - message = regex.Match(input); - attachmentList.AddRange(message.Value.Replace("-a", "").Trim().Replace("\"", "").Split(';')); + Console.WriteLine("Connected, Please enter a command:"); + Menu.Display(false); } + } - //post message - Yammer.ApiWrapper.PostMessage(body, session, attachmentList); + static void Session_ReceiveRequestToken(object sender, EventArgs e) + { + string message = "Once you've logged in and authorized this application via your browser, please \r\nenter the provided code and press enter to start using Yammer."; + Console.WriteLine(message); + string code = Console.ReadLine(); + if (Yammer.Session.Auth != null) + Yammer.Session.Auth.GetAccessToken(code); } + + } } + </code></pre> -<h2>Documentation</h2> -<a href="http://kdavie.github.com/yammer.net/documentation/Index.html" target="_blank">HTML Documentation</a> <h2>License</h2> @@ -358,4 +249,4 @@ Permission is hereby granted, free of charge, to any person obtaining a copy of THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - \ No newline at end of file + README.md @@ -107,7 +107,7 @@ namespace Yammer /// <returns></returns> public static List<Message> GetFollowingMessages(PageFlag flag, int id, Session session) { - if(flag == PageFlag.NEWER_THAN) + if (flag == PageFlag.NEWER_THAN) return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_FOLLOWING + "?newer_than=" + id.ToString(), session)); else return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_FOLLOWING + "?older_than=" + id.ToString(), session)); @@ -121,7 +121,7 @@ namespace Yammer /// <returns></returns> public static List<Message> GetMessagesSentBy(int id, Session session) { - return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_SENT_BY + id.ToString() + ".xml" , session)); + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_SENT_BY + id.ToString() + ".xml", session)); } /// <summary> @@ -132,7 +132,7 @@ namespace Yammer /// <returns></returns> public static List<Message> GetMessagesTaggedWith(int id, Session session) { - return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_TAGGED_WITH + id.ToString() + ".xml", session)); + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_TAGGED_WITH + id.ToString() + ".xml", session)); } /// <summary> @@ -143,7 +143,7 @@ namespace Yammer /// <returns></returns> public static List<Message> GetMessagesInThread(int id, Session session) { - return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_IN_THREAD + id.ToString() + ".xml", session)); + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_IN_THREAD + id.ToString() + ".xml", session)); } /// <summary> @@ -154,7 +154,7 @@ namespace Yammer /// <returns></returns> public static List<Message> GetMessagesInGroup(int id, Session session) { - return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_IN_GROUP + id.ToString() + ".xml", session)); + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_IN_GROUP + id.ToString() + ".xml", session)); } /// <summary> @@ -178,11 +178,11 @@ namespace Yammer NameValueCollection parameters = new NameValueCollection(); parameters.Add("body", body); string response; - if(attachments.Count > 0) + if (attachments.Count > 0) Yammer.HttpUtility.Upload(Resources.YAMMER_MESSAGES_CREATE, parameters, session, attachments); else response = Yammer.HttpUtility.Post(Resources.YAMMER_MESSAGES_CREATE, parameters, session); - + } /// <summary> @@ -214,7 +214,7 @@ namespace Yammer } - + #endregion @@ -276,7 +276,7 @@ namespace Yammer public static void LeaveGroup(int id, Session session) { GroupMembership(id, session); - + } private static void GroupMembership(int id, Session session) @@ -461,7 +461,7 @@ namespace Yammer { if (message != null) message.References.Messages.Add(reference); - + } private static void SetMessageReference(Message message, Guide reference) @@ -586,4 +586,4 @@ namespace Yammer #endregion } -} +} \ No newline at end of file Yammer Framework/Yammer/ApiWrapper.cs @@ -8,6 +8,7 @@ using System.Net; using System.Diagnostics; using System.Xml.Serialization; using System.IO; +using System.Collections.Specialized; namespace Yammer { @@ -15,7 +16,7 @@ namespace Yammer { #region Ctor - private Auth() + public Auth() { } @@ -28,35 +29,60 @@ namespace Yammer /// The client Web Proxy. Can be null /// </summary> /// <remarks></remarks> + [XmlIgnore] public WebProxy Proxy { get; set; } /// <summary> /// The OAuth key to use /// </summary> + [XmlElement] public OAuthKey Key { get; set; } /// <summary> /// The client's consumer key /// </summary> + [XmlElement] private string ConsumerKey { get; set; } /// <summary> /// The client's consumer secret /// </summary> + [XmlElement] private string ConsumerSecret { get; set; } /// <summary> /// The persisted client settings file. /// </summary> + [XmlElement] public Settings Settings { get; set; } /// <summary> /// Connection success indicator /// </summary> - public bool Success { get; set; } + [XmlElement] + public bool Success + { + get + { + return success; + } + set + { + success = value; + OnAuthorizationComplete(); + } + } + + private bool success; #endregion + public event EventHandler AuthorizationComplete; + public void OnAuthorizationComplete() + { + if (this.AuthorizationComplete != null) + this.AuthorizationComplete(this, new EventArgs()); + } #region Helper Methods /// <summary> @@ -68,7 +94,7 @@ namespace Yammer private string GetRequestTokenQuery(string consumerKey, string consumerSecret) { //TODO: Utilize Yammer.HttpUtility for get - Uri uri = new Uri("https://www.yammer.com/oauth/request_token"); + Uri uri = new Uri(Resources.OAUTH_REQUEST_TOKEN); string nurl; string nrp; @@ -114,9 +140,9 @@ namespace Yammer /// Retrieves OAuth access token /// </summary> /// <returns>the OAuth access token query string</returns> - private string GetAccessTokenQuery() + private string GetAccessTokenQuery(string callbackToken) { - Uri uri = new Uri(Resources.OAUTH_ACCESS_TOKEN); + Uri uri = new Uri(Resources.OAUTH_ACCESS_TOKEN + "?callback_token=" + callbackToken); string nurl; string nrp; @@ -143,7 +169,7 @@ namespace Yammer sig = System.Web.HttpUtility.UrlEncode(sig); StringBuilder sb = new StringBuilder(uri.ToString()); - sb.AppendFormat("?oauth_consumer_key={0}&", Key.ConsumerKey); + sb.AppendFormat("&oauth_consumer_key={0}&", Key.ConsumerKey); sb.AppendFormat("oauth_token={0}&", Key.TokenKey); sb.AppendFormat("oauth_signature_method={0}&", "HMAC-SHA1"); sb.AppendFormat("oauth_timestamp={0}&", timeStamp); @@ -205,11 +231,12 @@ namespace Yammer /// Retrieves the authorization information from the server /// and saves it the persisted see cref="Settings">settings</see> file /// </summary> - public void GetAccessToken() + public void GetAccessToken(string callbackToken) { try { - HttpWebRequest request = Yammer.HttpUtility.CreateWebRequest(WebMethod.POST, this.Proxy, GetAccessTokenQuery(), true); + HttpWebRequest request = Yammer.HttpUtility.CreateWebRequest(WebMethod.POST, this.Proxy, GetAccessTokenQuery(callbackToken), true); + string response = Yammer.HttpUtility.GetWebResponse(request); string tokenKey; string tokenSecret; @@ -218,6 +245,12 @@ namespace Yammer Settings.SaveConfiguration(tokenKey, tokenSecret,this.Key, this.Proxy); this.Success = true; } + catch (WebException ex) + { + this.Success = false; + if (ex.Message.Trim() == "The remote server returned an error: (401) Unauthorized.") + System.Windows.Forms.MessageBox.Show("You must authorize this application before continuing."); + } catch (Exception ex) { this.Success = false; Yammer Framework/Yammer/Auth.cs @@ -196,7 +196,7 @@ <FileName>User.cs</FileName> </TypeIdentifier> </Class> - <Class Name="Yammer.UserStats" Collapsed="true"> + <Class Name="Yammer.Stats" Collapsed="true"> <Position X="7.5" Y="4.5" Width="1.5" /> <TypeIdentifier> <HashCode>AAAAAAAAAAAAAAAgCAAAAAAAAAAAAAAAAAAAAgAAAAA=</HashCode> Yammer Framework/Yammer/ClassDiagram1.cd @@ -11,6 +11,7 @@ namespace Yammer IMAGE, FILE } + public enum SenderType { USER, @@ -51,6 +52,24 @@ namespace Yammer { GET, POST, - DELETE + DELETE, + PUT + } + + public enum SortBy + { + NONE, + MESSAGES, + MEMBERS, + PRIVACY, + CREATED_AT, + CREATOR, + FOLLOWERS + } + + public enum SuggestionType + { + USER, + GROUP } } Yammer Framework/Yammer/Enumerations.cs @@ -4,6 +4,8 @@ using System.Linq; using System.Text; using System.Runtime.Serialization; using System.Xml.Serialization; +using System.Xml; +using System.Collections.Specialized; namespace Yammer { @@ -11,6 +13,9 @@ namespace Yammer [XmlRoot(ElementName = "group")] public class Group { + + #region Yammer Properties + /// <summary> /// The object type, such as user, tag, etc. /// </summary> @@ -70,6 +75,98 @@ namespace Yammer [XmlElement(ElementName = "stats")] public GroupStats Stats { get; set; } + #endregion + + + internal static List<Group> GetAllGroups(string data) + { + XmlDocument xdoc = new XmlDocument(); + xdoc.LoadXml(data); + + XmlNodeList nodes = xdoc.SelectNodes("/response/response"); + List<Group> groups = new List<Group>(); + foreach (XmlNode node in nodes) + { + Group group = (Group)Utility.Deserialize(typeof(Group), "<group>" + node.InnerXml + "</group>"); + groups.Add(group); + } + return groups; + } + + internal static Group GetGroup(string data) + { + XmlDocument xdoc = new XmlDocument(); + xdoc.LoadXml(data); + XmlNode node = xdoc.SelectSingleNode("/response"); + Group group = (Group)Utility.Deserialize(typeof(Group), "<group>" + node.InnerXml + "</group>"); + return group; + } + + /// <summary> + /// Retrieves a list of all groups + /// </summary> + /// <returns></returns> + public static List<Group> GetAllGroups() + { + string response = Yammer.HttpUtility.Get(Resources.YAMMER_GROUP_LIST); + return Group.GetAllGroups(response); + } + + public static List<Group> GetAllGroups(MembershipParameters groupParams) + { + NameValueCollection parameters = new NameValueCollection(); + Yammer.Utility.AddMembershipParams(parameters, groupParams); + string response = Yammer.HttpUtility.Get(Resources.YAMMER_GROUP_LIST,parameters); + return Group.GetAllGroups(response); + } + + + /// <summary> + /// Retrieves data about group of given id + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static Group GetGroupById(int id) + { + string response = Yammer.HttpUtility.Get(Resources.YAMMER_GROUP_DATA + id.ToString() + ".xml"); + return Group.GetGroup(response); + } + + //page, sort_by, letter, reverse + + + /// <summary> + /// Join a group. + /// </summary> + /// <param name="id"></param> + /// <param name="session"></param> + public static void JoinGroup(int id) + { + GroupMembership(id); + } + + /// <summary> + /// Leave a group. + /// </summary> + /// <param name="id"></param> + /// <param name="session"></param> + public static void LeaveGroup(int id) + { + GroupMembership(id); + + } + + private static void GroupMembership(int id) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("group_id", id.ToString()); + Yammer.HttpUtility.Post(Resources.YAMMER_GROUP_JOIN + id.ToString() + ".xml", parameters); + } + + + + + } public class GroupStats Yammer Framework/Yammer/Group.cs @@ -13,6 +13,13 @@ namespace Yammer { public static class HttpUtility { + public static string Get(string url) + { + string nonce, timestamp; + string signature = GetSignature(WebMethod.GET, url, out timestamp, out nonce); + HttpWebRequest request = CreateWebRequest(url, WebMethod.GET, nonce, timestamp, signature); + return GetWebResponse(request); + } /// <summary> /// Creates http get web request and returns response /// </summary> @@ -27,6 +34,23 @@ namespace Yammer return GetWebResponse(request); } + public static string Get(string url, Session session, NameValueCollection parameters) + { + string nonce, timestamp; + string fullUrl = EncodeUrl(url, parameters); + string signature = GetSignature(WebMethod.GET, session, fullUrl, out timestamp, out nonce); + HttpWebRequest request = CreateWebRequest(fullUrl, WebMethod.GET, nonce, timestamp, signature, session); + return GetWebResponse(request); + } + public static string Get(string url, NameValueCollection parameters) + { + string nonce, timestamp; + string fullUrl = EncodeUrl(url, parameters); + string signature = GetSignature(WebMethod.GET, fullUrl, out timestamp, out nonce); + HttpWebRequest request = CreateWebRequest(fullUrl, WebMethod.GET, nonce, timestamp, signature); + return GetWebResponse(request); + } + /// <summary> /// Creates http post web request and returns response /// </summary> @@ -41,9 +65,44 @@ namespace Yammer string signature = GetSignature(WebMethod.POST, session, fullUrl, out timestamp, out nonce); HttpWebRequest request = CreateWebRequest(url, WebMethod.POST, nonce, timestamp, signature, session); WritePostData(parameters, request); + return GetLocationHeader(request); + } + + public static string Post(string url, NameValueCollection parameters) + { + string nonce, timestamp; + string fullUrl = EncodeUrl(url, parameters); + string signature = GetSignature(WebMethod.POST, fullUrl, out timestamp, out nonce); + HttpWebRequest request = CreateWebRequest(url, WebMethod.POST, nonce, timestamp, signature); + WritePostData(parameters, request); + return GetLocationHeader(request); + } + + + public static string Put(string url, NameValueCollection parameters, Session session) + { + string nonce, timestamp; + string fullUrl = EncodeUrl(url, parameters); + string signature = GetSignature(WebMethod.PUT, session, fullUrl, out timestamp, out nonce); + HttpWebRequest request = CreateWebRequest(fullUrl, WebMethod.PUT, new string[] { nonce, timestamp, signature }, session); + + + WritePostData(parameters, request); return GetWebResponse(request); } + public static string Put(string url, NameValueCollection parameters) + { + string nonce, timestamp; + string fullUrl = EncodeUrl(url, parameters); + string signature = GetSignature(WebMethod.PUT, fullUrl, out timestamp, out nonce); + HttpWebRequest request = CreateWebRequest(fullUrl, WebMethod.PUT, new string[] { nonce, timestamp, signature }); + + + WritePostData(parameters, request); + return GetWebResponse(request); + } + /// <summary> /// Creates http multipart post web request and returns response /// </summary> @@ -70,6 +129,11 @@ namespace Yammer return UploadAttachments(url, parameters, files, session); } + public static string Upload(string url, NameValueCollection parameters, List<string> files) + { + return UploadAttachments(url, parameters, files); + } + /// <summary> /// Creates http delete web request and returns response /// </summary> @@ -84,6 +148,41 @@ namespace Yammer return GetWebResponse(request); } + public static string Delete(string url) + { + string nonce, timestamp; + string signature = GetSignature(WebMethod.DELETE, url, out timestamp, out nonce); + HttpWebRequest request = CreateWebRequest(url, WebMethod.DELETE, nonce, timestamp, signature); + return GetWebResponse(request); + + } + + /// <summary> + /// Creates http delete web request and returns response + /// </summary> + /// <param name="url">The URL for the web request</param> + /// <param name="session">The Yammer<see cref="Session">session</see> object</param> + /// <returns>http response</returns> + public static string Delete(string url, NameValueCollection parameters, Session session) + { + string nonce, timestamp; + string fullUrl = EncodeUrl(url, parameters); + string signature = GetSignature(WebMethod.DELETE, session, fullUrl, out timestamp, out nonce); + HttpWebRequest request = CreateWebRequest(fullUrl, WebMethod.DELETE, nonce, timestamp, signature, session); + WritePostData(parameters, request); + return GetWebResponse(request); + + } + public static string Delete(string url, NameValueCollection parameters) + { + string nonce, timestamp; + string fullUrl = EncodeUrl(url, parameters); + string signature = GetSignature(WebMethod.DELETE, fullUrl, out timestamp, out nonce); + HttpWebRequest request = CreateWebRequest(fullUrl, WebMethod.DELETE, nonce, timestamp, signature); + WritePostData(parameters, request); + return GetWebResponse(request); + + } /// <summary> /// Creates the OAuth header for the http request @@ -99,18 +198,49 @@ namespace Yammer StringBuilder sb = new StringBuilder(); sb.Append("OAuth "); if (method == WebMethod.POST) - sb.Append("realm=\"" + Resources.YAMMER_MESSAGES_CREATE + "\","); - + sb.Append("realm=\"" + "\","); + else + sb.Append("realm=\"\","); + string authHeader = "oauth_consumer_key=\"" + session.AuthKey.ConsumerKey + "\"," + "oauth_token=\"" + session.AuthKey.TokenKey + "\"," + "oauth_nonce=\"" + nonce + "\"," + "oauth_timestamp=\"" + timeStamp + "\"," + - "oauth_signature_method=\"" + "HMAC-SHA1" + "\"," + + "oauth_signature_method=\"" + "PLAINTEXT" + "\"," + + "oauth_version=\"" + "1.0" + "\"," + + "oauth_signature=\"" + sig + "\""; + + + sb.Append(authHeader); + return sb.ToString(); + + //Authorization: OAuth realm="", oauth_consumer_key="AMbmZSOP3wHm1cjfvSsRg", oauth_signature_method="HMAC-SHA1", oauth_signature="yLDH5eLS4uUVa3vVbNxvDX9B8aFgnwRSFla3jph9y90%26", oauth_timestamp="1229537444", oauth_nonce="1229537444", oauth_version="1.0" + + } + + private static string CreateAuthHeader(WebMethod method, string nonce, string timeStamp, string sig) + { + StringBuilder sb = new StringBuilder(); + sb.Append("OAuth "); + if (method == WebMethod.POST) + sb.Append("realm=\"" + "\","); + else + sb.Append("realm=\"\","); + + string authHeader = "oauth_consumer_key=\"" + Yammer.Session.Auth.Key.ConsumerKey + "\"," + + "oauth_token=\"" + Yammer.Session.Auth.Key.TokenKey + "\"," + + "oauth_nonce=\"" + nonce + "\"," + + "oauth_timestamp=\"" + timeStamp + "\"," + + "oauth_signature_method=\"" + "PLAINTEXT" + "\"," + "oauth_version=\"" + "1.0" + "\"," + "oauth_signature=\"" + sig + "\""; + sb.Append(authHeader); return sb.ToString(); + + //Authorization: OAuth realm="", oauth_consumer_key="AMbmZSOP3wHm1cjfvSsRg", oauth_signature_method="HMAC-SHA1", oauth_signature="yLDH5eLS4uUVa3vVbNxvDX9B8aFgnwRSFla3jph9y90%26", oauth_timestamp="1229537444", oauth_nonce="1229537444", oauth_version="1.0" + } /// <summary> @@ -149,10 +279,57 @@ namespace Yammer string authHeader = CreateAuthHeader(method, nonce, timeStamp, sig, session); request.ContentType = "application/x-www-form-urlencoded"; request.Headers.Add("Authorization", authHeader); + + return request; + } + private static HttpWebRequest CreateWebRequest(string fullUrl, WebMethod method, string nonce, string timeStamp, string sig) + { + HttpWebRequest request = (HttpWebRequest)WebRequest.Create(fullUrl); + request.Method = method.ToString(); + request.Proxy = Yammer.Session.WebProxy; + string authHeader = CreateAuthHeader(method, nonce, timeStamp, sig); + request.ContentType = "application/x-www-form-urlencoded"; + request.Headers.Add("Authorization", authHeader); return request; } + private static HttpWebRequest CreateWebRequest(string fullUrl, WebMethod method, string[] oauthParams, Session session) + { + string nonce, timeStamp, sig; + nonce = oauthParams[0]; + timeStamp = oauthParams[1]; + sig = oauthParams[2]; + HttpWebRequest request = (HttpWebRequest)WebRequest.Create(fullUrl); + request.ServicePoint.Expect100Continue = false; + request.KeepAlive = false; + request.ProtocolVersion = HttpVersion.Version10; + request.Method = method.ToString(); + request.Proxy = session.Proxy; + string authHeader = CreateAuthHeader(method, nonce, timeStamp, sig, session); + request.ContentType = "text/plain"; + request.Headers.Add("Authorization", authHeader); + + return request; + } + private static HttpWebRequest CreateWebRequest(string fullUrl, WebMethod method, string[] oauthParams) + { + string nonce, timeStamp, sig; + nonce = oauthParams[0]; + timeStamp = oauthParams[1]; + sig = oauthParams[2]; + HttpWebRequest request = (HttpWebRequest)WebRequest.Create(fullUrl); + request.ServicePoint.Expect100Continue = false; + request.KeepAlive = false; + request.ProtocolVersion = HttpVersion.Version10; + request.Method = method.ToString(); + request.Proxy = Yammer.Session.WebProxy; + string authHeader = CreateAuthHeader(method, nonce, timeStamp, sig); + request.ContentType = "text/plain"; + request.Headers.Add("Authorization", authHeader); + + return request; + } /// <summary> /// /// </summary> @@ -174,6 +351,16 @@ namespace Yammer request.Headers.Add("Authorization", authHeader); return request; } + public static HttpWebRequest CreateWebRequest(string fullUrl, WebMethod method, string nonce, string timeStamp, string sig, string boundary) + { + HttpWebRequest request = (HttpWebRequest)WebRequest.Create(fullUrl); + request.Method = method.ToString(); + request.Proxy = Yammer.Session.WebProxy; + string authHeader = CreateAuthHeader(method, nonce, timeStamp, sig); + request.ContentType = "multipart/form-data; boundary=" + boundary; + request.Headers.Add("Authorization", authHeader); + return request; + } /// <summary> /// Encodes URL to RFC 3986 @@ -188,14 +375,29 @@ namespace Yammer foreach (string key in parameters.Keys) { if (count == 0) - fullUrl = url + "?" + key + "=" + Rfc3986.Encode(parameters[key]); + fullUrl = url + "?" + key + "=" + Rfc3986.Encode(parameters[key].ToLower()); else - fullUrl += "&" + key + "=" + Rfc3986.Encode(parameters[key]); + fullUrl += "&" + key + "=" + Rfc3986.Encode(parameters[key].ToLower()); count++; } return fullUrl; } + private static string PutParams(NameValueCollection parameters) + { + string qs = string.Empty; + int count = 0; + foreach (string key in parameters.Keys) + { + if (count == 0) + qs = key + "=" + Rfc3986.Encode(parameters[key].ToLower()); + else + qs += "," + key + "=" + Rfc3986.Encode(parameters[key].ToLower()); + count++; + } + return qs; + } + private static string GenerateRandomString(int intLenghtOfString) { StringBuilder randomString = new StringBuilder(); @@ -235,7 +437,28 @@ namespace Yammer method.ToString(), timestamp, nonce, - OAuthBase.SignatureTypes.HMACSHA1, out nurl, out nrp); + OAuthBase.SignatureTypes.PLAINTEXT, out nurl, out nrp); + + return System.Web.HttpUtility.UrlEncode(sig); + } + public static string GetSignature(WebMethod method, string url, out string timestamp, out string nonce) + { + OAuthBase oAuth = new OAuthBase(); + nonce = oAuth.GenerateNonce(); + timestamp = oAuth.GenerateTimeStamp(); + string nurl, nrp; + + Uri uri = new Uri(url); + string sig = oAuth.GenerateSignature( + uri, + Yammer.Session.Auth.Key.ConsumerKey, + Yammer.Session.Auth.Key.ConsumerSecret, + Yammer.Session.Auth.Key.TokenKey, + Yammer.Session.Auth.Key.TokenSecret, + method.ToString(), + timestamp, + nonce, + OAuthBase.SignatureTypes.PLAINTEXT, out nurl, out nrp); return System.Web.HttpUtility.UrlEncode(sig); } @@ -254,10 +477,43 @@ namespace Yammer response = request.GetResponse(); using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8)) data = reader.ReadToEnd(); + + } + catch (System.Net.WebException ex) + { + if (ex.Status != WebExceptionStatus.ConnectionClosed && ex.Status != WebExceptionStatus.KeepAliveFailure) + throw ex; + else + System.Threading.Thread.Sleep(500); + } + catch (Exception ex) + { + //System.Windows.Forms.MessageBox.Show("Error retrieving web response " + ex.Message); + throw ex; + } + finally + { + if (response != null) + response.Close(); + } + + return data; + + + } + + public static string GetLocationHeader(HttpWebRequest request) + { + WebResponse response = null; + string data = string.Empty; + try + { + response = request.GetResponse(); + data = response.Headers["Location"]; } catch (Exception ex) { - System.Windows.Forms.MessageBox.Show("Error retrieving web response " + ex.Message); + //System.Windows.Forms.MessageBox.Show("Error retrieving web response " + ex.Message); throw ex; } finally @@ -276,7 +532,7 @@ namespace Yammer /// </summary> /// <param name="parameters">The query string parameters</param> /// <param name="request">The http request to write to</param> - private static void WritePostData(NameValueCollection parameters, HttpWebRequest request) + public static void WritePostData(NameValueCollection parameters, HttpWebRequest request) { int count = 0; string queryString = string.Empty; @@ -289,6 +545,7 @@ namespace Yammer count++; } + byte[] postDataBytes = Encoding.ASCII.GetBytes(queryString); request.ContentLength = postDataBytes.Length; Stream reqStream = request.GetRequestStream(); @@ -344,7 +601,50 @@ namespace Yammer } WritePostData(contentTrailer,io, true); - string response = GetWebResponse(request); + string response = GetLocationHeader(request); + io.Close(); + request = null; + + return response; + } + + private static string UploadAttachments(string url, NameValueCollection parameters, List<string> fileNames) + { + string nonce, timestamp; + string beginBoundary = GenerateRandomString(25); + string contentBoundary = "--" + beginBoundary; + string endBoundary = contentBoundary + "--"; + string contentTrailer = "\r\n" + endBoundary; + + string signature = HttpUtility.GetSignature(WebMethod.POST, url, out timestamp, out nonce); + HttpWebRequest request = HttpUtility.CreateWebRequest(url, WebMethod.POST, nonce, timestamp, signature, beginBoundary); + Version protocolVersion = HttpVersion.Version11; + string method = WebMethod.POST.ToString(); + string contentType = "multipart/form-data; boundary=" + beginBoundary; + string contentDisposition = "Content-Disposition: form-data; name="; + request.Headers.Add("Cache-Control", "no-cache"); + request.KeepAlive = true; + string postParams = GetPostParameters(parameters, contentBoundary, contentDisposition); + + FileInfo[] fi = new FileInfo[fileNames.Count]; + int i = 0; + long postDataSize = 0; + int headerLength = 0; + List<string> fileHeaders = new List<string>(); + AddFileHeaders(fileNames, contentBoundary, contentDisposition, fi, ref i, ref postDataSize, ref headerLength, fileHeaders); + request.ContentLength = postParams.Length + headerLength + contentTrailer.Length + postDataSize; + System.IO.Stream io = request.GetRequestStream(); + WritePostData(postParams, io, false); + i = 0; + foreach (string fileName in fileNames) + { + WritePostData(fileHeaders[i], io, false); + WriteFile(io, fileName); + i++; + } + WritePostData(contentTrailer, io, true); + + string response = GetLocationHeader(request); io.Close(); request = null; @@ -427,6 +727,8 @@ namespace Yammer } + + Yammer Framework/Yammer/HttpUtility.cs @@ -19,9 +19,6 @@ namespace Yammer [XmlElement(ElementName = "thumbnail-url")] public string ThumbnailUrl { get; set; } - // <image> - // <size>37235</size> - // <url>https://www.yammer.com/api/v1/images/1301</url> <thumbnail-url>https://www.yammer.com/api/v1/images/1301/small</thumbnail-url> - //</image> + } } Yammer Framework/Yammer/Image.cs @@ -5,6 +5,9 @@ using System.Text; using System.Runtime.Serialization; using System.Xml.Serialization; using System.Collections; +using System.Collections.Specialized; +using System.Xml; +using System.IO; namespace Yammer { @@ -16,6 +19,699 @@ namespace Yammer { } + #region All Messages + + /// <summary> + /// All messages in this network. Corresponds to the "All" tab on the website. + /// </summary> + /// <returns></returns> + public static List<Message> GetAllMessages() + { + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_ALL)); + } + + /// <summary> + /// All messages in this network. Corresponds to the "All" tab on the website. + /// </summary> + /// <param name="threaded">Return only the first message in each thread.</param> + /// <returns></returns> + public static List<Message> GetAllMessages(bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_ALL, parameters)); + } + + /// <summary> + /// Corresponds to the "All" tab on the website. + /// </summary> + /// <param name="newer_than"></param> + /// <returns></returns> + public static List<Message> GetAllMessages(PageFlag flag, int id) + { + NameValueCollection parameters = new NameValueCollection(); + AddPageFlagParam(flag, parameters, id); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_ALL, parameters)); + } + + /// <summary> + /// Corresponds to the "All" tab on the website. + /// </summary> + /// <param name="newer_than"></param> + /// <param name="threaded">Return only the first message in each thread.</param> + /// <returns></returns> + public static List<Message> GetAllMessages(PageFlag flag, int id, bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + AddPageFlagParam(flag, parameters, id); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_ALL, parameters)); + + } + + #endregion + + #region Sent Messages + + /// <summary> + /// Corresponds to the "Sent" tab on the website. + /// </summary> + /// <returns></returns> + public static List<Message> GetSentMessages() + { + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_SENT)); + } + + /// <summary> + /// Corresponds to the "Sent" tab on the website. + /// </summary> + /// <param name="threaded">Return only the first message in each thread.</param> + /// <returns></returns> + public static List<Message> GetSentMessages(bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_SENT, parameters)); + } + + /// <summary> + /// Corresponds to the "Sent" tab on the website. + /// </summary> + /// <param name="flag"></param> + /// <param name="threaded"></param> + /// <returns></returns> + public static List<Message> GetSentMessages(PageFlag flag, int id) + { + NameValueCollection parameters = new NameValueCollection(); + AddPageFlagParam(flag, parameters, id); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_SENT, parameters)); + + } + + /// <summary> + /// Corresponds to the "Sent" tab on the website. + /// </summary> + /// <param name="flag"></param> + /// <param name="threaded"></param> + /// <returns></returns> + public static List<Message> GetSentMessages(PageFlag flag, int id, bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + AddPageFlagParam(flag, parameters, id); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_SENT, parameters)); + + } + + #endregion + + #region Received Messages + + /// <summary> + /// Messages received by the logged-in user. Corresponds to the "Received" tab on the website. + /// </summary> + /// <returns></returns> + public static List<Message> GetReceivedMessages() + { + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_RECEIVED)); + } + + /// <summary> + /// Messages received by the logged-in user. Corresponds to the "Received" tab on the website. + /// </summary> + /// <returns></returns> + public static List<Message> GetReceivedMessages(bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_RECEIVED, parameters)); + } + + /// <summary> + /// Messages received by the logged-in user. Corresponds to the "Received" tab on the website. + /// </summary> + /// <param name="flag"></param> + /// <param name="thread"></param> + /// <returns></returns> + public static List<Message> GetReceivedMessages(PageFlag flag, int id) + { + NameValueCollection parameters = new NameValueCollection(); + AddPageFlagParam(flag, parameters, id); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_RECEIVED, parameters)); + + } + + /// <summary> + /// Messages received by the logged-in user. Corresponds to the "Received" tab on the website. + /// </summary> + /// <param name="flag"></param> + /// <param name="thread"></param> + /// <returns></returns> + public static List<Message> GetReceivedMessages(PageFlag flag, int id, bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + AddPageFlagParam(flag, parameters, id); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_RECEIVED,parameters)); + + } + + #endregion + + #region Following Messages + + /// <summary> + /// Messages followed by the logged-in user. Corresponds to the "Following" tab on the website. + /// </summary> + /// <returns></returns> + public static List<Message> GetFollowingMessages() + { + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_FOLLOWING)); ; + } + + /// <summary> + /// Messages followed by the logged-in user. Corresponds to the "Following" tab on the website. + /// </summary> + /// <returns></returns> + public static List<Message> GetFollowingMessages(bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_FOLLOWING, parameters)); ; + } + + /// <summary> + /// Messages followed by the logged-in user. Corresponds to the "Following" tab on the website. + /// </summary> + /// <param name="flag"></param> + /// <param name="date"></param> + /// <returns></returns> + public static List<Message> GetFollowingMessages(PageFlag flag, int id) + { + NameValueCollection parameters = new NameValueCollection(); + AddPageFlagParam(flag, parameters, id); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_FOLLOWING, parameters)); + + } + + /// <summary> + /// Messages followed by the logged-in user. Corresponds to the "Following" tab on the website. + /// </summary> + /// <param name="flag"></param> + /// <param name="date"></param> + /// <returns></returns> + public static List<Message> GetFollowingMessages(PageFlag flag, int id, bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + AddPageFlagParam(flag, parameters, id); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_FOLLOWING, parameters)); + + } + + #endregion + + #region Messages Sent By + + /// <summary> + /// Messages sent by the user with the given ID. Corresponds to the messages on a user profile page on the website. + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesSentBy(int id) + { + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_SENT_BY + id.ToString() + ".xml")); + } + + /// <summary> + /// Messages sent by the user with the given ID. Corresponds to the messages on a user profile page on the website. + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesSentBy(int id, bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_SENT_BY + id.ToString() + ".xml", parameters)); + } + + /// <summary> + /// Messages sent by the user with the given ID. Corresponds to the messages on a user profile page on the website. + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesSentBy(PageFlag flag, int id, int pageId) + { + NameValueCollection parameters = new NameValueCollection(); + AddPageFlagParam(flag, parameters, pageId); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_SENT_BY + id.ToString() + ".xml", parameters)); + } + + /// <summary> + /// Messages sent by the user with the given ID. Corresponds to the messages on a user profile page on the website. + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesSentBy(PageFlag flag, int id, int pageId, bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + AddPageFlagParam(flag, parameters, pageId); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_SENT_BY + id.ToString() + ".xml", parameters)); + } + + #endregion + + #region Messages Tagged With + + /// <summary> + /// Messages including the tag with given ID. Corresponds to the messages on a tag's page on the website. + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesTaggedWith(int id) + { + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_TAGGED_WITH + id.ToString() + ".xml")); + } + + /// <summary> + /// Messages including the tag with given ID. Corresponds to the messages on a tag's page on the website. + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesTaggedWith(int id, bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_TAGGED_WITH + id.ToString() + ".xml", parameters)); + } + + /// <summary> + /// Messages including the tag with given ID. Corresponds to the messages on a tag's page on the website. + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesTaggedWith(PageFlag flag, int id, int pageId) + { + NameValueCollection parameters = new NameValueCollection(); + AddPageFlagParam(flag, parameters, pageId); + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_TAGGED_WITH + id.ToString() + ".xml", parameters)); + } + + /// <summary> + /// Messages including the tag with given ID. Corresponds to the messages on a tag's page on the website. + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesTaggedWith(PageFlag flag, int id, int pageId, bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + AddPageFlagParam(flag, parameters, pageId); + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_TAGGED_WITH + id.ToString() + ".xml", parameters)); + } + + + #endregion + + #region Messages in Group + + /// <summary> + /// Messages in the group with the given ID. Corresponds to the messages you'd see on a group's profile page. + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesInGroup(int id) + { + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_IN_GROUP + id.ToString() + ".xml")); + } + + /// <summary> + /// Messages in the group with the given ID. Corresponds to the messages you'd see on a group's profile page. + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesInGroup(int id, bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_IN_GROUP + id.ToString() + ".xml", parameters)); + } + + /// <summary> + /// Messages in the group with the given ID. Corresponds to the messages you'd see on a group's profile page. + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesInGroup(PageFlag flag, int id, int pageId) + { + NameValueCollection parameters = new NameValueCollection(); + AddPageFlagParam(flag, parameters, pageId); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_IN_GROUP + id.ToString() + ".xml", parameters)); + } + + + /// <summary> + /// Messages in the group with the given ID. Corresponds to the messages you'd see on a group's profile page. + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesInGroup(PageFlag flag, int id, int pageId, bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + AddPageFlagParam(flag, parameters, pageId); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_IN_GROUP + id.ToString() + ".xml", parameters)); + } + + + #endregion + + #region Messages Favorites Of + + /// <summary> + /// Favorite messages of the given user ID. Can pass 'current' in place of user_id for currently logged in user + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesFavoritesOf(int id) + { + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_FAVORITES_OF + id.ToString() + ".xml")); + } + + /// <summary> + /// Favorite messages of the given user ID. Can pass 'current' in place of user_id for currently logged in user + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesFavoritesOf(int id, bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_FAVORITES_OF + id.ToString() + ".xml", parameters)); + } + + /// <summary> + /// Favorite messages of the given user ID. Can pass 'current' in place of user_id for currently logged in user + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesFavoritesOf(PageFlag flag, int id, int pageId) + { + NameValueCollection parameters = new NameValueCollection(); + AddPageFlagParam(flag, parameters, pageId); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_FAVORITES_OF + id.ToString() + ".xml", parameters)); + } + + /// <summary> + /// Favorite messages of the given user ID. Can pass 'current' in place of user_id for currently logged in user + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesFavoritesOf(PageFlag flag, int id, int pageId, bool threaded) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("threaded", threaded.ToString()); + AddPageFlagParam(flag, parameters, pageId); + + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_FAVORITES_OF + id.ToString() + ".xml", parameters)); + } + + + #endregion + + #region Messages In Thread + + /// <summary> + /// Messages in the thread with the given ID. Corresponds to the page you'd see when clicking on "in reply to" on the website. + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesInThread(int id) + { + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_IN_THREAD + id.ToString() + ".xml")); + } + + /// <summary> + /// Messages in the thread with the given ID. Corresponds to the page you'd see when clicking on "in reply to" on the website. + /// </summary> + /// <param name="id"></param> + /// <returns></returns> + public static List<Message> GetMessagesInThread(PageFlag flag, int id, int pageId) + { + NameValueCollection parameters = new NameValueCollection(); + AddPageFlagParam(flag, parameters, pageId); + return RetrieveMessages(Yammer.HttpUtility.Get(Resources.YAMMER_MESSAGES_IN_THREAD + id.ToString() + ".xml", parameters)); + } + + #endregion + + #region Post Message + + /// <summary> + /// Create a new message. + /// </summary> + /// <param name="body"></param> + public static string PostMessage(string body, List<string> attachments) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("body", body); + string response = string.Empty; + if (attachments.Count > 0) + response = Yammer.HttpUtility.Upload(Resources.YAMMER_MESSAGES_CREATE, parameters, attachments); + else + response = Yammer.HttpUtility.Post(Resources.YAMMER_MESSAGES_CREATE, parameters); + + return response; + } + + /// <summary> + /// Sends message in reply to message of given id + /// </summary> + /// <param name="body"></param> + /// <param name="reply"></param> + public static string PostMessage(string body, int id, List<string> attachments) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("body", body); + parameters.Add("replied_to_id", id.ToString()); + string response = string.Empty; + if (attachments.Count > 0) + response = Yammer.HttpUtility.Upload(Resources.YAMMER_MESSAGES_CREATE, parameters, attachments); + else + response = Yammer.HttpUtility.Post(Resources.YAMMER_MESSAGES_CREATE, parameters); + + return response; + } + + + /// <summary> + /// Sends a private message directly to the user indicated. + /// </summary> + /// <param name="directToId"></param> + /// <param name="body"></param> + /// <param name="attachments"></param> + /// <returns></returns> + public static string PostMessage(int directToId, string body, List<string> attachments) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("body", body); + parameters.Add("direct_to_id", directToId.ToString()); + string response = string.Empty; + if (attachments.Count > 0) + response = Yammer.HttpUtility.Upload(Resources.YAMMER_MESSAGES_CREATE, parameters, attachments); + else + response = Yammer.HttpUtility.Post(Resources.YAMMER_MESSAGES_CREATE, parameters); + + return response; + } + + + + + #endregion + + #region Delete Message + + /// <summary> + /// Delete a message owned by the current user. + /// </summary> + /// <param name="id"></param> + public static void DeleteMessage(int id) + { + Yammer.HttpUtility.Delete(Resources.YAMMER_MESSAGES_DELETE + id.ToString()); + } + + #endregion + + #region Helper Methods + + private static object Deserialize(Type type, string xml) + { + + XmlSerializer serializer = new XmlSerializer(type); + System.Text.ASCIIEncoding encoding = new System.Text.ASCIIEncoding(); + byte[] bytes = encoding.GetBytes(xml); + System.IO.MemoryStream stream = new MemoryStream(bytes); + object obj = (object)serializer.Deserialize(stream); + + return obj; + + } + + private static void AddPageFlagParam(PageFlag pf, NameValueCollection parameters, int id) + { + if (pf == PageFlag.NEWER_THAN) + parameters.Add("newer_than", id.ToString()); + else + parameters.Add("older_than", id.ToString()); + } + + private static void SetMessageReference(Message message, Message reference) + { + if (message != null) + message.References.Messages.Add(reference); + + } + + private static void SetMessageReference(Message message, Guide reference) + { + if (message != null) + message.References.Guide = reference; + } + + private static void AddMessageReferences(List<Message> messages, object reference) + { + if (messages != null) + { + User user; + Tag tag; + Thread thread; + foreach (Message msg in messages) + { + switch (ConvertReferenceType(reference, out user, out tag, out thread)) + { + case ObjectType.USER: + msg.References.Users.Add(user); + break; + case ObjectType.THREAD: + msg.References.Thread = thread; + break; + case ObjectType.TAG: + msg.References.Tags.Add(tag); + break; + } + } + } + + } + + private static ObjectType ConvertReferenceType(object reference, out User user, out Tag tag, out Thread thread) + { + user = null; + tag = null; + thread = null; + user = reference as User; + ObjectType type = ObjectType.NONE; + bool converted = false; + if (user != null) { converted = true; type = ObjectType.USER; } + if (!converted) + { + thread = reference as Thread; + if (thread != null) { converted = true; type = ObjectType.THREAD; } + if (!converted) + { + tag = reference as Tag; + if (tag != null) { converted = true; type = ObjectType.TAG; } + } + } + + return type; + } + + private static List<Message> RetrieveMessages(string data) + { + List<Message> messages = null; + try + { + XmlDocument xdoc = new XmlDocument(); + xdoc.LoadXml(data); + messages = new List<Message>(); + ReadMessages(messages, xdoc); + ReadReferences(messages, xdoc); + } + catch (Exception ex) + { + System.Windows.Forms.MessageBox.Show("Deserialization Error: " + ex.Message.ToString()); + } + + return messages; + } + + private static void ReadReferences(List<Message> messages, XmlDocument xdoc) + { + foreach (XmlNode node in xdoc.SelectNodes("/response/references/reference")) + { + string xml = node.OuterXml; + ObjectType objectType = (ObjectType)Enum.Parse(Type.GetType("Yammer.ObjectType"), node.SelectSingleNode("type").InnerText.ToUpper()); + switch (objectType) + { + case ObjectType.MESSAGE: + Message message = (Message)Deserialize(typeof(Message), "<message>" + node.InnerXml + "</message>"); + SetMessageReference(messages.Find(delegate(Message m) { return m.RepliedToId == message.Id; }), message); + break; + case ObjectType.USER: + User user = (User)Deserialize(typeof(User), node.OuterXml); + AddMessageReferences(messages.FindAll(delegate(Message m) { return m.SenderId.ToString() == user.Id || m.RepliedToId == user.Id; }), user); + break; + case ObjectType.TAG: + Tag tag = (Tag)Deserialize(typeof(Tag), node.OuterXml); + string tagText = "[[tag:" + tag.Id + "]] tag"; + AddMessageReferences(messages.FindAll(delegate(Message m) { return m.Body.Parsed.Contains(tagText); }), tag); + break; + case ObjectType.THREAD: + Thread thread = (Thread)Deserialize(typeof(Thread), node.OuterXml); + AddMessageReferences(messages.FindAll(delegate(Message m) { return m.ThreadId == thread.Id; }), thread); + break; + case ObjectType.GUIDE: + Guide guide = (Guide)Deserialize(typeof(Guide), node.OuterXml); + SetMessageReference(messages.Find(delegate(Message m) { return m.SenderId.ToString() == guide.Id; }), guide); + break; + default: + break; + } + } + } + + private static void ReadMessages(List<Message> messages, XmlDocument xdoc) + { + foreach (XmlNode mnode in xdoc.SelectNodes("/response/messages/message")) + { + Message message = (Message)Deserialize(typeof(Message), mnode.OuterXml); + message.References = new Reference(); + messages.Add(message); + } + } + + #endregion + #region Yammer Properties /// <summary> @@ -134,6 +830,33 @@ namespace Yammer public Reference References { get; set; } + public User Sender + { + get + { + return Yammer.User.GetUserById(this.References.Users, this.SenderId); + } + } + + public Yammer.User Recipient + { + get + { + if (this.DirectToId != null) + return Yammer.User.GetUserById(this.References.Users, int.Parse(this.DirectToId)); + else + return null; + } + } + + public Guide Guide + { + get + { + return this.References.Guide; + } + } + #endregion } Yammer Framework/Yammer/Message.cs @@ -8,11 +8,13 @@ namespace Yammer public static class Resources { + private static string APP_PATH = System.Configuration.ConfigurationSettings.AppSettings["APP_PATH"]; + #region oAuth - public static string OAUTH_REQUEST_TOKEN = "https://www.yammer.com/oauth/request_token"; - public static string OAUTH_AUTHORIZE = "https://www.yammer.com/oauth/authorize"; - public static string OAUTH_ACCESS_TOKEN = "https://www.yammer.com/oauth/access_token"; + public static string OAUTH_REQUEST_TOKEN = APP_PATH + "/oauth/request_token"; + public static string OAUTH_AUTHORIZE = APP_PATH + "/oauth/authorize"; + public static string OAUTH_ACCESS_TOKEN = APP_PATH + "/oauth/access_token"; #endregion @@ -21,55 +23,55 @@ namespace Yammer /// <summary> /// All messages in this network. Corresponds to the "All" tab on the website /// </summary> - public static string YAMMER_MESSAGES_ALL = "https://www.yammer.com/api/v1/messages.xml"; + public static string YAMMER_MESSAGES_ALL = APP_PATH + "/api/v1/messages.xml"; /// <summary> /// Alias for /api/v1/messages/from_user/logged-in_user_id.format Corresponds to the "Sent" tab on the website. /// </summary> - public static string YAMMER_MESSAGES_SENT = "https://www.yammer.com/api/v1/messages/sent.xml"; + public static string YAMMER_MESSAGES_SENT = APP_PATH + "/api/v1/messages/sent.xml"; /// <summary> /// Messages received by the logged-in user. Corresponds to the "Received" tab on the website. /// </summary> - public static string YAMMER_MESSAGES_RECEIVED = "https://www.yammer.com/api/v1/messages/received.xml"; + public static string YAMMER_MESSAGES_RECEIVED = APP_PATH + "/api/v1/messages/received.xml"; /// <summary> /// Messages sent by the user with the given ID. Corresponds to the messages on a user profile page on the website. /// </summary> - public static string YAMMER_MESSAGES_FOLLOWING = "https://www.yammer.com/api/v1/messages/following.xml"; + public static string YAMMER_MESSAGES_FOLLOWING = APP_PATH + "/api/v1/messages/following.xml"; /// <summary> /// Messages sent by the user with the given ID. Corresponds to the messages on a user profile page on the website. /// </summary> - public static string YAMMER_MESSAGES_SENT_BY = "https://www.yammer.com/api/v1/messages/from_user/"; + public static string YAMMER_MESSAGES_SENT_BY = APP_PATH + "/api/v1/messages/from_user/"; /// <summary> /// Messages including the tag with given ID. Corresponds to the messages on a tag's page on the website. /// </summary> - public static string YAMMER_MESSAGES_TAGGED_WITH = "https://www.yammer.com/api/v1/messages/tagged_with/"; + public static string YAMMER_MESSAGES_TAGGED_WITH = APP_PATH + "/api/v1/messages/tagged_with/"; /// <summary> /// Messages in the thread with the given ID. Corresponds to the page you'd see when clicking on "in reply to" on the website. /// </summary> - public static string YAMMER_MESSAGES_IN_THREAD = "https://www.yammer.com/api/v1/messages/in_thread/"; + public static string YAMMER_MESSAGES_IN_THREAD = APP_PATH + "/api/v1/messages/in_thread/"; /// <summary> /// Messages in the group with the given ID. Corresponds to the messages you'd see on a group's profile page. /// </summary> - public static string YAMMER_MESSAGES_IN_GROUP = "https://www.yammer.com/api/v1/messages/in_group/"; + public static string YAMMER_MESSAGES_IN_GROUP = APP_PATH + "/api/v1/messages/in_group/"; /// <summary> /// Favorite messages of the given user ID. Can pass 'current' in place of user_id for currently logged in user /// </summary> - public static string YAMMER_MESSAGES_FAVORITES_OF = "https://www.yammer.com/api/v1/messages/favorites_of/"; + public static string YAMMER_MESSAGES_FAVORITES_OF = APP_PATH + "/api/v1/messages/favorites_of/"; /// <summary> /// Create a new message. /// </summary> - public static string YAMMER_MESSAGES_CREATE = "https://www.yammer.com/api/v1/messages/"; + public static string YAMMER_MESSAGES_CREATE = APP_PATH + "/api/v1/messages/"; /// <summary> /// Delete a message owned by the current user. /// </summary> - public static string YAMMER_MESSAGES_DELETE = "https://www.yammer.com/api/v1/messages/"; + public static string YAMMER_MESSAGES_DELETE = APP_PATH + "/api/v1/messages/"; /// <summary> /// Add a message to user_id's favorite messages. /// </summary> - public static string YAMMER_MESSAGES_ADD_FAVORITE = "https://www.yammer.com/api/v1/favorites_of/"; + public static string YAMMER_MESSAGES_ADD_FAVORITE = APP_PATH + "/api/v1/favorites_of/"; /// <summary> /// Remove a favorite. /// </summary> - public static string YAMMER_MESSAGES_DELETE_FAVORITE = "https://www.yammer.com/api/v1/favorites_of/"; + public static string YAMMER_MESSAGES_DELETE_FAVORITE = APP_PATH + "/api/v1/favorites_of/"; #endregion @@ -78,11 +80,9 @@ namespace Yammer /// <summary> /// A list of groups. /// </summary> - public static string YAMMER_GROUP_LIST = "https://www.yammer.com/api/v1/groups.xml"; - /// <summary> - /// https://www.yammer.com/api/v1/groups/id.format - /// </summary> - public static string YAMMER_GROUP_DATA = "https://www.yammer.com/api/v1/groups/"; + public static string YAMMER_GROUP_LIST = APP_PATH + "/api/v1/groups.xml"; + + public static string YAMMER_GROUP_DATA = APP_PATH + "/api/v1/groups/"; #endregion @@ -91,11 +91,11 @@ namespace Yammer /// <summary> /// Tags in this network. NOT YET IMPLEMENTED /// </summary> - public static string YAMMER_TAGS = "https://www.yammer.com/api/v1/tags.xml"; + public static string YAMMER_TAGS = APP_PATH + "/api/v1/tags.xml"; /// <summary> /// View data about one tag. /// </summary> - public static string YAMMER_TAGS_DATA = "https://www.yammer.com/api/v1/tags/"; + public static string YAMMER_TAGS_DATA = APP_PATH + "/api/v1/tags/"; #endregion @@ -104,15 +104,21 @@ namespace Yammer /// <summary> /// Users in this network. /// </summary> - public static string YAMMER_USERS_ALL = "https://www.yammer.com/api/v1/users.xml"; + public static string YAMMER_USERS_ALL = APP_PATH + "/api/v1/users.xml"; /// <summary> /// View data about one user. /// </summary> - public static string YAMMER_USERS_SINGLE = "https://www.yammer.com/api/v1/users/"; + public static string YAMMER_USERS_SINGLE = APP_PATH + "/api/v1/users/"; /// <summary> /// Alias to /api/v1/users/current user's id.format. /// </summary> - public static string YAMMER_USERS_CURRENT = "https://www.yammer.com/api/v1/users/current.xml"; + public static string YAMMER_USERS_CURRENT = APP_PATH + "/api/v1/users/current.xml"; + + public static string YAMMER_USERS_CREATE = APP_PATH + "/api/v1/users.xml"; + + public static string YAMMER_USERS_MODIFY = APP_PATH + "/api/v1/users/"; + + public static string YAMMER_USERS_DELETE = APP_PATH + "/api/v1/users/"; #endregion @@ -121,11 +127,11 @@ namespace Yammer /// <summary> /// Join a group. /// </summary> - public static string YAMMER_GROUP_JOIN = "https://www.yammer.com/api/v1/group_memberships/"; + public static string YAMMER_GROUP_JOIN = APP_PATH + "/api/v1/group_memberships/"; /// <summary> /// Leave a group. /// </summary> - public static string YAMMER_GROUP_RESIGN = "https://www.yammer.com/api/v1/group_memberships/"; + public static string YAMMER_GROUP_RESIGN = APP_PATH + "/api/v1/group_memberships/"; #endregion @@ -134,16 +140,16 @@ namespace Yammer /// <summary> /// Show org chart relationships. /// </summary> - public static string YAMMER_RELATIONSHIPS_ALL = "https://www.yammer.com/api/v1/relationships.xml"; + public static string YAMMER_RELATIONSHIPS_ALL = APP_PATH + "/api/v1/relationships.xml"; /// <summary> /// Add an org chart relationship. /// </summary> - public static string YAMMER_RELATIONSHIPS_CREATE = "https://www.yammer.com/api/v1/relationships.xml"; + public static string YAMMER_RELATIONSHIPS_CREATE = APP_PATH + "/api/v1/relationships.xml"; /// <summary> /// Remove a relationship. /// </summary> - public static string YAMMER_RELATIONSHIPS_DELETE = "https://www.yammer.com/api/v1/relationships/"; - + public static string YAMMER_RELATIONSHIPS_DELETE = APP_PATH + "/api/v1/relationships/"; + #endregion #region Suggestions @@ -151,19 +157,19 @@ namespace Yammer /// <summary> /// Show suggested groups and users. /// </summary> - public static string YAMMER_SUGGESTIONS_SHOW_ALL = "https://www.yammer.com/api/v1/suggestions.xml"; + public static string YAMMER_SUGGESTIONS_SHOW_ALL = APP_PATH + "/api/v1/suggestions.xml"; /// <summary> /// Show only suggested users. /// </summary> - public static string YAMMER_SUGGESTIONS_SHOW_USERS = "https://www.yammer.com/api/v1/suggestions/users.xml"; - /// <summary> + public static string YAMMER_SUGGESTIONS_SHOW_USERS = APP_PATH + "/api/v1/suggestions/users.xml"; + /// <summary> /// Show only suggested groups. /// </summary> - public static string YAMMER_SUGGESTIONS_SHOW_GROUPS = "https://www.yammer.com/api/v1/suggestions/groups.xml"; + public static string YAMMER_SUGGESTIONS_SHOW_GROUPS = APP_PATH + "/api/v1/suggestions/groups.xml"; /// <summary> /// Decline a suggestion. /// </summary> - public static string YAMMER_SUGGESTIONS_DECLINE = "https://www.yammer.com/api/v1/suggestions/"; + public static string YAMMER_SUGGESTIONS_DECLINE = APP_PATH + "/api/v1/suggestions/"; #endregion @@ -171,19 +177,19 @@ namespace Yammer /// <summary> /// Check to see if you are subscribed to the user of the given id. /// </summary> - public static string YAMMER_SUBSCRIPTIONS_TO_USER = "https://www.yammer.com/api/v1/subscriptions/to_user/"; + public static string YAMMER_SUBSCRIPTIONS_TO_USER = APP_PATH + "/api/v1/subscriptions/to_user/"; /// <summary> /// Check to see if you are subscribed to the tag of the given id. /// </summary> - public static string YAMMER_SUBSCRIPTIONS_TO_TAG = "https://www.yammer.com/api/v1/subscriptions/to_tag/"; + public static string YAMMER_SUBSCRIPTIONS_TO_TAG = APP_PATH + "/api/v1/subscriptions/to_tag/"; /// <summary> /// Subscribe to a user or tag. /// </summary> - public static string YAMMER_SUBSCRIPTIONS_SUBSCRIBE = "https://www.yammer.com/api/v1/subscriptions/"; + public static string YAMMER_SUBSCRIPTIONS_SUBSCRIBE = APP_PATH + "/api/v1/subscriptions/"; /// <summary> /// Unsubscribe to a user or tag. /// </summary> - public static string YAMMER_SUBSCRIPTIONS_UNSUBSCRIBE = "https://www.yammer.com/api/v1/subscriptions/ "; + public static string YAMMER_SUBSCRIPTIONS_UNSUBSCRIBE = APP_PATH + "/api/v1/subscriptions/ "; #endregion @@ -192,7 +198,7 @@ namespace Yammer /// <summary> /// Return typeahead suggestions for the prefix passed /// </summary> - public static string YAMMER_AUTOCOMPLETE = "https://www.yammer.com/api/v1/autocomplete.xml"; + public static string YAMMER_AUTOCOMPLETE = APP_PATH + "/api/v1/autocomplete.xml"; #endregion Yammer Framework/Yammer/Resources.cs @@ -5,6 +5,9 @@ using System.Text; using System.Web; using System.Net; using OAuth; +using System.Threading; +using System.Windows.Forms; +using threading = System.Threading; namespace Yammer { public class Session @@ -12,10 +15,142 @@ namespace Yammer public WebProxy Proxy { get; set; } public OAuthKey AuthKey { get; set; } + public Session(OAuthKey key, WebProxy proxy) { this.AuthKey = key; this.Proxy = proxy; + Session.Assets = new Assets(this); + } + + public static Assets Assets { get; set; } + + //New Code************ + + static Session() + { + + } + + static void Auth_AuthorizationComplete(object sender, EventArgs e) + { + OnAuthorizationComplete(); + } + public static event EventHandler AuthorizationComplete; + public static void OnAuthorizationComplete() + { + if (Session.AuthorizationComplete != null) + Session.AuthorizationComplete(null, new EventArgs()); + } + + public static void Start() + { + Start(false, null, null, null, null); + } + + public static void Start(bool useProxy, string address, string port, string username, string password) + { + Login(useProxy, address, port, username, password); + } + + public static Yammer.Settings Settings { get; set; } + + private static Yammer.Auth auth; + public static Yammer.Auth Auth + { + get + { + if (auth == null) + CheckAuth(); + + return auth; + } + set + { + auth = value; + auth.AuthorizationComplete += new EventHandler(Auth_AuthorizationComplete); + } + } + + public static WebProxy WebProxy { get; set; } + + private static void Login(bool useProxy, string address, string port, string username, string password) + { + + Session.WebProxy = null; + bool validProxy; + + if (useProxy) + validProxy = ValidateProxySettings(address, port, username, password); + else + validProxy = true; + + + if (validProxy) + { + try + { + if (useProxy) + { + Session.WebProxy = new System.Net.WebProxy(); + Session.WebProxy.Address = new Uri(address + ":" + port); + Session.WebProxy.Credentials = new NetworkCredential(username, password); + } + + threading.Thread thread = new threading.Thread(new ThreadStart(GetRequestToken)); + thread.Start(); + } + catch (Exception ex) + { + Yammer.Utility.SetErrorLog(ex.Message); + } + } + else + MessageBox.Show("If you are using a proxy-server please add values for each setting."); + } + + private static bool ValidateProxySettings(string address, string port, string username, string password) + { + if (address == null || port == null || username == null || password == null) + return false; + + if (address == string.Empty || port == string.Empty || username == string.Empty || password == string.Empty) + return false; + + return true; + } + + private static void GetRequestToken() + { + string ck = System.Configuration.ConfigurationSettings.AppSettings["CONSUMER_KEY"]; + string cs = System.Configuration.ConfigurationSettings.AppSettings["CONSUMER_SECRET"]; + Session.Auth = Yammer.Auth.GetRequestToken(Session.WebProxy, ck, cs); + //TODO: Allow callback URL + if (Session.Auth != null) + Session.Auth.Authorize(null); + + Session.OnReceiveRequestToken(); + } + + public static event EventHandler ReceiveRequestToken; + + static void OnReceiveRequestToken() + { + if (Session.ReceiveRequestToken != null) + Session.ReceiveRequestToken(null, new EventArgs()); + } + + private static void CheckAuth() + { + string ck = System.Configuration.ConfigurationSettings.AppSettings["CONSUMER_KEY"]; + string cs = System.Configuration.ConfigurationSettings.AppSettings["CONSUMER_SECRET"]; + Yammer.Settings settings = Yammer.Settings.CheckConfiguration(); + if (settings != null) + { + Yammer.Session.Auth = new Auth(); + Yammer.Session.Auth.Key = new OAuthKey(ck, cs, settings.OAuth.TokenKey, settings.OAuth.TokenSecret); + } + } } } Yammer Framework/Yammer/Session.cs @@ -23,6 +23,40 @@ namespace Yammer public OAuthSettings OAuth { get; set; } [XmlElement] public string UserId { get; set; } + [XmlElement] + public string Email { get; set; } + [XmlElement] + public string Domain { get; set; } + private bool showAvatars = true; + [XmlElement] + public bool ShowAvatars + { + get + { + return showAvatars; + } + set + { + showAvatars = value; + } + } + [XmlElement] + public bool ShowFullNames { get; set; } + [XmlElement] + public bool SupressEnterKey { get; set; } + + [XmlElement] + public bool SmtpUseSSL { get; set; } + [XmlElement] + public string SmtpHost { get; set; } + [XmlElement] + public string SmtpPort { get; set; } + [XmlElement] + public string SmtpUser { get; set; } + [XmlElement] + public string SmtpPass { get; set; } + [XmlElement] + public string EmailRecipients { get; set; } /// <summary> /// Checks if the persisted <see cref="Settings">settings</see> file exists on the client @@ -30,7 +64,7 @@ namespace Yammer /// <returns></returns> public static Settings CheckConfiguration() { - Dictionary<string, DirectoryInfo> appData = Utility.GetAppDirectory(); + Dictionary<string, DirectoryInfo> appData = Utility.GetAppData(); if (System.IO.File.Exists(appData["data"] + "\\settings.yam")) { XmlSerializer serializer = new XmlSerializer(typeof(Settings)); @@ -52,7 +86,7 @@ namespace Yammer /// <param name="tokenSecret"></param> public static void SaveConfiguration(string tokenKey, string tokenSecret, OAuthKey key, WebProxy proxy) { - Dictionary<string, DirectoryInfo> appData = Utility.GetAppDirectory(); + Dictionary<string, DirectoryInfo> appData = Utility.GetAppData(); Settings settings = new Settings(); if (proxy != null) { Yammer Framework/Yammer/Settings.cs @@ -4,6 +4,7 @@ using System.Linq; using System.Text; using System.Runtime.Serialization; using System.Xml.Serialization; +using System.Collections.Specialized; namespace Yammer { @@ -38,6 +39,51 @@ namespace Yammer [XmlElement(ElementName = "target-url")] public string TargetUrl { get; set; } + + /// <summary> + /// Subscribe to user + /// </summary> + /// <param name="id"></param> + public static void SubscribeToUser(int id) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("target_type", "user"); + parameters.Add("target_id", id.ToString()); + string data = Yammer.HttpUtility.Post(Resources.YAMMER_SUBSCRIPTIONS_SUBSCRIBE, parameters); + } + + /// <summary> + /// Subscribe to tag + /// </summary> + /// <param name="id"></param> + public static void SubscribeToTag(int id) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("target_type", "tag"); + parameters.Add("target_id", id.ToString()); + string data = Yammer.HttpUtility.Post(Resources.YAMMER_SUBSCRIPTIONS_SUBSCRIBE, parameters); + } + + /// <summary> + /// Unsubscribe to user + /// </summary> + /// <param name="id"></param> + /// <param name="session"></param> + public static void DeleteSubscriptionToUser(int id) + { + string data = Yammer.HttpUtility.Delete(Resources.YAMMER_RELATIONSHIPS_DELETE + "?target_type=user" + "&target_id=" + id.ToString()); + } + + /// <summary> + /// Unsubscribe to tag + /// </summary> + /// <param name="id"></param> + /// <param name="session"></param> + public static void DeleteSubscriptionToTag(int id, Session session) + { + string data = Yammer.HttpUtility.Delete(Resources.YAMMER_RELATIONSHIPS_DELETE + "?target_type=tag" + "&target_id=" + id.ToString()); + } + } } Yammer Framework/Yammer/Subscription.cs @@ -31,7 +31,7 @@ namespace Yammer /// </summary> [DataMember(Name = "stats")] [XmlElement(ElementName = "stats")] - public UserStats Stats { get; set; } + public Stats Stats { get; set; } /// <summary> /// Short text identifier Yammer Framework/Yammer/Tag.cs @@ -4,12 +4,17 @@ using System.Linq; using System.Text; using System.Runtime.Serialization; using System.Xml.Serialization; +using System.Xml; +using System.Collections.Specialized; +using System.Reflection; namespace Yammer { [DataContract(Name = "reference")] [XmlRoot(ElementName = "reference")] public class User { + #region Yammer Properties + /// <summary> /// The object type. /// </summary> @@ -105,7 +110,7 @@ namespace Yammer /// </summary> [DataMember(Name = "stats")] [XmlElement(ElementName = "stats")] - public UserStats Stats { get; set; } + public Stats Stats { get; set; } /// <summary> /// User location @@ -115,17 +120,173 @@ namespace Yammer public string Location { get; set; } + #endregion + + internal static User GetUser(string data) + { + XmlDocument xdoc = new XmlDocument(); + xdoc.LoadXml(data); + XmlNode node = xdoc.SelectSingleNode("/response"); + User user = (User)Utility.Deserialize(typeof(User), "<reference>" + node.InnerXml + "</reference>"); + return user; + } + + internal static List<User> GetAllUsers(string data) + { + XmlDocument xdoc = new XmlDocument(); + xdoc.LoadXml(data); + + XmlNodeList nodes = xdoc.SelectNodes("/response/response"); + List<User> users = new List<User>(); + foreach (XmlNode node in nodes) + { + User user = (User)Utility.Deserialize(typeof(User), "<reference>" + node.InnerXml + "</reference>"); + users.Add(user); + } + return users; + } + + /// <summary> + /// Retreives data about current user + /// </summary> + /// <param name="session"></param> + /// <returns></returns> + public static User GetCurrentUser() + { + string response = Yammer.HttpUtility.Get(Resources.YAMMER_USERS_CURRENT); + return User.GetUser(response); + } + + /// <summary> + /// Retrieves list of users in network + /// </summary> + /// <returns></returns> + public static List<User> GetAllUsers() + { + + //string response = Yammer.HttpUtility.Get(Resources.YAMMER_USERS_ALL); + //return User.GetAllUsers(response); + if (Session.Assets == null) + Session.Assets = new Assets(); + + return Session.Assets.Users; + } + + /// <summary> + /// Retrieves list of users in network + /// </summary> + /// <param name="userParams"></param> + /// <returns></returns> + public static List<User> GetAllUsers(MembershipParameters userParams) + { + NameValueCollection parameters = new NameValueCollection(); + Yammer.Utility.AddMembershipParams(parameters, userParams); + string response = Yammer.HttpUtility.Get(Resources.YAMMER_USERS_ALL, parameters); + return User.GetAllUsers(response); + } + + public static User GetUserById(int id) + { + if (Session.Assets == null) + Session.Assets = new Assets(); + + return Session.Assets.Users.Find(delegate(User u) { return int.Parse(u.Id) == id; }); + } + + public static User GetUserById(List<User> users, int id) + { + return users.Find(delegate(User u) { return int.Parse(u.Id) == id; }); + } + + public static User GetUserByUserName(string name) + { + return Yammer.User.GetAllUsers().Find(delegate(Yammer.User u) { return u.Name.ToLower() == name.ToLower(); }); + } + + public static void Update(int id, UserParameters userParams) + { + NameValueCollection parameters = new NameValueCollection(); + AddUserParam(parameters, userParams); + string response = Yammer.HttpUtility.Put(Resources.YAMMER_USERS_MODIFY + id.ToString() + ".xml", parameters); + Session.Assets.UpdateUsers(); + } + + public static void Create(UserParameters userParams) + { + NameValueCollection parameters = new NameValueCollection(); + AddUserParam(parameters, userParams); + string response = Yammer.HttpUtility.Post(Resources.YAMMER_USERS_CREATE, parameters); + } + + public static void Delete(int id) + { + NameValueCollection parameters = new NameValueCollection(); + parameters.Add("delete", "true"); + string response = Yammer.HttpUtility.Delete(Resources.YAMMER_USERS_DELETE + id.ToString() + ".xml", parameters); + Session.Assets.UpdateUsers(); + } + + public void Delete() + { + User.Delete(int.Parse(this.Id)); + + } + + private static void AddUserParam(NameValueCollection parameters, UserParameters userParams) + { + PropertyInfo[] pic = userParams.GetType().GetProperties(); + UserAttribute name; + foreach (PropertyInfo pi in pic) + { + object value = pi.GetValue(userParams, null); + bool include = false; + if (value != null) + { + string typeName = value.GetType().Name; + switch (typeName) + { + case "String": + name = (UserAttribute)UserAttribute.GetCustomAttribute(pi, typeof(UserAttribute)); + parameters.Add(name.Name, pi.GetValue(userParams, null).ToString()); + break; + case "List`1": + name = (UserAttribute)UserAttribute.GetCustomAttribute(pi, typeof(UserAttribute)); + if (name.Name == "education[]") + { + List<UserEducation> edl = (List<UserEducation>)pi.GetValue(userParams, null); + foreach (UserEducation pc in edl) + parameters.Add(name.Name, pc.School + "," + pc.Degree + "," + pc.Description + "," + pc.StartYear + "," + pc.EndYear); + + } + else if (name.Name == "previous_companies[]") + { + List<PreviousCompany> pcl = (List<PreviousCompany>)pi.GetValue(userParams, null); + foreach (PreviousCompany pc in pcl) + parameters.Add(name.Name, pc.Company + "," + pc.Position + "," + pc.Description + "," + pc.StartYear + "," + pc.EndYear); + } + break; + default: + include = false; + break; + } + } + } + } + + public void Save(UserParameters up) + { + User.Update(int.Parse(this.Id), up); + + } } - public class UserStats + public class Stats { - [DataMember(Name = "updates")] [XmlElement(ElementName = "updates")] public string Updates { get; set; } - [DataMember(Name = "followers")] [XmlElement(ElementName = "followers")] public string Followers { get; set; } Yammer Framework/Yammer/User.cs @@ -5,6 +5,9 @@ using System.Text; using System.IO; using System.Xml; using System.Xml.Serialization; +using System.Windows.Forms; +using System.Reflection; +using System.Collections.Specialized; namespace Yammer { public class Utility @@ -13,10 +16,11 @@ namespace Yammer /// Retrieves application directory collection /// </summary> /// <returns>application directory collection</returns> - public static Dictionary<string, DirectoryInfo> GetAppDirectory() + public static Dictionary<string, DirectoryInfo> GetAppData() { Dictionary<string, DirectoryInfo> appData = new Dictionary<string, DirectoryInfo>(); - string path = System.Environment.GetFolderPath(System.Environment.SpecialFolder.ApplicationData); + + string path = System.Environment.CurrentDirectory; if (!Directory.Exists(path + "\\" + "Yammer\\Data")) Directory.CreateDirectory(path + "\\" + "Yammer\\Data"); @@ -37,7 +41,7 @@ namespace Yammer /// <returns>application<see cref="Variables"/>variables</returns> public static Variables GetApplicationData() { - Dictionary<string, DirectoryInfo> appData = Utility.GetAppDirectory(); + Dictionary<string, DirectoryInfo> appData = Utility.GetAppData(); if (System.IO.File.Exists(appData["data"] + "\\application.yam")) { XmlSerializer serializer = new XmlSerializer(typeof(Variables)); @@ -55,7 +59,7 @@ namespace Yammer /// <param name="lastMessageId"></param> public static void SetApplicationData(string lastMessageId) { - Dictionary<string, DirectoryInfo> appData = Utility.GetAppDirectory(); + Dictionary<string, DirectoryInfo> appData = Utility.GetAppData(); Variables variables = new Variables(); variables.LastMessageId = lastMessageId; TextWriter writer = new StreamWriter(appData["data"] + "\\application.yam"); @@ -63,5 +67,89 @@ namespace Yammer serializer.Serialize(writer, variables); writer.Close(); } + + + public static string GetErrorLog() + { + Dictionary<string, DirectoryInfo> appData = Utility.GetAppData(); + if (System.IO.File.Exists(appData["data"] + "\\errorlog.yam")) + { + XmlSerializer serializer = new XmlSerializer(typeof(Variables)); + TextReader reader = new StreamReader(appData["data"] + "\\errorlog.yam"); + string errorLog = reader.ReadToEnd(); + reader.Close(); + return errorLog; + } + return null; + } + + public static void SetErrorLog(string error) + { + Dictionary<string, DirectoryInfo> appData = Utility.GetAppData(); + string errorLog = GetErrorLog(); + StringBuilder sb = new StringBuilder(); + if (errorLog != null) + sb.AppendLine(errorLog); + + sb.AppendLine(error); + sb.AppendLine("**************************************************************************"); + sb.AppendLine(""); + + TextWriter writer = new StreamWriter(appData["data"] + "\\errorlog.yam"); + writer.Write(sb.ToString()); + writer.Close(); + + } + + + public static object Deserialize(Type type, string xml) + { + + XmlSerializer serializer = new XmlSerializer(type); + System.Text.ASCIIEncoding encoding = new System.Text.ASCIIEncoding(); + byte[] bytes = encoding.GetBytes(xml); + System.IO.MemoryStream stream = new MemoryStream(bytes); + object obj = (object)serializer.Deserialize(stream); + + return obj; + + } + + public static void AddMembershipParams(NameValueCollection parameters, MembershipParameters groupParams) + { + PropertyInfo[] pic = groupParams.GetType().GetProperties(); + foreach (PropertyInfo pi in pic) + { + object value = pi.GetValue(groupParams, null); + bool include = false; + if (value != null) + { + string typeName = value.GetType().Name; + switch (typeName) + { + case "Int32": + if ((int)value > 0) + include = true; + break; + case "SortBy": + if ((SortBy)value != SortBy.NONE) + include = true; + break; + default: + include = true; + break; + } + + + if (include) + { + MembershipParameterAttribute name = (MembershipParameterAttribute)MembershipParameterAttribute.GetCustomAttribute(pi, typeof(MembershipParameterAttribute)); + parameters.Add(name.Name, pi.GetValue(groupParams, null).ToString()); + } + } + } + + + } } } Yammer Framework/Yammer/Utility.cs @@ -58,6 +58,8 @@ <Reference Include="System.Xml" /> </ItemGroup> <ItemGroup> + <Compile Include="ApiWrapper.cs" /> + <Compile Include="Assets.cs" /> <Compile Include="Attachment.cs" /> <Compile Include="Auth.cs" /> <Compile Include="AutoComplete.cs" /> @@ -66,33 +68,40 @@ <Compile Include="Enumerations.cs" /> <Compile Include="File.cs" /> <Compile Include="Group.cs" /> + <Compile Include="MembershipParameters.cs" /> <Compile Include="Guide.cs" /> <Compile Include="HttpUtility.cs" /> <Compile Include="Image.cs" /> <Compile Include="Message.cs" /> + <Compile Include="MessageProperties.cs" /> + <Compile Include="PreviousCompany.cs" /> <Compile Include="Reference.cs" /> + <Compile Include="Relationship.cs" /> <Compile Include="Resources.cs" /> <Compile Include="Properties\AssemblyInfo.cs" /> <Compile Include="Security.cs" /> <Compile Include="Session.cs" /> <Compile Include="Settings.cs" /> <Compile Include="Subscription.cs" /> + <Compile Include="Suggested.cs" /> + <Compile Include="Suggestion.cs" /> <Compile Include="Tag.cs" /> <Compile Include="Thread.cs" /> <Compile Include="User.cs" /> - <Compile Include="ApiWrapper.cs" /> + <Compile Include="UserEducation.cs" /> + <Compile Include="UserParameters.cs" /> <Compile Include="Utility.cs" /> <Compile Include="Variables.cs" /> </ItemGroup> <ItemGroup> + <None Include="ClassDiagram1.cd" /> + </ItemGroup> + <ItemGroup> <ProjectReference Include="..\oAuth\oAuth.csproj"> <Project>{FA127787-7F14-4EF0-A27E-9BE55880F082}</Project> <Name>oAuth</Name> </ProjectReference> </ItemGroup> - <ItemGroup> - <None Include="ClassDiagram1.cd" /> - </ItemGroup> <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />  - <member name="M:Yammer.Auth.ReadResponse(System.String,System.String@,System.String@)"> + <member name="F:Yammer.Resources.YAMMER_MESSAGES_ALL"> <summary> - Splits the Yammer token key and token secret from the response + All messages in this network. Corresponds to the "All" tab on the website </summary> - <param name="response">The http web response</param> - <param name="tokenKey">the token key to save to</param> - <param name="tokenSecret">the token secret to save to</param> </member> - <member name="P:Yammer.Auth.Proxy"> + <member name="F:Yammer.Resources.YAMMER_MESSAGES_SENT"> <summary> - The client Web Proxy. Can be null + Alias for /api/v1/messages/from_user/logged-in_user_id.format Corresponds to the "Sent" tab on the website. </summary> - <remarks></remarks> </member> - <member name="P:Yammer.Auth.Key"> + <member name="F:Yammer.Resources.YAMMER_MESSAGES_RECEIVED"> <summary> - The OAuth key to use + Messages received by the logged-in user. Corresponds to the "Received" tab on the website. </summary> </member> - <member name="P:Yammer.Auth.ConsumerKey"> + <member name="F:Yammer.Resources.YAMMER_MESSAGES_FOLLOWING"> <summary> - The client's consumer key + Messages sent by the user with the given ID. Corresponds to the messages on a user profile page on the website. </summary> </member> - <member name="P:Yammer.Auth.ConsumerSecret"> + <member name="F:Yammer.Resources.YAMMER_MESSAGES_SENT_BY"> <summary> - The client's consumer secret + Messages sent by the user with the given ID. Corresponds to the messages on a user profile page on the website. </summary> </member> - <member name="P:Yammer.Auth.Settings"> + <member name="F:Yammer.Resources.YAMMER_MESSAGES_TAGGED_WITH"> <summary> - The persisted client settings file. + Messages including the tag with given ID. Corresponds to the messages on a tag's page on the website. </summary> </member> - <member name="P:Yammer.Auth.Success"> + <member name="F:Yammer.Resources.YAMMER_MESSAGES_IN_THREAD"> <summary> - Connection success indicator + Messages in the thread with the given ID. Corresponds to the page you'd see when clicking on "in reply to" on the website. </summary> </member> - <member name="P:Yammer.Subscription.Url"> + <member name="F:Yammer.Resources.YAMMER_MESSAGES_IN_GROUP"> <summary> - The API resource for fetching this object. + Messages in the group with the given ID. Corresponds to the messages you'd see on a group's profile page. </summary> </member> - <member name="P:Yammer.Subscription.Type"> + <member name="F:Yammer.Resources.YAMMER_MESSAGES_FAVORITES_OF"> <summary> - The object type, such as user, tag, etc. + Favorite messages of the given user ID. Can pass 'current' in place of user_id for currently logged in user </summary> </member> - <member name="T:Yammer.AutoComplete"> + <member name="F:Yammer.Resources.YAMMER_MESSAGES_CREATE"> <summary> - NOT YET IMPLEMENTED + Create a new message. </summary> </member> - <member name="M:Yammer.ApiWrapper.GetAllMessages(Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_MESSAGES_DELETE"> <summary> - All messages in this network. Corresponds to the "All" tab on the website. + Delete a message owned by the current user. </summary> - <param name="session"></param> - <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetAllMessages(Yammer.PageFlag,System.Int32,Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_MESSAGES_ADD_FAVORITE"> <summary> - Corresponds to the "All" tab on the website. + Add a message to user_id's favorite messages. </summary> - <param name="newer_than"></param> - <param name="session"></param> - <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetSentMessages(Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_MESSAGES_DELETE_FAVORITE"> <summary> - Corresponds to the "Sent" tab on the website. + Remove a favorite. </summary> - <param name="session"></param> - <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetSentMessages(Yammer.PageFlag,System.Int32,Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_GROUP_LIST"> <summary> - Corresponds to the "Sent" tab on the website. + A list of groups. </summary> - <param name="flag"></param> - <param name="thread"></param> - <param name="session"></param> - <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetReceivedMessages(Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_TAGS"> <summary> - Messages received by the logged-in user. Corresponds to the "Received" tab on the website. + Tags in this network. NOT YET IMPLEMENTED </summary> - <param name="session"></param> - <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetReceivedMessages(Yammer.PageFlag,System.Int32,Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_TAGS_DATA"> <summary> - Messages received by the logged-in user. Corresponds to the "Received" tab on the website. + View data about one tag. </summary> - <param name="flag"></param> - <param name="thread"></param> - <param name="session"></param> - <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetFollowingMessages(Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_USERS_ALL"> <summary> - Messages followed by the logged-in user. Corresponds to the "Following" tab on the website. + Users in this network. </summary> - <param name="session"></param> - <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetFollowingMessages(Yammer.PageFlag,System.Int32,Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_USERS_SINGLE"> <summary> - Messages followed by the logged-in user. Corresponds to the "Following" tab on the website. + View data about one user. </summary> - <param name="flag"></param> - <param name="date"></param> - <param name="session"></param> - <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetMessagesSentBy(System.Int32,Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_USERS_CURRENT"> <summary> - Messages sent by the user with the given ID. Corresponds to the messages on a user profile page on the website. + Alias to /api/v1/users/current user's id.format. </summary> - <param name="id"></param> - <param name="session"></param> - <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetMessagesTaggedWith(System.Int32,Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_GROUP_JOIN"> <summary> - Messages including the tag with given ID. Corresponds to the messages on a tag's page on the website. + Join a group. </summary> - <param name="id"></param> - <param name="session"></param> - <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetMessagesInThread(System.Int32,Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_GROUP_RESIGN"> <summary> - Messages in the thread with the given ID. Corresponds to the page you'd see when clicking on "in reply to" on the website. + Leave a group. </summary> - <param name="id"></param> - <param name="session"></param> - <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetMessagesInGroup(System.Int32,Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_RELATIONSHIPS_ALL"> <summary> - Messages in the group with the given ID. Corresponds to the messages you'd see on a group's profile page. + Show org chart relationships. </summary> - <param name="id"></param> - <param name="session"></param> - <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetMessagesFavoritesOf(System.Int32,Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_RELATIONSHIPS_CREATE"> <summary> - Favorite messages of the given user ID. Can pass 'current' in place of user_id for currently logged in user + Add an org chart relationship. </summary> - <param name="id"></param> - <param name="session"></param> - <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.PostMessage(System.String,Yammer.Session,System.Collections.Generic.List{System.String})"> + <member name="F:Yammer.Resources.YAMMER_RELATIONSHIPS_DELETE"> <summary> - Create a new message. + Remove a relationship. </summary> - <param name="body"></param> - <param name="session"></param> </member> - <member name="M:Yammer.ApiWrapper.PostMessage(System.String,System.Int32,Yammer.Session,System.Collections.Generic.List{System.String})"> + <member name="F:Yammer.Resources.YAMMER_SUGGESTIONS_SHOW_ALL"> <summary> - Create a new message in reply to message of given id + Show suggested groups and users. </summary> - <param name="body"></param> - <param name="reply"></param> - <param name="session"></param> </member> - <member name="M:Yammer.ApiWrapper.DeleteMessage(System.Int32,Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_SUGGESTIONS_SHOW_USERS"> <summary> - Delete a message owned by the current user. + Show only suggested users. </summary> - <param name="id"></param> - <param name="session"></param> </member> - <member name="M:Yammer.ApiWrapper.GetAllGroups(Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_SUGGESTIONS_SHOW_GROUPS"> + <summary> + Show only suggested groups. + </summary> + </member> + <member name="F:Yammer.Resources.YAMMER_SUGGESTIONS_DECLINE"> <summary> - Retrieves a list of all groups + Decline a suggestion. </summary> - <param name="session"></param> - <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetGroupById(System.Int32,Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_SUBSCRIPTIONS_TO_USER"> <summary> - Retrieves data about group of given id + Check to see if you are subscribed to the user of the given id. </summary> - <param name="id"></param> - <param name="session"></param> - <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.JoinGroup(System.Int32,Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_SUBSCRIPTIONS_TO_TAG"> <summary> - Join a group. + Check to see if you are subscribed to the tag of the given id. </summary> - <param name="id"></param> - <param name="session"></param> </member> - <member name="M:Yammer.ApiWrapper.LeaveGroup(System.Int32,Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_SUBSCRIPTIONS_SUBSCRIBE"> <summary> - Leave a group. + Subscribe to a user or tag. </summary> - <param name="id"></param> - <param name="session"></param> </member> - <member name="M:Yammer.ApiWrapper.GetCurrentUser(Yammer.Session)"> + <member name="F:Yammer.Resources.YAMMER_SUBSCRIPTIONS_UNSUBSCRIBE"> <summary> - Retreives data about current user + Unsubscribe to a user or tag. + </summary> + </member> + <member name="F:Yammer.Resources.YAMMER_AUTOCOMPLETE"> + <summary> + Return typeahead suggestions for the prefix passed + </summary> + </member> + <member name="M:Yammer.ApiWrapper.GetAllMessages(Yammer.Session)"> + <summary> + All messages in this network. Corresponds to the "All" tab on the website. </summary> <param name="session"></param> <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetUserById(System.Int32,Yammer.Session)"> + <member name="M:Yammer.ApiWrapper.GetAllMessages(Yammer.Session,System.Boolean)"> <summary> - Retrieves data about user of given id + All messages in this network. Corresponds to the "All" tab on the website. </summary> - <param name="id"></param> <param name="session"></param> + <param name="threaded">Return only the first message in each thread.</param> <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetAllUsers(Yammer.Session)"> + <member name="M:Yammer.ApiWrapper.GetAllMessages(Yammer.PageFlag,System.Int32,Yammer.Session)"> <summary> - Retrieves list of users in network + Corresponds to the "All" tab on the website. </summary> + <param name="newer_than"></param> <param name="session"></param> <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetAllRelationships(Yammer.Session)"> + <member name="M:Yammer.ApiWrapper.GetAllMessages(Yammer.PageFlag,System.Int32,System.Boolean,Yammer.Session)"> <summary> - Retrieves org chart relationships. + Corresponds to the "All" tab on the website. </summary> + <param name="newer_than"></param> + <param name="threaded">Return only the first message in each thread.</param> <param name="session"></param> + <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.CreateRelationship(Yammer.RelationshipType,System.String,Yammer.Session)"> + <member name="M:Yammer.ApiWrapper.GetSentMessages(Yammer.Session)"> <summary> - Creates a new org chart relationship + Corresponds to the "Sent" tab on the website. </summary> - <param name="type"></param> - <param name="email"></param> <param name="session"></param> + <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.DeleteRelationship"> + <member name="M:Yammer.ApiWrapper.GetSentMessages(Yammer.Session,System.Boolean)"> <summary> - Deletes org chart relationship - NOT YET IMPLEMENTED + Corresponds to the "Sent" tab on the website. </summary> + <param name="session"></param> + <param name="threaded">Return only the first message in each thread.</param> + <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.GetAllSuggestions(Yammer.Session)"> + <member name="M:Yammer.ApiWrapper.GetSentMessages(Yammer.PageFlag,System.Int32,Yammer.Session)"> <summary> - Returns list of all suggested groups and users - NOT YET IMPLEMENTED + Corresponds to the "Sent" tab on the website. </summary> + <param name="flag"></param> + <param name="threaded"></param> <param name="session"></param> + <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.SubscribeToUser(System.Int32,Yammer.Session)"> + <member name="M:Yammer.ApiWrapper.GetSentMessages(Yammer.PageFlag,System.Int32,System.Boolean,Yammer.Session)"> <summary> - Subscribe to user + Corresponds to the "Sent" tab on the website. </summary> - <param name="id"></param> + <param name="flag"></param> + <param name="threaded"></param> <param name="session"></param> + <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.SubscribeToTag(System.Int32,Yammer.Session)"> + <member name="M:Yammer.ApiWrapper.GetReceivedMessages(Yammer.Session)"> <summary> - Subscribe to tag + Messages received by the logged-in user. Corresponds to the "Received" tab on the website. </summary> - <param name="id"></param> <param name="session"></param> + <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.DeleteSubscriptionToUser(System.Int32,Yammer.Session)"> + <member name="M:Yammer.ApiWrapper.GetReceivedMessages(Yammer.Session,System.Boolean)"> <summary> - Unsubscribe to user + Messages received by the logged-in user. Corresponds to the "Received" tab on the website. </summary> - <param name="id"></param> <param name="session"></param> + <returns></returns> </member> - <member name="M:Yammer.ApiWrapper.DeleteSubscriptionToTag(System.Int32,Yammer.Session)"> + <member name="M:Yammer.ApiWrapper.GetReceivedMessages(Yammer.PageFlag,System.Int32,Yammer.Session)"> <summary> - Unsubscribe to tag + Messages received by the logged-in user. Corresponds to the "Received" tab on the website. </summary> - <param name="id"></param> + <param name="flag"></param> + <param name="thread"></param> <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Group.Type"> + <member name="M:Yammer.ApiWrapper.GetReceivedMessages(Yammer.PageFlag,System.Int32,System.Boolean,Yammer.Session)"> <summary> - The object type, such as user, tag, etc. + Messages received by the logged-in user. Corresponds to the "Received" tab on the website. </summary> + <param name="flag"></param> + <param name="thread"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Group.Id"> + <member name="M:Yammer.ApiWrapper.GetFollowingMessages(Yammer.Session)"> <summary> - The ID number for this object. Note that IDs are not unique across all object types: - there may be a user and tag with the same numerical ID. + Messages followed by the logged-in user. Corresponds to the "Following" tab on the website. </summary> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Group.FullName"> + <member name="M:Yammer.ApiWrapper.GetFollowingMessages(Yammer.Session,System.Boolean)"> <summary> - Name given to this group. + Messages followed by the logged-in user. Corresponds to the "Following" tab on the website. </summary> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Group.Name"> + <member name="M:Yammer.ApiWrapper.GetFollowingMessages(Yammer.PageFlag,System.Int32,Yammer.Session)"> <summary> - Shortened name of this group. Used in references (@salesteam), addressing (to:salesteam), - the email address for group updates (salesteam@yammer.com) and the web URL (www.yammer.com/groups/salesteam). + Messages followed by the logged-in user. Corresponds to the "Following" tab on the website. </summary> + <param name="flag"></param> + <param name="date"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Group.Privacy"> + <member name="M:Yammer.ApiWrapper.GetFollowingMessages(Yammer.PageFlag,System.Int32,System.Boolean,Yammer.Session)"> <summary> - Either public or private, to indicate whether updates are visible to non-members - (public) and whether joining requires a group admin's approval (private). + Messages followed by the logged-in user. Corresponds to the "Following" tab on the website. </summary> + <param name="flag"></param> + <param name="date"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Group.Url"> + <member name="M:Yammer.ApiWrapper.GetMessagesSentBy(System.Int32,Yammer.Session)"> <summary> - The API resource for fetching this object. + Messages sent by the user with the given ID. Corresponds to the messages on a user profile page on the website. </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Group.WebUrl"> + <member name="M:Yammer.ApiWrapper.GetMessagesSentBy(System.Int32,Yammer.Session,System.Boolean)"> <summary> - The URL for viewing this object on the main Yammer website. + Messages sent by the user with the given ID. Corresponds to the messages on a user profile page on the website. </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Group.Stats"> + <member name="M:Yammer.ApiWrapper.GetMessagesSentBy(Yammer.PageFlag,System.Int32,System.Int32,Yammer.Session)"> <summary> - Group stats + Messages sent by the user with the given ID. Corresponds to the messages on a user profile page on the website. </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="M:Yammer.Settings.CheckConfiguration"> + <member name="M:Yammer.ApiWrapper.GetMessagesSentBy(Yammer.PageFlag,System.Int32,System.Int32,System.Boolean,Yammer.Session)"> <summary> - Checks if the persisted <see cref="T:Yammer.Settings">settings</see> file exists on the client + Messages sent by the user with the given ID. Corresponds to the messages on a user profile page on the website. </summary> + <param name="id"></param> + <param name="session"></param> <returns></returns> </member> - <member name="M:Yammer.Settings.SaveConfiguration(System.String,System.String,OAuth.OAuthKey,System.Net.WebProxy)"> + <member name="M:Yammer.ApiWrapper.GetMessagesTaggedWith(System.Int32,Yammer.Session)"> <summary> - Saves the <see cref="T:Yammer.Settings">settings</see> file to the client + Messages including the tag with given ID. Corresponds to the messages on a tag's page on the website. </summary> - <param name="tokenKey"></param> - <param name="tokenSecret"></param> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Guide.Type"> + <member name="M:Yammer.ApiWrapper.GetMessagesTaggedWith(System.Int32,Yammer.Session,System.Boolean)"> <summary> - The object type. + Messages including the tag with given ID. Corresponds to the messages on a tag's page on the website. </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Guide.Id"> + <member name="M:Yammer.ApiWrapper.GetMessagesTaggedWith(Yammer.PageFlag,System.Int32,System.Int32,Yammer.Session)"> <summary> - The ID number for this object. Note that IDs are not unique across all object types: - there may be a user and tag with the same numerical ID. + Messages including the tag with given ID. Corresponds to the messages on a tag's page on the website. </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Guide.Name"> + <member name="M:Yammer.ApiWrapper.GetMessagesTaggedWith(Yammer.PageFlag,System.Int32,System.Int32,Yammer.Session,System.Boolean)"> <summary> - The name of this guide + Messages including the tag with given ID. Corresponds to the messages on a tag's page on the website. </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Guide.FullName"> + <member name="M:Yammer.ApiWrapper.GetMessagesInGroup(System.Int32,Yammer.Session)"> <summary> - The guide's full name. + Messages in the group with the given ID. Corresponds to the messages you'd see on a group's profile page. </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Guide.MugshotUrl"> + <member name="M:Yammer.ApiWrapper.GetMessagesInGroup(System.Int32,Yammer.Session,System.Boolean)"> <summary> - The URL of this guide's picture. + Messages in the group with the given ID. Corresponds to the messages you'd see on a group's profile page. </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Guide.WebUrl"> + <member name="M:Yammer.ApiWrapper.GetMessagesInGroup(Yammer.PageFlag,System.Int32,System.Int32,Yammer.Session)"> <summary> - The URL for viewing this object on the main Yammer website. + Messages in the group with the given ID. Corresponds to the messages you'd see on a group's profile page. </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Body.Plain"> + <member name="M:Yammer.ApiWrapper.GetMessagesInGroup(Yammer.PageFlag,System.Int32,System.Int32,Yammer.Session,System.Boolean)"> <summary> - A plaintext version of the message body. + Messages in the group with the given ID. Corresponds to the messages you'd see on a group's profile page. </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Body.Parsed"> + <member name="M:Yammer.ApiWrapper.GetMessagesFavoritesOf(System.Int32,Yammer.Session)"> <summary> - A version of the message body with #tags and @users replaced by [[object:id]]. - This is not present in the reference version of a message. + Favorite messages of the given user ID. Can pass 'current' in place of user_id for currently logged in user </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.User.Type"> + <member name="M:Yammer.ApiWrapper.GetMessagesFavoritesOf(System.Int32,Yammer.Session,System.Boolean)"> <summary> - The object type. + Favorite messages of the given user ID. Can pass 'current' in place of user_id for currently logged in user </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.User.Id"> + <member name="M:Yammer.ApiWrapper.GetMessagesFavoritesOf(Yammer.PageFlag,System.Int32,System.Int32,Yammer.Session)"> <summary> - The ID number for this object. Note that IDs are not unique across all object types: - there may be a user and tag with the same numerical ID. + Favorite messages of the given user ID. Can pass 'current' in place of user_id for currently logged in user </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.User.Name"> + <member name="M:Yammer.ApiWrapper.GetMessagesFavoritesOf(Yammer.PageFlag,System.Int32,System.Int32,Yammer.Session,System.Boolean)"> <summary> - The username of this user. + Favorite messages of the given user ID. Can pass 'current' in place of user_id for currently logged in user </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.User.FullName"> + <member name="M:Yammer.ApiWrapper.GetMessagesInThread(System.Int32,Yammer.Session)"> <summary> - The user's full name. + Messages in the thread with the given ID. Corresponds to the page you'd see when clicking on "in reply to" on the website. </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.User.MugshotUrl"> + <member name="M:Yammer.ApiWrapper.GetMessagesInThread(Yammer.PageFlag,System.Int32,System.Int32,Yammer.Session)"> <summary> - The URL of this user's picture. + Messages in the thread with the given ID. Corresponds to the page you'd see when clicking on "in reply to" on the website. </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.User.Url"> + <member name="M:Yammer.ApiWrapper.PostMessage(System.String,Yammer.Session,System.Collections.Generic.List{System.String})"> <summary> - The API resource for fetching this object. + Create a new message. </summary> + <param name="body"></param> + <param name="session"></param> </member> - <member name="P:Yammer.User.WebUrl"> + <member name="M:Yammer.ApiWrapper.PostMessage(System.String,System.Int32,Yammer.Session,System.Collections.Generic.List{System.String})"> <summary> - The URL for viewing this object on the main Yammer website. + Sends message in reply to message of given id </summary> + <param name="body"></param> + <param name="reply"></param> + <param name="session"></param> </member> - <member name="P:Yammer.User.JobTitle"> + <member name="M:Yammer.ApiWrapper.PostMessage(System.Int32,System.String,Yammer.Session,System.Collections.Generic.List{System.String})"> <summary> - User's job title + Sends a private message directly to the user indicated. </summary> + <param name="directToId"></param> + <param name="body"></param> + <param name="session"></param> + <param name="attachments"></param> + <returns></returns> </member> - <member name="P:Yammer.User.Contact"> + <member name="M:Yammer.ApiWrapper.PostMessage(System.String,Yammer.Session,System.Int32,System.Collections.Generic.List{System.String})"> <summary> - User's contact information + Sends a message to the group indicated </summary> + <param name="body"></param> + <param name="session"></param> + <param name="groupId"></param> + <param name="attachments"></param> + <returns></returns> </member> - <member name="P:Yammer.User.NetworkId"> + <member name="M:Yammer.ApiWrapper.DeleteMessage(System.Int32,Yammer.Session)"> <summary> - The network id of the user + Delete a message owned by the current user. </summary> + <param name="id"></param> + <param name="session"></param> </member> - <member name="P:Yammer.User.HireDate"> + <member name="M:Yammer.ApiWrapper.GetAllGroups(Yammer.Session)"> <summary> - User's date of hire + Retrieves a list of all groups </summary> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.User.NetworkName"> + <member name="M:Yammer.ApiWrapper.GetGroupById(System.Int32,Yammer.Session)"> <summary> - The network name of the user + Retrieves data about group of given id </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.User.Stats"> + <member name="M:Yammer.ApiWrapper.JoinGroup(System.Int32,Yammer.Session)"> <summary> - User's stats + Join a group. </summary> + <param name="id"></param> + <param name="session"></param> </member> - <member name="P:Yammer.User.Location"> + <member name="M:Yammer.ApiWrapper.LeaveGroup(System.Int32,Yammer.Session)"> <summary> - User location + Leave a group. </summary> + <param name="id"></param> + <param name="session"></param> </member> - <member name="P:Yammer.Message.Id"> + <member name="M:Yammer.ApiWrapper.GetCurrentUser(Yammer.Session)"> <summary> - The ID number for this object. Note that IDs are not unique across all object types: - there may be a user and tag with the same numerical ID. + Retreives data about current user </summary> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Message.GroupId"> + <member name="M:Yammer.ApiWrapper.GetUserById(System.Int32,Yammer.Session)"> <summary> - (Optional) When a message is posted into a group, that group's ID will appear here - and the group will be available in the references section. + Retrieves data about user of given id </summary> + <param name="id"></param> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Message.DirectToId"> + <member name="M:Yammer.ApiWrapper.GetAllUsers(Yammer.Session)"> <summary> - (Optional) When a message is a private 1-to-1 (or "direct") message, this will - indicate the intended recipient. + Retrieves list of users in network </summary> + <param name="session"></param> + <returns></returns> </member> - <member name="P:Yammer.Message.Url"> + <member name="M:Yammer.ApiWrapper.GetAllRelationships(Yammer.Session)"> <summary> - The API resource for fetching this object. + Retrieves org chart relationships. </summary> + <param name="session"></param> </member> - <member name="P:Yammer.Message.WebUrl"> + <member name="M:Yammer.ApiWrapper.CreateRelationship(Yammer.RelationshipType,System.String,Yammer.Session)"> <summary> - The URL for viewing this object on the main Yammer website. + Creates a new org chart relationship </summary> + <param name="type"></param> + <param name="email"></param> + <param name="session"></param> </member> - <member name="P:Yammer.Message.RepliedToId"> + <member name="M:Yammer.ApiWrapper.DeleteRelationship(Yammer.Session,System.Int32,Yammer.RelationshipType)"> <summary> - The ID of the message this message is in reply to, if applicable. + Deletes org chart relationship </summary> </member> - <member name="P:Yammer.Message.ThreadId"> + <member name="M:Yammer.ApiWrapper.GetAllSuggestions(Yammer.Session)"> <summary> - The thread in which this message appears. + Returns list of all suggested groups and users </summary> + <param name="session"></param> </member> - <member name="P:Yammer.Message.Body"> + <member name="M:Yammer.ApiWrapper.GetSuggestedUsers(Yammer.Session)"> <summary> - Message body + Returns list of all suggested users + NOT YET IMPLEMENTED </summary> + <param name="session"></param> </member> - <member name="P:Yammer.Message.Attachments"> + <member name="M:Yammer.ApiWrapper.GetSuggestedGroups(Yammer.Session)"> <summary> - A list of attachments for this message. + Returns list of all suggested groups + NOT YET IMPLEMENTED </summary> + <param name="session"></param> </member> - <member name="P:Yammer.Message.MessageType"> + <member name="M:Yammer.ApiWrapper.SubscribeToUser(System.Int32,Yammer.Session)"> <summary> - This will be system or update. A system message is automatically generated by the - system and describes an action, such as "Kris Gale has joined the Geni network." - An update message is a regular message posted by a user such as "Kris Gale: Hi everyone." - Put simply, this indicates whether a colon will separate the body of the message - from the sender's name in the web interface. + Subscribe to user </summary> + <param name="id"></param> + <param name="session"></param> </member> - <member name="P:Yammer.Message.SenderId"> + <member name="M:Yammer.ApiWrapper.SubscribeToTag(System.Int32,Yammer.Session)"> <summary> - The ID of the message's sender. + Subscribe to tag </summary> + <param name="id"></param> + <param name="session"></param> </member> - <member name="P:Yammer.Message.SenderType"> + <member name="M:Yammer.ApiWrapper.DeleteSubscriptionToUser(System.Int32,Yammer.Session)"> <summary> - The sender's object type: user or guide. The guide is virtual user that exists - in the system to send messages such as the tips and initial welcome message. + Unsubscribe to user </summary> + <param name="id"></param> + <param name="session"></param> </member> - <member name="P:Yammer.Message.CreatedAt"> + <member name="M:Yammer.ApiWrapper.DeleteSubscriptionToTag(System.Int32,Yammer.Session)"> <summary> - The time and date this resource was created. This would indicate when a - user joined the network or when a message was posted. + Unsubscribe to tag </summary> + <param name="id"></param> + <param name="session"></param> </member> <member name="P:Yammer.Thread.Type"> <summary> @@ -614,6 +669,24 @@ Thread stats </summary> </member> + <member name="T:Yammer.AutoComplete"> + <summary> + NOT YET IMPLEMENTED + </summary> + </member> + <member name="M:Yammer.Settings.CheckConfiguration"> + <summary> + Checks if the persisted <see cref="T:Yammer.Settings">settings</see> file exists on the client + </summary> + <returns></returns> + </member> + <member name="M:Yammer.Settings.SaveConfiguration(System.String,System.String,OAuth.OAuthKey,System.Net.WebProxy)"> + <summary> + Saves the <see cref="T:Yammer.Settings">settings</see> file to the client + </summary> + <param name="tokenKey"></param> + <param name="tokenSecret"></param> + </member> <member name="M:Yammer.HttpUtility.Get(System.String,Yammer.Session)"> <summary> Creates http get web request and returns response @@ -650,6 +723,14 @@ <param name="session">The Yammer<see cref="T:Yammer.Session">session</see> object</param> <returns>http response</returns> </member> + <member name="M:Yammer.HttpUtility.Delete(System.String,System.Collections.Specialized.NameValueCollection,Yammer.Session)"> + <summary> + Creates http delete web request and returns response + </summary> + <param name="url">The URL for the web request</param> + <param name="session">The Yammer<see cref="T:Yammer.Session">session</see> object</param> + <returns>http response</returns> + </member> <member name="M:Yammer.HttpUtility.CreateAuthHeader(Yammer.WebMethod,System.String,System.String,System.String,Yammer.Session)"> <summary> Creates the OAuth header for the http request @@ -736,37 +817,144 @@ <param name="parameters">The query string parameters</param> <param name="request">The http request to write to</param> </member> - <member name="P:Yammer.Tag.Type"> + <member name="M:Yammer.Utility.GetAppData"> + <summary> + Retrieves application directory collection + </summary> + <returns>application directory collection</returns> + </member> + <member name="M:Yammer.Utility.GetApplicationData"> + <summary> + Retrieves application variables + </summary> + <returns>application<see cref="T:Yammer.Variables"/>variables</returns> + </member> + <member name="M:Yammer.Utility.SetApplicationData(System.String)"> + <summary> + Writes application variables to client computer + </summary> + <param name="lastMessageId"></param> + </member> + <member name="M:Yammer.Auth.GetRequestTokenQuery(System.String,System.String)"> + <summary> + Retrieves the OAuth request token + </summary> + <param name="consumerKey">The client's consumer key</param> + <param name="consumerSecret">The client's consumer secret</param> + <returns>the request token query string</returns> + </member> + <member name="M:Yammer.Auth.GetAuthorizeQuery(System.String,System.String)"> + <summary> + Retrieves the OAuth authorization token + </summary> + <param name="tokenKey">The generated OAuth Token</param> + <param name="callback">The callback URL for the client</param> + <returns>the OAuth authorization query string</returns> + </member> + <member name="M:Yammer.Auth.GetAccessTokenQuery(System.String)"> + <summary> + Retrieves OAuth access token + </summary> + <returns>the OAuth access token query string</returns> + </member> + <member name="M:Yammer.Auth.GetRequestToken(System.Net.WebProxy,System.String,System.String)"> + <summary> + retrieves the <see cref="T:Yammer.Auth">authorization object</see> + </summary> + <param name="proxy"></param> + <param name="consumerKey"></param> + <param name="consumerSecret"></param> + <returns>The <see cref="T:Yammer.Auth">authorization object</see></returns> + </member> + <member name="M:Yammer.Auth.Authorize(System.String)"> + <summary> + Opens web browser for authorization + </summary> + <param name="callbackUrl"></param> + </member> +  + <member name="M:Yammer.Auth.ReadResponse(System.String,System.String@,System.String@)"> + <summary> + Splits the Yammer token key and token secret from the response + </summary> + <param name="response">The http web response</param> + <param name="tokenKey">the token key to save to</param> + <param name="tokenSecret">the token secret to save to</param> + </member> + <member name="P:Yammer.Auth.Proxy"> + <summary> + The client Web Proxy. Can be null + </summary> + <remarks></remarks> + </member> + <member name="P:Yammer.Auth.Key"> + <summary> + The OAuth key to use + </summary> + </member> + <member name="P:Yammer.Auth.ConsumerKey"> + <summary> + The client's consumer key + </summary> + </member> + <member name="P:Yammer.Auth.ConsumerSecret"> + <summary> + The client's consumer secret + </summary> + </member> + <member name="P:Yammer.Auth.Settings"> + <summary> + The persisted client settings file. + </summary> + </member> + <member name="P:Yammer.Auth.Success"> + <summary> + Connection success indicator + </summary> + </member> + <member name="P:Yammer.Group.Type"> <summary> The object type, such as user, tag, etc. </summary> </member> - <member name="P:Yammer.Tag.Id"> + <member name="P:Yammer.Group.Id"> <summary> The ID number for this object. Note that IDs are not unique across all object types: there may be a user and tag with the same numerical ID. </summary> </member> - <member name="P:Yammer.Tag.Stats"> + <member name="P:Yammer.Group.FullName"> <summary> - Tag stats + Name given to this group. </summary> </member> - <member name="P:Yammer.Tag.Name"> + <member name="P:Yammer.Group.Name"> <summary> - Short text identifier + Shortened name of this group. Used in references (@salesteam), addressing (to:salesteam), + the email address for group updates (salesteam@yammer.com) and the web URL (www.yammer.com/groups/salesteam). </summary> </member> - <member name="P:Yammer.Tag.Url"> + <member name="P:Yammer.Group.Privacy"> + <summary> + Either public or private, to indicate whether updates are visible to non-members + (public) and whether joining requires a group admin's approval (private). + </summary> + </member> + <member name="P:Yammer.Group.Url"> <summary> The API resource for fetching this object. </summary> </member> - <member name="P:Yammer.Tag.WebUrl"> + <member name="P:Yammer.Group.WebUrl"> <summary> The URL for viewing this object on the main Yammer website. </summary> </member> + <member name="P:Yammer.Group.Stats"> + <summary> + Group stats + </summary> + </member> <member name="F:Yammer.Attachment.filename"> <summary> The filename of the filepart to be uploaded. @@ -827,174 +1015,191 @@ Gets the length of the data to be sent. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_MESSAGES_ALL"> + <member name="P:Yammer.Message.Id"> <summary> - All messages in this network. Corresponds to the "All" tab on the website + The ID number for this object. Note that IDs are not unique across all object types: + there may be a user and tag with the same numerical ID. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_MESSAGES_SENT"> + <member name="P:Yammer.Message.GroupId"> <summary> - Alias for /api/v1/messages/from_user/logged-in_user_id.format Corresponds to the "Sent" tab on the website. + (Optional) When a message is posted into a group, that group's ID will appear here + and the group will be available in the references section. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_MESSAGES_RECEIVED"> + <member name="P:Yammer.Message.DirectToId"> <summary> - Messages received by the logged-in user. Corresponds to the "Received" tab on the website. + (Optional) When a message is a private 1-to-1 (or "direct") message, this will + indicate the intended recipient. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_MESSAGES_FOLLOWING"> + <member name="P:Yammer.Message.Url"> <summary> - Messages sent by the user with the given ID. Corresponds to the messages on a user profile page on the website. + The API resource for fetching this object. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_MESSAGES_SENT_BY"> + <member name="P:Yammer.Message.WebUrl"> <summary> - Messages sent by the user with the given ID. Corresponds to the messages on a user profile page on the website. + The URL for viewing this object on the main Yammer website. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_MESSAGES_TAGGED_WITH"> + <member name="P:Yammer.Message.RepliedToId"> <summary> - Messages including the tag with given ID. Corresponds to the messages on a tag's page on the website. + The ID of the message this message is in reply to, if applicable. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_MESSAGES_IN_THREAD"> + <member name="P:Yammer.Message.ThreadId"> <summary> - Messages in the thread with the given ID. Corresponds to the page you'd see when clicking on "in reply to" on the website. + The thread in which this message appears. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_MESSAGES_IN_GROUP"> + <member name="P:Yammer.Message.Body"> <summary> - Messages in the group with the given ID. Corresponds to the messages you'd see on a group's profile page. + Message body </summary> </member> - <member name="F:Yammer.Resources.YAMMER_MESSAGES_FAVORITES_OF"> + <member name="P:Yammer.Message.Attachments"> <summary> - Favorite messages of the given user ID. Can pass 'current' in place of user_id for currently logged in user + A list of attachments for this message. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_MESSAGES_CREATE"> + <member name="P:Yammer.Message.MessageType"> <summary> - Create a new message. + This will be system or update. A system message is automatically generated by the + system and describes an action, such as "Kris Gale has joined the Geni network." + An update message is a regular message posted by a user such as "Kris Gale: Hi everyone." + Put simply, this indicates whether a colon will separate the body of the message + from the sender's name in the web interface. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_MESSAGES_DELETE"> + <member name="P:Yammer.Message.SenderId"> <summary> - Delete a message owned by the current user. + The ID of the message's sender. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_MESSAGES_ADD_FAVORITE"> + <member name="P:Yammer.Message.SenderType"> <summary> - Add a message to user_id's favorite messages. + The sender's object type: user or guide. The guide is virtual user that exists + in the system to send messages such as the tips and initial welcome message. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_MESSAGES_DELETE_FAVORITE"> + <member name="P:Yammer.Message.CreatedAt"> <summary> - Remove a favorite. + The time and date this resource was created. This would indicate when a + user joined the network or when a message was posted. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_GROUP_LIST"> + <member name="P:Yammer.Guide.Type"> <summary> - A list of groups. + The object type. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_GROUP_DATA"> + <member name="P:Yammer.Guide.Id"> <summary> - https://www.yammer.com/api/v1/groups/id.format + The ID number for this object. Note that IDs are not unique across all object types: + there may be a user and tag with the same numerical ID. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_TAGS"> + <member name="P:Yammer.Guide.Name"> <summary> - Tags in this network. NOT YET IMPLEMENTED + The name of this guide </summary> </member> - <member name="F:Yammer.Resources.YAMMER_TAGS_DATA"> + <member name="P:Yammer.Guide.FullName"> <summary> - View data about one tag. + The guide's full name. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_USERS_ALL"> + <member name="P:Yammer.Guide.MugshotUrl"> <summary> - Users in this network. + The URL of this guide's picture. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_USERS_SINGLE"> + <member name="P:Yammer.Guide.WebUrl"> <summary> - View data about one user. + The URL for viewing this object on the main Yammer website. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_USERS_CURRENT"> + <member name="P:Yammer.User.Type"> <summary> - Alias to /api/v1/users/current user's id.format. + The object type. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_GROUP_JOIN"> + <member name="P:Yammer.User.Id"> <summary> - Join a group. + The ID number for this object. Note that IDs are not unique across all object types: + there may be a user and tag with the same numerical ID. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_GROUP_RESIGN"> + <member name="P:Yammer.User.Name"> <summary> - Leave a group. + The username of this user. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_RELATIONSHIPS_ALL"> + <member name="P:Yammer.User.FullName"> <summary> - Show org chart relationships. + The user's full name. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_RELATIONSHIPS_CREATE"> + <member name="P:Yammer.User.MugshotUrl"> <summary> - Add an org chart relationship. + The URL of this user's picture. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_RELATIONSHIPS_DELETE"> + <member name="P:Yammer.User.Url"> <summary> - Remove a relationship. + The API resource for fetching this object. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_SUGGESTIONS_SHOW_ALL"> + <member name="P:Yammer.User.WebUrl"> <summary> - Show suggested groups and users. + The URL for viewing this object on the main Yammer website. </summary> </member> - <member name="F:Yammer.Resources.YAMMER_SUGGESTIONS_SHOW_USERS"> + <member name="P:Yammer.User.JobTitle"> <summary> - Show only suggested users. + User's job title </summary> </member> - <member name="F:Yammer.Resources.YAMMER_SUGGESTIONS_SHOW_GROUPS"> + <member name="P:Yammer.User.Contact"> <summary> - Show only suggested groups. + User's contact information </summary> </member> - <member name="F:Yammer.Resources.YAMMER_SUGGESTIONS_DECLINE"> + <member name="P:Yammer.User.NetworkId"> <summary> - Decline a suggestion. + The network id of the user </summary> </member> - <member name="F:Yammer.Resources.YAMMER_SUBSCRIPTIONS_TO_USER"> + <member name="P:Yammer.User.HireDate"> <summary> - Check to see if you are subscribed to the user of the given id. + User's date of hire </summary> </member> - <member name="F:Yammer.Resources.YAMMER_SUBSCRIPTIONS_TO_TAG"> + <member name="P:Yammer.User.NetworkName"> <summary> - Check to see if you are subscribed to the tag of the given id. + The network name of the user </summary> </member> - <member name="F:Yammer.Resources.YAMMER_SUBSCRIPTIONS_SUBSCRIBE"> + <member name="P:Yammer.User.Stats"> <summary> - Subscribe to a user or tag. + User's stats </summary> </member> - <member name="F:Yammer.Resources.YAMMER_SUBSCRIPTIONS_UNSUBSCRIBE"> + <member name="P:Yammer.User.Location"> <summary> - Unsubscribe to a user or tag. + User location </summary> </member> - <member name="F:Yammer.Resources.YAMMER_AUTOCOMPLETE"> + <member name="P:Yammer.Body.Plain"> <summary> - Return typeahead suggestions for the prefix passed + A plaintext version of the message body. + </summary> + </member> + <member name="P:Yammer.Body.Parsed"> + <summary> + A version of the message body with #tags and @users replaced by [[object:id]]. + This is not present in the reference version of a message. </summary> </member> </members> Yammer Framework/Yammer/bin/Release/Yammer.XML Yammer Framework/Yammer/bin/Release/Yammer.dll Yammer Framework/Yammer/bin/Release/Yammer.pdb Yammer Framework/Yammer/bin/Release/oAuth.dll Yammer Framework/Yammer/bin/Release/oAuth.pdb @@ -4,49 +4,6 @@ <name>oAuth</name> </assembly> <members> - <member name="T:OAuth.Rfc3986"> - <summary> - Performs RFC 3986 encoding and decoding. - http://www.apps.ietf.org/rfc/rfc3986.html - </summary> - </member> - <member name="M:OAuth.Rfc3986.EncodeAndJoin(System.Collections.Specialized.NameValueCollection)"> - <summary> - Join the name-value pairs into a string seperated with ampersands. - Each name and value is first RFC 3986 encoded and values are separated - from names with equal signs. - </summary> - <param name="values">The name value collection to encode and join</param> - <returns>An RFC 3986 compliant string</returns> - </member> - <member name="M:OAuth.Rfc3986.SplitAndDecode(System.String)"> - <summary> - Splits a ampersand-separated list of key-value pairs, decodes the keys and - values, and adds them to a NameValueCollection. Keys and values are separated - by equals signs. - </summary> - <param name="input">The key-value pair list</param> - <returns>A name value collection, which may be empty.</returns> - <exception cref="T:System.FormatException"> - If the string is not a series of key-value pairs separated by ampersands, - or if one of the keys is null or empty, or if one of the keys or values is - not properly encoded. - </exception> - </member> - <member name="M:OAuth.Rfc3986.Encode(System.String)"> - <summary> - Perform RFC 3986 Percent-encoding on a string. - </summary> - <param name="input">The input string</param> - <returns>The RFC 3986 Percent-encoded string</returns> - </member> - <member name="M:OAuth.Rfc3986.Decode(System.String)"> - <summary> - Perform RFC 3986 Percent-decoding on a string. - </summary> - <param name="input">The input RFC 3986 Percent-encoded string</param> - <returns>The decoded string</returns> - </member> <member name="M:OAuth.OAuthBase.ComputeHash(System.Security.Cryptography.HashAlgorithm,System.String)"> <summary> Helper function to compute a hash value @@ -149,5 +106,48 @@ Comparer class used to perform the sorting of the query parameters </summary> </member> + <member name="T:OAuth.Rfc3986"> + <summary> + Performs RFC 3986 encoding and decoding. + http://www.apps.ietf.org/rfc/rfc3986.html + </summary> + </member> + <member name="M:OAuth.Rfc3986.EncodeAndJoin(System.Collections.Specialized.NameValueCollection)"> + <summary> + Join the name-value pairs into a string seperated with ampersands. + Each name and value is first RFC 3986 encoded and values are separated + from names with equal signs. + </summary> + <param name="values">The name value collection to encode and join</param> + <returns>An RFC 3986 compliant string</returns> + </member> + <member name="M:OAuth.Rfc3986.SplitAndDecode(System.String)"> + <summary> + Splits a ampersand-separated list of key-value pairs, decodes the keys and + values, and adds them to a NameValueCollection. Keys and values are separated + by equals signs. + </summary> + <param name="input">The key-value pair list</param> + <returns>A name value collection, which may be empty.</returns> + <exception cref="T:System.FormatException"> + If the string is not a series of key-value pairs separated by ampersands, + or if one of the keys is null or empty, or if one of the keys or values is + not properly encoded. + </exception> + </member> + <member name="M:OAuth.Rfc3986.Encode(System.String)"> + <summary> + Perform RFC 3986 Percent-encoding on a string. + </summary> + <param name="input">The input string</param> + <returns>The RFC 3986 Percent-encoded string</returns> + </member> + <member name="M:OAuth.Rfc3986.Decode(System.String)"> + <summary> + Perform RFC 3986 Percent-decoding on a string. + </summary> + <param name="input">The input RFC 3986 Percent-encoded string</param> + <returns>The decoded string</returns> + </member> </members> </doc> Yammer Framework/Yammer/bin/Release/oAuth.xml Yammer Framework/Yammer/obj/Debug/Refactor/Yammer.dll Yammer Framework/Yammer/obj/Debug/ResolveAssemblyReference.cache @@ -1,28 +1,36 @@ -C:\ContextMenu\CuttingEdge0502\ContextMenu\Yammer\Yammer\obj\Debug\ResolveAssemblyReference.cache -C:\ContextMenu\CuttingEdge0502\ContextMenu\Yammer\Yammer\bin\Debug\Yammer.dll -C:\ContextMenu\CuttingEdge0502\ContextMenu\Yammer\Yammer\bin\Debug\Yammer.pdb -C:\ContextMenu\CuttingEdge0502\ContextMenu\Yammer\Yammer\obj\Debug\Yammer.dll -C:\ContextMenu\CuttingEdge0502\ContextMenu\Yammer\Yammer\obj\Debug\Yammer.pdb -C:\ContextMenu\CuttingEdge0502\ContextMenu\Yammer\Yammer\bin\Debug\oAuth.dll -C:\ContextMenu\CuttingEdge0502\ContextMenu\Yammer\Yammer\bin\Debug\oAuth.pdb -C:\Documents and Settings\kdavie\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\bin\Debug\Yammer.dll -C:\Documents and Settings\kdavie\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\bin\Debug\Yammer.pdb -C:\Documents and Settings\kdavie\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\obj\Debug\ResolveAssemblyReference.cache -C:\Documents and Settings\kdavie\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\obj\Debug\Yammer.dll -C:\Documents and Settings\kdavie\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\obj\Debug\Yammer.pdb -C:\Documents and Settings\kdavie\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\bin\Debug\oAuth.dll -C:\Documents and Settings\kdavie\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\bin\Debug\oAuth.pdb -C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\bin\Debug\Yammer.dll -C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\bin\Debug\Yammer.pdb -C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\obj\Debug\ResolveAssemblyReference.cache -C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\obj\Debug\Yammer.dll -C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\obj\Debug\Yammer.pdb -C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\bin\Debug\oAuth.dll -C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\bin\Debug\oAuth.pdb -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\bin\Debug\Yammer.dll -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\bin\Debug\Yammer.pdb -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\bin\Debug\oAuth.dll -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\bin\Debug\oAuth.pdb -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\obj\Debug\ResolveAssemblyReference.cache -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\obj\Debug\Yammer.dll -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\obj\Debug\Yammer.pdb +C:\Documents and Settings\Kevin\Desktop\Yammer\Yammer\bin\Debug\Yammer.dll +C:\Documents and Settings\Kevin\Desktop\Yammer\Yammer\bin\Debug\Yammer.pdb +C:\Documents and Settings\Kevin\Desktop\Yammer\Yammer\obj\Debug\ResolveAssemblyReference.cache +C:\Documents and Settings\Kevin\Desktop\Yammer\Yammer\obj\Debug\Yammer.dll +C:\Documents and Settings\Kevin\Desktop\Yammer\Yammer\obj\Debug\Yammer.pdb +C:\Documents and Settings\Kevin\Desktop\Yammer\Yammer\bin\Debug\oAuth.dll +C:\Documents and Settings\Kevin\Desktop\Yammer\Yammer\bin\Debug\oAuth.pdb +C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Debug\Yammer.dll +C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Debug\Yammer.pdb +C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Debug\oAuth.dll +C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Debug\oAuth.pdb +C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\obj\Debug\ResolveAssemblyReference.cache +C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\obj\Debug\Yammer.dll +C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\obj\Debug\Yammer.pdb +C:\Users\Kevin\Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Debug\Yammer.dll +C:\Users\Kevin\Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Debug\Yammer.pdb +C:\Users\Kevin\Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Debug\oAuth.dll +C:\Users\Kevin\Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Debug\oAuth.pdb +C:\Users\Kevin\Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\obj\Debug\ResolveAssemblyReference.cache +C:\Users\Kevin\Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\obj\Debug\Yammer.dll +C:\Users\Kevin\Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\obj\Debug\Yammer.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Debug\Yammer.dll +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Debug\Yammer.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Debug\oAuth.dll +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Debug\oAuth.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\obj\Debug\ResolveAssemblyReference.cache +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\obj\Debug\Yammer.dll +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\obj\Debug\Yammer.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Debug\Yammer.dll.config +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerFramework\Yammer\bin\Debug\Yammer.dll +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerFramework\Yammer\bin\Debug\Yammer.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerFramework\Yammer\bin\Debug\oAuth.dll +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerFramework\Yammer\bin\Debug\oAuth.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerFramework\Yammer\obj\Debug\ResolveAssemblyReference.cache +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerFramework\Yammer\obj\Debug\Yammer.dll +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerFramework\Yammer\obj\Debug\Yammer.pdb Yammer Framework/Yammer/obj/Debug/Yammer.csproj.FileListAbsolute.txt Yammer Framework/Yammer/obj/Debug/Yammer.dll Yammer Framework/Yammer/obj/Debug/Yammer.pdb Yammer Framework/Yammer/obj/Release/ResolveAssemblyReference.cache @@ -1,24 +1,10 @@ -C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\bin\Release\Yammer.dll -C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\bin\Release\Yammer.pdb -C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\obj\Release\ResolveAssemblyReference.cache -C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\obj\Release\Yammer.dll -C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\obj\Release\Yammer.pdb -C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\Yammer\bin\Release\Yammer.XML -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\bin\Release\Yammer.XML -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\bin\Release\Yammer.dll -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\bin\Release\Yammer.pdb -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\bin\Release\oAuth.dll -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\bin\Release\oAuth.pdb -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\bin\Release\oAuth.xml -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\obj\Release\ResolveAssemblyReference.cache -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\obj\Release\Yammer.dll -C:\Documents and Settings\Kevin\Yammer Framework\Yammer\obj\Release\Yammer.pdb -C:\Documents and Settings\Kevin\yammer.net\Yammer Framework\Yammer\bin\Release\Yammer.dll -C:\Documents and Settings\Kevin\yammer.net\Yammer Framework\Yammer\bin\Release\Yammer.pdb -C:\Documents and Settings\Kevin\yammer.net\Yammer Framework\Yammer\bin\Release\oAuth.dll -C:\Documents and Settings\Kevin\yammer.net\Yammer Framework\Yammer\bin\Release\oAuth.pdb -C:\Documents and Settings\Kevin\yammer.net\Yammer Framework\Yammer\bin\Release\oAuth.xml -C:\Documents and Settings\Kevin\yammer.net\Yammer Framework\Yammer\obj\Release\ResolveAssemblyReference.cache -C:\Documents and Settings\Kevin\yammer.net\Yammer Framework\Yammer\obj\Release\Yammer.dll -C:\Documents and Settings\Kevin\yammer.net\Yammer Framework\Yammer\obj\Release\Yammer.pdb -C:\Documents and Settings\Kevin\yammer.net\Yammer Framework\Yammer\bin\Release\Yammer.XML +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Release\Yammer.dll +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Release\Yammer.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Release\oAuth.dll +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Release\oAuth.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Release\oAuth.xml +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\obj\Release\ResolveAssemblyReference.cache +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\obj\Release\Yammer.dll +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\obj\Release\Yammer.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Release\Yammer.dll.config +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\Yammer\bin\Release\Yammer.XML Yammer Framework/Yammer/obj/Release/Yammer.csproj.FileListAbsolute.txt Yammer Framework/Yammer/obj/Release/Yammer.dll Yammer Framework/Yammer/obj/Release/Yammer.pdb @@ -333,7 +333,13 @@ namespace OAuth switch (signatureType) { case SignatureTypes.PLAINTEXT: - return HttpUtility.UrlEncode(string.Format("{0}&{1}", consumerSecret, tokenSecret)); + return consumerSecret + "&" + tokenSecret; + //return HttpUtility.UrlEncode(string.Format("{0}&{1}", consumerSecret, tokenSecret)); + //%26 + secret + + //return HttpUtility.UrlEncode(tokenSecret + "@") ; + //return GenerateSignatureBase(url, consumerKey, token, tokenSecret, httpMethod, timeStamp, nonce, PlainTextSignatureType, out normalizedUrl, out normalizedRequestParameters); + case SignatureTypes.HMACSHA1: string signatureBase = GenerateSignatureBase(url, consumerKey, token, tokenSecret, httpMethod, timeStamp, nonce, HMACSHA1SignatureType, out normalizedUrl, out normalizedRequestParameters); Yammer Framework/oAuth/OAuthBase.cs Yammer Framework/oAuth/bin/Debug/oAuth.dll Yammer Framework/oAuth/bin/Debug/oAuth.pdb @@ -4,49 +4,6 @@ <name>oAuth</name> </assembly> <members> - <member name="T:OAuth.Rfc3986"> - <summary> - Performs RFC 3986 encoding and decoding. - http://www.apps.ietf.org/rfc/rfc3986.html - </summary> - </member> - <member name="M:OAuth.Rfc3986.EncodeAndJoin(System.Collections.Specialized.NameValueCollection)"> - <summary> - Join the name-value pairs into a string seperated with ampersands. - Each name and value is first RFC 3986 encoded and values are separated - from names with equal signs. - </summary> - <param name="values">The name value collection to encode and join</param> - <returns>An RFC 3986 compliant string</returns> - </member> - <member name="M:OAuth.Rfc3986.SplitAndDecode(System.String)"> - <summary> - Splits a ampersand-separated list of key-value pairs, decodes the keys and - values, and adds them to a NameValueCollection. Keys and values are separated - by equals signs. - </summary> - <param name="input">The key-value pair list</param> - <returns>A name value collection, which may be empty.</returns> - <exception cref="T:System.FormatException"> - If the string is not a series of key-value pairs separated by ampersands, - or if one of the keys is null or empty, or if one of the keys or values is - not properly encoded. - </exception> - </member> - <member name="M:OAuth.Rfc3986.Encode(System.String)"> - <summary> - Perform RFC 3986 Percent-encoding on a string. - </summary> - <param name="input">The input string</param> - <returns>The RFC 3986 Percent-encoded string</returns> - </member> - <member name="M:OAuth.Rfc3986.Decode(System.String)"> - <summary> - Perform RFC 3986 Percent-decoding on a string. - </summary> - <param name="input">The input RFC 3986 Percent-encoded string</param> - <returns>The decoded string</returns> - </member> <member name="M:OAuth.OAuthBase.ComputeHash(System.Security.Cryptography.HashAlgorithm,System.String)"> <summary> Helper function to compute a hash value @@ -149,5 +106,48 @@ Comparer class used to perform the sorting of the query parameters </summary> </member> + <member name="T:OAuth.Rfc3986"> + <summary> + Performs RFC 3986 encoding and decoding. + http://www.apps.ietf.org/rfc/rfc3986.html + </summary> + </member> + <member name="M:OAuth.Rfc3986.EncodeAndJoin(System.Collections.Specialized.NameValueCollection)"> + <summary> + Join the name-value pairs into a string seperated with ampersands. + Each name and value is first RFC 3986 encoded and values are separated + from names with equal signs. + </summary> + <param name="values">The name value collection to encode and join</param> + <returns>An RFC 3986 compliant string</returns> + </member> + <member name="M:OAuth.Rfc3986.SplitAndDecode(System.String)"> + <summary> + Splits a ampersand-separated list of key-value pairs, decodes the keys and + values, and adds them to a NameValueCollection. Keys and values are separated + by equals signs. + </summary> + <param name="input">The key-value pair list</param> + <returns>A name value collection, which may be empty.</returns> + <exception cref="T:System.FormatException"> + If the string is not a series of key-value pairs separated by ampersands, + or if one of the keys is null or empty, or if one of the keys or values is + not properly encoded. + </exception> + </member> + <member name="M:OAuth.Rfc3986.Encode(System.String)"> + <summary> + Perform RFC 3986 Percent-encoding on a string. + </summary> + <param name="input">The input string</param> + <returns>The RFC 3986 Percent-encoded string</returns> + </member> + <member name="M:OAuth.Rfc3986.Decode(System.String)"> + <summary> + Perform RFC 3986 Percent-decoding on a string. + </summary> + <param name="input">The input RFC 3986 Percent-encoded string</param> + <returns>The decoded string</returns> + </member> </members> </doc> Yammer Framework/oAuth/bin/Release/oAuth.XML Yammer Framework/oAuth/bin/Release/oAuth.dll Yammer Framework/oAuth/bin/Release/oAuth.pdb Yammer Framework/oAuth/obj/Debug/Refactor/oAuth.dll @@ -13,8 +13,33 @@ C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\ C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\oAuth\obj\Debug\ResolveAssemblyReference.cache C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\oAuth\obj\Debug\oAuth.dll C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\oAuth\obj\Debug\oAuth.pdb -C:\Documents and Settings\Kevin\Yammer Framework\oAuth\bin\Debug\oAuth.dll -C:\Documents and Settings\Kevin\Yammer Framework\oAuth\bin\Debug\oAuth.pdb -C:\Documents and Settings\Kevin\Yammer Framework\oAuth\obj\Debug\ResolveAssemblyReference.cache -C:\Documents and Settings\Kevin\Yammer Framework\oAuth\obj\Debug\oAuth.dll -C:\Documents and Settings\Kevin\Yammer Framework\oAuth\obj\Debug\oAuth.pdb +C:\Documents and Settings\Kevin\Desktop\Yammer\oAuth\bin\Debug\oAuth.dll +C:\Documents and Settings\Kevin\Desktop\Yammer\oAuth\bin\Debug\oAuth.pdb +C:\Documents and Settings\Kevin\Desktop\Yammer\oAuth\obj\Debug\ResolveAssemblyReference.cache +C:\Documents and Settings\Kevin\Desktop\Yammer\oAuth\obj\Debug\oAuth.dll +C:\Documents and Settings\Kevin\Desktop\Yammer\oAuth\obj\Debug\oAuth.pdb +C:\Documents and Settings\kdavie\Desktop\Yammer\oAuth\bin\Debug\oAuth.dll +C:\Documents and Settings\kdavie\Desktop\Yammer\oAuth\bin\Debug\oAuth.pdb +C:\Documents and Settings\kdavie\Desktop\Yammer\oAuth\obj\Debug\ResolveAssemblyReference.cache +C:\Documents and Settings\kdavie\Desktop\Yammer\oAuth\obj\Debug\oAuth.dll +C:\Documents and Settings\kdavie\Desktop\Yammer\oAuth\obj\Debug\oAuth.pdb +C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\bin\Debug\oAuth.dll +C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\bin\Debug\oAuth.pdb +C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\obj\Debug\ResolveAssemblyReference.cache +C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\obj\Debug\oAuth.dll +C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\obj\Debug\oAuth.pdb +C:\Users\Kevin\Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\bin\Debug\oAuth.dll +C:\Users\Kevin\Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\bin\Debug\oAuth.pdb +C:\Users\Kevin\Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\obj\Debug\ResolveAssemblyReference.cache +C:\Users\Kevin\Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\obj\Debug\oAuth.dll +C:\Users\Kevin\Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\obj\Debug\oAuth.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\bin\Debug\oAuth.dll +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\bin\Debug\oAuth.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\obj\Debug\ResolveAssemblyReference.cache +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\obj\Debug\oAuth.dll +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\obj\Debug\oAuth.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerFramework\oAuth\bin\Debug\oAuth.dll +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerFramework\oAuth\bin\Debug\oAuth.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerFramework\oAuth\obj\Debug\ResolveAssemblyReference.cache +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerFramework\oAuth\obj\Debug\oAuth.dll +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerFramework\oAuth\obj\Debug\oAuth.pdb Yammer Framework/oAuth/obj/Debug/oAuth.csproj.FileListAbsolute.txt Yammer Framework/oAuth/obj/Debug/oAuth.dll Yammer Framework/oAuth/obj/Debug/oAuth.pdb @@ -4,9 +4,24 @@ C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\ C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\oAuth\obj\Release\oAuth.dll C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\oAuth\obj\Release\oAuth.pdb C:\Documents and Settings\Kevin\My Documents\Visual Studio 2008\Projects\Yammer\oAuth\bin\Release\oAuth.XML -C:\Documents and Settings\Kevin\Yammer Framework\oAuth\bin\Release\oAuth.XML -C:\Documents and Settings\Kevin\Yammer Framework\oAuth\bin\Release\oAuth.dll -C:\Documents and Settings\Kevin\Yammer Framework\oAuth\bin\Release\oAuth.pdb -C:\Documents and Settings\Kevin\Yammer Framework\oAuth\obj\Release\ResolveAssemblyReference.cache -C:\Documents and Settings\Kevin\Yammer Framework\oAuth\obj\Release\oAuth.dll -C:\Documents and Settings\Kevin\Yammer Framework\oAuth\obj\Release\oAuth.pdb +C:\Documents and Settings\kdavie\My Documents\Visual Studio 2008\Projects\Yammer\oAuth\bin\Release\oAuth.dll +C:\Documents and Settings\kdavie\My Documents\Visual Studio 2008\Projects\Yammer\oAuth\bin\Release\oAuth.pdb +C:\Documents and Settings\kdavie\My Documents\Visual Studio 2008\Projects\Yammer\oAuth\obj\Release\ResolveAssemblyReference.cache +C:\Documents and Settings\kdavie\My Documents\Visual Studio 2008\Projects\Yammer\oAuth\obj\Release\oAuth.dll +C:\Documents and Settings\kdavie\My Documents\Visual Studio 2008\Projects\Yammer\oAuth\obj\Release\oAuth.pdb +C:\Documents and Settings\Kevin\Desktop\Yammer\oAuth\bin\Release\oAuth.dll +C:\Documents and Settings\Kevin\Desktop\Yammer\oAuth\bin\Release\oAuth.pdb +C:\Documents and Settings\Kevin\Desktop\Yammer\oAuth\obj\Release\ResolveAssemblyReference.cache +C:\Documents and Settings\Kevin\Desktop\Yammer\oAuth\obj\Release\oAuth.dll +C:\Documents and Settings\Kevin\Desktop\Yammer\oAuth\obj\Release\oAuth.pdb +C:\Documents and Settings\kdavie\Desktop\Yammer\oAuth\bin\Release\oAuth.dll +C:\Documents and Settings\kdavie\Desktop\Yammer\oAuth\bin\Release\oAuth.pdb +C:\Documents and Settings\kdavie\Desktop\Yammer\oAuth\obj\Release\ResolveAssemblyReference.cache +C:\Documents and Settings\kdavie\Desktop\Yammer\oAuth\obj\Release\oAuth.dll +C:\Documents and Settings\kdavie\Desktop\Yammer\oAuth\obj\Release\oAuth.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\bin\Release\oAuth.dll +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\bin\Release\oAuth.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\obj\Release\ResolveAssemblyReference.cache +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\obj\Release\oAuth.dll +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\obj\Release\oAuth.pdb +C:\Documents and Settings\Kevin Davie\My Documents\Visual Studio 2008\Projects\YammerADSync\oAuth\bin\Release\oAuth.XML Yammer Framework/oAuth/obj/Release/oAuth.csproj.FileListAbsolute.txt Yammer Framework/oAuth/obj/Release/oAuth.dll Yammer Framework/oAuth/obj/Release/oAuth.pdb Yammer Framework/Yammer/Yammer.sln Yammer Framework/Yammer/Yammer.suo Yammer Framework/Yammer/bin/Debug/BandObjectLib.dll Yammer Framework/Yammer/bin/Debug/Interop.SHDocVw.dll Yammer Framework/YammerFramework.chm 8d29e806b2657a6d80576369ce5bec7193dbfa05 unknown Kevin Davie@.(none) http://github.com/kdavie/yammer.net/commit/3c40b46775732ced0d75788c6231627471db646d 3c40b46775732ced0d75788c6231627471db646d

2009-07-24T13:05:06-07:00

major update 1c76050266e565bfd918ed96b40cf36d14068249 unknown Kevin Davie@.(none)