SubscriberSearch-net is an example application which illustrates how to create a Hub Exchange application utilizing Single Sign-on (SSO), Fuel API Family (REST), E-mail SOAP API, and Fuel UX together in one application for ExactTarget's Interactive Marketing Hub using .NET/C#.
The full application allows the user to search their ExactTarget subscriber list and update the subscriber status of individual subscribers.
This application was built in steps and they are tagged so that you can get the final application or just specific code.
Step1 - Created the basic app and implemented the JWT for display in Interactive Marketing Hub
Step2 - Added Fuel REST API request to platform service to store and display SOAP URL returned from call
Step3 - Added Fuel UX for the user interface styling
Step4 - Added search functionality to datagrid using SOAP call through handler
Step5 - Added update subscriber functionality and SOAP call
- Access to App Center on http://code.exacttarget.com
- .NET Framework 3.5 or higher
- Web Server that can host .NET Web Sites
- Built with .NET Framework 3.5 in Microsoft Visual Web Developer 2010 Express
- Documentation: Commented code and used Docco/Nocco to create docs folder from comments
- Clone the repo onto your server and deploy to internet facing location.
- Open the project or solution in .NET Studio and save. The project is setup to run debug mode at port 54847 in the project properties->web.
- Make sure the Login.aspx page is set as the start page by right clicking on it in the Solution Explorer and selecting the option.
- Create a new Hub Exchange application in App Center (requires login) naming it what you want.
- If testing locally, for the Login URL, put the path to http://localhost:54847/Login.aspx. For the Home URL, put the path to http://localhost:54847/Default.aspx. For the Logout URL, put the path to http://localhost:54847/Logout.aspx. If hosting non locally enter the proper paths.
- Open web.config file and update the [applicationSecret] attribute value with the Application Signature that was made available in App Center after creating a Hub Exchange application.
- If not testing locally, set up IIS/Web Server to properly host .NET web application. IIS Application pool will be .NET v2.0.
- Test the web application. Make sure the web app is running. Since the IMH is not passing the JWT that the application requires you should get a page that simply states "Error Occurred: Object reference not set to an instance of an object." That will let you know the web server is serving the page correctly.
- Go to ExactTarget IMH and login to your ExactTarget account. Your application created in App Center should be in the IMH menu. Select it and accept any mixed security warnings if you receive them.
Copyright and license
Copyright (c) 2012 ExactTarget
Licensed under the MIT License (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the COPYING file.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.