{"id":34,"date":"2009-03-19T23:25:00","date_gmt":"2009-03-19T22:25:00","guid":{"rendered":"\/post\/2009\/03\/19\/Using-the-Agent-WebService-of-the-Response-Group-Service.aspx"},"modified":"2014-02-22T21:55:33","modified_gmt":"2014-02-22T20:55:33","slug":"using-the-agent-webservice-of-the-response-group-service","status":"publish","type":"post","link":"https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/","title":{"rendered":"Using the Agent WebService of the Response Group Service"},"content":{"rendered":"<p>Your Office Communications Server 2007 R2, Response Group Service deployment comes with a tiny but nice little addition: the Agent WebService. It basically offers exactly the same data and functionality as the Agent OC tab but does this through a SOAP interface. If you have RGS deployed on a pool with the FQDN &#8216;ocs-pool-01.contoso.com&#8217;, you&#8217;ll find the Agent OC tab at <a href=\"https:\/\/ocs-pool-01.contoso.com\/Rgs\/Clients\/Tab.aspx\">https:\/\/ocs-pool-01.contoso.com\/Rgs\/Clients\/Tab.aspx<\/a>. The Agent WebService is then located at <a href=\"https:\/\/ocs-pool-01.contoso.com\/Rgs\/Clients\/ProxyService.asmx\">https:\/\/ocs-pool-01.contoso.com\/Rgs\/Clients\/ProxyService.asmx<\/a>. If you are running the OCS WebComponents on other machines than the front ends, then the host name is the FQDN of the WebComponents machine\/farm. So here&#8217;s how you can write your own client to sign in\/out with RGS Agent Groups. The TechNet article <a title=\"Deploying Response Group Clients\" href=\"http:\/\/technet.microsoft.com\/library\/dd425365(office.13).aspx\" target=\"_blank\">Deploying Response Group Clients<\/a> gives more information about deploying RGS Clients, with focus on the Agent OC Tab.<\/p>\n<h2>Generating the Client Proxy<\/h2>\n<p>The first thing you typically want to do is to actually generate the proxy code which you will compile into your own client. You do so by calling<\/p>\n<pre class=\"brush: plain; title: ; notranslate\" title=\"\">\r\nwsdl.exe \/namespace:RgsAgentService \/language:cs \/out:RgsAgentService.cs https:\/\/ocs-pool-01.contoso.com\/Rgs\/Clients\/ProxyService.asmx?wsdl\r\n<\/pre>\n<p>This will generate the RgsAgentService.cs file which you can include into your project and use right away. <a title=\"Web Services Description Language Tool (Wsdl.exe)\" href=\"http:\/\/msdn.microsoft.com\/library\/7h3ystb6(VS.80).aspx\" target=\"_blank\">Web Services Description Language Tool (Wsdl.exe)<\/a> on MSDN has more info on wsdl.exe if needed.<\/p>\n<h2>Using the Web Service<\/h2>\n<p>Now you&#8217;re already good to go and use the web service. The code below shows a sample console application which does the following.<\/p>\n<ul>\n<li>\n<div>Create a new instance of ProxyService (the generated class from the step above) which points to the service on the pool you&#8217;re interested in.<\/div>\n<\/li>\n<li>\n<div>Query the web service if the current user is an agent or not. This requires you to authenticate with the user&#8217;s credentials.<\/div>\n<\/li>\n<li>\n<div>If the current user is an agent<\/div>\n<ul>\n<li>\n<div>Determine some basic information (e.g. the name and SIP address of the agent).<\/div>\n<\/li>\n<li>\n<div>Retrieve the list of agent groups the agent is a member of in the connected pool.<\/div>\n<\/li>\n<li>\n<div>If there are formal agent groups to which the agent is not signed in, the user is asked if he wants to sign in.<\/div>\n<ul>\n<li>\n<div>If he choses to sign in, tries to sign the agent in to those formal groups.<\/div>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<pre class=\"brush: csharp; title: Program.cs; notranslate\" title=\"Program.cs\">\r\nusing System;\r\nusing System.Collections.Generic;\r\n\r\nusing RgsAgentService;\r\n\r\nnamespace RgsClient\r\n{\r\n    class Program\r\n    {\r\n        static void Main(string[] args)\r\n        {\r\n            string poolFqdn = &quot;ocs-pool-01.contoso.com&quot;;\r\n\r\n            if (args.Length &gt; 0)\r\n            {\r\n                poolFqdn = args[0];\r\n            }\r\n\r\n            ProxyService service = ConnectToPool(poolFqdn);\r\n\r\n            \/\/ First, figure out if the current user is an Agent.\r\n            if (!service.IsAgent())\r\n            {\r\n                Console.WriteLine(&quot;You are not an agent in Pool '{0}'.&quot;, poolFqdn);\r\n                return;\r\n            }\r\n\r\n            \/\/ Now get some information about the Agent (i.e. the current User).\r\n            AcdAgent self = service.GetAgent();\r\n\r\n            Console.WriteLine(&quot;You were authenticated as agent '{0}' ('{1}') in pool '{2}'.&quot;,\r\n                self.DisplayName, self.SipAddress, poolFqdn);\r\n            Console.WriteLine();\r\n\r\n            \/\/ Finally, determine which Agent Groups this Agent belongs to.\r\n            AcdGroup[] agentGroups = service.GetGroups();\r\n\r\n            Console.WriteLine(&quot;Agent Group Name                  Formal?   Signed In?  # Agents&quot;);\r\n            Console.WriteLine(&quot;----------------------------------------------------------------&quot;);\r\n\r\n            Dictionary&lt;string, Guid&gt; agentGroupIdsForSignIn = new Dictionary&lt;string, Guid&gt;();\r\n\r\n            for (int i = 0; i &lt; agentGroups.Length; i++)\r\n            {\r\n                Console.WriteLine(&quot;{0,-32}  {1,-8}  {2,-10}  {3,8}&quot;,\r\n                    agentGroups[i].Name, agentGroups[i].CanSignIn,\r\n                    agentGroups[i].IsSignedIn, agentGroups[i].NumberOfAgents);\r\n\r\n                if (agentGroups[i].CanSignIn &amp;&amp;\r\n                    !agentGroups[i].IsSignedIn)\r\n                {\r\n                    agentGroupIdsForSignIn.Add(agentGroups[i].Name, agentGroups[i].Id);\r\n                }\r\n            }\r\n\r\n            \/\/ If the Agent is not signed in to all his formal groups, then offer\r\n            \/\/ him to do so now.\r\n            if (agentGroupIdsForSignIn.Count &gt; 0)\r\n            {\r\n                Console.WriteLine();\r\n                Console.WriteLine(&quot;You are not currently signed in to {0} agent group(s):&quot;,\r\n                    agentGroupIdsForSignIn.Count);\r\n\r\n                foreach (string agentGroupName in agentGroupIdsForSignIn.Keys)\r\n                {\r\n                    Console.WriteLine(&quot;    {0}&quot;, agentGroupName);\r\n                }\r\n\r\n                Console.WriteLine();\r\n                Console.Write(&quot;Do you want to sign in to these groups now? [y\/n] &quot;);\r\n\r\n                ConsoleKeyInfo key = Console.ReadKey();\r\n                while (key.KeyChar != 'y' &amp;&amp; key.KeyChar != 'n')\r\n                {\r\n                    key = Console.ReadKey();\r\n                }\r\n\r\n                if (key.KeyChar == 'n')\r\n                {\r\n                    return;\r\n                }\r\n\r\n                Console.WriteLine();\r\n\r\n                if (service.SignInMultiple(agentGroupIdsForSignIn.Values.ToArray()))\r\n                {\r\n                    Console.WriteLine(&quot;You have successfully signed in.&quot;);\r\n                }\r\n                else\r\n                {\r\n                    Console.WriteLine(&quot;Sign-in to at leat one agent group has failed.&quot;);\r\n                }\r\n            }\r\n        }\r\n\r\n        private static ProxyService ConnectToPool(string poolFqdn)\r\n        {\r\n            ProxyService service = new ProxyService();\r\n\r\n            service.Url = String.Format(&quot;https:\/\/{0}\/Rgs\/Clients\/ProxyService.asmx&quot;, poolFqdn);\r\n            service.UseDefaultCredentials = true;\r\n\r\n            return service;\r\n        }\r\n    }\r\n}\r\n<\/pre>\n<p>Running this program will yield something similar to the following.<\/p>\n<pre class=\"brush: plain; title: ; notranslate\" title=\"\">\r\nYou were authenticated as agent 'Bob' ('bob@contoso.com') in pool 'rgs-pool-01.contoso.com'.\r\n\r\nAgent Group Name                  Formal?   Signed In?  # Agents\r\n----------------------------------------------------------------\r\nPayroll Questions                 False     True               5\r\nGeneral HR Questions              True      False              8\r\n\r\nYou are not currently signed in to 1 agent group(s):\r\n    General HR Questions\r\n\r\nDo you want to sign in to these groups now? [y\/n] y\r\nYou have successfully signed in.\r\n<\/pre>\n<h2>More Methods<\/h2>\n<p>The WebService has a few more methods. These are in particular<\/p>\n<ul>\n<li>\n<div>SignIn(Guid groupId) &#8211; Tries to sign the current agent in to the agent group with the given ID<\/div>\n<\/li>\n<li>\n<div>SignOut(Guid groupId) &#8211; Tries to sign the current agent out of the agent group with the given ID<\/div>\n<\/li>\n<li>\n<div>SignOutMultiple(Guid[] groupIds) &#8211; Tries to sign the current agent out of all the groups identified with their respective IDs<\/div>\n<\/li>\n<\/ul>\n<p>These methods all return a boolean which indicates success (true) or failure (false).<\/p>\n<h2>Summary<\/h2>\n<p>You can integrate the RGS Agent Services into your own application by using the corresponding web service which is installed with the Response Group Service. This allows you to offer the same information and functionality as the RGS Agent OC Tab in a customizable manner.<\/p>\n<p><\/p>","protected":false},"excerpt":{"rendered":"<p>Your Office Communications Server 2007 R2, Response Group Service deployment comes with a tiny but nice little addition: the Agent WebService. It basically offers exactly the same data and functionality as the Agent OC tab but does this through a SOAP interface. If you have RGS deployed on a pool with the FQDN &#8216;ocs-pool-01.contoso.com&#8217;, you&#8217;ll &hellip; <a href=\"https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/\" class=\"more-link\">Continue reading<span class=\"screen-reader-text\"> &#8220;Using the Agent WebService of the Response Group Service&#8221;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[61],"tags":[12,26,32,34,42],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v19.13 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Using the Agent WebService of the Response Group Service - Tales of a Code Monkey<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Using the Agent WebService of the Response Group Service - Tales of a Code Monkey\" \/>\n<meta property=\"og:description\" content=\"Your Office Communications Server 2007 R2, Response Group Service deployment comes with a tiny but nice little addition: the Agent WebService. It basically offers exactly the same data and functionality as the Agent OC tab but does this through a SOAP interface. If you have RGS deployed on a pool with the FQDN &#8216;ocs-pool-01.contoso.com&#8217;, you&#8217;ll &hellip; Continue reading &quot;Using the Agent WebService of the Response Group Service&quot;\" \/>\n<meta property=\"og:url\" content=\"https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/\" \/>\n<meta property=\"og:site_name\" content=\"Tales of a Code Monkey\" \/>\n<meta property=\"article:published_time\" content=\"2009-03-19T22:25:00+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2014-02-22T20:55:33+00:00\" \/>\n<meta name=\"author\" content=\"roger\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"roger\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/\",\"url\":\"https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/\",\"name\":\"Using the Agent WebService of the Response Group Service - Tales of a Code Monkey\",\"isPartOf\":{\"@id\":\"https:\/\/cymbeline.ch\/#website\"},\"datePublished\":\"2009-03-19T22:25:00+00:00\",\"dateModified\":\"2014-02-22T20:55:33+00:00\",\"author\":{\"@id\":\"https:\/\/cymbeline.ch\/#\/schema\/person\/cf1f3b3205f4266bf8b68a80fa6b0916\"},\"breadcrumb\":{\"@id\":\"https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/cymbeline.ch\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Using the Agent WebService of the Response Group Service\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/cymbeline.ch\/#website\",\"url\":\"https:\/\/cymbeline.ch\/\",\"name\":\"Tales of a Code Monkey\",\"description\":\"... the adventures of a guy making software.\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/cymbeline.ch\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/cymbeline.ch\/#\/schema\/person\/cf1f3b3205f4266bf8b68a80fa6b0916\",\"name\":\"roger\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/cymbeline.ch\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/33cc08db99ae52beb26ab6fda46e0eb7?s=96&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/33cc08db99ae52beb26ab6fda46e0eb7?s=96&r=g\",\"caption\":\"roger\"},\"sameAs\":[\"https:\/\/www.cymbeline.ch\"],\"url\":\"https:\/\/cymbeline.ch\/author\/roger\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Using the Agent WebService of the Response Group Service - Tales of a Code Monkey","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/","og_locale":"en_US","og_type":"article","og_title":"Using the Agent WebService of the Response Group Service - Tales of a Code Monkey","og_description":"Your Office Communications Server 2007 R2, Response Group Service deployment comes with a tiny but nice little addition: the Agent WebService. It basically offers exactly the same data and functionality as the Agent OC tab but does this through a SOAP interface. If you have RGS deployed on a pool with the FQDN &#8216;ocs-pool-01.contoso.com&#8217;, you&#8217;ll &hellip; Continue reading \"Using the Agent WebService of the Response Group Service\"","og_url":"https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/","og_site_name":"Tales of a Code Monkey","article_published_time":"2009-03-19T22:25:00+00:00","article_modified_time":"2014-02-22T20:55:33+00:00","author":"roger","twitter_misc":{"Written by":"roger","Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/","url":"https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/","name":"Using the Agent WebService of the Response Group Service - Tales of a Code Monkey","isPartOf":{"@id":"https:\/\/cymbeline.ch\/#website"},"datePublished":"2009-03-19T22:25:00+00:00","dateModified":"2014-02-22T20:55:33+00:00","author":{"@id":"https:\/\/cymbeline.ch\/#\/schema\/person\/cf1f3b3205f4266bf8b68a80fa6b0916"},"breadcrumb":{"@id":"https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/cymbeline.ch\/2009\/03\/19\/using-the-agent-webservice-of-the-response-group-service\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/cymbeline.ch\/"},{"@type":"ListItem","position":2,"name":"Using the Agent WebService of the Response Group Service"}]},{"@type":"WebSite","@id":"https:\/\/cymbeline.ch\/#website","url":"https:\/\/cymbeline.ch\/","name":"Tales of a Code Monkey","description":"... the adventures of a guy making software.","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/cymbeline.ch\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/cymbeline.ch\/#\/schema\/person\/cf1f3b3205f4266bf8b68a80fa6b0916","name":"roger","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/cymbeline.ch\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/33cc08db99ae52beb26ab6fda46e0eb7?s=96&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/33cc08db99ae52beb26ab6fda46e0eb7?s=96&r=g","caption":"roger"},"sameAs":["https:\/\/www.cymbeline.ch"],"url":"https:\/\/cymbeline.ch\/author\/roger\/"}]}},"_links":{"self":[{"href":"https:\/\/cymbeline.ch\/wp-json\/wp\/v2\/posts\/34"}],"collection":[{"href":"https:\/\/cymbeline.ch\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/cymbeline.ch\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/cymbeline.ch\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/cymbeline.ch\/wp-json\/wp\/v2\/comments?post=34"}],"version-history":[{"count":6,"href":"https:\/\/cymbeline.ch\/wp-json\/wp\/v2\/posts\/34\/revisions"}],"predecessor-version":[{"id":182,"href":"https:\/\/cymbeline.ch\/wp-json\/wp\/v2\/posts\/34\/revisions\/182"}],"wp:attachment":[{"href":"https:\/\/cymbeline.ch\/wp-json\/wp\/v2\/media?parent=34"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/cymbeline.ch\/wp-json\/wp\/v2\/categories?post=34"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/cymbeline.ch\/wp-json\/wp\/v2\/tags?post=34"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}