Frequently Asked Questions (English)

How can my organization support TntMPD's gift input features?

jedimasteryoder — Fri, 03 Feb 2012 17:29:28 GMT

Current revision posted to Frequently Asked Questions (English) by jedimasteryoder on 2/3/2012 12:29:28 PM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer (software). This system can provide a TntMPD-compatible download for your staff. Tools and documentation are provided to allow you to custom integrate TntMPD.DataServer with your own donation system. TntMPD.DataServer already includes pre-built integration templates for:
  - DonorWise
  - Raiser's Edge
  - OPTIGEM
  - Dynamics SL (Solomon)
  - Talisma Fundraising (Donor2)
  - MPower MPX
  - More ...
- By using DonorElf (website & service). This system not only provides your staff a web-based solution for downloading donations into TntMPD, but it also provides a web-based CRM your staff can use. It can integrate with the following systems:
  - Quickbooks
  - Raiser's Edge
  - PowerChurch
  - Contact DonorElf Paul Yoder if you want your accounting system integrated too
- [[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Collaborate with others who have custom integrated TntMPD with their organization's donation system. Here's a list of others who have custom integrated TntMPD with their organization's donation system...

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------

How can my organization support TntMPD's gift input features?

Troy Wolbrink — Thu, 05 Jan 2012 21:09:47 GMT

Revision 22 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 4:09:47 PM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer (software). This system can provide a TntMPD-compatible download for your staff. Tools and documentation are provided to allow you to custom integrate TntMPD.DataServer with your own donation system. TntMPD.DataServer already includes pre-built integration templates for:
  - DonorWise
  - Raiser's Edge
  - OPTIGEM
  - Dynamics SL (Solomon)
  - Talisma Fundraising (Donor2)
  - MPower MPX
  - More ...
- By using DonorElf (website & service). This system not only provides your staff a web-based solution for downloading donations into TntMPD, but it also provides a web-based CRM your staff can use. It can integrate with the following systems:
  - Quickbooks
  - Raiser's Edge
  - PowerChurch
  - Contact DonorElf if you want your accounting system integrated too
- [[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------

How can my organization support TntMPD's gift input features?

Troy Wolbrink — Thu, 05 Jan 2012 21:09:00 GMT

Revision 21 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 4:09:00 PM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer (software). This system can provide a TntMPD-compatible download for your staff. Tools and documentation are provided to allow you to custom integrate TntMPD.DataServer with your own donation system. TntMPD.DataServer already includes pre-built integration templates for:
  - DonorWise
  - Raiser's Edge
  - OPTIGEM
  - Dynamics SL (Solomon)
  - Talisma Fundraising (Donor2)
  - MPower MPX
  - More ...
- By using DonorElf (website & service). This system not only provides your staff a web-based solution for downloading donations into TntMPD, but it also provides a web-based CRM your staff can use. It can integrate with the following systems:
  - Quickbooks
  - Raiser's Edge
  - PowerChurch
  - Contact DonorElf if you want your accounting system integrated too
- [[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------

How can my organization support TntMPD's gift input features?

Troy Wolbrink — Thu, 05 Jan 2012 21:07:35 GMT

Revision 20 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 4:07:35 PM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer (software). This system can provide a TntMPD-compatible download for your staff. Tools and documentation are provided to allow you to custom integrate TntMPD.DataServer with your own donation system. TntMPD.DataServer already includes pre-built integration templates for:
  - DonorWise
  - Raiser's Edge
  - OPTIGEM
  - Dynamics SL (Solomon)
  - Talisma Fundraising (Donor2)
  - MPower MPX
  - More ...
- By using DonorElf (website & service). This system not only provides your staff a web-based solution for downloading donations into TntMPD, but it also provides a web-based CRM your staff can use. It can integrate with the following systems:
  - Quickbooks
  - Raiser's Edge
  - PowerChurch
  - Contact DonorElf if you want your accounting system integrated too
- [[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------

How can my organization support TntMPD's gift input features?

jedimasteryoder — Thu, 05 Jan 2012 20:44:59 GMT

Revision 19 posted to Frequently Asked Questions (English) by jedimasteryoder on 1/5/2012 3:44:59 PM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer (software). This system can provide a TntMPD-compatible download for your staff. Tools and documentation are provided to allow you to custom integrate TntMPD.DataServer with your own donation system. TntMPD.DataServer already includes pre-built integration templates for:
  - DonorWise
  - Raiser's Edge
  - OPTIGEM
  - Dynamics SL (Solomon)
  - Talisma Fundraising (Donor2)
  - MPower MPX
  - More ...
- By using DonorElf (website & service). This system not only provides your staff a web-based solution for downloading donations into TntMPD, but it also provides a web-based CRM your staff can use. It can integrate with the following systems:
  - Quickbooks
  - Raiser's Edge
  - PowerChurch
  - Contact [[en:mailto:paul@donorelf.com|Paul Yoder]]DonorElf if you want your accounting system integrated with DonorElftoo
- [[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------

How can my organization support TntMPD's gift input features?

jedimasteryoder — Thu, 05 Jan 2012 20:42:49 GMT

Revision 18 posted to Frequently Asked Questions (English) by jedimasteryoder on 1/5/2012 3:42:49 PM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer (software). This system can provide a TntMPD-compatible download for your staff. Tools and documentation are provided to allow you to custom integrate TntMPD.DataServer with your own donation system. TntMPD.DataServer already includes pre-built integration templates for:
  - DonorWise
  - Raiser's Edge
  - OPTIGEM
  - Dynamics SL (Solomon)
  - Talisma Fundraising (Donor2)
  - MPower MPX
  - More ...
- By using DonorElf (service)website & service). This system not only provides your staff a web-based solution for downloading donations into TntMPD, but it also provides a web-based CRM your staff can use. It can integrate with the following systems:
  - Quickbooks
  - Raiser's Edge
  - PowerChurch
  - Contact [[en:mailto:paul@donorelf.com|Paul Yoder]] if you want your accounting system integrated with DonorElf
- [[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------
Word Made Flesh	Paul Yoder	Quickbooks (SDK) C# (client-side) PHP (server-side) SOAP (communication protocol)	Paul developed a web-based solution using PHP to allow TntMPD to "Input from Web" against a copy of Quickbooks donation data.

How can my organization support TntMPD's gift input features?

Troy Wolbrink — Thu, 05 Jan 2012 16:21:12 GMT

Revision 17 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 11:21:12 AM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer (software). The preferred and recommended way to This system can provide a TntMPD-compatible download for your staffis to use TntMPD.DataServer. Tools and documentation are provided to allow you to custom integrate TntMPD.DataServer with your own donation system. TntMPD.DataServer already includes pre-built integration templates for:
  - DonorWise
  - Raiser's Edge
  - OPTIGEM
  - Dynamics SL (Solomon)
  - Talisma Fundraising (Donor2)
  - MPower MPX
  - More ...
- By using DonorElf (service). This system not only provides your staff a web-based solution for downloading donations into TntMPD, but it also provides a web-based CRM your staff can use. It can integrate with the following systems:
  - Quickbooks
  - Raiser's Edge
  - PowerChurch
- [[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------
Word Made Flesh	Paul Yoder	Quickbooks (SDK) C# (client-side) PHP (server-side) SOAP (communication protocol)	Paul developed a web-based solution using PHP to allow TntMPD to "Input from Web" against a copy of Quickbooks donation data.

How can my organization support TntMPD's gift input features?

Troy Wolbrink — Thu, 05 Jan 2012 15:36:47 GMT

Revision 16 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 10:36:47 AM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer. The preferred and recommended way to provide a TntMPD-compatible download for your staff is to use TntMPD.DataServer. Tools and documentation are provided to allow you to custom integrate TntMPD.DataServer with your own donation system. TntMPD.DataServer already includes pre-built integration templates for:
  - DonorWise
  - Raiser's Edge
  - OPTIGEM
  - Dynamics SL (Solomon)
  - Talisma Fundraising (Donor2)
  - MPower MPX
  - More ...
- By using DonorElf. This system not only provides your staff a web-based solution for downloading donations into TntMPD, but it also provides a web-based CRM your staff can use. It can integrate with the following systems:
  - Quickbooks
  - Raiser's Edge
  - PowerChurch
- [[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------
Word Made Flesh	Paul Yoder	Quickbooks (SDK) C# (client-side) PHP (server-side) SOAP (communication protocol)	Paul developed a web-based solution using PHP to allow TntMPD to "Input from Web" against a copy of Quickbooks donation data.

How can my organization support TntMPD's gift input features?

Troy Wolbrink — Thu, 05 Jan 2012 15:36:08 GMT

Revision 15 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 10:36:08 AM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer. The preferred and recommended way to provide a TntMPD-compatible download for your staff is to use TntMPD.DataServer. Tools and documentation are provided to allow you to custom integrate TntMPD.DataServer with your own donation system. TntMPD.DataServer already includes pre-built integration templates for:
  - DonorWise
  - Raiser's Edge
  - OPTIGEM
  - Dynamics SL (Solomon)
  - Talisma Fundraising (Donor2)
  - MPower MPX
  - More ... Tools and documentation are provided to allow you to integrate TntMPD.DataServer with your own donation system.
- By using DonorElf. This system not only provides your staff a web-based solution for downloading donations into TntMPD, but it also provides a web-based CRM your staff can use. It can integrate with the following systems:
  - Quickbooks
  - Raiser's Edge
  - PowerChurch
- [[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------
Word Made Flesh	Paul Yoder	Quickbooks (SDK) C# (client-side) PHP (server-side) SOAP (communication protocol)	Paul developed a web-based solution using PHP to allow TntMPD to "Input from Web" against a copy of Quickbooks donation data.

How can my organization support TntMPD's gift input features?

Troy Wolbrink — Thu, 05 Jan 2012 15:34:33 GMT

Revision 14 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 10:34:33 AM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer. The preferred and recommended way to provide a TntMPD-compatible download for your staff is to use TntMPD.DataServer. TntMPD.DataServer already includes pre-built integration templates for:
  - DonorWise
  - Raiser's Edge
  - OPTIGEM
  - Dynamics SL (Solomon)
  - Talisma Fundraising (Donor2)
  - MPower MPX
  - More ... Tools and documentation are provided to allow you to integrate TntMPD.DataServer with your own donation system.
- By using DonorElf. This system not only provides your staff a web-based solution for downloading donations into TntMPD, but it also provides a web-based CRM your staff can use. It can integrate with the following systems:
- - Quickbooks
  - Raiser's Edge
  - PowerChurch
[[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------
Word Made Flesh	Paul Yoder	Quickbooks (SDK) C# (client-side) PHP (server-side) SOAP (communication protocol)	Paul developed a web-based solution using PHP to allow TntMPD to "Input from Web" against a copy of Quickbooks donation data.

How can my organization support TntMPD's gift input features?

Troy Wolbrink — Thu, 05 Jan 2012 15:32:54 GMT

Revision 13 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 10:32:54 AM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer. The preferred and recommended way to provide a TntMPD-compatible download for your staff is to use TntMPD.DataServer. TntMPD.DataServer already includes pre-built integration templates for:
  - DonorWise
  - Raiser's Edge
  - OPTIGEM
  - Dynamics SL (Solomon)
  - Talisma Fundraising (Donor2)
  - MPower MPX
  - More ... Tools and documentation are provided to allow you to integrate TntMPD.DataServer with your own donation system.

- By using DonorElf. This system not only provides your staff a web-based solution for downloading donations into TntMPD, but it also provides a web-based CRM your staff can use. It can integrate with the following systems:
  - Quickbooks
  - Raiser's Edge
  - PowerChurch
- [[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------
Word Made Flesh	Paul Yoder	Quickbooks (SDK) C# (client-side) PHP (server-side) SOAP (communication protocol)	Paul developed a web-based solution using PHP to allow TntMPD to "Input from Web" against a copy of Quickbooks donation data.

How can my organization support TntMPD's gift input features?

Troy Wolbrink — Thu, 05 Jan 2012 15:32:09 GMT

Revision 12 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 10:32:09 AM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer. The preferred and recommended way to provide a TntMPD-compatible download for your staff is to use TntMPD.DataServer. TntMPD.DataServer already includes pre-built integration templates for:
  - DonorWise
  - Raiser's Edge
  - OPTIGEM
  - Dynamics SL (Solomon)
  - Talisma Fundraising (Donor2)
  - MPower MPX
  - More ... Tools and documentation are provided to allow you to integrate TntMPD.DataServer with your own donation system.
- By using DonorElf. This system not only provides your staff a web-based solution for downloading donations into TntMPD, but it also provides a web-based CRM your staff can use. It can integrate with the following systems:
  - Quickbooks
  - Raiser's Edge
  - PowerChurch
- [[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------
Word Made Flesh	Paul Yoder	Quickbooks (SDK) C# (client-side) PHP (server-side) SOAP (communication protocol)	Paul developed a web-based solution using PHP to allow TntMPD to "Input from Web" against a copy of Quickbooks donation data.

How can my organization support TntMPD's gift input features?

Troy Wolbrink — Thu, 05 Jan 2012 15:31:18 GMT

Revision 11 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 10:31:18 AM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer. The preferred and recommended way to provide a TntMPD-compatible download for your staff is to use TntMPD.DataServer. TntMPD.DataServer already includes pre-built integration templates for:
  - DonorWise
  - Raiser's Edge
  - OPTIGEM
  - Dynamics SL (Solomon)
  - Talisma Fundraising (Donor2)
  - MPower MPX
  - More ... Tools and documentation are provided to allow you to integrate TntMPD.DataServer with your own donation system.
- By using DonorElf. This system not only provides your staff a web-based solution for downloading donations into TntMPD, but it also provides a web-based CRM your staff can use. It can integrate with the following systems:
  - Quickbooks
  - Raiser's Edge
  - PowerChurch
- [[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------
Word Made Flesh	Paul Yoder	Quickbooks (SDK) C# (client-side) PHP (server-side) SOAP (communication protocol)	Paul developed a web-based solution using PHP to allow TntMPD to "Input from Web" against a copy of Quickbooks donation data.

How can my organization support TntMPD's gift input features?

Troy Wolbrink — Thu, 05 Jan 2012 15:27:55 GMT

Revision 10 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 10:27:55 AM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer. The preferred and recommended way to provide a TntMPD-compatible download for your staff is to use TntMPD.DataServer. TntMPD.DataServer already includes pre-built integration templates for:
  - DonorWise,
  - Raiser's Edge and
  - OPTIGEM
  - Dynamics SL (Solomon)
  - Talisma Fundraising (Donor2)
  - MPower MPX
  - More ... Tools and documentation are provided to allow you to integrate TntMPD.DataServer with your own donation system.
- [[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------
Word Made Flesh	Paul Yoder	Quickbooks (SDK) C# (client-side) PHP (server-side) SOAP (communication protocol)	Paul developed a web-based solution using PHP to allow TntMPD to "Input from Web" against a copy of Quickbooks donation data.

How can my organization support TntMPD's gift input features?

Troy Wolbrink — Wed, 19 Nov 2008 00:50:24 GMT

Revision 9 posted to Frequently Asked Questions (English) by Troy Wolbrink on 11/18/2008 7:50:24 PM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer. The preferred and recommended way to provide a TntMPD-compatible download for your staff is to use TntMPD.DataServer. TntMPD.DataServer already includes pre-built integration templates for DonorWise, Raiser's Edge and OPTIGEM. Tools and documentation are provided to allow you to integrate TntMPD.DataServer with your own donation system.
- [[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------
Word Made Flesh	Paul Yoder	Quickbooks (SDK) C# (client-side) PHP (server-side) SOAP (communication protocol)	Paul developed a web-based solution using PHP to allow TntMPD to "Input from Web" against a copy of Quickbooks donation data.

How can my organization support TntMPD's gift input features?

Troy Wolbrink — Mon, 29 Sep 2008 18:35:59 GMT

Revision 8 posted to Frequently Asked Questions (English) by Troy Wolbrink on 9/29/2008 2:35:59 PM

How can my organization support TntMPD's gift input features?

Filed under: Developer Guides

Even on its own, TntMPD is a powerful tool for ministry partner development. But by integrating TntMPD with your organization's donation system:

You eliminate many hours of manual data entry each month for each staff member who uses the tool.
You remove barriers that keep your staff fully organized and fully funded.
You strongly encourage your staff and send a strong message that you care about them.

TntMPD accommodates two ways of receiving detailed contribution data:

By connecting to your donation system over the Web. This is often the most powerful way for your staff to connect with your donation system. This option allows your staff to stay current with up to the minute donation data as it becomes available. There are two ways to implement this.
- By using TntMPD.DataServer. The preferred and recommended way to provide a TntMPD-compatible download for your staff is to use TntMPD.DataServer. TntMPD.DataServer already includes pre-built integration templates for DonorWise, Raiser's Edge and OPTIGEM. Tools and documentation are provided to allow you to integrate TntMPD.DataServer with your own donation system.
- [[en:how-can-i-make-my-organization-s-online-donation-system-compatible-with-tntmpd|By providing your own custom web server application.]]
[[en:how-would-i-send-our-staff-a-monthly-or-weekly-tntmpd-datasync-file|By sending your staff a monthly (or weekly) TntMPD DataSync file.]] Another very powerful way is to regularly send your staff a TntMPD DataSync file. Sending this file as an email attachment makes it incredibly easy for your staff to sync to the data. All they have to do is double-click on the attachment. Another alternative is to have a secure website location where the file can be made available.

Organization	Integrator	Technologies	Description
-------------------
Every Nation Ministries	Luke Stokes	Donor2 Microsoft SQL Server Microsoft ASP	Luke developed an ASP solution to allow TntMPD to "Input from Web" against Donor2's SQL Server database.
------------------
Word Made Flesh	Paul Yoder	Quickbooks (SDK) C# (client-side) PHP (server-side) SOAP (communication protocol)	Paul developed a web-based solution using PHP to allow TntMPD to "Input from Web" against a copy of Quickbooks donation data.

How can I make my organization's online donation system compatible with TntMPD?

Troy Wolbrink — Wed, 01 Feb 2012 19:09:03 GMT

Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 2/1/2012 2:09:03 PM

How can I make my organization's online donation system compatible with TntMPD?

Filed under: Developer Guides

This document describes how you can make your organization's online donation system compatible with TntMPD. The technical details are spelled out so that you can provide your own custom solution. It requires a knowledge of computer programming. Keep in mind that the preferred and recommended way to provide a TntMPD-compatible download for your staff is to use TntMPD.DataServer. TntMPD.DataServer already includes pre-built integration templates for DonorWise, Raiser's Edge and OPTIGEM. Tools and documentation are provided to allow you to integrate TntMPD.DataServer with your own donation system.

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details
Download names and addresses of donors
Be notified of their staff account balance

Not only will your staff be able to use these features, but their application will be branded with your organization's logo. Also, while they are using the "Web Input" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file
Account Balance Query
Donations Query
Addresses Query
Addresses By IDs Query
Profiles Query (Optional) <new for TntMPD 2.0>
Designations Query (Optional) <future: TntMPD 2.2>

Query INI File

You need to provide a Query INI File. This file will provide the web address and parameter template needed to download the results of the query. Below is an example. Notice it is based on a standard Windows INI file format.

[APPLICATION]
MinimumVersion=1.5.0
RecommendedVersion=1.5.0

[ORGANIZATION]
RedirectQueryIni=
Name=Your Organization Name
Abbreviation=MyOrg
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
MinimumWebGiftDate=1/1/1990
Code=MyOrg-USA
QueryAuthentication=0
MinPidLength=0
OrgHelpEmail=help@myorg.org
OrgHelpUrl=https://www.myorg.org/help.htm
OrgHelpUrlDescription=Click here to report this issue over the Web!
OrgHelpOther=You may also reach the CCC Call Center at 407-826-2948.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
StaffPortalUrl=http://myorg.org/staffportal.html
BaseCurrencyCode=USD
AllowPassiveAuth=True

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

[ACCOUNT_BALANCE.2]
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

[DONATIONS]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[DONATIONS.2]
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[ADDRESSES]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES.2]
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS.2]
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[PROFILES.2]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=Profiles&Username=$ACCOUNT$&Password=$PASSWORD$

[DESIGNATIONS.2.2]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDesigs&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

Now let me explain the meaning of each value...

[APPLICATION]
// You can require a minimum version of TntMPD for Web Input features.
MinimumVersion=1.5.0
// You can recommend a minimum version of TntMPD for Web Input features if you wish.
RecommendedVersion=1.5.0

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/    // URL of your online donation system.
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$  // Your POST template. (described later)

[ACCOUNT_BALANCE.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

[DONATIONS]    // URL and POST have same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[DONATIONS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[ADDRESSES]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&PID=$PERSONIDS$

[ADDRESSES_BY_PERSONIDS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder
                                                                                               // included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[PROFILES.2] <new for TntMPD 2.0>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=Profiles&Username=$ACCOUNT$&Password=$PASSWORD$

[DESIGNATIONS.2.2]   <future: TntMPD 2.2>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDesigs&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

The benefit of keeping the instructions in this file is that if you later change the URL or POST template of your query, you can just edit the Query INI File and make a seamless transition. The staff using the program will never know it changed.

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]
[DONATIONS.2.1]
[DONATIONS.2.0]
[DONATIONS.2]
[DONATIONS]

The Queries

--Placeholders--
Each query has a URL and a POST. The URL specifies your online donation server object (CGI object, for example). The POST specifies the data to send with the HTTP POST transaction. The POST is in a template form. These placeholders are key words that will be substituted by the appropriate string based on the user's input in TntMPD:

$ACCOUNT$	The user name of the staff logging in to the donation system.
$PASSWORD$	The password of the staff logging in to the donation system.
$PROFILE$	<new for TntMPD 2.0> The profile code of the staff logging in to the donation system. If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$ placeholder is never provided in the Profiles Query itself.
$DATEFROM$	The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)
$DATETO$	The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)
$PERSONIDS$	A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

Action=TntBalance&Username=JohnDoe&Password=abc123

--Standard Response--
Each query should return its results as CSV text. I will describe the
field names expected for each query.

--Error Response--
Each query should handle invalid conditions (such as an invalid username) by
returning two lines of text. The first line of text should be "ERROR".
The second line of text is the error description. Here are a couple of
examples to give you the general idea.

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Note for anyone writing a front-end: existing legacy servers may return errors using a different format, such as BAD_PASSWORD instead of ERROR, with a multi-line error description.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID	ACCT_NAME	BALANCE
12345678	Doe, John & Jane	1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName	Description
EMPLID	Comma separated list of designation ids (A18) associated with this user/profile.
ACCT_NAME	List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.
BALANCE	(Text) Custom text that describes the user's account balance.

Donations Query

The purpose of this query is to return all donation detail data for the staff member within a certain date range. In addition to the usual $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders, it also uses $DATEFROM$ and $DATETO$. Keep in mind that these placeholders come in the (M/D/YYYY) format. The $DATEFROM$ and $DATETO$ placeholders describe the beginning and ending dates of the query. You should include donation data for all dates between and including these dates. The beginning date will be limited by the "MinimumWebGiftDate" value in the Query INI file.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
DISPLAY_DATE	(M/D/YYYY) Date of contribution
AMOUNT	(Float) Amount of contribution
DONATION_ID	(A18) Donation ID
DESIGNATION	(A18) What account this donation is designated for (normally same as employee id)
MOTIVATION	(A18) (Optional) If you track this in your donation system you may include this code here.
PAYMENT_METHOD	<future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.
TENDERED_AMOUNT	<future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor. You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.
TENDERED_CURRENCY	<future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.
MEMO	<future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.
BASE_CURRENCY	<future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.
PERSONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Addresses Query

The purpose of this query is to return detailed name, address and phone data for the staff member's donors. In addition to the usual $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders, it also uses $DATEFROM$. Keep in mind that this parameter comes in the (M/D/YYYY) format. The $DATEFROM$ placeholder limits the address list to only those that have changed since the given date. If the given date is blank, the user is requesting ALL addresses.

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
PERSON_TYPE	"O" or "P" (Organization or Person)
DECEASED	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Is the donor deceased
LAST_NAME_ORG	Last Name or Organization Name
ORG_CONTACT_PERSON	<future: TntMPD 2.2> When it's an organization (PERSON_TYPE="O"), who is the contact person for this organization?
FIRST_NAME	First Name
MIDDLE_NAME	Middle Name
TITLE	Title (Mr., Mrs.)
SUFFIX	Suffix (Jr., Sr.)
SP_LAST_NAME	for spouse
SP_FIRST_NAME	for spouse
SP_MIDDLE_NAME	for spouse
SP_TITLE	for spouse
SP_SUFFIX	for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.
ADDR1	Street Address (Line 1)
ADDR2	Street Address (Line 2)
ADDR3	Street Address (Line 3)
ADDR4	Street Address (Line 4)
CITY	City
STATE	State
ZIP	Postal Code
COUNTRY	(A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.
CNTRY_DESCR	Name of country.
ADDR_CHANGED	(M/D/YYYY) When the addres was last changed.
ADDR_VALID	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
PHONE	Phone number.
PHONE_CHANGED	(M/D/YYYY) When the phone was last changed.
PHONE_VALID	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
MOBILE_PHONE	<future: TntMPD 2.2> Mobile phone number.
MOBILE_PHONE_CHANGED	<future: TntMPD 2.2> (M/D/YYYY) When the mobile phone was last changed.
MOBILE_PHONE_VALID	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
SPOUSE_MOBILE_PHONE	<future: TntMPD 2.2> Spouse mobile phone number.
SPOUSE_MOBILE_PHONE_CHANGED	<future: TntMPD 2.2> (M/D/YYYY) When the spouse mobile phone was last changed.
SPOUSE_MOBILE_PHONE_VALID	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
EMAIL	<future: TntMPD 2.2> Email address.
EMAIL_CHANGED	<future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.
EMAIL_VALID	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
SPOUSE_EMAIL	<future: TntMPD 2.2> Email address.
SPOUSE_EMAIL_CHANGED	<future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.
SPOUSE_EMAIL_VALID	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
MEMO	<future: TntMPD 2.2> A note regarding the donor.
MAGAZINE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?
DECEASED	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?
REMINDER	<future: TntMPD 2.2> (A18) How often is the donor reminded by the organization to make a donation?
RELATED_IDS	<future: TntMPD 2.2> A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Here's an example result:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Addresses By IDs Query

This Query only differs from the Addresses Query in that it uses the $PERSONIDS$ parameter instead of the $DATEFROM$ parameter. The $PERSONID$ parameter is substituted by a comma separated list of donor IDs. These donor IDs are obtained from donations in the Donations Query. TntMPD will never submit a request with more than 200 donor IDs.

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional) <new for TntMPD 2.0>

The purpose of this query is to return a list of different profiles associated with the user. This allows a user to have different "modes" for downloading information, without having to setup different username/passwords for each mode. This works especially well in a Single Sign On (SSO) environment.

Example result:

PROFILE_CODE	PROFILE_DESCRIPTION
	Staff Account (Default)
MIN1	Operating Account #1
MIN2	Operating Account #2

Field Descriptions:

FieldName	Description
PROFILE_CODE	(A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.
PROFILE_DESCRIPTION	(A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

Designations Query (Optional) <future: TntMPD 2.2>

The purpose of this query is to simply return the designations of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

DESIG_ID	DESIG_NAME	ORG_PATH
12345678	Doe, John & Jane	/CAMPUS/STAFF/

Field Descriptions:

FieldName	Description
DESIG_ID	(A18) Designation id associated with this user/profile.
DESIG_NAME	(A50) Designation account name associated with this user.
ORG_PATH	(Text) Where this designation fits in the organizational tree.

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. (Leading zeros will be removed from numeric donor ids.) But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective. Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

Testing your compatibility with TntMPD

To test your online donation system's compatibility with TntMPD, pull up the "Gift Input from Web" screen. Where it has you choose your Organization, choose "Custom". (Note: You must hold down the Shift key when you drop down the list.) Then you can simply type in the URL of your Query INI File. That is all there is to it!

Making it easy for your staff to connect...

If you want to include your organization in the drop down list where you choose the Organization, just send me an email. (wolbrink@ccci.org) Be sure to include your organization's name, and the URL of your Query INI File. I can update the list on my website, and your organization will automatically appear in the list.

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org I would be glad to help you.

How can I make my organization's online donation system compatible with TntMPD?

Troy Wolbrink — Tue, 24 Jan 2012 20:08:23 GMT

Revision 18 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/24/2012 3:08:23 PM

How can I make my organization's online donation system compatible with TntMPD?

Filed under: Developer Guides

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details
Download names and addresses of donors
Be notified of their staff account balance

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file
Account Balance Query
Donations Query
Addresses Query
Addresses By IDs Query
Profiles Query (Optional) <new for TntMPD 2.0>
Designations Query (Optional) <future: TntMPD 2.2>

Query INI File

[DESIGNATIONS.2.2]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDesigs&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

Now let me explain the meaning of each value...

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]
[DONATIONS.2.1]
[DONATIONS.2.0]
[DONATIONS.2]
[DONATIONS]

The Queries

$ACCOUNT$	The user name of the staff logging in to the donation system.
$PASSWORD$	The password of the staff logging in to the donation system.
$PROFILE$	<new for TntMPD 2.0> The profile code of the staff logging in to the donation system. If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$ placeholder is never provided in the Profiles Query itself.
$DATEFROM$	The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)
$DATETO$	The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)
$PERSONIDS$	A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

Action=TntBalance&Username=JohnDoe&Password=abc123

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Note for anyone writing a front-end: existing legacy servers may return errors using a different format, such as BAD_PASSWORD instead of ERROR, with a multi-line error description.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID	ACCT_NAME	BALANCE
12345678	Doe, John & Jane	1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName	Description
EMPLID	Comma separated list of designation ids (A18) associated with this user/profile.
ACCT_NAME	List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.
BALANCE	(Text) Custom text that describes the user's account balance.

Donations Query

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
DISPLAY_DATE	(M/D/YYYY) Date of contribution
AMOUNT	(Float) Amount of contribution
DONATION_ID	(A18) Donation ID
DESIGNATION	(A18) What account this donation is designated for (normally same as employee id)
MOTIVATION	(A18) (Optional) If you track this in your donation system you may include this code here.
PAYMENT_METHOD	<future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.
TENDERED_AMOUNT	<future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor. You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.
TENDERED_CURRENCY	<future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.
MEMO	<future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.
BASE_CURRENCY	<future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.
PERSONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Addresses Query

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
PERSON_TYPE	"O" or "P" (Organization or Person)
LAST_NAME_ORG	Last Name or Organization Name
FIRST_NAME	First Name
MIDDLE_NAME	Middle Name
TITLE	Title (Mr., Mrs.)
SUFFIX	Suffix (Jr., Sr.)
SP_LAST_NAME	for spouse
SP_FIRST_NAME	for spouse
SP_MIDDLE_NAME	for spouse
SP_TITLE	for spouse
SP_SUFFIX	for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.
ADDR1	Street Address (Line 1)
ADDR2	Street Address (Line 2)
ADDR3	Street Address (Line 3)
ADDR4	Street Address (Line 4)
CITY	City
STATE	State
ZIP	Postal Code
COUNTRY	(A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.
CNTRY_DESCR	Name of country.
ADDR_CHANGED	(M/D/YYYY) When the addres was last changed.
ADDR_DELIVERABLE
ADDR_VALID	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
PHONE	Phone number.
PHONE_CHANGED	(M/D/YYYY) When the phone was last changed.
PHONE_OPERATIONAL
PHONE_VALID	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
MOBILE_PHONE	<future: TntMPD 2.2> Mobile phone number.
MOBILE_PHONE_CHANGED	<future: TntMPD 2.2> (M/D/YYYY) When the mobile phone was last changed.
MOBILE_PHONE_VALID	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
SPOUSE_MOBILE_PHONE	<future: TntMPD 2.2> Spouse mobile phone number.
SPOUSE_MOBILE_PHONE_CHANGED	<future: TntMPD 2.2> (M/D/YYYY) When the spouse mobile phone was last changed.
SPOUSE_MOBILE_PHONE_VALID	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
EMAIL	<future: TntMPD 2.2> Email address.
EMAIL_CHANGED	<future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.
EMAIL_OPERATIONAL
EMAIL_VALID	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
MEMO
SPOUSE_EMAIL	<future: TntMPD 2.2> Email address.
SPOUSE_EMAIL_CHANGED	<future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.
SPOUSE_EMAIL_VALID	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
MEMO	<future: TntMPD 2.2> A note regarding the donor.
MAGAZINE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?
DECEASED	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?
REMINDER	<future: TntMPD 2.2> (A18) How often is the donor reminded by the organization to make a donation?
RELATED_IDS	<future: TntMPD 2.2> A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

Addresses By IDs Query

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional) <new for TntMPD 2.0>

Example result:

PROFILE_CODE	PROFILE_DESCRIPTION
	Staff Account (Default)
MIN1	Operating Account #1
MIN2	Operating Account #2

Field Descriptions:

FieldName	Description
PROFILE_CODE	(A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.
PROFILE_DESCRIPTION	(A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

Designations Query (Optional) <future: TntMPD 2.2>

The purpose of this query is to simply return the designations of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

DESIG_ID	DESIG_NAME	ORG_PATH
12345678	Doe, John & Jane	/CAMPUS/STAFF/

Field Descriptions:

FieldName	Description
DESIG_ID	(A18) Designation id associated with this user/profile.
DESIG_NAME	(A50) Designation account name associated with this user.
ORG_PATH	(Text) Where this designation fits in the organizational tree.

Case Insensitivity

Testing your compatibility with TntMPD

Making it easy for your staff to connect...

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org I would be glad to help you.

How can I make my organization's online donation system compatible with TntMPD?

Troy Wolbrink — Mon, 03 Oct 2011 21:35:22 GMT

Revision 17 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/3/2011 5:35:22 PM

How can I make my organization's online donation system compatible with TntMPD?

Filed under: Developer Guides

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details
Download names and addresses of donors
Be notified of their staff account balance

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file
Account Balance Query
Donations Query
Addresses Query
Addresses By IDs Query
Profiles Query (Optional) <new for TntMPD 2.0>
Designations Query (Optional) <future: TntMPD 2.2>

Query INI File

[DESIGNATIONS.2.2]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDesigs&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

Now let me explain the meaning of each value...

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]
[DONATIONS.2.1]
[DONATIONS.2.0]
[DONATIONS.2]
[DONATIONS]

The Queries

$ACCOUNT$	The user name of the staff logging in to the donation system.
$PASSWORD$	The password of the staff logging in to the donation system.
$PROFILE$	<new for TntMPD 2.0> The profile code of the staff logging in to the donation system. If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$ placeholder is never provided in the Profiles Query itself.
$DATEFROM$	The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)
$DATETO$	The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)
$PERSONIDS$	A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

Action=TntBalance&Username=JohnDoe&Password=abc123

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Note for anyone writing a front-end: existing legacy servers may return errors using a different format, such as BAD_PASSWORD instead of ERROR, with a multi-line error description.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID	ACCT_NAME	BALANCE
12345678	Doe, John & Jane	1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName	Description
EMPLID	Comma separated list of designation ids (A18) associated with this user/profile.
ACCT_NAME	List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.
BALANCE	(Text) Custom text that describes the user's account balance.

Donations Query

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
DISPLAY_DATE	(M/D/YYYY) Date of contribution
AMOUNT	(Float) Amount of contribution
DONATION_ID	(A18) Donation ID
DESIGNATION	(A18) What account this donation is designated for (normally same as employee id)
MOTIVATION	(A18) (Optional) If you track this in your donation system you may include this code here.
PAYMENT_METHOD	<future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.
TENDERED_AMOUNT	<future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor. You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.
TENDERED_CURRENCY	<future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.
MEMO	<future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.
BASE_CURRENCY	<future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.
PERSONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Addresses Query

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
PERSON_TYPE	"O" or "P" (Organization or Person)
LAST_NAME_ORG	Last Name or Organization Name
FIRST_NAME	First Name
MIDDLE_NAME	Middle Name
TITLE	Title (Mr., Mrs.)
SUFFIX	Suffix (Jr., Sr.)
SP_LAST_NAME	for spouse
SP_FIRST_NAME	for spouse
SP_MIDDLE_NAME	for spouse
SP_TITLE	for spouse
SP_SUFFIX	for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.
ADDR1	Street Address (Line 1)
ADDR2	Street Address (Line 2)
ADDR3	Street Address (Line 3)
ADDR4	Street Address (Line 4)
CITY	City
STATE	State
ZIP	Postal Code
COUNTRY	(A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.
CNTRY_DESCR	Name of country.
ADDR_CHANGED	(M/D/YYYY) When the addres was last changed.
ADDR_DELIVERABLE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
PHONE	Phone number.
PHONE_CHANGED	(M/D/YYYY) When the phone was last changed.
PHONE_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
EMAIL	<future: TntMPD 2.2> Email address.
EMAIL_CHANGED	<future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.
EMAIL_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
MEMO	<future: TntMPD 2.2> A note regarding the donor.
MAGAZINE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?
DECEASED	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?
REMINDER	<future: TntMPD 2.2> (A18) How often is the donor reminded by the organization to make a donation?
RELATED_IDS	<future: TntMPD 2.2> A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

Addresses By IDs Query

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional) <new for TntMPD 2.0>

Example result:

PROFILE_CODE	PROFILE_DESCRIPTION
	Staff Account (Default)
MIN1	Operating Account #1
MIN2	Operating Account #2

Field Descriptions:

FieldName	Description
PROFILE_CODE	(A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.
PROFILE_DESCRIPTION	(A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

Designations Query (Optional) <future: TntMPD 2.2>

The purpose of this query is to simply return the designations of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

DESIG_ID	DESIG_NAME	ORG_PATH
12345678	Doe, John & Jane	/CAMPUS/STAFF/

Field Descriptions:

FieldName	Description
DESIG_ID	(A18) Designation id associated with this user/profile.
DESIG_NAME	(A50) Designation account name associated with this user.
ORG_PATH	(Text) Where this designation fits in the organizational tree.

Case Insensitivity

Testing your compatibility with TntMPD

Making it easy for your staff to connect...

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org I would be glad to help you.

How can I make my organization's online donation system compatible with TntMPD?

Troy Wolbrink — Mon, 03 Oct 2011 21:24:38 GMT

Revision 16 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/3/2011 5:24:38 PM

How can I make my organization's online donation system compatible with TntMPD?

Filed under: Developer Guides

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details
Download names and addresses of donors
Be notified of their staff account balance

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file
Account Balance Query
Donations Query
Addresses Query
Addresses By IDs Query
Profiles Query (Optional) <new for TntMPD 2.0>
Designations Query (Optional) <future: TntMPD 2.2>

Query INI File

[DESIGNATIONS.2.2]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDesigs&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

Now let me explain the meaning of each value...

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]
[DONATIONS.2.1]
[DONATIONS.2.0]
[DONATIONS.2]
[DONATIONS]

The Queries

$ACCOUNT$	The user name of the staff logging in to the donation system.
$PASSWORD$	The password of the staff logging in to the donation system.
$PROFILE$	<new for TntMPD 2.0> The profile code of the staff logging in to the donation system. If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$ placeholder is never provided in the Profiles Query itself.
$DATEFROM$	The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)
$DATETO$	The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)
$PERSONIDS$	A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

Action=TntBalance&Username=JohnDoe&Password=abc123

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Note for anyone writing a front-end: existing legacy servers may return errors using a different format, such as BAD_PASSWORD instead of ERROR, with a multi-line error description.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID	ACCT_NAME	BALANCE
12345678	Doe, John & Jane	1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName	Description
EMPLID	Comma separated list of designation ids (A18) associated with this user/profile.
ACCT_NAME	List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.
BALANCE	(Text) Custom text that describes the user's account balance.

Donations Query

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
DISPLAY_DATE	(M/D/YYYY) Date of contribution
AMOUNT	(Float) Amount of contribution
DONATION_ID	(A18) Donation ID
DESIGNATION	(A18) What account this donation is designated for (normally same as employee id)
MOTIVATION	(A18) (Optional) If you track this in your donation system you may include this code here.
PAYMENT_METHOD	<future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.
TENDERED_AMOUNT	<future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor. You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.
TENDERED_CURRENCY	<future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.
MEMO	<future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.
BASE_CURRENCY	<future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.
PERSONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Addresses Query

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
PERSON_TYPE	"O" or "P" (Organization or Person)
LAST_NAME_ORG	Last Name or Organization Name
FIRST_NAME	First Name
MIDDLE_NAME	Middle Name
TITLE	Title (Mr., Mrs.)
SUFFIX	Suffix (Jr., Sr.)
SP_LAST_NAME	for spouse
SP_FIRST_NAME	for spouse
SP_MIDDLE_NAME	for spouse
SP_TITLE	for spouse
SP_SUFFIX	for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.
ADDR1	Street Address (Line 1)
ADDR2	Street Address (Line 2)
ADDR3	Street Address (Line 3)
ADDR4	Street Address (Line 4)
CITY	City
STATE	State
ZIP	Postal Code
COUNTRY	(A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.
CNTRY_DESCR	Name of country.
ADDR_CHANGED	(M/D/YYYY) When the addres was last changed.
ADDR_DELIVERABLE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
PHONE	Phone number.
PHONE_CHANGED	(M/D/YYYY) When the phone was last changed.
PHONE_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
EMAIL	<future: TntMPD 2.2> Email address.
EMAIL_CHANGED	<future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.
EMAIL_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
MEMO	<future: TntMPD 2.2> A note regarding the donor.
MAGAZINE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?
DECEASED	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?
REMINDER	<future: TntMPD 2.2> (A18) How often is the donor reminded by the organization to make a donation?
RELATED_IDS	<future: TntMPD 2.2> A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

Addresses By IDs Query

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional) <new for TntMPD 2.0>

Example result:

PROFILE_CODE	PROFILE_DESCRIPTION
	Staff Account (Default)
MIN1	Operating Account #1
MIN2	Operating Account #2

Field Descriptions:

FieldName	Description
PROFILE_CODE	(A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.
PROFILE_DESCRIPTION	(A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

Designations Query (Optional) <future: TntMPD 2.2>

The purpose of this query is to simply return the designations of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

DESIG_ID	DESIG_NAME	ORG_PATH
12345678	Doe, John & Jane	/CAMPUS/STAFF/

Field Descriptions:

FieldName	Description
DESIG_ID	(A18) Designation id associated with this user/profile.
DESIG_NAME	(A50) Designation account name associated with this user.
ORG_PATH	(Text) Where this designation fits in the organizational tree.

Case Insensitivity

Testing your compatibility with TntMPD

Making it easy for your staff to connect...

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org I would be glad to help you.

How can I make my organization's online donation system compatible with TntMPD?

Troy Wolbrink — Mon, 03 Oct 2011 21:10:06 GMT

Revision 15 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/3/2011 5:10:06 PM

How can I make my organization's online donation system compatible with TntMPD?

Filed under: Developer Guides

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details
Download names and addresses of donors
Be notified of their staff account balance

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file
Account Balance Query
Donations Query
Addresses Query
Addresses By IDs Query
Profiles Query (Optional) <new for TntMPD 2.0>
Designations Query (Optional) <future: TntMPD 2.2>

Query INI File

[DESIGNATIONS.2.2]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDesigs&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

Now let me explain the meaning of each value...

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]
[DONATIONS.2.1]
[DONATIONS.2.0]
[DONATIONS.2]
[DONATIONS]

The Queries

$ACCOUNT$	The user name of the staff logging in to the donation system.
$PASSWORD$	The password of the staff logging in to the donation system.
$PROFILE$	<new for TntMPD 2.0> The profile code of the staff logging in to the donation system. If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$ placeholder is never provided in the Profiles Query itself.
$DATEFROM$	The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)
$DATETO$	The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)
$PERSONIDS$	A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

Action=TntBalance&Username=JohnDoe&Password=abc123

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Note for anyone writing a front-end: existing legacy servers may return errors using a different format, such as BAD_PASSWORD instead of ERROR, with a multi-line error description.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID	ACCT_NAME	BALANCE
12345678	Doe, John & Jane	1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName	Description
EMPLID	Comma separated list of designation ids (A18) associated with this user/profile.
ACCT_NAME	List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.
BALANCE	(Text) Custom text that describes the user's account balance.

Donations Query

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
DISPLAY_DATE	(M/D/YYYY) Date of contribution
AMOUNT	(Float) Amount of contribution
DONATION_ID	(A18) Donation ID
DESIGNATION	(A18) What account this donation is designated for (normally same as employee id)
MOTIVATION	(A18) (Optional) If you track this in your donation system you may include this code here.
PAYMENT_METHOD	<future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.
TENDERED_AMOUNT	<future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor. You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.
TENDERED_CURRENCY	<future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.
MEMO	<future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.
BASE_CURRENCY	<future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.
PERSONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Addresses Query

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
PERSON_TYPE	"O" or "P" (Organization or Person)
LAST_NAME_ORG	Last Name or Organization Name
FIRST_NAME	First Name
MIDDLE_NAME	Middle Name
TITLE	Title (Mr., Mrs.)
SUFFIX	Suffix (Jr., Sr.)
SP_LAST_NAME	for spouse
SP_FIRST_NAME	for spouse
SP_MIDDLE_NAME	for spouse
SP_TITLE	for spouse
SP_SUFFIX	for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.
ADDR1	Street Address (Line 1)
ADDR2	Street Address (Line 2)
ADDR3	Street Address (Line 3)
ADDR4	Street Address (Line 4)
CITY	City
STATE	State
ZIP	Postal Code
COUNTRY	(A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.
CNTRY_DESCR	Name of country.
ADDR_CHANGED	(M/D/YYYY) When the addres was last changed.
ADDR_DELIVERABLE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
PHONE	Phone number.
PHONE_CHANGED	(M/D/YYYY) When the phone was last changed.
PHONE_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
EMAIL	<future: TntMPD 2.2> Email address.
EMAIL_CHANGED	<future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.
EMAIL_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
MEMO	<future: TntMPD 2.2> A note regarding the donor.
MAGAZINE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?
DECEASED	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?
REMINDER	<future: TntMPD 2.2> (A18) How often is the donor reminded by the organization to make a donation?
RELATED_IDS	<future: TntMPD 2.2> A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

Addresses By IDs Query

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional) <new for TntMPD 2.0>

Example result:

PROFILE_CODE	PROFILE_DESCRIPTION
	Staff Account (Default)
MIN1	Operating Account #1
MIN2	Operating Account #2

Field Descriptions:

FieldName	Description
PROFILE_CODE	(A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.
PROFILE_DESCRIPTION	(A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

Designations Query (Optional) <future: TntMPD 2.2>

The purpose of this query is to simply return the designations of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

DESIG_ID	DESIG_NAME	ORG_PATH
12345678	Doe, John & Jane	/CAMPUS/STAFF/

Field Descriptions:

FieldName	Description
DESIG_ID	(A18) Designation id associated with this user/profile.
DESIG_NAME	(A50) Designation account name associated with this user.
ORG_PATH	(Text) Where this designation fits in the organizational tree.

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective. Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

Testing your compatibility with TntMPD

Making it easy for your staff to connect...

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org I would be glad to help you.

How can I make my organization's online donation system compatible with TntMPD?

Troy Wolbrink — Mon, 03 Oct 2011 21:09:33 GMT

Revision 14 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/3/2011 5:09:33 PM

How can I make my organization's online donation system compatible with TntMPD?

Filed under: Developer Guides

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details
Download names and addresses of donors
Be notified of their staff account balance

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file
Account Balance Query
Donations Query
Addresses Query
Addresses By IDs Query
Profiles Query (Optional) <new for TntMPD 2.0>
Designations Query (Optional) <future: TntMPD 2.2>

Query INI File

[DESIGNATIONS.2.2]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDesigs&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

Now let me explain the meaning of each value...

[ORGANIZATION]
// If you move your Query INI File, you can permanently redirect users to the new query.ini url.
RedirectQueryIni=
// Specify the name of your organization here.
Name=Your Organization Name
// Specify a short abbreviation of your organization here.
Abbreviation=MyOrg
// Old versions of TntMPD may use this. This has been deprecated. Use "WebLogo-JPEG-470x120" on new work.
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
// URL of where your logo can be downloaded (JPEG only).
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
// URL of a mini portal into your website
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
// URL to help your staff get setup with an account.
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
// URL of your banner ad.
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
// Boundary of how back your online donation system provides data for. (M/D/YYYY)
MinimumWebGiftDate=1/1/1990
// Unique code to represent your ministry internally to TntMPD. (User never sees this.)
Code=MyOrg-USA
// Set this to "1" if you want the queries to use basic HTTP authentication
QueryAuthentication=0
// TntMPD internally removes leading zeros from numeric donor account ids. Specify the minimum number of
// digits a donor id should be, and TntMPD will add leading zeros when returning them back in the
// "Addresses By IDs Query" query.
MinPidLength=0
// <new for TntMPD 2.1.16> Specify an email address where users can report errors with your download process.
OrgHelpEmail=help@myorg.org
// <new for TntMPD 2.0> Specify a url where users can report errors with your download process.
OrgHelpUrl=https://www.myorg.org/help.htm
// <new for TntMPD 2.0> Specify the text users will see for OrgHelpUrl.
OrgHelpUrlDescription=Click here to report this issue over the Web!
// <new for TntMPD 2.0> Specify alternative text for how users can get help with downloading information.
OrgHelpOther=You may also reach the us at 123-456-7890.
// <new for TntMPD 2.0> Specify the url where users can request new download profiles.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
// <new for TntMPD 2.0.44> Specify the url where users can view a staff portal.
StaffPortalUrl=http://myorg.org/staffportal.html
// <future: TntMPD 2.2> Specify the base currency code (ISO 4217 3-char) for gifts returning from your
// Donations Query.
BaseCurrencyCode=USD
// <new for TntMPD 2.1.68> indicates if TntMPD is allowed to attempt logging in while user types password.
AllowPassiveAuth=True
[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/    // URL of your online donation system.
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$  // Your POST template. (described later)

[ACCOUNT_BALANCE.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

[DONATIONS]    // URL and POST have same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[DONATIONS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[ADDRESSES]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&PID=$PERSONIDS$

[ADDRESSES_BY_PERSONIDS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder
                                                                                               // included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[PROFILES.2] <new for TntMPD 2.0>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=Profiles&Username=$ACCOUNT$&Password=$PASSWORD$

[DESIGNATIONS.2.2]   <future: TntMPD 2.2>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDesigs&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]
[DONATIONS.2.1]
[DONATIONS.2.0]
[DONATIONS.2]
[DONATIONS]

The Queries

$ACCOUNT$	The user name of the staff logging in to the donation system.
$PASSWORD$	The password of the staff logging in to the donation system.
$PROFILE$	<new for TntMPD 2.0> The profile code of the staff logging in to the donation system. If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$ placeholder is never provided in the Profiles Query itself.
$DATEFROM$	The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)
$DATETO$	The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)
$PERSONIDS$	A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

Action=TntBalance&Username=JohnDoe&Password=abc123

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Note for anyone writing a front-end: existing legacy servers may return errors using a different format, such as BAD_PASSWORD instead of ERROR, with a multi-line error description.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID	ACCT_NAME	BALANCE
12345678	Doe, John & Jane	1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName	Description
EMPLID	Comma separated list of designation ids (A18) associated with this user/profile.
ACCT_NAME	List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.
BALANCE	(Text) Custom text that describes the user's account balance.

Donations Query

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
DISPLAY_DATE	(M/D/YYYY) Date of contribution
AMOUNT	(Float) Amount of contribution
DONATION_ID	(A18) Donation ID
DESIGNATION	(A18) What account this donation is designated for (normally same as employee id)
MOTIVATION	(A18) (Optional) If you track this in your donation system you may include this code here.
PAYMENT_METHOD	<future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.
TENDERED_AMOUNT	<future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor. You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.
TENDERED_CURRENCY	<future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.
MEMO	<future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.
BASE_CURRENCY	<future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.
PERSONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Addresses Query

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
PERSON_TYPE	"O" or "P" (Organization or Person)
LAST_NAME_ORG	Last Name or Organization Name
FIRST_NAME	First Name
MIDDLE_NAME	Middle Name
TITLE	Title (Mr., Mrs.)
SUFFIX	Suffix (Jr., Sr.)
SP_LAST_NAME	for spouse
SP_FIRST_NAME	for spouse
SP_MIDDLE_NAME	for spouse
SP_TITLE	for spouse
SP_SUFFIX	for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.
ADDR1	Street Address (Line 1)
ADDR2	Street Address (Line 2)
ADDR3	Street Address (Line 3)
ADDR4	Street Address (Line 4)
CITY	City
STATE	State
ZIP	Postal Code
COUNTRY	(A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.
CNTRY_DESCR	Name of country.
ADDR_CHANGED	(M/D/YYYY) When the addres was last changed.
ADDR_DELIVERABLE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
PHONE	Phone number.
PHONE_CHANGED	(M/D/YYYY) When the phone was last changed.
PHONE_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
EMAIL	<future: TntMPD 2.2> Email address.
EMAIL_CHANGED	<future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.
EMAIL_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
MEMO	<future: TntMPD 2.2> A note regarding the donor.
MAGAZINE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?
DECEASED	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?
REMINDER	<future: TntMPD 2.2> (A18) How often is the donor reminded by the organization to make a donation?
RELATED_IDS	<future: TntMPD 2.2> A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

Addresses By IDs Query

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional) <new for TntMPD 2.0>

Example result:

PROFILE_CODE	PROFILE_DESCRIPTION
	Staff Account (Default)
MIN1	Operating Account #1
MIN2	Operating Account #2

Field Descriptions:

FieldName	Description
PROFILE_CODE	(A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.
PROFILE_DESCRIPTION	(A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

Designations Query (Optional) <future: TntMPD 2.2>

The purpose of this query is to simply return the designations of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

DESIG_ID	DESIG_NAME	ORG_PATH
12345678	Doe, John & Jane	/CAMPUS/STAFF/

Field Descriptions:

FieldName	Description
DESIG_ID	(A18) Designation id associated with this user/profile.
DESIG_NAME	(A50) Designation account name associated with this user.
ORG_PATH	(Text) Where this designation fits in the organizational tree.

Case Insensitivity

Testing your compatibility with TntMPD

Making it easy for your staff to connect...

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org I would be glad to help you.

How can I make my organization's online donation system compatible with TntMPD?

Troy Wolbrink — Mon, 03 Oct 2011 20:13:45 GMT

Revision 13 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/3/2011 4:13:45 PM

How can I make my organization's online donation system compatible with TntMPD?

Filed under: Developer Guides

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details
Download names and addresses of donors
Be notified of their staff account balance

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file
Account Balance Query
Donations Query
Addresses Query
Addresses By IDs Query
Profiles Query (Optional) <new for TntMPD 2.0>
Designations Query (Optional) <future: TntMPD 2.2>

Query INI File

[APPLICATION]
MinimumVersion=1.5.0
RecommendedVersion=1.5.0

[ORGANIZATION]
RedirectQueryIni=
Name=Your Organization Name
Abbreviation=MyOrg
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
MinimumWebGiftDate=1/1/1990
Code=MyOrg-USA
QueryAuthentication=0
MinPidLength=0
OrgHelpEmail=help@myorg.org
OrgHelpUrl=https://www.myorg.org/help.htm
OrgHelpUrlDescription=Click here to report this issue over the Web!
OrgHelpOther=You may also reach the CCC Call Center at 407-826-2948.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
StaffPortalUrl=http://myorg.org/staffportal.html
BaseCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

[DESIGNATIONS.2.2]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDesigs&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

Now let me explain the meaning of each value...

[ORGANIZATION]
// If you move your Query INI File, you can permanently redirect users to the new query.ini url.
RedirectQueryIni=
// Specify the name of your organization here.
Name=Your Organization Name
// Specify a short abbreviation of your organization here.
Abbreviation=MyOrg
// Really old Old versions of TntMPD may use this. This has been deprecated. Use "WebLogo-JPEG-470x120" on new work.
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
// URL of where your logo can be downloaded (JPEG only).
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
// URL of a mini portal into your website
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
// URL to help your staff get setup with an account.
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
// URL of your banner ad.
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
// Boundary of how back your online donation system provides data for. (M/D/YYYY)
MinimumWebGiftDate=1/1/1990
// Unique code to represent your ministry internally to TntMPD. (User never sees this.)
Code=MyOrg-USA
// Set this to "1" if you want the queries to use basic HTTP authentication
QueryAuthentication=0
// TntMPD internally removes leading zeros from numeric donor account ids. Specify the minimum number of digits a
// digits a donor id should be, and TntMPD will add leading zeros when returning them back in the
// "Addresses By IDs Query" query.
MinPidLength=0
// <new for TntMPD 2.1.16> Specify an email address where users can report errors with your download process.
OrgHelpEmail=help@myorg.org
// <new for TntMPD 2.0> Specify a url where users can report errors with your download process.
OrgHelpUrl=https://www.myorg.org/help.htm
// <new for TntMPD 2.0> Specify the text users will see for OrgHelpUrl.
OrgHelpUrlDescription=Click here to report this issue over the Web!
// <new for TntMPD 2.0> Specify alternative text for how users can get help with downloading information.
OrgHelpOther=You may also reach the us at 123-456-7890.
// <new for TntMPD 2.0> Specify the url where users can request new download profiles.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
// <new for TntMPD 2.0.44> Specify the url where users can view a staff portal.
StaffPortalUrl=http://myorg.org/staffportal.html
// <future: TntMPD 2.2> Specify the base currency code (ISO 4217 3-char) for gifts returning from your
// Donations Query.
BaseCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/    // URL of your online donation system.
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$   &Username=$ACCOUNT$&Password=$PASSWORD$  // Your POST template. (described later)

[ACCOUNT_BALANCE.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

[DONATIONS]    // URL and POST have same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[DONATIONS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[ADDRESSES]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&PID=$PERSONIDS$

[ADDRESSES_BY_PERSONIDS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder
                                                                                               // included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[PROFILES.2] <new for TntMPD 2.0>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=Profiles&Username=$ACCOUNT$&Password=$PASSWORD$

[DESIGNATIONS.2.2]   <future: TntMPD 2.2>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDesigs&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]
[DONATIONS.2.1]
[DONATIONS.2.0]
[DONATIONS.2]
[DONATIONS]

The Queries

$ACCOUNT$	The user name of the staff logging in to the donation system.
$PASSWORD$	The password of the staff logging in to the donation system.
$PROFILE$	<new for TntMPD 2.0> The profile code of the staff logging in to the donation system. If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$ placeholder is never provided in the Profiles Query itself.
$DATEFROM$	The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)
$DATETO$	The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)
$PERSONIDS$	A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

Action=TntBalance&Username=JohnDoe&Password=abc123

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Note for anyone writing a front-end: existing legacy servers may return errors using a different format, such as BAD_PASSWORD instead of ERROR, with a multi-line error description.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID	ACCT_NAME	BALANCE
12345678	Doe, John & Jane	1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName	Description
EMPLID	Comma separated list of designation ids (A18) associated with this user/profile.
ACCT_NAME	List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.
BALANCE	(Text) Custom text that describes the user's account balance.

Donations Query

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
DISPLAY_DATE	(M/D/YYYY) Date of contribution
AMOUNT	(Float) Amount of contribution
DONATION_ID	(A18) Donation ID
DESIGNATION	(A18) What account this donation is designated for (normally same as employee id)
MOTIVATION	(A18) (Optional) If you track this in your donation system you may include this code here.
PAYMENT_METHOD	<future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.
TENDERED_AMOUNT	<future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor. You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.
TENDERED_CURRENCY	<future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.
MEMO	<future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.
BASE_CURRENCY	<future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.
PERSONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Addresses Query

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
PERSON_TYPE	"O" or "P" (Organization or Person)
LAST_NAME_ORG	Last Name or Organization Name
FIRST_NAME	First Name
MIDDLE_NAME	Middle Name
TITLE	Title (Mr., Mrs.)
SUFFIX	Suffix (Jr., Sr.)
SP_LAST_NAME	for spouse
SP_FIRST_NAME	for spouse
SP_MIDDLE_NAME	for spouse
SP_TITLE	for spouse
SP_SUFFIX	for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.
ADDR1	Street Address (Line 1)
ADDR2	Street Address (Line 2)
ADDR3	Street Address (Line 3)
ADDR4	Street Address (Line 4)
CITY	City
STATE	State
ZIP	Postal Code
COUNTRY	(A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.
CNTRY_DESCR	Name of country.
ADDR_CHANGED	(M/D/YYYY) When the addres was last changed.
ADDR_DELIVERABLE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
PHONE	Phone number.
PHONE_CHANGED	(M/D/YYYY) When the phone was last changed.
PHONE_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
EMAIL	<future: TntMPD 2.2> Email address.
EMAIL_CHANGED	<future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.
EMAIL_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
MEMO	<future: TntMPD 2.2> A note regarding the donor.
MAGAZINE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?
DECEASED	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?
REMINDER	<future: TntMPD 2.2> (A18) How often is the donor reminded by the organization to make a donation?
RELATED_IDS	<future: TntMPD 2.2> A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

Addresses By IDs Query

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional) <new for TntMPD 2.0>

Example result:

PROFILE_CODE	PROFILE_DESCRIPTION
	Staff Account (Default)
MIN1	Operating Account #1
MIN2	Operating Account #2

Field Descriptions:

FieldName	Description
PROFILE_CODE	(A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.
PROFILE_DESCRIPTION	(A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

Designations Query (Optional) <future: TntMPD 2.2>

The purpose of this query is to simply return the designations of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

DESIG_ID	DESIG_NAME	ORG_PATH
12345678	Doe, John & Jane	/CAMPUS/STAFF/

Field Descriptions:

FieldName	Description
DESIG_ID	(A18) Designation id associated with this user/profile.
DESIG_NAME	(A50) Designation account name associated with this user.
ORG_PATH	(Text) Where this designation fits in the organizational tree.

Case Insensitivity

Testing your compatibility with TntMPD

Making it easy for your staff to connect...

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org I would be glad to help you.

How can I make my organization's online donation system compatible with TntMPD?

Troy Wolbrink — Mon, 03 Oct 2011 20:06:02 GMT

Revision 12 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/3/2011 4:06:02 PM

How can I make my organization's online donation system compatible with TntMPD?

Filed under: Developer Guides

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details
Download names and addresses of donors
Be notified of their staff account balance

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file
Account Balance Query
Donations Query
Addresses Query
Addresses By IDs Query
Profiles Query (Optional) <new for TntMPD 2.0>
SingleSignOn
Designations Query (Optional) <future: TntMPD 2.2>

Query INI File

[APPLICATION]
MinimumVersion=1.5.0
RecommendedVersion=1.5.0

[ORGANIZATION]
RedirectQueryIni=
Name=Your Organization Name
Abbreviation=MyOrg
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
MinimumWebGiftDate=1/1/1990
Code=MyOrg-USA
QueryAuthentication=0
MinPidLength=0
OrgHelpEmail=help@myorg.org
OrgHelpUrl=https://www.myorg.org/help.htm
OrgHelpUrlDescription=Click here to report this issue over the Web!
OrgHelpOther=You may also reach the CCC Call Center at 407-826-2948.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
StaffPortalUrl=http://myorg.org/staffportal.html
DefaultCurrencyCode=USD
BaseCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.2]
Url=https://www.myorg.org/cg-bin/ssoDESIGNATIONS.2.2]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Username=$ACCOUNT$&Password=$PASSWORD$
Post=Action=TntDesigs&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

Now let me explain the meaning of each value...

[ORGANIZATION]
// If you move your Query INI File, you can permanently redirect users to the new query.ini url.
RedirectQueryIni=
// Specify the name of your organization here.
Name=Your Organization Name
// Specify a short abbreviation of your organization here.
Abbreviation=MyOrg
// Really old versions of TntMPD may use this. This has been deprecated. Use "WebLogo-JPEG-470x120" on new work.
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
// URL of where your logo can be downloaded (JPEG only).
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
// URL of a mini portal into your website
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
// URL to help your staff get setup with an account.
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
// URL of your banner ad.
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
// Boundary of how back your online donation system provides data for. (M/D/YYYY)
MinimumWebGiftDate=1/1/1990
// Unique code to represent your ministry internally to TntMPD. (User never sees this.)
Code=MyOrg-USA
// Set this to "1" if you want the queries to use basic HTTP authentication
QueryAuthentication=0
// TntMPD internally removes leading zeros from numeric donor account ids. Specify the minimum number of digits a
// donor id should be, and TntMPD will add leading zeros when returning them back in the "Addresses By IDs Query" query.
MinPidLength=0
// <new for TntMPD 2.1.16> Specify an email address where users can report errors with your download process.
OrgHelpEmail=help@myorg.org
// <new for TntMPD 2.0> Specify a url where users can report errors with your download process.
OrgHelpUrl=https://www.myorg.org/help.htm
// <new for TntMPD 2.0> Specify the text users will see for OrgHelpUrl.
OrgHelpUrlDescription=Click here to report this issue over the Web!
// <new for TntMPD 2.0> Specify alternative text for how users can get help with downloading information.
OrgHelpOther=You may also reach the us at 123-456-7890.
// <new for TntMPD 2.0> Specify the url where users can request new download profiles.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
// <new for TntMPD 2.0.44> Specify the url where users can view a staff portal.
StaffPortalUrl=http://myorg.org/staffportal.html
// <future: TntMPD 2.2> Specify the base currency code (ISO 4217 3-char) for gifts returning from your Donations Query.
DefaultCurrencyCode=USD
BaseCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/    // URL of your online donation system.
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$    // Your POST template. (described later)

[ACCOUNT_BALANCE.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

[DONATIONS]    // URL and POST have same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[DONATIONS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[ADDRESSES]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&PID=$PERSONIDS$

[ADDRESSES_BY_PERSONIDS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[PROFILES.2] <new for TntMPD 2.0>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=Profiles&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.2] DESIGNATIONS.2.2]   <future: TntMPD 2.2>
// Note: If this query were actually used, credentials would not be
//   passed in to the other queries. But $SSO_TICKET$ would be used instead.
Url=https://www.myorg.org/cg-bin/sso>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Username=$ACCOUNT$&Password=$PASSWORD$
Post=Action=TntDesigs&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]
[DONATIONS.2.1]
[DONATIONS.2.0]
[DONATIONS.2]
[DONATIONS]

The Queries

$ACCOUNT$	The user name of the staff logging in to the donation system.
$PASSWORD$	The password of the staff logging in to the donation system.
$SSO_TICKET$	<future: TntMPD 2.2> The service ticket returned by the SingleSignOn Query. Generally you would use this in lieu of $ACCOUNT$ and $PASSWORD$. Note: The SingleSignOn query never receives the $SSO_TICKET$ placeholder, but only accepts $ACCOUNT$ and $PASSWORD$.
$PROFILE$	<new for TntMPD 2.0> The profile code of the staff logging in to the donation system. If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$ placeholder is never provided in the Profiles Query itself.
$DATEFROM$	The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)
$DATETO$	The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)
$PERSONIDS$	A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

Action=TntBalance&Username=JohnDoe&Password=abc123

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Note for anyone writing a front-end: existing legacy servers may return errors using a different format, such as BAD_PASSWORD instead of ERROR, with a multi-line error description.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID	ACCT_NAME	BALANCE
12345678	Doe, John & Jane	1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName	Description
EMPLID	Comma separated list of designation ids (A18) associated with this user/profile.
ACCT_NAME	List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.
BALANCE	(Text) Custom text that describes the user's account balance.

Donations Query

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
DISPLAY_DATE	(M/D/YYYY) Date of contribution
AMOUNT	(Float) Amount of contribution
DONATION_ID	(A18) Donation ID
DESIGNATION	(A18) What account this donation is designated for (normally same as employee id)
MOTIVATION	(A18) (Optional) If you track this in your donation system you may include this code here.
PAYMENT_METHOD	<future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.
TENDERED_AMOUNT	<future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor. You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.
TENDERED_CURRENCY	<future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.
MEMO	<future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.
BASE_CURRENCY	<future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" "BaseCurrencyCode" should be defined once in the [Organization] section.
PERSONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Addresses Query

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
PERSON_TYPE	"O" or "P" (Organization or Person)
LAST_NAME_ORG	Last Name or Organization Name
FIRST_NAME	First Name
MIDDLE_NAME	Middle Name
TITLE	Title (Mr., Mrs.)
SUFFIX	Suffix (Jr., Sr.)
SP_LAST_NAME	for spouse
SP_FIRST_NAME	for spouse
SP_MIDDLE_NAME	for spouse
SP_TITLE	for spouse
SP_SUFFIX	for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.
ADDR1	Street Address (Line 1)
ADDR2	Street Address (Line 2)
ADDR3	Street Address (Line 3)
ADDR4	Street Address (Line 4)
CITY	City
STATE	State
ZIP	Postal Code
COUNTRY	(A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.
CNTRY_DESCR	Name of country.
ADDR_CHANGED	(M/D/YYYY) When the addres was last changed.
ADDR_DELIVERABLE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
PHONE	Phone number.
PHONE_CHANGED	(M/D/YYYY) When the phone was last changed.
PHONE_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
EMAIL	<future: TntMPD 2.2> Email address.
EMAIL_CHANGED	<future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.
EMAIL_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
MEMO	<future: TntMPD 2.2> A note regarding the donor.
MAGAZINE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?
DECEASED	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?
REMINDER	<future: TntMPD 2.2> (A18) How often is the donor reminded by the organization to make a donation?
RELATED_IDS	<future: TntMPD 2.2> A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

Addresses By IDs Query

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional) <new for TntMPD 2.0>

Example result:

PROFILE_CODE	PROFILE_DESCRIPTION
	Staff Account (Default)
MIN1	Operating Account #1
MIN2	Operating Account #2

Field Descriptions:

FieldName	Description
PROFILE_CODE	(A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.
PROFILE_DESCRIPTION	(A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

SingleSignOn

Designations Query (Optional) <future: TntMPD 2.2>

The purpose of this query is to simply return a one-time-use authentication ticket that can be used in one (and only one) querythe designations of the staff member submitting the request. It receives only uses the $ACCOUNT$ ACCOUNT$, $PASSWORD$ and $PASSWORD$. It should return one rowPROFILE$ placeholders.

Example result:

SSO_TICKET

ST-gjdhgvyudmfnbgbyf

DESIG_ID	DESIG_NAME	ORG_PATH
12345678	Doe, John & Jane	/CAMPUS/STAFF/

Field Descriptions:

FieldName	Description
SSO_TICKET
DESIG_ID	(A18) Designation id associated with this user/profile.
DESIG_NAME	(A50) Designation account name associated with this user.
ORG_PATH	(Text) An authentication "service" ticket than can be passed into another query for one-time useWhere this designation fits in the organizational tree.

Case Insensitivity

Testing your compatibility with TntMPD

Making it easy for your staff to connect...

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org I would be glad to help you.

How can I make my organization's online donation system compatible with TntMPD?

Troy Wolbrink — Fri, 02 Sep 2011 18:42:20 GMT

Revision 11 posted to Frequently Asked Questions (English) by Troy Wolbrink on 9/2/2011 2:42:20 PM

How can I make my organization's online donation system compatible with TntMPD?

Filed under: Developer Guides

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details
Download names and addresses of donors
Be notified of their staff account balance

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file
Account Balance Query
Donations Query
Addresses Query
Addresses By IDs Query
Profiles Query (Optional) <new for TntMPD 2.0>
SingleSignOn Query (Optional) <future: TntMPD 2.2>

Query INI File

[APPLICATION]
MinimumVersion=1.5.0
RecommendedVersion=1.5.0

[ORGANIZATION]
RedirectQueryIni=
Name=Your Organization Name
Abbreviation=MyOrg
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
MinimumWebGiftDate=1/1/1990
Code=MyOrg-USA
QueryAuthentication=0
MinPidLength=0
OrgHelpEmail=help@myorg.org
OrgHelpUrl=https://www.myorg.org/help.htm
OrgHelpUrlDescription=Click here to report this issue over the Web!
OrgHelpOther=You may also reach the CCC Call Center at 407-826-2948.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
StaffPortalUrl=http://myorg.org/staffportal.html
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.2]
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

Now let me explain the meaning of each value...

[ORGANIZATION]
// If you move your Query INI File, you can permanently redirect users to the new query.ini url.
RedirectQueryIni=
// Specify the name of your organization here.
Name=Your Organization Name
// Specify a short abbreviation of your organization here.
Abbreviation=MyOrg
// Really old versions of TntMPD may use this. This has been deprecated. Use "WebLogo-JPEG-470x120" on new work.
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
// URL of where your logo can be downloaded (JPEG only).
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
// URL of a mini portal into your website
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
// URL to help your staff get setup with an account.
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
// URL of your banner ad.
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
// Boundary of how back your online donation system provides data for. (M/D/YYYY)
MinimumWebGiftDate=1/1/1990
// Unique code to represent your ministry internally to TntMPD. (User never sees this.)
Code=MyOrg-USA
// Set this to "1" if you want the queries to use basic HTTP authentication
QueryAuthentication=0
// TntMPD internally removes leading zeros from numeric donor account ids. Specify the minimum number of digits a
// donor id should be, and TntMPD will add leading zeros when returning them back in the "Addresses By IDs Query" query.
MinPidLength=0
// <new for TntMPD 2.1.16> Specify an email address where users can report errors with your download process.
OrgHelpEmail=help@myorg.org
// <new for TntMPD 2.0> Specify a url where users can report errors with your download process.
OrgHelpUrl=https://www.myorg.org/help.htm
// <new for TntMPD 2.0> Specify the text users will see for OrgHelpUrl.
OrgHelpUrlDescription=Click here to report this issue over the Web!
// <new for TntMPD 2.0> Specify alternative text for how users can get help with downloading information.
OrgHelpOther=You may also reach the us at 123-456-7890.
// <new for TntMPD 2.0> Specify the url where users can request new download profiles.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
// <new for TntMPD 2.0.44> Specify the url where users can view a staff portal.
StaffPortalUrl=http://myorg.org/staffportal.html
// <future: TntMPD 2.2> Specify the base currency code (ISO 4217 3-char) for gifts returning from your Donations Query.
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/    // URL of your online donation system.
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$    // Your POST template. (described later)

[ACCOUNT_BALANCE.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

[DONATIONS]    // URL and POST have same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[DONATIONS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[ADDRESSES]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&PID=$PERSONIDS$

[ADDRESSES_BY_PERSONIDS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[PROFILES.2] <new for TntMPD 2.0>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=Profiles&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.2] <future: TntMPD 2.2>
// Note: If this query were actually used, credentials would not be
//   passed in to the other queries. But $SSO_TICKET$ would be used instead.
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]
[DONATIONS.2.1]
[DONATIONS.2.0]
[DONATIONS.2]
[DONATIONS]

The Queries

$ACCOUNT$	The user name of the staff logging in to the donation system.
$PASSWORD$	The password of the staff logging in to the donation system.
$SSO_TICKET$	<future: TntMPD 2.2> The service ticket returned by the SingleSignOn Query. Generally you would use this in lieu of $ACCOUNT$ and $PASSWORD$. Note: The SingleSignOn query never receives the $SSO_TICKET$ placeholder, but only accepts $ACCOUNT$ and $PASSWORD$.
$PROFILE$	<new for TntMPD 2.0> The profile code of the staff logging in to the donation system. If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$ placeholder is never provided in the Profiles Query itself.
$DATEFROM$	The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)
$DATETO$	The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)
$PERSONIDS$	A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

<divre></divre>Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

<divre></divre>Action=TntBalance&Username=JohnDoe&Password=abc123

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Note for anyone writing a front-end: existing legacy servers may return errors using a different format, such as BAD_PASSWORD instead of ERROR, with a multi-line error description.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID	ACCT_NAME	BALANCE
12345678	Doe, John & Jane	1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName	Description
EMPLID	Comma separated list of designation ids (A18) associated with this user/profile.
ACCT_NAME	List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.
BALANCE	(Text) Custom text that describes the user's account balance.

Donations Query

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
DISPLAY_DATE	(M/D/YYYY) Date of contribution
AMOUNT	(Float) Amount of contribution
DONATION_ID	(A18) Donation ID
DESIGNATION	(A18) What account this donation is designated for (normally same as employee id)
MOTIVATION	(A18) (Optional) If you track this in your donation system you may include this code here.
PAYMENT_METHOD	<future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.
TENDERED_AMOUNT	<future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor. You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.
TENDERED_CURRENCY	<future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.
MEMO	<future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.
BASE_CURRENCY	<future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" should be defined once in the [Organization] section.
PERSONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Addresses Query

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
PERSON_TYPE	"O" or "P" (Organization or Person)
LAST_NAME_ORG	Last Name or Organization Name
FIRST_NAME	First Name
MIDDLE_NAME	Middle Name
TITLE	Title (Mr., Mrs.)
SUFFIX	Suffix (Jr., Sr.)
SP_LAST_NAME	for spouse
SP_FIRST_NAME	for spouse
SP_MIDDLE_NAME	for spouse
SP_TITLE	for spouse
SP_SUFFIX	for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.
ADDR1	Street Address (Line 1)
ADDR2	Street Address (Line 2)
ADDR3	Street Address (Line 3)
ADDR4	Street Address (Line 4)
CITY	City
STATE	State
ZIP	Postal Code
COUNTRY	(A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.
CNTRY_DESCR	Name of country.
ADDR_CHANGED	(M/D/YYYY) When the addres was last changed.
ADDR_DELIVERABLE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
PHONE	Phone number.
PHONE_CHANGED	(M/D/YYYY) When the phone was last changed.
PHONE_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
EMAIL	<future: TntMPD 2.2> Email address.
EMAIL_CHANGED	<future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.
EMAIL_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".

Addresses By IDs Query

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional) <new for TntMPD 2.0>

Example result:

PROFILE_CODE	PROFILE_DESC	PROFILE_DESCRIPTION
	Staff Account (Default)
MIN1	Operating Account #1
MIN2	Operating Account #2

Field Descriptions:

FieldName	Description
PROFILE_CODE	(A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.
PROFILE_DESCRIPTION	(A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

SingleSignOn Query (Optional) <future: TntMPD 2.2>

The purpose of this query is to return a one-time-use authentication ticket that can be used in one (and only one) query. It receives $ACCOUNT$ and $PASSWORD$. It should return one row.

Example result:

SSO_TICKET

ST-gjdhgvyudmfnbgbyf

Field Descriptions:

FieldName	Description
SSO_TICKET	(Text) An authentication "service" ticket than can be passed into another query for one-time use.

Case Insensitivity

Testing your compatibility with TntMPD

Making it easy for your staff to connect...

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org I would be glad to help you.

How can I make my organization's online donation system compatible with TntMPD?

Troy Wolbrink — Mon, 14 Mar 2011 14:50:37 GMT

Revision 10 posted to Frequently Asked Questions (English) by Troy Wolbrink on 3/14/2011 10:50:37 AM

How can I make my organization's online donation system compatible with TntMPD?

Filed under: Developer Guides

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details
Download names and addresses of donors
Be notified of their staff account balance

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file
Account Balance Query
Donations Query
Addresses Query
Addresses By IDs Query
Profiles Query (Optional) <new for TntMPD 2.0>
SingleSignOn Query (Optional) <future: TntMPD 2.2>

Query INI File

[APPLICATION]
MinimumVersion=1.5.0
RecommendedVersion=1.5.0

[ORGANIZATION]
RedirectQueryIni=
Name=Your Organization Name
Abbreviation=MyOrg
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
MinimumWebGiftDate=1/1/1990
Code=MyOrg-USA
QueryAuthentication=0
MinPidLength=0
OrgHelpEmail=help@myorg.org
OrgHelpUrl=https://www.myorg.org/help.htm
OrgHelpUrlDescription=Click here to report this issue over the Web!
OrgHelpOther=You may also reach the CCC Call Center at 407-826-2948.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
StaffPortalUrl=http://myorg.org/staffportal.html
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.2]
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

Now let me explain the meaning of each value...

[ORGANIZATION]
// If you move your Query INI File, you can permanently redirect users to the new query.ini url.
RedirectQueryIni=
// Specify the name of your organization here.
Name=Your Organization Name
// Specify a short abbreviation of your organization here.
Abbreviation=MyOrg
// Really old versions of TntMPD may use this. This has been deprecated. Use "WebLogo-JPEG-470x120" on new work.
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
// URL of where your logo can be downloaded (JPEG only).
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
// URL of a mini portal into your website
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
// URL to help your staff get setup with an account.
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
// URL of your banner ad.
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
// Boundary of how back your online donation system provides data for. (M/D/YYYY)
MinimumWebGiftDate=1/1/1990
// Unique code to represent your ministry internally to TntMPD. (User never sees this.)
Code=MyOrg-USA
// Set this to "1" if you want the queries to use basic HTTP authentication
QueryAuthentication=0
// TntMPD internally removes leading zeros from numeric donor account ids. Specify the minimum number of digits a
// donor id should be, and TntMPD will add leading zeros when returning them back in the "Addresses By IDs Query" query.
MinPidLength=0
// <new for TntMPD 2.1.16> Specify an email address where users can report errors with your download process.
OrgHelpEmail=help@myorg.org
// <new for TntMPD 2.0> Specify a url where users can report errors with your download process.
OrgHelpUrl=https://www.myorg.org/help.htm
// <new for TntMPD 2.0> Specify the text users will see for OrgHelpUrl.
OrgHelpUrlDescription=Click here to report this issue over the Web!
// <new for TntMPD 2.0> Specify alternative text for how users can get help with downloading information.
OrgHelpOther=You may also reach the us at 123-456-7890.
// <new for TntMPD 2.0> Specify the url where users can request new download profiles.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
// <new for TntMPD 2.0.44> Specify the url where users can view a staff portal.
StaffPortalUrl=http://myorg.org/staffportal.html
// <future: TntMPD 2.2> Specify the base currency code (ISO 4217 3-char) for gifts returning from your Donations Query.
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/    // URL of your online donation system.
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$    // Your POST template. (described later)

[ACCOUNT_BALANCE.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

[DONATIONS]    // URL and POST have same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[DONATIONS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[ADDRESSES]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&PID=$PERSONIDS$

[ADDRESSES_BY_PERSONIDS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[PROFILES.2] <new for TntMPD 2.0>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=Profiles&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.2] <future: TntMPD 2.2>
// Note: If this query were actually used, credentials would not be
//   passed in to the other queries. But $SSO_TICKET$ would be used instead.
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]
[DONATIONS.2.1]
[DONATIONS.2.0]
[DONATIONS.2]
[DONATIONS]

The Queries

$ACCOUNT$	The user name of the staff logging in to the donation system.
$PASSWORD$	The password of the staff logging in to the donation system.
$SSO_TICKET$	<future: TntMPD 2.2> The service ticket returned by the SingleSignOn Query. Generally you would use this in lieu of $ACCOUNT$ and $PASSWORD$. Note: The SingleSignOn query never receives the $SSO_TICKET$ placeholder, but only accepts $ACCOUNT$ and $PASSWORD$.
$PROFILE$	<new for TntMPD 2.0> The profile code of the staff logging in to the donation system. If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$ placeholder is never provided in the Profiles Query itself.
$DATEFROM$	The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)
$DATETO$	The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)
$PERSONIDS$	A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

<divre></divre>Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

<divre></divre>Action=TntBalance&Username=JohnDoe&Password=abc123

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Note for anyone writing a front-end: existing legacy servers may return errors using a different format, such as BAD_PASSWORD instead of ERROR, with a multi-line error description.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID	ACCT_NAME	BALANCE
12345678	Doe, John & Jane	1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName	Description
EMPLID	Comma separated list of designation ids (A18) associated with this user/profile.
ACCT_NAME	List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.
BALANCE	(Text) Custom text that describes the user's account balance.

Donations Query

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
DISPLAY_DATE	(M/D/YYYY) Date of contribution
AMOUNT	(Float) Amount of contribution
DONATION_ID	(A18) Donation ID
DESIGNATION	(A18) What account this donation is designated for (normally same as employee id)
MOTIVATION	(A18) (Optional) If you track this in your donation system you may include this code here.
PAYMENT_METHOD	<future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.
TENDERED_AMOUNT	<future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor. You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.
TENDERED_CURRENCY	<future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.
MEMO	<future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.
BASE_CURRENCY	<future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" should be defined once in the [Organization] section.
PERSONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Addresses Query

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
PERSON_TYPE	"O" or "P" (Organization or Person)
LAST_NAME_ORG	Last Name or Organization Name
FIRST_NAME	First Name
MIDDLE_NAME	Middle Name
TITLE	Title (Mr., Mrs.)
SUFFIX	Suffix (Jr., Sr.)
SP_LAST_NAME	for spouse
SP_FIRST_NAME	for spouse
SP_MIDDLE_NAME	for spouse
SP_TITLE	for spouse
SP_SUFFIX	for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.
ADDR1	Street Address (Line 1)
ADDR2	Street Address (Line 2)
ADDR3	Street Address (Line 3)
ADDR4	Street Address (Line 4)
CITY	City
STATE	State
ZIP	Postal Code
COUNTRY	(A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.
CNTRY_DESCR	Name of country.
ADDR_CHANGED	(M/D/YYYY) When the addres was last changed.
ADDR_DELIVERABLE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
PHONE	Phone number.
PHONE_CHANGED	(M/D/YYYY) When the phone was last changed.
PHONE_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
EMAIL	<future: TntMPD 2.2> Email address.
EMAIL_CHANGED	<future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.
EMAIL_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".

Addresses By IDs Query

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional) <new for TntMPD 2.0>

Example result:

PROFILE_CODE	PROFILE_DESC
	Staff Account (Default)
MIN1	Operating Account #1
MIN2	Operating Account #2

Field Descriptions:

FieldName	Description
PROFILE_CODE	(A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.
PROFILE_DESCRIPTION	(A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

SingleSignOn Query (Optional) <future: TntMPD 2.2>

The purpose of this query is to return a one-time-use authentication ticket that can be used in one (and only one) query. It receives $ACCOUNT$ and $PASSWORD$. It should return one row.

Example result:

SSO_TICKET

ST-gjdhgvyudmfnbgbyf

Field Descriptions:

FieldName	Description
SSO_TICKET	(Text) An authentication "service" ticket than can be passed into another query for one-time use.

Case Insensitivity

Testing your compatibility with TntMPD

Making it easy for your staff to connect...

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org I would be glad to help you.

How can I make my organization's online donation system compatible with TntMPD?

Steve Simms — Mon, 15 Mar 2010 21:47:14 GMT

Revision 9 posted to Frequently Asked Questions (English) by Steve Simms on 3/15/2010 5:47:14 PM

How can I make my organization's online donation system compatible with TntMPD?

Filed under: Developer Guides

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details
Download names and addresses of donors
Be notified of their staff account balance

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file
Account Balance Query
Donations Query
Addresses Query
Addresses By IDs Query
Profiles Query (Optional) <new for TntMPD 2.0>
SingleSignOn Query (Optional) <future: TntMPD 2.2>

Query INI File

[APPLICATION]
MinimumVersion=1.5.0
RecommendedVersion=1.5.0

[ORGANIZATION]
RedirectQueryIni=
Name=Your Organization Name
Abbreviation=MyOrg
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
MinimumWebGiftDate=1/1/1990
Code=MyOrg-USA
QueryAuthentication=0
MinPidLength=0
OrgHelpEmail=help@myorg.org
OrgHelpUrl=https://www.myorg.org/help.htm
OrgHelpUrlDescription=Click here to report this issue over the Web!
OrgHelpOther=You may also reach the CCC Call Center at 407-826-2948.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
StaffPortalUrl=http://myorg.org/staffportal.html
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.2]
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

Now let me explain the meaning of each value...

[ORGANIZATION]
// If you move your Query INI File, you can permanently redirect users to the new query.ini url.
RedirectQueryIni=
// Specify the name of your organization here.
Name=Your Organization Name
// Specify a short abbreviation of your organization here.
Abbreviation=MyOrg
// Really old versions of TntMPD may use this. This has been deprecated. Use "WebLogo-JPEG-470x120" on new work.
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
// URL of where your logo can be downloaded (JPEG only).
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
// URL of a mini portal into your website
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
// URL to help your staff get setup with an account.
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
// URL of your banner ad.
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
// Boundary of how back your online donation system provides data for. (M/D/YYYY)
MinimumWebGiftDate=1/1/1990
// Unique code to represent your ministry internally to TntMPD. (User never sees this.)
Code=MyOrg-USA
// Set this to "1" if you want the queries to use basic HTTP authentication
QueryAuthentication=0
// TntMPD internally removes leading zeros from numeric donor account ids. Specify the minimum number of digits a
// donor id should be, and TntMPD will add leading zeros when returning them back in the "Addresses By IDs Query" query.
MinPidLength=0
// <new for TntMPD 2.1.16> Specify an email address where users can report errors with your download process.
OrgHelpEmail=help@myorg.org
// <new for TntMPD 2.0> Specify a url where users can report errors with your download process.
OrgHelpUrl=https://www.myorg.org/help.htm
// <new for TntMPD 2.0> Specify the text users will see for OrgHelpUrl.
OrgHelpUrlDescription=Click here to report this issue over the Web!
// <new for TntMPD 2.0> Specify alternative text for how users can get help with downloading information.
OrgHelpOther=You may also reach the us at 123-456-7890.
// <new for TntMPD 2.0> Specify the url where users can request new download profiles.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
// <new for TntMPD 2.0.44> Specify the url where users can view a staff portal.
StaffPortalUrl=http://myorg.org/staffportal.html
// <future: TntMPD 2.2> Specify the base currency code (ISO 4217 3-char) for gifts returning from your Donations Query.
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/    // URL of your online donation system.
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$    // Your POST template. (described later)

[ACCOUNT_BALANCE.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

[DONATIONS]    // URL and POST have same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[DONATIONS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[ADDRESSES]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&PID=$PERSONIDS$

[ADDRESSES_BY_PERSONIDS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[PROFILES.2] <new for TntMPD 2.0>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=Profiles&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.2] <future: TntMPD 2.2>
// Note: If this query were actually used, credentials would not be
//   passed in to the other queries. But $SSO_TICKET$ would be used instead.
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]
[DONATIONS.2.1]
[DONATIONS.2.0]
[DONATIONS.2]
[DONATIONS]

The Queries

$ACCOUNT$	The user name of the staff logging in to the donation system.
$PASSWORD$	The password of the staff logging in to the donation system.
$SSO_TICKET$	<future: TntMPD 2.2> The service ticket returned by the SingleSignOn Query. Generally you would use this in lieu of $ACCOUNT$ and $PASSWORD$. Note: The SingleSignOn query never receives the $SSO_TICKET$ placeholder, but only accepts $ACCOUNT$ and $PASSWORD$.
$PROFILE$	<new for TntMPD 2.0> The profile code of the staff logging in to the donation system. If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$ placeholder is never provided in the Profiles Query itself.
$DATEFROM$	The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)
$DATETO$	The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)
$PERSONIDS$	A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

<divre></divre>Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

<divre></divre>Action=TntBalance&Username=JohnDoe&Password=abc123

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Note for anyone writing a front-end: existing legacy servers may return errors using a different format, such as BAD_PASSWORD instead of ERROR, with a multi-line error description.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID	ACCT_NAME	BALANCE
12345678	Doe, John & Jane	1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName	Description
EMPLID	Comma separated list of designation ids (A18) associated with this user/profile.
ACCT_NAME	List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.
BALANCE	(Text) Custom text that describes the user's account balance.

Donations Query

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
DISPLAY_DATE	(M/D/YYYY) Date of contribution
AMOUNT	(Float) Amount of contribution
DONATION_ID	(A18) Donation ID
DESIGNATION	(A18) What account this donation is designated for (normally same as employee id)
MOTIVATION	(A18) (Optional) If you track this in your donation system you may include this code here.
PAYMENT_METHOD	<future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.
TENDERED_AMOUNT	<future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor. You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.
TENDERED_CURRENCY	<future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.
MEMO	<future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.
BASE_CURRENCY	<future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" should be defined once in the [Organization] section.

Addresses Query

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
PERSON_TYPE	"O" or "P" (Organization or Person)
LAST_NAME_ORG	Last Name or Organization Name
FIRST_NAME	First Name
MIDDLE_NAME	Middle Name
TITLE	Title (Mr., Mrs.)
SUFFIX	Suffix (Jr., Sr.)
SP_LAST_NAME	for spouse
SP_FIRST_NAME	for spouse
SP_MIDDLE_NAME	for spouse
SP_TITLE	for spouse
SP_SUFFIX	for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.
ADDR1	Street Address (Line 1)
ADDR2	Street Address (Line 2)
ADDR3	Street Address (Line 3)
ADDR4	Street Address (Line 4)
CITY	City
STATE	State
ZIP	Postal Code
COUNTRY	(A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.
CNTRY_DESCR	Name of country.
ADDR_CHANGED	(M/D/YYYY) When the addres was last changed.
ADDR_DELIVERABLE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
PHONE	Phone number.
PHONE_CHANGED	(M/D/YYYY) When the phone was last changed.
PHONE_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
EMAIL	<future: TntMPD 2.2> Email address.
EMAIL_CHANGED	<future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.
EMAIL_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".

Addresses By IDs Query

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional) <new for TntMPD 2.0>

Example result:

PROFILE_CODE	PROFILE_DESC
	Staff Account (Default)
MIN1	Operating Account #1
MIN2	Operating Account #2

Field Descriptions:

FieldName	Description
PROFILE_CODE	(A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.
PROFILE_DESCRIPTION	(A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

SingleSignOn Query (Optional) <future: TntMPD 2.2>

The purpose of this query is to return a one-time-use authentication ticket that can be used in one (and only one) query. It receives $ACCOUNT$ and $PASSWORD$. It should return one row.

Example result:

SSO_TICKET

ST-gjdhgvyudmfnbgbyf

Field Descriptions:

FieldName	Description
SSO_TICKET	(Text) An authentication "service" ticket than can be passed into another query for one-time use.

Case Insensitivity

Testing your compatibility with TntMPD

Making it easy for your staff to connect...

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org I would be glad to help you.

How can I make my organization's online donation system compatible with TntMPD?

Troy Wolbrink — Tue, 23 Feb 2010 18:35:37 GMT

Revision 8 posted to Frequently Asked Questions (English) by Troy Wolbrink on 2/23/2010 1:35:37 PM

How can I make my organization's online donation system compatible with TntMPD?

Filed under: Developer Guides

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details
Download names and addresses of donors
Be notified of their staff account balance

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file
Account Balance Query
Donations Query
Addresses Query
Addresses By IDs Query
Profiles Query (Optional) <new for TntMPD 2.0>
SingleSignOn Query (Optional) <future: TntMPD 2.2>

Query INI File

[APPLICATION]
MinimumVersion=1.5.0
RecommendedVersion=1.5.0

[ORGANIZATION]
RedirectQueryIni=
Name=Your Organization Name
Abbreviation=MyOrg
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
MinimumWebGiftDate=1/1/1990
Code=MyOrg-USA
QueryAuthentication=0
MinPidLength=0
OrgHelpEmail=help@myorg.org
OrgHelpUrl=https://www.myorg.org/help.htm
OrgHelpUrlDescription=Click here to report this issue over the Web!
OrgHelpOther=You may also reach the CCC Call Center at 407-826-2948.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
StaffPortalUrl=http://myorg.org/staffportal.html
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.2]
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

Now let me explain the meaning of each value...

[ORGANIZATION]
// If you move your Query INI File, you can permanently redirect users to the new query.ini url.
RedirectQueryIni=
// Specify the name of your organization here.
Name=Your Organization Name
// Specify a short abbreviation of your organization here.
Abbreviation=MyOrg
// Really old versions of TntMPD may use this. This has been deprecated. Use "WebLogo-JPEG-470x120" on new work.
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
// URL of where your logo can be downloaded (JPEG only).
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
// URL of a mini portal into your website
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
// URL to help your staff get setup with an account.
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
// URL of your banner ad.
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
// Boundary of how back your online donation system provides data for. (M/D/YYYY)
MinimumWebGiftDate=1/1/1990
// Unique code to represent your ministry internally to TntMPD. (User never sees this.)
Code=MyOrg-USA
// Set this to "1" if you want the queries to use basic HTTP authentication
QueryAuthentication=0
// TntMPD internally removes leading zeros from numeric donor account ids. Specify the minimum number of digits a
// donor id should be, and TntMPD will add leading zeros when returning them back in the "Addresses By IDs Query" query.
MinPidLength=0
// <new for TntMPD 2.1.16> Specify an email address where users can report errors with your download process.
OrgHelpEmail=help@myorg.org
// <new for TntMPD 2.0> Specify a url where users can report errors with your download process.
OrgHelpUrl=https://www.myorg.org/help.htm
// <new for TntMPD 2.0> Specify the text users will see for OrgHelpUrl.
OrgHelpUrlDescription=Click here to report this issue over the Web!
// <new for TntMPD 2.0> Specify alternative text for how users can get help with downloading information.
OrgHelpOther=You may also reach the us at 123-456-7890.
// <new for TntMPD 2.0> Specify the url where users can request new download profiles.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
// <new for TntMPD 2.0.44> Specify the url where users can view a staff portal.
StaffPortalUrl=http://myorg.org/staffportal.html
// <future: TntMPD 2.2> Specify the base currency code (ISO 4217 3-char) for gifts returning from your Donations Query.
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/    // URL of your online donation system.
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$    // Your POST template. (described later)

[ACCOUNT_BALANCE.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

[DONATIONS]    // URL and POST have same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[DONATIONS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[ADDRESSES]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&PID=$PERSONIDS$

[ADDRESSES_BY_PERSONIDS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[PROFILES.2] <new for TntMPD 2.0>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=Profiles&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.2] <future: TntMPD 2.2>
// Note: If this query were actually used, credentials would not be
//   passed in to the other queries. But $SSO_TICKET$ would be used instead.
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]
[DONATIONS.2.1]
[DONATIONS.2.0]
[DONATIONS.2]
[DONATIONS]

The Queries

$ACCOUNT$	The user name of the staff logging in to the donation system.
$PASSWORD$	The password of the staff logging in to the donation system.
$SSO_TICKET$	<future: TntMPD 2.2> The service ticket returned by the SingleSignOn Query. Generally you would use this in lieu of $ACCOUNT$ and $PASSWORD$. Note: The SingleSignOn query never receives the $SSO_TICKET$ placeholder, but only accepts $ACCOUNT$ and $PASSWORD$.
$PROFILE$	<new for TntMPD 2.0> The profile code of the staff logging in to the donation system. If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$ placeholder is never provided in the Profiles Query itself.
$DATEFROM$	The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)
$DATETO$	The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)
$PERSONIDS$	A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

<divre></divre>Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

<divre></divre>Action=TntBalance&Username=JohnDoe&Password=abc123

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID	ACCT_NAME	BALANCE
12345678	Doe, John & Jane	1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName	Description
EMPLID	Comma separated list of designation ids (A18) associated with this user/profile.
ACCT_NAME	List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.
BALANCE	(Text) Custom text that describes the user's account balance.

Donations Query

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
DISPLAY_DATE	(M/D/YYYY) Date of contribution
AMOUNT	(Float) Amount of contribution
DONATION_ID	(A18) Donation ID
DESIGNATION	(A18) What account this donation is designated for (normally same as employee id)
MOTIVATION	(A18) (Optional) If you track this in your donation system you may include this code here.
PAYMENT_METHOD	<future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.
TENDERED_AMOUNT	<future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor. You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.
TENDERED_CURRENCY	<future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.
MEMO	<future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.
BASE_CURRENCY	<future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" should be defined once in the [Organization] section.

Addresses Query

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
PERSON_TYPE	"O" or "P" (Organization or Person)
LAST_NAME_ORG	Last Name or Organization Name
FIRST_NAME	First Name
MIDDLE_NAME	Middle Name
TITLE	Title (Mr., Mrs.)
SUFFIX	Suffix (Jr., Sr.)
SP_LAST_NAME	for spouse
SP_FIRST_NAME	for spouse
SP_MIDDLE_NAME	for spouse
SP_TITLE	for spouse
SP_SUFFIX	for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.
ADDR1	Street Address (Line 1)
ADDR2	Street Address (Line 2)
ADDR3	Street Address (Line 3)
ADDR4	Street Address (Line 4)
CITY	City
STATE	State
ZIP	Postal Code
COUNTRY	(A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.
CNTRY_DESCR	Name of country.
ADDR_CHANGED	(M/D/YYYY) When the addres was last changed.
ADDR_DELIVERABLE	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
PHONE	Phone number.
PHONE_CHANGED	(M/D/YYYY) When the phone was last changed.
PHONE_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".
EMAIL	<future: TntMPD 2.2> Email address.
EMAIL_CHANGED	<future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.
EMAIL_OPERATIONAL	<future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "TRUE".

Addresses By IDs Query

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional) <new for TntMPD 2.0>

Example result:

PROFILE_CODE	PROFILE_DESC
	Staff Account (Default)
MIN1	Operating Account #1
MIN2	Operating Account #2

Field Descriptions:

FieldName	Description
PROFILE_CODE	(A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.
PROFILE_DESCRIPTION	(A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

SingleSignOn Query (Optional) <future: TntMPD 2.2>

The purpose of this query is to return a one-time-use authentication ticket that can be used in one (and only one) query. It receives $ACCOUNT$ and $PASSWORD$. It should return one row.

Example result:

SSO_TICKET

ST-gjdhgvyudmfnbgbyf

Field Descriptions:

FieldName	Description
SSO_TICKET	(Text) An authentication "service" ticket than can be passed into another query for one-time use.

Case Insensitivity

Testing your compatibility with TntMPD

Making it easy for your staff to connect...

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org I would be glad to help you.

How can I make my organization's online donation system compatible with TntMPD?

Troy Wolbrink — Sat, 30 May 2009 01:48:35 GMT

Revision 7 posted to Frequently Asked Questions (English) by Troy Wolbrink on 5/29/2009 9:48:35 PM

How can I make my organization's online donation system compatible with TntMPD?

Filed under: Developer Guides

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details
Download names and addresses of donors
Be notified of their staff account balance

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file
Account Balance Query
Donations Query
Addresses Query
Addresses By IDs Query
Profiles Query (Optional) <new for TntMPD 2.0>
SingleSignOn Query (Optional) <future: TntMPD 2.12.2>

Query INI File

[APPLICATION]
MinimumVersion=1.5.0
RecommendedVersion=1.5.0

[ORGANIZATION]
RedirectQueryIni=
Name=Your Organization Name
Abbreviation=MyOrg
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
MinimumWebGiftDate=1/1/1990
Code=MyOrg-USA
QueryAuthentication=0
MinPidLength=0
OrgHelpUrl=https://www.myorg.org/help.htm
OrgHelpUrlDescription=Click here to report this issue over the Web!
OrgHelpOther=You may also reach the CCC Call Center at 407-826-2948.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
StaffPortalUrl=http://myorg.org/staffportal.html
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.1]SingleSignOn.2.2]
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

Now let me explain the meaning of each value...

[ORGANIZATION]
// If you move your Query INI File, you can permanently redirect users to the new query.ini url.
RedirectQueryIni=
// Specify the name of your organization here.
Name=Your Organization Name
// Specify a short abbreviation of your organization here.
Abbreviation=MyOrg
// Really old versions of TntMPD may use this. This has been deprecated. Use "WebLogo-JPEG-470x120" on new work.
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
// URL of where your logo can be downloaded (JPEG only).
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
// URL of a mini portal into your website
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
// URL to help your staff get setup with an account.
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
// URL of your banner ad.
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
// Boundary of how back your online donation system provides data for. (M/D/YYYY)
MinimumWebGiftDate=1/1/1990
// Unique code to represent your ministry internally to TntMPD. (User never sees this.)
Code=MyOrg-USA
// Set this to "1" if you want the queries to use basic HTTP authentication
QueryAuthentication=0
// TntMPD internally removes leading zeros from numeric donor account ids. Specify the minimum number of digits a
// donor id should be, and TntMPD will add leading zeros when returning them back in the "Addresses By IDs Query" query.
MinPidLength=0
// <new for TntMPD 2.0> Specify a url where users can report errors with your download process.
OrgHelpUrl=https://www.myorg.org/help.htm
// <new for TntMPD 2.0> Specify the text users will see for OrgHelpUrl.
OrgHelpUrlDescription=Click here to report this issue over the Web!
// <new for TntMPD 2.0> Specify alternative text for how users can get help with downloading information.
OrgHelpOther=You may also reach the us at 123-456-7890.
// <new for TntMPD 2.0> Specify the url where users can request new download profiles.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
// <new for TntMPD 2.0.44> Specify the url where users can view a staff portal.
StaffPortalUrl=http://myorg.org/staffportal.html
// <future: TntMPD 2.12.2> Specify the base currency code (ISO 4217 3-char) for gifts returning from your Donations Query.
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/    // URL of your online donation system.
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$    // Your POST template. (described later)

[ACCOUNT_BALANCE.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

[DONATIONS]    // URL and POST have same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[DONATIONS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[ADDRESSES]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&PID=$PERSONIDS$

[ADDRESSES_BY_PERSONIDS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[PROFILES.2] <new for TntMPD 2.0>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=Profiles&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.1] SingleSignOn.2.2] <future: TntMPD 2.12.2>
// Note: If this query were actually used, credentials would not be
//   passed in to the other queries. But $SSO_TICKET$ would be used instead.
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]
[DONATIONS.2.1]
[DONATIONS.2.0]
[DONATIONS.2]
[DONATIONS]

The Queries

$ACCOUNT$	The user name of the staff logging in to the donation system.
$PASSWORD$	The password of the staff logging in to the donation system.
$SSO_TICKET$	<future: TntMPD 2.12.2> The service ticket returned by the SingleSignOn Query. Generally you would use this in lieu of $ACCOUNT$ and $PASSWORD$. Note: The SingleSignOn query never receives the $SSO_TICKET$ placeholder, but only accepts $ACCOUNT$ and $PASSWORD$.
$PROFILE$	<new for TntMPD 2.0> The profile code of the staff logging in to the donation system. If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$ placeholder is never provided in the Profiles Query itself.
$DATEFROM$	The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)
$DATETO$	The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)
$PERSONIDS$	A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

<divre></divre>Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

<divre></divre>Action=TntBalance&Username=JohnDoe&Password=abc123

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID	ACCT_NAME	BALANCE
12345678	Doe, John & Jane	1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName	Description
EMPLID	Comma separated list of designation ids (A18) associated with this user/profile.
ACCT_NAME	List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.
BALANCE	(Text) Custom text that describes the user's account balance.

Donations Query

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
DISPLAY_DATE	(M/D/YYYY) Date of contribution
AMOUNT	(Float) Amount of contribution
DONATION_ID	(A18) Donation ID
DESIGNATION	(A18) What account this donation is designated for (normally same as employee id)
MOTIVATION	(A18) (Optional) If you track this in your donation system you may include this code here.
PAYMENT_METHOD	<future: TntMPD 2.12.2> (A18) (Optional) Payment method of this donation.
TENDERED_AMOUNT	<future: TntMPD 2.12.2> (Float) (Optional) Amount of donation as tendered by donor. You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.
TENDERED_CURRENCY	<future: TntMPD 2.12.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.
MEMO	<future: TntMPD 2.12.2> (A) Any comments (no length limit) associated with this gift.
BASE_CURRENCY	<future: TntMPD 2.12.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" should be defined once in the [Organization] section.

Addresses Query

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
PERSON_TYPE	"O" or "P" (Organization or Person)
LAST_NAME_ORG	Last Name or Organization Name
FIRST_NAME	First Name
MIDDLE_NAME	Middle Name
TITLE	Title (Mr., Mrs.)
SUFFIX	Suffix (Jr., Sr.)
SP_LAST_NAME	for spouse
SP_FIRST_NAME	for spouse
SP_MIDDLE_NAME	for spouse
SP_TITLE	for spouse
SP_SUFFIX	for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.
ADDR1	Street Address (Line 1)
ADDR2	Street Address (Line 2)
ADDR3	Street Address (Line 3)
ADDR4	Street Address (Line 4)
CITY	City
STATE	State
ZIP	Postal Code
COUNTRY	(A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.
CNTRY_DESCR	Name of country.
ADDR_CHANGED	(M/D/YYYY) When the addres was last changed.
ADDR_DELIVERABLE	<future: TntMPD 2.12.2> "TRUE" or "FALSE". Blank implies "TRUE".
PHONE	Phone number.
PHONE_CHANGED	(M/D/YYYY) When the phone was last changed.
PHONE_OPERATIONAL	<future: TntMPD 2.12.2> "TRUE" or "FALSE". Blank implies "TRUE".
EMAIL	<future: TntMPD 2.12.2> Email address.
EMAIL_CHANGED	<future: TntMPD 2.12.2>(M/D/YYYY) When the email was last changed.
EMAIL_OPERATIONAL	<future: TntMPD 2.12.2> "TRUE" or "FALSE". Blank implies "TRUE".

Addresses By IDs Query

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional) <new for TntMPD 2.0>

Example result:

PROFILE_CODE	PROFILE_DESC
	Staff Account (Default)
MIN1	Operating Account #1
MIN2	Operating Account #2

Field Descriptions:

FieldName	Description
PROFILE_CODE	(A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.
PROFILE_DESCRIPTION	(A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

SingleSignOn Query (Optional) <future: TntMPD 2.12.2>

The purpose of this query is to return a one-time-use authentication ticket that can be used in one (and only one) query. It receives $ACCOUNT$ and $PASSWORD$. It should return one row.

Example result:

SSO_TICKET

ST-gjdhgvyudmfnbgbyf

Field Descriptions:

FieldName	Description
SSO_TICKET	(Text) An authentication "service" ticket than can be passed into another query for one-time use.

Case Insensitivity

Testing your compatibility with TntMPD

Making it easy for your staff to connect...

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org I would be glad to help you.

How can I make my organization's online donation system compatible with TntMPD?

Troy Wolbrink — Mon, 02 Mar 2009 16:08:18 GMT

Revision 6 posted to Frequently Asked Questions (English) by Troy Wolbrink on 3/2/2009 11:08:18 AM

How can I make my organization's online donation system compatible with TntMPD?

Filed under: Developer Guides

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details
Download names and addresses of donors
Be notified of their staff account balance

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file
Account Balance Query
Donations Query
Addresses Query
Addresses By IDs Query
Profiles Query (Optional) <new for TntMPD 2.0>
SingleSignOn Query (Optional) <future: TntMPD 2.1>

Query INI File

[APPLICATION]
MinimumVersion=1.5.0
RecommendedVersion=1.5.0

[ORGANIZATION]
RedirectQueryIni=
Name=Your Organization Name
Abbreviation=MyOrg
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
MinimumWebGiftDate=1/1/1990
Code=MyOrg-USA
QueryAuthentication=0
MinPidLength=0
OrgHelpUrl=https://www.myorg.org/help.htm
OrgHelpUrlDescription=Click here to report this issue over the Web!
OrgHelpOther=You may also reach the CCC Call Center at 407-826-2948.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
StaffPortalUrl=http://myorg.org/staffportal.html
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.1]
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

Now let me explain the meaning of each value...

[ORGANIZATION]
// If you move your Query INI File, you can permanently redirect users to the new query.ini url.
RedirectQueryIni=
// Specify the name of your organization here.
Name=Your Organization Name
// Specify a short abbreviation of your organization here.
Abbreviation=MyOrg
// Really old versions of TntMPD may use this. This has been deprecated. Use "WebLogo-JPEG-470x120" on new work.
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
// URL of where your logo can be downloaded (JPEG only).
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
// URL of a mini portal into your website
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
// URL to help your staff get setup with an account.
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
// URL of your banner ad.
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
// Boundary of how back your online donation system provides data for. (M/D/YYYY)
MinimumWebGiftDate=1/1/1990
// Unique code to represent your ministry internally to TntMPD. (User never sees this.)
Code=MyOrg-USA
// Set this to "1" if you want the queries to use basic HTTP authentication
QueryAuthentication=0
// TntMPD internally removes leading zeros from numeric donor account ids. Specify the minimum number of digits a
// donor id should be, and TntMPD will add leading zeros when returning them back in the "Addresses By IDs Query" query.
MinPidLength=0
// <new for TntMPD 2.0> Specify a url where users can report errors with your download process.
OrgHelpUrl=https://www.myorg.org/help.htm
// <new for TntMPD 2.0> Specify the text users will see for OrgHelpUrl.
OrgHelpUrlDescription=Click here to report this issue over the Web!
// <new for TntMPD 2.0> Specify alternative text for how users can get help with downloading information.
OrgHelpOther=You may also reach the us at 123-456-7890.
// <new for TntMPD 2.0> Specify the url where users can request new download profiles.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
// <new for TntMPD 2.0.44> Specify the url where users can view a staff portal.
StaffPortalUrl=http://myorg.org/staffportal.html
// <future: TntMPD 2.1> Specify the base currency code (ISO 4217 3-char) for gifts returning from your Donations Query.
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/    // URL of your online donation system.
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$    // Your POST template. (described later)

[ACCOUNT_BALANCE.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

[DONATIONS]    // URL and POST have same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[DONATIONS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[ADDRESSES]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&PID=$PERSONIDS$

[ADDRESSES_BY_PERSONIDS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[PROFILES.2] <new for TntMPD 2.0>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=Profiles&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.1] <future: TntMPD 2.1>
// Note: If this query were actually used, credentials would not be
//   passed in to the other queries. But $SSO_TICKET$ would be used instead.
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]
[DONATIONS.2.1]
[DONATIONS.2.0]
[DONATIONS.2]
[DONATIONS]

The Queries

$ACCOUNT$	The user name of the staff logging in to the donation system.
$PASSWORD$	The password of the staff logging in to the donation system.
$SSO_TICKET$	<future: TntMPD 2.1> The service ticket returned by the SingleSignOn Query. Generally you would use this in lieu of $ACCOUNT$ and $PASSWORD$. Note: The SingleSignOn query never receives the $SSO_TICKET$ placeholder, but only accepts $ACCOUNT$ and $PASSWORD$.
$PROFILE$	<new for TntMPD 2.0> The profile code of the staff logging in to the donation system. If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$ placeholder is never provided in the Profiles Query itself.
$DATEFROM$	The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)
$DATETO$	The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)
$PERSONIDS$	A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

Action=TntBalance&Username=JohnDoe&Password=abc123

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID	ACCT_NAME	BALANCE
12345678	Doe, John & Jane	1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName	Description
EMPLID	Comma separated list of designation ids (A18) associated with this user/profile.
ACCT_NAME	List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.
BALANCE	(Text) Custom text that describes the user's account balance.

Donations Query

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
DISPLAY_DATE	(M/D/YYYY) Date of contribution
AMOUNT	(Float) Amount of contribution
DONATION_ID	(A18) Donation ID
DESIGNATION	(A18) What account this donation is designated for (normally same as employee id)
MOTIVATION	(A18) (Optional) If you track this in your donation system you may include this code here.
PAYMENT_METHOD	<future: TntMPD 2.1> (A18) (Optional) Payment method of this donation.
TENDERED_AMOUNT	<future: TntMPD 2.1> (Float) (Optional) Amount of donation as tendered by donor. You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.
TENDERED_CURRENCY	<future: TntMPD 2.1> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.
MEMO	<future: TntMPD 2.1> (A) Any comments (no length limit) associated with this gift.
BASE_CURRENCY	<future: TntMPD 2.1> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" should be defined once in the [Organization] section.

Addresses Query

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Here's an example result:

Field Descriptions:

FieldName	Description
PEOPLE_ID	(A18) Donor ID
ACCT_NAME	Donor full name
PERSON_TYPE	"O" or "P" (Organization or Person)
LAST_NAME_ORG	Last Name or Organization Name
FIRST_NAME	First Name
MIDDLE_NAME	Middle Name
TITLE	Title (Mr., Mrs.)
SUFFIX	Suffix (Jr., Sr.)
SP_LAST_NAME	for spouse
SP_FIRST_NAME	for spouse
SP_MIDDLE_NAME	for spouse
SP_TITLE	for spouse
SP_SUFFIX	for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.
ADDR1	Street Address (Line 1)
ADDR2	Street Address (Line 2)
ADDR3	Street Address (Line 3)
ADDR4	Street Address (Line 4)
CITY	City
STATE	State
ZIP	Postal Code
COUNTRY	(A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.
CNTRY_DESCR	Name of country.
ADDR_CHANGED	(M/D/YYYY) When the addres was last changed.
ADDR_DELIVERABLE	<future: TntMPD 2.1> "TRUE" or "FALSE". Blank implies "TRUE".
PHONE	Phone number.
PHONE_CHANGED	(M/D/YYYY) When the phone was last changed.
PHONE_OPERATIONAL	<future: TntMPD 2.1> "TRUE" or "FALSE". Blank implies "TRUE".
EMAIL	<future: TntMPD 2.1> Email address.
EMAIL_CHANGED	<future: TntMPD 2.1>(M/D/YYYY) When the email was last changed.
EMAIL_OPERATIONAL	<future: TntMPD 2.1> "TRUE" or "FALSE". Blank implies "TRUE".

Addresses By IDs Query

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional) <new for TntMPD 2.0>

Example result:

PROFILE_CODE	PROFILE_DESC
	Staff Account (Default)
MIN1	Operating Account #1
MIN2	Operating Account #2

Field Descriptions:

FieldName	Description
PROFILE_CODE	(A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.
PROFILE_DESCRIPTION	(A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

SingleSignOn Query (Optional) <future: TntMPD 2.1>

The purpose of this query is to return a one-time-use authentication ticket that can be used in one (and only one) query. It receives $ACCOUNT$ and $PASSWORD$. It should return one row.

Example result:

SSO_TICKET

ST-gjdhgvyudmfnbgbyf

Field Descriptions:

FieldName	Description
SSO_TICKET	(Text) An authentication "service" ticket than can be passed into another query for one-time use.

Case Insensitivity

Testing your compatibility with TntMPD

Making it easy for your staff to connect...

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org I would be glad to help you.

How can I make my organization's online donation system compatible with TntMPD?

Troy Wolbrink — Mon, 29 Sep 2008 19:06:25 GMT

Revision 5 posted to Frequently Asked Questions (English) by Troy Wolbrink on 9/29/2008 3:06:25 PM

How can I make my organization's online donation system compatible with TntMPD?

Filed under: Developer Guides

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details
Download names and addresses of donors
Be notified of their staff account balance

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file
Account Balance Query
Donations Query
Addresses Query
Addresses By IDs Query
Profiles Query (Optional) <new for TntMPD 2.0>
SingleSignOn Query (Optional) <future: TntMPD 2.1>

Query INI File

[APPLICATION]
MinimumVersion=1.5.0
RecommendedVersion=1.5.0

[ORGANIZATION]
RedirectQueryIni=
Name=Your Organization Name
Abbreviation=MyOrg
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
MinimumWebGiftDate=1/1/1990
Code=MyOrg-USA
QueryAuthentication=0
MinPidLength=0
OrgHelpUrl=https://www.myorg.org/help.htm
OrgHelpUrlDescription=Click here to report this issue over the Web!
OrgHelpOther=You may also reach the CCC Call Center at 407-826-2948.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
StaffPortalUrl=http://myorg.org/staffportal.html
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.1]
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

Now let me explain the meaning of each value...

[ORGANIZATION]
// If you move your Query INI File, you can permanently redirect users to the new query.ini url.
RedirectQueryIni=
// Specify the name of your organization here.
Name=Your Organization Name
// Specify a short abbreviation of your organization here.
Abbreviation=MyOrg
// Really old versions of TntMPD may use this. This has been deprecated. Use "WebLogo-JPEG-470x120" on new work.
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
// URL of where your logo can be downloaded (JPEG only).
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
// URL of a mini portal into your website
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
// URL to help your staff get setup with an account.
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
// URL of your banner ad.
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
// Boundary of how back your online donation system provides data for. (M/D/YYYY)
MinimumWebGiftDate=1/1/1990
// Unique code to represent your ministry internally to TntMPD. (User never sees this.)
Code=MyOrg-USA
// Set this to "1" if you want the queries to use basic HTTP authentication
QueryAuthentication=0
// TntMPD internally removes leading zeros from numeric donor account ids. Specify the minimum number of digits a
// donor id should be, and TntMPD will add leading zeros when returning them back in the "Addresses By IDs Query" query.
MinPidLength=0
// <new for TntMPD 2.0> Specify a url where users can report errors with your download process.
OrgHelpUrl=https://www.myorg.org/help.htm
// <new for TntMPD 2.0> Specify the text users will see for OrgHelpUrl.
OrgHelpUrlDescription=Click here to report this issue over the Web!
// <new for TntMPD 2.0> Specify alternative text for how users can get help with downloading information.
OrgHelpOther=You may also reach the us at 123-456-7890.
// <new for TntMPD 2.0> Specify the url where users can request new download profiles.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
// <new for TntMPD 2.0.44> Specify the url where users can view a staff portal.
StaffPortalUrl=http://myorg.org/staffportal.html
// <future: TntMPD 2.1> Specify the base currency code (ISO 4217 3-char) for gifts returning from your Donations Query.
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/    // URL of your online donation system.
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$    // Your POST template. (described later)

[ACCOUNT_BALANCE.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

[DONATIONS]    // URL and POST have same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[DONATIONS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[ADDRESSES]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&PID=$PERSONIDS$

[ADDRESSES_BY_PERSONIDS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[PROFILES.2] <new for TntMPD 2.0>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=Profiles&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.1] <future: TntMPD 2.1>
// Note: If this query were actually used, credentials would not be
//   passed in to the other queries. But $SSO_TICKET$ would be used instead.
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]
[DONATIONS.2.1]
[DONATIONS.2.0]
[DONATIONS.2]
[DONATIONS]

The Queries

$ACCOUNT$	The user name of the staff logging in to the donation system.
$PASSWORD$	The password of the staff logging in to the donation system.
$SSO_TICKET$	<future: TntMPD 2.1> The service ticket returned by the SingleSignOn Query. Generally you would use this in lieu of $ACCOUNT$ and $PASSWORD$. Note: The SingleSignOn query never receives the $SSO_TICKET$ placeholder, but only accepts $ACCOUNT$ and $PASSWORD$.
$PROFILE$	<new for TntMPD 2.0> The profile code of the staff logging in to the donation system. If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$ placeholder is never provided in the Profiles Query itself.
$DATEFROM$	The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)
$DATETO$	The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)
$PERSONIDS$	A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

Action=TntBalance&Username=JohnDoe&Password=abc123

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID	ACCT_NAME	BALANCE
12345678	Doe, John & Jane	1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName	Description
EMPLID	Comma separated list of designation ids (A18) associated with this user/profile.
ACCT_NAME	List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.
BALANCE	(Text) Custom text that describes the user's account balance.

Donations Query

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.1> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.1> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.1> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.1> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.1> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" should be defined once in the [Organization] section.

Addresses Query

The purpose of this query is to return detailed name, address and phone data for the staff member's donors. In addition to the usual $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders, it also uses $DATEFROM$. Keep in mind that this parameter comes in the (M/D/YYYY) format. The $DATEFROM$ placeholder limits the address list to only those that have changed since the given date. If the given date is blank, the user is requesting ALL addresses.

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.1>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.1>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.1> Email address.

EMAIL_CHANGED <future: TntMPD 2.1>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.1>
"TRUE" or "FALSE". Blank implies "TRUE".

Addresses By IDs Query

This Query only differs from the Addresses Query in that it uses the $PERSONIDS$ parameter instead of the $DATEFROM$ parameter. The $PERSONID$ parameter is substituted by a comma separated list of donor IDs. These donor IDs are obtained from donations in the Donations Query. TntMPD will never submit a request with more than 200 donor IDs.

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional)   <new for TntMPD 2.0>

The purpose of this query is to return a list of different profiles associated with the user. This allows a user to have different "modes" for downloading information, without having to setup different username/passwords for each mode. This works especially well in a Single Sign On (SSO) environment.

Example result:

PROFILE_CODE PROFILE_DESC

Staff Account (Default)

MIN1 Operating Account #1

MIN2 Operating Account #2

Field Descriptions:

FieldName Description

PROFILE_CODE (A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.

PROFILE_DESCRIPTION (A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

SingleSignOn Query (Optional)   <future: TntMPD 2.1>

The purpose of this query is to return a one-time-use authentication ticket that can be used in one (and only one) query. It receives $ACCOUNT$ and $PASSWORD$. It should return one row.

Example result:

SSO_TICKET

ST-gjdhgvyudmfnbgbyf

Field Descriptions:

FieldName Description

SSO_TICKET (Text) An authentication "service" ticket than can be passed into another query for one-time use.

Testing your compatibility with TntMPD

To test your online donation system's compatibility with TntMPD, pull up the "Gift Input from Web" screen. Where it has you choose your Organization, choose "Custom". (Note: You must hold down the Shift key when you drop down the list.) Then you can simply type in the URL of your Query INI File. That is all there is to it!

Making it easy for your staff to connect...

If you want to include your organization in the drop down list where you choose the Organization, just send me an email. (wolbrink@ccci.org) Be sure to include your organization's name, and the URL of your Query INI File. I can update the list on my website, and your organization will automatically appear in the list.

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you.

How can I make my organization's online donation system compatible with TntMPD?

Troy Wolbrink — Mon, 29 Sep 2008 18:53:24 GMT
Revision 4 posted to Frequently Asked Questions (English) by Troy Wolbrink on 9/29/2008 2:53:24 PM

How can I make my organization's online donation system compatible with TntMPD?

This document describes how you can make your organization's online donation system compatible with TntMPD. The technical details are spelled out so that you can provide your own custom solution. It requires a knowledge of computer programming. Keep in mind that the preferred and recommended way to provide a TntMPD-compatible download for your staff is to use TntMPD.DataServer. TntMPD.DataServer already includes pre-built integration templates for DonorWise, Raiser's Edge and OPTIGEM. Tools and documentation are provided to allow you to integrate TntMPD.DataServer with your own donation system.

Once you are TntMPD-compatible, your staff will be able to use TntMPD to connect to your system using the Web to:

Download contribution details

Download names and addresses of donors

Be notified of their staff account balance

Not only will your staff be able to use these features, but their application will be branded with your organization's logo. Also, while they are using the "Web Input" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

What it takes...

Query INI file

Account Balance Query

Donations Query

Addresses Query

Addresses By IDs Query

Profiles Query (Optional) <new for TntMPD 2.0>

SingleSignOn Query (Optional) <future: TntMPD 2.1>

Query INI File

You need to provide a Query INI File. This file will provide the web address and parameter template needed to download the results of the query. Below is an example. Notice it is based on a standard Windows INI file format.

[APPLICATION]
MinimumVersion=1.5.0
RecommendedVersion=1.5.0

[ORGANIZATION]
RedirectQueryIni=
Name=Your Organization Name
Abbreviation=MyOrg
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
MinimumWebGiftDate=1/1/1990
Code=MyOrg-USA
QueryAuthentication=0
MinPidLength=0
OrgHelpUrl=https://www.myorg.org/help.htm
OrgHelpUrlDescription=Click here to report this issue over the Web!
OrgHelpOther=You may also reach the CCC Call Center at 407-826-2948.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
StaffPortalUrl=http://myorg.org/staffportal.html
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

[ACCOUNT_BALANCE.2]
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

[DONATIONS]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[DONATIONS.2]
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[ADDRESSES]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES.2]
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS.2]
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[PROFILES.2]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=Profiles&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.1]
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

Now let me explain the meaning of each value...

[APPLICATION]
// You can require a minimum version of TntMPD for Web Input features.
MinimumVersion=1.5.0
// You can recommend a minimum version of TntMPD for Web Input features if you wish.
RecommendedVersion=1.5.0

[ORGANIZATION]
// If you move your Query INI File, you can permanently redirect users to the new query.ini url.
RedirectQueryIni=
// Specify the name of your organization here.
Name=Your Organization Name
// Specify a short abbreviation of your organization here.
Abbreviation=MyOrg
// Really old versions of TntMPD may use this. This has been deprecated. Use "WebLogo-JPEG-470x120" on new work.
WebLogo-JPEG-476x100=http://www.myorg.org/WebLogo.jpg
// URL of where your logo can be downloaded (JPEG only).
WebLogo-JPEG-470x120=http://www.myorg.org/WebLogo.jpg
// URL of a mini portal into your website
WebPortalUrl-470x120=http://www.myorg.org/miniportal?Username=$ACCOUNT$&Password=$PASSWORD$
// URL to help your staff get setup with an account.
AccountHelpUrl=http://www.myorg.org/staffaccounthelp.html
// URL of your banner ad.
BannerAdUrl-468x60=http://www.myorg.org/bannerad.html
// Boundary of how back your online donation system provides data for. (M/D/YYYY)
MinimumWebGiftDate=1/1/1990
// Unique code to represent your ministry internally to TntMPD. (User never sees this.)
Code=MyOrg-USA
// Set this to "1" if you want the queries to use basic HTTP authentication
QueryAuthentication=0
// TntMPD internally removes leading zeros from numeric donor account ids. Specify the minimum number of digits a
// donor id should be, and TntMPD will add leading zeros when returning them back in the "Addresses By IDs Query" query.
MinPidLength=0
// <new for TntMPD 2.0> Specify a url where users can report errors with your download process.
OrgHelpUrl=https://www.myorg.org/help.htm
// <new for TntMPD 2.0> Specify the text users will see for OrgHelpUrl.
OrgHelpUrlDescription=Click here to report this issue over the Web!
// <new for TntMPD 2.0> Specify alternative text for how users can get help with downloading information.
OrgHelpOther=You may also reach the us at 123-456-7890.
// <new for TntMPD 2.0> Specify the url where users can request new download profiles.
RequestProfileUrl=https://www.myorg.org/requestprofile.htm
// <new for TntMPD 2.0.44> Specify the url where users can view a staff portal.
StaffPortalUrl=http://myorg.org/staffportal.html
// <future: TntMPD 2.1> Specify the base currency code (ISO 4217 3-char) for gifts returning from your Donations Query.
DefaultCurrencyCode=USD

[ACCOUNT_BALANCE]
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/    // URL of your online donation system.
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$    // Your POST template. (described later)

[ACCOUNT_BALANCE.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$

[DONATIONS]    // URL and POST have same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[DONATIONS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntDonList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$&DateTo=$DATETO$

[ADDRESSES]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&DateFrom=$DATEFROM$

[ADDRESSES.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[ADDRESSES_BY_PERSONIDS]    // same comments as for ACCOUNT_BALANCE section
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&PID=$PERSONIDS$

[ADDRESSES_BY_PERSONIDS.2]   <new for TntMPD 2.0> // A version specific section with the new $PROFILE$ placeholder included
Post=Action=TntAddrList&Username=$ACCOUNT$&Password=$PASSWORD$&ProfileCode=$PROFILE$&DateFrom=$DATEFROM$

[PROFILES.2] <new for TntMPD 2.0>
Url=https://www.myorg.org/cgi-bin/StaffAccountApp/
Post=Action=Profiles&Username=$ACCOUNT$&Password=$PASSWORD$

[SingleSignOn.2.1] <future: TntMPD 2.1>
// Note: If this query were actually used, credentials would not be
//   passed in to the other queries. But $SSO_TICKET$ would be used instead.
Url=https://www.myorg.org/cg-bin/sso/
Post=Username=$ACCOUNT$&Password=$PASSWORD$

The benefit of keeping the instructions in this file is that if you later change the URL or POST template of your query, you can just edit the Query INI File and make a seamless transition. The staff using the program will never know it changed.

TntMPD-version specific sections <new for TntMPD 2.0>

TntMPD 2.0 and newer will support version specific sections. For example a client running TntMPD 2.2 will search for the "DONATION" section by using the first out of this list that it finds first:

[DONATIONS.2.2]

[DONATIONS.2.1]

[DONATIONS.2.0]

[DONATIONS.2]

[DONATIONS]

The Queries

--Placeholders--
Each query has a URL and a POST. The URL specifies your online donation server object (CGI object, for example). The POST specifies the data to send with the HTTP POST transaction. The POST is in a template form. These placeholders are key words that will be substituted by the appropriate string based on the user's input in TntMPD:

$ACCOUNT$ The user name of the staff logging in to the donation system.

$PASSWORD$ The password of the staff logging in to the donation system.

$SSO_TICKET$ <future: TntMPD 2.1> The service ticket returned by the SingleSignOn Query.
Generally you would use this in lieu of $ACCOUNT$ and $PASSWORD$. Note: The
SingleSignOn query never receives the $SSO_TICKET$ placeholder, but only
accepts $ACCOUNT$ and $PASSWORD$.

$PROFILE$ <new for TntMPD 2.0> The profile code of the staff logging in to the donation system.
If the Profiles query is not supported, this will always be blank. Note: The $PROFILE$
placeholder is never provided in the Profiles Query itself.

$DATEFROM$ The specified beginning date. (M/D/YYYY) (I'll explain later where and how this is used.)

$DATETO$ The specified ending date. (M/D/YYYY) (I'll explain later where and how this is used.)

$PERSONIDS$ A comma separated list of donor IDs. (I'll explain later where and how this is used.)

So for example, if I defined my Post value by:

Post=Action=TntBalance&Username=$ACCOUNT$&Password=$PASSWORD$

And if my user name was "JohnDoe", and my password was "abc123" then the following data would be send with the HTTP POST transaction:

Action=TntBalance&Username=JohnDoe&Password=abc123

--Standard Response--
Each query should return its results as CSV text. I will describe the
field names expected for each query.

--Error Response--
Each query should handle invalid conditions (such as an invalid username) by
returning two lines of text. The first line of text should be "ERROR".
The second line of text is the error description. Here are a couple of
examples to give you the general idea.

ERROR
Invalid password.

ERROR
Invalid user name.

ERROR
Server is down for maintenance.

ERROR
Invalid date range.

Account Balance Query

The purpose of this query is to simply return the staff account balance of the staff member submitting the request. It only uses the $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders.

Example result:

EMPLID ACCT_NAME BALANCE

12345678 Doe, John & Jane 1225.30

Result in it's raw form just in case you are not familiar with the CSV format:

EMPLID,ACCT_NAME,BALANCE
12345678,"Doe, John & Jane",1225.30

Field Descriptions:

FieldName Description

EMPLID Comma separated list of designation ids (A18) associated with this user/profile.

ACCT_NAME List of designation account names (A50) associated with this user. Each name is delimited by carriage returns and line feeds (vbCrLf or #13#10), and correlates to designation ids found in EMPLID.

BALANCE (Text) Custom text that describes the user's account balance.

Donations Query

The purpose of this query is to return all donation detail data for the staff member within a certain date range. In addition to the usual $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders, it also uses $DATEFROM$ and $DATETO$. Keep in mind that these placeholders come in the (M/D/YYYY) format. The $DATEFROM$ and $DATETO$ placeholders describe the beginning and ending dates of the query. You should include donation data for all dates between and including these dates. The beginning date will be limited by the "MinimumWebGiftDate" value in the Query INI file.

Click here To see

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.1> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.1> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.1> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.1> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.1> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" should be defined once in the [Organization] section.

Addresses Query

The purpose of this query is to return detailed name, address and phone data for the staff member's donors. In addition to the usual $ACCOUNT$, $PASSWORD$ and $PROFILE$ placeholders, it also uses $DATEFROM$. Keep in mind that this parameter comes in the (M/D/YYYY) format. The $DATEFROM$ placeholder limits the address list to only those that have changed since the given date. If the given date is blank, the user is requesting ALL addresses.

Note: You may simply ignore the $DATEFROM$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Click here To see

Here's an example result.:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.1>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.1>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.1> Email address.

EMAIL_CHANGED <future: TntMPD 2.1>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.1>
"TRUE" or "FALSE". Blank implies "TRUE".

Addresses By IDs Query

This Query only differs from the Addresses Query in that it uses the $PERSONIDS$ parameter instead of the $DATEFROM$ parameter. The $PERSONID$ parameter is substituted by a comma separated list of donor IDs. These donor IDs are obtained from donations in the Donations Query. TntMPD will never submit a request with more than 200 donor IDs.

Note: You may simply ignore the $PERSONIDS$ parameter and return all addresses every time if you wish. But keep in mind that this will generally increase the download time for the user.

Profiles Query (Optional)   <new for TntMPD 2.0>

The purpose of this query is to return a list of different profiles associated with the user. This allows a user to have different "modes" for downloading information, without having to setup different username/passwords for each mode. This works especially well in a Single Sign On (SSO) environment.

Example result:

PROFILE_CODE PROFILE_DESC

Staff Account (Default)

MIN1 Operating Account #1

MIN2 Operating Account #2

Field Descriptions:

FieldName Description

PROFILE_CODE (A18) A code to identify this profile. A blank profile code would be the default profile associated with the account. Note: The Field Name "ROLE_CODE" was supported at one time, but is now deprecated for new work.

PROFILE_DESCRIPTION (A50) A description of the profile. This is what the user sees. Note: The Field Name "ROLE_DESCRIPTION" was supported at one time, but is now deprecated for new work.

SingleSignOn Query (Optional)   <future: TntMPD 2.1>

The purpose of this query is to return a one-time-use authentication ticket that can be used in one (and only one) query. It receives $ACCOUNT$ and $PASSWORD$. It should return one row.

Example result:

SSO_TICKET

ST-gjdhgvyudmfnbgbyf

Field Descriptions:

FieldName Description

SSO_TICKET (Text) An authentication "service" ticket than can be passed into another query for one-time use.

Testing your compatibility with TntMPD

To test your online donation system's compatibility with TntMPD, pull up the "Gift Input from Web" screen. Where it has you choose your Organization, choose "Custom". (Note: You must hold down the Shift key when you drop down the list.) Then you can simply type in the URL of your Query INI File. That is all there is to it!

Making it easy for your staff to connect...

If you want to include your organization in the drop down list where you choose the Organization, just send me an email. (wolbrink@ccci.org) Be sure to include your organization's name, and the URL of your Query INI File. I can update the list on my website, and your organization will automatically appear in the list.

Then when your staff member tries to do "Gift Input from Web" for the first time, they can just select your organization's name in the list. It couldn't be much easier!

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Troy Wolbrink — Wed, 01 Feb 2012 19:06:04 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 2/1/2012 2:06:04 PM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Filed under: Developer Guides

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has up to three sections. The sections are:

[ORGANIZATION]

[DONORS]

[GIFTS].

<future: TntMPD 2.2> Supported sections will also include (to be described later):

[APPLICATION]

[FILE]

[DESIGNATIONS]

[GIFTS_BY_DONORS].

An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
BaseCurrencyCode=USD

[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.2> BaseCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

DECEASED <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Is the donor deceased

LAST_NAME_ORG Last Name or Organization Name

ORG_CONTACT_PERSON <future: TntMPD 2.2>
When it's an organization (PERSON_TYPE="O"), who is the contact person for this organization?

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_VALID <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_VALID <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

MOBILE_PHONE <future: TntMPD 2.2> Mobile phone number.

MOBILE_PHONE_CHANGED <future: TntMPD 2.2>
(M/D/YYYY) When the mobile phone was last changed.

MOBILE_PHONE_VALID <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

SPOUSE_MOBILE_PHONE <future: TntMPD 2.2> Spouse mobile phone number.

SPOUSE_MOBILE_PHONE_CHANGED <future: TntMPD 2.2>
(M/D/YYYY) When the spouse mobile phone was last changed.

SPOUSE_MOBILE_PHONE_VALID <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.2> Email address.

EMAIL_CHANGED <future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.

EMAIL_VALID <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

SPOUSE_EMAIL <future: TntMPD 2.2> Email address.

SPOUSE_EMAIL_CHANGED <future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.

SPOUSE_EMAIL_VALID <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

MEMO <future: TntMPD 2.2> A note regarding the donor.

MAGAZINE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?

DECEASED <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?

REMINDER <future: TntMPD 2.2>
(A18) How often is the donor reminded by the organization to make a donation?

RELATED_IDS <future: TntMPD 2.2>
A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Here's an example result:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.

PERSONAL <future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. (Leading zeros will be removed from numeric donor ids.) But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective.  Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Troy Wolbrink — Tue, 24 Jan 2012 20:09:40 GMT
Revision 17 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/24/2012 3:09:40 PM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Filed under: Developer Guides

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has up to three sections. The sections are:

[ORGANIZATION]

[DONORS]

[GIFTS].

<future: TntMPD 2.2> Supported sections will also include (to be described later):

[APPLICATION]

[FILE]

[DESIGNATIONS]

[GIFTS_BY_DONORS].

An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
BaseCurrencyCode=USD

[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.2> BaseCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE

ADDR_VALID <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL

PHONE_VALID <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

MOBILE_PHONE <future: TntMPD 2.2> Mobile phone number.

MOBILE_PHONE_CHANGED <future: TntMPD 2.2>
(M/D/YYYY) When the mobile phone was last changed.

MOBILE_PHONE_VALID <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

SPOUSE_MOBILE_PHONE <future: TntMPD 2.2> Spouse mobile phone number.

SPOUSE_MOBILE_PHONE_CHANGED <future: TntMPD 2.2>
(M/D/YYYY) When the spouse mobile phone was last changed.

SPOUSE_MOBILE_PHONE_VALID <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.2> Email address.

EMAIL_CHANGED <future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL

EMAIL_VALID <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

MEMO

SPOUSE_EMAIL <future: TntMPD 2.2> Email address.

SPOUSE_EMAIL_CHANGED <future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.

SPOUSE_EMAIL_VALID <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

MEMO <future: TntMPD 2.2> A note regarding the donor.

MAGAZINE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?

DECEASED <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?

REMINDER <future: TntMPD 2.2>
(A18) How often is the donor reminded by the organization to make a donation?

RELATED_IDS <future: TntMPD 2.2>
A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Here's an example result:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.

PERSONAL <future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. (Leading zeros will be removed from numeric donor ids.) But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective.  Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Troy Wolbrink — Wed, 05 Oct 2011 19:13:57 GMT
Revision 16 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/5/2011 3:13:57 PM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Filed under: Developer Guides

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has up to three sections. The sections are:

[ORGANIZATION]

[DONORS]

[GIFTS].

<future: TntMPD 2.2> Supported section sections will also include (to be described later):

[APPLICATION]

[FILE]

[DESIGNATIONS]

[GIFTS_BY_DONORS].

An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
BaseCurrencyCode=USD

[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.2> BaseCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.2> Email address.

EMAIL_CHANGED <future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

MEMO <future: TntMPD 2.2>
A note regarding the donor.

MAGAZINE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?

DECEASED <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?

REMINDER <future: TntMPD 2.2>
(A18) How often is the donor reminded by the organization to make a donation?

RELATED_IDS <future: TntMPD 2.2>
A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Here's an example result:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.

PERSONAL <future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. (Leading zeros will be removed from numeric donor ids.) But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective.  Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Troy Wolbrink — Wed, 05 Oct 2011 19:04:47 GMT
Revision 15 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/5/2011 3:04:47 PM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Filed under: Developer Guides

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has up to three sections. The sections are:

[ORGANIZATION]

[DONORS]

[GIFTS].

<future: TntMPD 2.2> Supported versions section will also include (to be described later):

[APPLICATION]

[FILE]

[ACCOUNT_BALANCE]

[DESIGNATIONS]

[GIFTS_BY_DONORS].

An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
BaseCurrencyCode=USD

[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.2> BaseCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.2> Email address.

EMAIL_CHANGED <future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

MEMO <future: TntMPD 2.2>
A note regarding the donor.

MAGAZINE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?

DECEASED <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?

REMINDER <future: TntMPD 2.2>
(A18) How often is the donor reminded by the organization to make a donation?

RELATED_IDS <future: TntMPD 2.2>
A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Here's an example result:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.

PERSONAL <future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. (Leading zeros will be removed from numeric donor ids.) But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective.  Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Troy Wolbrink — Mon, 03 Oct 2011 21:46:35 GMT
Revision 14 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/3/2011 5:46:35 PM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Filed under: Developer Guides

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has up to three sections. The sections are:

[ORGANIZATION], ORGANIZATION]

[DONORS]and

[GIFTS]. An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

<future: TntMPD 2.2> Supported versions will also include (to be described later):

[APPLICATION], APPLICATION]

[FILE], FILE]

[ACCOUNT_BALANCE], ACCOUNT_BALANCE]

[DESIGNATIONS]AND

[GIFTS_BY_DONORS].

An example is listed below. (more info to come!The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
BaseCurrencyCode=USD

[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.2> BaseCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.2> Email address.

EMAIL_CHANGED <future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

MEMO <future: TntMPD 2.2>
A note regarding the donor.

MAGAZINE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?

DECEASED <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?

REMINDER <future: TntMPD 2.2>
(A18) How often is the donor reminded by the organization to make a donation?

RELATED_IDS <future: TntMPD 2.2>
A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Here's an example result:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.

PERSONAL <future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. (Leading zeros will be removed from numeric donor ids.) But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective.  Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Troy Wolbrink — Mon, 03 Oct 2011 21:43:42 GMT
Revision 13 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/3/2011 5:43:42 PM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Filed under: Developer Guides

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has up to three sections. The sections are [ORGANIZATION], [DONORS] and [GIFTS]. An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

<future: TntMPD 2.2> Supported versions will also include: [APPLICATION], [FILE], [ACCOUNT_BALANCE]ACCOUNT_BALANCE], [DESIGNATIONS] AND [DESIGNATIONS].GIFTS_BY_DONORS]. (more info to come!)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
BaseCurrencyCode=USD

[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.2> BaseCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.2> Email address.

EMAIL_CHANGED <future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

MEMO <future: TntMPD 2.2>
A note regarding the donor.

MAGAZINE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?

DECEASED <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?

REMINDER <future: TntMPD 2.2>
(A18) How often is the donor reminded by the organization to make a donation?

RELATED_IDS <future: TntMPD 2.2>
A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Here's an example result:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.

PERSONAL <future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. (Leading zeros will be removed from numeric donor ids.) But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective.  Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Troy Wolbrink — Mon, 03 Oct 2011 21:31:32 GMT
Revision 12 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/3/2011 5:31:32 PM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Filed under: Developer Guides

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has up to three sections. The sections are [ORGANIZATION], [DONORS] and [GIFTS]. An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

<future: TntMPD 2.2> Supported versions will also include: [APPLICATION], [FILE], [ACCOUNT_BALANCE] AND [DESIGNATIONS]. (more info to come!)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
BaseCurrencyCode=USD

[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.2> BaseCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.2> Email address.

EMAIL_CHANGED <future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

MEMO <future: TntMPD 2.2>
A note regarding the donor.

MAGAZINE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?

DECEASED <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?

REMINDER <future: TntMPD 2.2>
(A18) How often is the donor reminded by the organization to make a donation?

RELATED_IDS <future: TntMPD 2.2>
A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Here's an example result:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.

PERSONAL <future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. (Leading zeros will be removed from numeric donor ids.) But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective.  Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Troy Wolbrink — Mon, 03 Oct 2011 21:29:04 GMT
Revision 11 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/3/2011 5:29:04 PM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Filed under: Developer Guides

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has up to three sections. The sections are [ORGANIZATION], [DONORS] and [GIFTS]. An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

<future: TntMPD 2.2> Supported versions will also include: [APPLICATION], [FILE], [ACCOUNT_BALANCE] AND [DESIGNATIONS]. (more info to come!)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
DefaultCurrencyCode=USD
BaseCurrencyCode=USD

[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.2> BaseCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.2> Email address.

EMAIL_CHANGED <future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

MEMO <future: TntMPD 2.2>
A note regarding the donor.

MAGAZINE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?

DECEASED <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?

REMINDER <future: TntMPD 2.2>
(A18) How often is the donor reminded by the organization to make a donation?

RELATED_IDS <future: TntMPD 2.2>
A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Here's an example result:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.

PERSONAL <future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. (Leading zeros will be removed from numeric donor ids.) But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective.  Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Troy Wolbrink — Mon, 03 Oct 2011 21:22:20 GMT
Revision 10 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/3/2011 5:22:20 PM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Filed under: Developer Guides

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has up to three sections. The sections are [ORGANIZATION], [DONORS] and [GIFTS]. An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

<future: TntMPD 2.2> Supported versions will also include: [APPLICATION], [FILE], [ACCOUNT_BALANCE] AND [DESIGNATIONS]. (more info to come!)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
DefaultCurrencyCode=USD

[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.2> BaseCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.2> Email address.

EMAIL_CHANGED <future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

MEMO <future: TntMPD 2.2>
A note regarding the donor.

MAGAZINE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?

DECEASED <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?

REMINDER <future: TntMPD 2.2>
(A18) How often is the donor reminded by the organization to make a donation?

RELATED_IDS <future: TntMPD 2.2>
A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Here's an example result:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "BaseCurrencyCode" should be defined once in the [Organization] section.

PERSONAL <future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. (Leading zeros will be removed from numeric donor ids.) But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective.  Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Troy Wolbrink — Mon, 03 Oct 2011 21:19:49 GMT
Revision 9 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/3/2011 5:19:49 PM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Filed under: Developer Guides

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has up to three sections. The sections are [ORGANIZATION], [DONORS] and [GIFTS]. An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

<future: TntMPD 2.2> Supported versions will also include: [APPLICATION], [FILE], [ACCOUNT_BALANCE] AND [DESIGNATIONS]. (more info to come!)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
DefaultCurrencyCode=USD

[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.2> DefaultCurrencyCode BaseCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.2> Email address.

EMAIL_CHANGED <future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

MEMO <future: TntMPD 2.2>
A note regarding the donor.

MAGAZINE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Does the donor subscribe to the organization's news magazine?

DECEASED <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "FALSE". Is the donor decease?

REMINDER <future: TntMPD 2.2>
(A18) How often is the donor reminded by the organization to make a donation?

RELATED_IDS <future: TntMPD 2.2>
A comma seperated list of related donor ids (used by TntMPD to help with matching contacts to donor ids).

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Here's an example result:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" "BaseCurrencyCode" should be defined once in the [Organization] section.

PERSONAL <future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective.  Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Troy Wolbrink — Mon, 14 Mar 2011 14:52:29 GMT
Revision 8 posted to Frequently Asked Questions (English) by Troy Wolbrink on 3/14/2011 10:52:29 AM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Filed under: Developer Guides

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has three sections. The sections are [ORGANIZATION], [DONORS] and [GIFTS]. An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
DefaultCurrencyCode=USD
[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...
[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.2> DefaultCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.2> Email address.

EMAIL_CHANGED <future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Here's an example result:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" should be defined once in the [Organization] section.

PERSONAL <future: TntMPD 2.2> "TRUE" or "FALSE". Blank implies "FALSE". Indicates if the gift is intended to be a personal gift for the staff member (which usually means it's not tax deductible).

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective.  Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

tcarnahan — Fri, 27 Nov 2009 04:45:02 GMT
Revision 7 posted to Frequently Asked Questions (English) by tcarnahan on 11/26/2009 11:45:02 PM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Filed under: Developer Guides

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has three sections. The sections are [ORGANIZATION], [DONORS] and [GIFTS]. An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
DefaultCurrencyCode=USD
[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...
[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.2> DefaultCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.2> Email address.

EMAIL_CHANGED <future: TntMPD 2.2>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.2>
"TRUE" or "FALSE". Blank implies "TRUE".

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Here's an example result:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.2> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.2> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.2> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" should be defined once in the [Organization] section.

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective.  Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Troy Wolbrink — Fri, 29 May 2009 22:56:52 GMT
Revision 6 posted to Frequently Asked Questions (English) by Troy Wolbrink on 5/29/2009 6:56:52 PM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Filed under: Developer Guides

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has three sections. The sections are [ORGANIZATION], [DONORS] and [GIFTS]. An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
DefaultCurrencyCode=USD
[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...
[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.12.2> DefaultCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.12.2>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.12.2>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.12.2> Email address.

EMAIL_CHANGED <future: TntMPD 2.12.2>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.12.2>
"TRUE" or "FALSE". Blank implies "TRUE".

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Here's an example result:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.12.2> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.12.2> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.12.2> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.12.2> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.12.2> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" should be defined once in the [Organization] section.

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective.  Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Troy Wolbrink — Mon, 02 Mar 2009 16:11:17 GMT
Revision 5 posted to Frequently Asked Questions (English) by Troy Wolbrink on 3/2/2009 11:11:17 AM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Filed under: Developer Guides

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has three sections. The sections are [ORGANIZATION], [DONORS] and [GIFTS]. An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
DefaultCurrencyCode=USD
[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...
[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.1> DefaultCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.1>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.1>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.1> Email address.

EMAIL_CHANGED <future: TntMPD 2.1>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.1>
"TRUE" or "FALSE". Blank implies "TRUE".

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Here's an example result:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.1> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.1> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.1> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.1> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.1> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" should be defined once in the [Organization] section.

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Case Insensitivity

TntMPD will store designation ids, donor ids and donation ids exactly as it is received. But internally when TntMPD is syncing incoming data, it will match up these ids in a case insensitive way. So a donation id of "ABC" and "abc" are the same from TntMPD's perspective.  Sending your staff two donations with an id of "ABC" and "abc" respectively will either result in a "duplicate id error" in TntMPD or it will overwrite the one donation with the other.

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Troy Wolbrink — Mon, 29 Sep 2008 18:49:51 GMT
Revision 4 posted to Frequently Asked Questions (English) by Troy Wolbrink on 9/29/2008 2:49:51 PM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Filed under: Developer Guides

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has three sections. The sections are [ORGANIZATION], [DONORS] and [GIFTS]. An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
DefaultCurrencyCode=USD
[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...
[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.1> DefaultCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Click here To see

Here's an example result:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.1>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.1>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.1> Email address.

EMAIL_CHANGED <future: TntMPD 2.1>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.1>
"TRUE" or "FALSE". Blank implies "TRUE".

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Click here To see

Here's an example result.:

[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.1> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.1> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.1> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.1> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.1> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" should be defined once in the [Organization] section.

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

Troy Wolbrink — Mon, 29 Sep 2008 18:44:15 GMT
Revision 3 posted to Frequently Asked Questions (English) by Troy Wolbrink on 9/29/2008 2:44:15 PM

How would I send our staff a monthly (or weekly) TntMPD DataSync file?

This document describes how you can take data from your organization's donation system and package it in a way that is compatible with TntMPD. The file you create is called a TntMPD DataSync file. Once you make this file available to your individual staff member (such as via an email attachment) your staff will be able to bring their donation data into TntMPD. The type of data you can put into a DataSync file includes:

Download contribution details

Download names and addresses of donors

Not only will your staff be able to use these features, but their application will be branded with your organization's logo and name. Also, while they are using the "Gift and Address Input from File" features of TntMPD, you can display your own advertisement/announcement banner.

This is an example of the logo you can provide:

This is an example of the advertising banner you can provide:

Technical Details

A TntMPD DataSync file has the file name extension *.tntmpd. So for example you may send your staff a file called "January2002.tntmpd". TntMPD recognizes this file format which makes it incredibly easy for your staff to get started. All they need to do is double-click the file and open it. Since *.tntmpd is a registered filename extension, Windows will tell TntMPD to open it.

The DataSync file is synchronized with the currently opened database. Because the data is synchronized, you can input the file several times into the same database without duplicating data in the database.

The DataSync file has three sections. The sections are [ORGANIZATION], [DONORS] and [GIFTS]. An example is listed below. (The complete version is available here: http://download.tntware.com/sample_data_sync_file/sample.tntmpd)

[ORGANIZATION]
Name=Sample Organization
Abbreviation=SampleOrg
WebLogo-JPEG-470x120=http://download.tntware.com/ccc/SampleWebLogo.jpg
BannerAdUrl-468x60=http://download.tntware.com/ccc/SampleAdBanner.htm
Code=Sample-Organization-USA
DefaultCurrencyCode=USD
[DONORS]
"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...
[GIFTS]
"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

[ORGANIZATION]

The organization section has information about your organization. Here you can specify your organization's name, abbreviation and logo (JPEG only). In addition you can specify an announcement banner that the user sees while they import the file. The last item is code. Try to think of a unique code to represent your ministry (25 chars max).

<future: TntMPD 2.1> DefaultCurrencyCode specifies the base currency code (ISO 4217 3-char) for donations represented in the [GIFTS] section.

[DONORS]

The donors section has name, address and phone information about donors.

Click here To see an example result.

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

PERSON_TYPE "O" or "P" (Organization or Person)

LAST_NAME_ORG Last Name or Organization Name

FIRST_NAME First Name

MIDDLE_NAME Middle Name

TITLE Title (Mr., Mrs.)

SUFFIX Suffix (Jr., Sr.)

SP_LAST_NAME for spouse

SP_FIRST_NAME for spouse

SP_MIDDLE_NAME for spouse

SP_TITLE for spouse

SP_SUFFIX for spouse Note: If this is not blank, it is just concatenated with a space to SP_LAST_NAME.

ADDR1 Street Address (Line 1)

ADDR2 Street Address (Line 2)

ADDR3 Street Address (Line 3)

ADDR4 Street Address (Line 4)

CITY City

STATE State

ZIP Postal Code

COUNTRY (A3) ISO 3166 Alpha 3 country code <new in TntMPD 2.0> ISO 3166 Alpha 2 country codes are supported in TntMPD 2.0.

CNTRY_DESCR Name of country.

ADDR_CHANGED (M/D/YYYY) When the addres was last changed.

ADDR_DELIVERABLE <future: TntMPD 2.1>
"TRUE" or "FALSE". Blank implies "TRUE".

PHONE Phone number.

PHONE_CHANGED (M/D/YYYY) When the phone was last changed.

PHONE_OPERATIONAL <future: TntMPD 2.1>
"TRUE" or "FALSE". Blank implies "TRUE".

EMAIL <future: TntMPD 2.1> Email address.

EMAIL_CHANGED <future: TntMPD 2.1>(M/D/YYYY) When the email was last changed.

EMAIL_OPERATIONAL <future: TntMPD 2.1>
"TRUE" or "FALSE". Blank implies "TRUE".

[GIFTS]

The gifts section has detailed contribution information over a particular date range.

Click here To see an example result.

Field Descriptions:

FieldName Description

PEOPLE_ID (A18) Donor ID

ACCT_NAME Donor full name

DISPLAY_DATE (M/D/YYYY) Date of contribution

AMOUNT (Float) Amount of contribution

DONATION_ID (A18) Donation ID

DESIGNATION (A18) What account this donation is designated for (normally same as employee id)

MOTIVATION (A18) (Optional) If you track this in your donation system you may include this code here.

PAYMENT_METHOD <future: TntMPD 2.1> (A18) (Optional) Payment method of this donation.

TENDERED_AMOUNT <future: TntMPD 2.1> (Float) (Optional) Amount of donation as tendered by donor.
You may leave this blank if it is tendered in the same as currency code defined in the query.ini file.

TENDERED_CURRENCY <future: TntMPD 2.1> (A3) (Optional) Currency code (ISO 4217 3-char) of donation as tendered by donor. You may leave this blank if it is the same as the default currency code from the query.ini file.

MEMO <future: TntMPD 2.1> (A) Any comments (no length limit) associated with this gift.

BASE_CURRENCY <future: TntMPD 2.1> (A3) Base currency code (ISO 4217 3-char) of donation as represented by AMOUNT. The only case where it is valid to provide a value for this field is when importing a DataSync file without an [Organization] section. Apart from this exception, this field is not to be used. Instead, "DefaultCurrencyCode" should be defined once in the [Organization] section.

Really Simple Option

One way to make this work is to provide just the [DONORS] or [GIFTS] section in a file (minus the section header). TntMPD will recognize that a single section is being provided.

For example, TntMPD would recognize this as being a [DONORS] section:

"PEOPLE_ID","ACCT_NAME","ADDR1","ADDR2","ADDR3","ADDR4","CITY","STATE","ZIP",...
"921875429","Smith, Dave J & Julie J","630 Pine St",,,,"Hickleman","SD","18372-2637",...
"332812300","Pine Hills Christian Church","1212 Elm Cir",,,,"Orlando","FL","32828-1868",...
"220389751","Fryerson, Sue","900 S Sarmon Dr",,,,"Mitchell","SD","57302-9244", ...

And for another example, TntMPD would recognize this as being a [GIFTS] section:

"PEOPLE_ID","ACCT_NAME","DISPLAY_DATE","AMOUNT","DONATION_ID","DESIGNATION","MOTIVATION"
"921875429","Smith, Dave J & Julie J","08/23/2002","60","J5INQ","0455770","Z01000"
"332812300","Pine Hills Christian Church","08/22/2002","50","J5E2S","0455770","Z01000"
"220389751","Fryerson, Sue","08/22/2002","40","J5EGE","0455770","Z01000"

How to contact me

If you have any questions regarding this document, please don't hesitate to contact me at my email address: wolbrink@ccci.org   I would be glad to help you. If your organization finds this feature useful, I would love to know about that as well.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Mon, 30 Jan 2012 19:26:40 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/30/2012 2:26:40 PM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

Lion (10.7.0)

2. Try restarting your Mac.

3. Try reinstalling the latest TntMPD for Mac:

Delete TntMPD from your "Applications" folder.

Empty the Mac Trash can (and then restarting restart if you can't remove all items).

Reinstall TntMPD into your Mac)"Applications" folder:
          http://www.tntware.com/tntmpd/downloads/p/14018.aspx

(How to force a fresh install)

4. Try an older version of TntMPD for Mac (2.1.56):
           http://download.tntware.com/tntmpd/archive/2.1.56/TntMPD.2.1.56.dmg

Note this older version requires XQuartz 2.6.0 or newer.  Under "Applications/Utilities", click on "XQuartz" (or "X11" if XQuartz doesn't exist).  Then, under the "X11" menu, click on "About X11" to check the version.

5.   You might try upgrading your Mac OS X. Someone has reported that upgrading from 10.6.8 to 10 .7 resolved their TntMPD startup issue.

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Tue, 27 Dec 2011 20:09:36 GMT
Revision 20 posted to Frequently Asked Questions (English) by Troy Wolbrink on 12/27/2011 3:09:36 PM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

Lion (10.7.0)

2. Make sure you're running Try restarting your Mac.

3. Try reinstalling the latest TntMPD for Mac (and then restarting your Mac):
          http://www.tntware.com/tntmpd/downloads/p/14018.aspx

4. Try an older version of TntMPD for Mac (2.1.56):
           http://download.tntware.com/tntmpd/archive/2.1.56/TntMPD.2.1.56.dmg

Note this older version requires XQuartz 2.6.0 or newer.  Under "Applications/Utilities", click on "XQuartz" (or "X11" if XQuartz doesn't exist).  Then, under the "X11" menu, click on "About X11" to check the version.
                      (Note: If you've never before run XQuartz this way, this might also prevent TntMPD from starting.)

3. Make sure you don't have Wine installed into your Applications folder.
         This might affect how TntMPD operates.
             If you have this, and if TntMPD won't start, delete Wine from your Applications folder.

4. You can force TntMPD to reinstall by doing the following: Delete these two folders:

      / Users / YourName / Library / Application Support / Wine /
      / Users / YourName / Library / Application Support / TntWare /

5. Close X11 and/or XQuartz if they are running. Then try to start TntMPD.

          A. Did X11 or XQuartz appear? If not, you might try uninstalling XQuartz and install an older version.

          B. Open this folder, and look for a new file (that was created when you tried starting TntMPD):

              / Users / YourName / Library / Application Support / TntWare / TntMPD / EventLogs /

6.   You might try installing an older version of Wine (1.1.34) into your Applications folder:
            http://darwine.good-day.net/Wine_1.1.34.dmg

7.   You might try upgrading your Mac OS X. Someone has reported that upgrading from 10.6.8 to 10 .7 resolved their TntMPD startup issue.

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Wed, 03 Aug 2011 18:37:59 GMT
Revision 19 posted to Frequently Asked Questions (English) by Troy Wolbrink on 8/3/2011 2:37:59 PM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

2. Make sure you're running XQuartz 2.6.0 or newer.

                  Under "Applications/Utilities", click on "XQuartz" (or "X11" if XQuartz doesn't exist).
                  Then, under the "X11" menu, click on "About X11" to check the version.
                      (Note: If you've never before run XQuartz this way, this might also prevent TntMPD from starting.)

3. Make sure you don't have Wine installed into your Applications folder.
         This might affect how TntMPD operates.
             If you have this, and if TntMPD won't start, delete Wine from your Applications folder.

4. You can force TntMPD to reinstall by doing the following: Delete these two folders:

      / Users / YourName / Library / Application Support / Wine /
      / Users / YourName / Library / Application Support / TntWare /

5. Close X11 and/or XQuartz if they are running. Then try to start TntMPD.

          A. Did X11 or XQuartz appear? If not, you might try uninstalling XQuartz and install an older version.

          B. Open this folder, and look for a new file (that was created when you tried starting TntMPD):

              / Users / YourName / Library / Application Support / TntWare / TntMPD / EventLogs /

6.   You might try installing an older version of Wine (1.1.34) into your Applications folder:
            http://darwine.good-day.net/Wine_1.1.34.dmg

7.   You might try upgrading your Mac OS X. Someone has reported that upgrading from 10.6.8 to 10 .7 resolved their TntMPD startup issue.

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Mon, 09 May 2011 20:32:37 GMT
Revision 18 posted to Frequently Asked Questions (English) by Troy Wolbrink on 5/9/2011 4:32:37 PM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

2. Make sure you're running XQuartz 2.6.0 or newer.

                  Under "Applications/Utilities", click on "XQuartz" (or "X11" if XQuartz doesn't exist).
                  Then, under the "X11" menu, click on "About X11" to check the version.
                      (Note: If you've never before run XQuartz this way, this might also prevent TntMPD from starting.)

3. Make sure you don't have Wine installed into your Applications folder.
         This might affect how TntMPD operates.
             If you have this, and if TntMPD won't start, delete Wine from your Applications folder.

4. You can force TntMPD to reinstall by doing the following: Delete these two folders:

      / Users / YourName / Library / Application Support / Wine /
      / Users / YourName / Library / Application Support / TntWare /

5. Close X11 and/or XQuartz if they are running. Then try to start TntMPD.

          A. Did X11 or XQuartz appear? If not, you might try uninstalling XQuartz and install an older version.

          B. Open this folder, and look for a new file (that was created when you tried starting TntMPD):

              / Users / YourName / Library / Application Support / TntWare / TntMPD / EventLogs /

6.   You might try installing an older version of Wine (1.1.34) into your Applications folder:
            http://darwine.good-day.net/Wine_1.1.34.dmg

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Tue, 12 Apr 2011 17:24:51 GMT
Revision 17 posted to Frequently Asked Questions (English) by Troy Wolbrink on 4/12/2011 1:24:51 PM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

2. Make sure you're running XQuartz 2.6.0 or newer.

                  Under "Applications/Utilities", click on "XQuartz" (or "X11" if XQuartz doesn't exist).
                  Then, under the "X11" menu, click on "About X11" to check the version.
                  (Note: If you've never before run XQuartz this way, this might also prevent TntMPD from starting.)

3. Make sure you don't have Wine installed into your Applications folder.
         This might affect how TntMPD operates.
             If you have this, and if TntMPD won't start, delete Wine from your Applications folder.

4. You can force TntMPD to reinstall by doing the following: Delete these two folders:

      / Users / YourName / Library / Application Support / Wine /
      / Users / YourName / Library / Application Support / TntWare /

5. Close X11 and/or XQuartz if they are running. Then try to start TntMPD.

          A. Did X11 or XQuartz appear? If not, you might try uninstalling XQuartz and install an older version.

          B. Open this folder, and look for a new file (that was created when you tried starting TntMPD):

              / Users / YourName / Library / Application Support / TntWare / TntMPD / EventLogs /

6.   You might try installing an older version of Wine (1.1.34) into your Applications folder:
            http://darwine.good-day.net/Wine_1.1.34.dmg

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Tue, 12 Apr 2011 17:24:26 GMT
Revision 16 posted to Frequently Asked Questions (English) by Troy Wolbrink on 4/12/2011 1:24:26 PM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

2. Make sure you're running XQuartz 2.6.0 or newer.

                  Under "Applications/Utilities", click on "XQuartz" (or "X11" if XQuartz doesn't exist).
                  Then, under the "X11" menu, click on "About X11" to check the version.
                  (Note: If you've never before run XQuartz this way, this might also prevent TntMPD from starting.)

3. Make sure you don't have Wine installed into your Applications folder.
         This might affect how TntMPD operates.
             If you have this, and if TntMPD won't start, delete Wine from your Applications folder.

4. You can force TntMPD to reinstall by doing the following: Delete these two folders:

      / Users / YourName / Library / Application Support / Wine /
      / Users / YourName / Library / Application Support / TntWare /

5. Close X11 and/or XQuartz if they are running. Then try to start TntMPD.

          A. Did X11 or XQuartz appear? If not, you might try uninstalling XQuartz and install an older version.

          B. Open this folder, and look for a new file (that was created when you tried starting TntMPD):

              / Users / YourName / Library / Application Support / TntWare / TntMPD / EventLogs /

6.   You might try installing an older version of Wine (1.1.34) into your Applications folder:
            http://darwine.good-day.net/Wine_1.1.34.dmg

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Tue, 12 Apr 2011 17:24:04 GMT
Revision 15 posted to Frequently Asked Questions (English) by Troy Wolbrink on 4/12/2011 1:24:04 PM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

2. Make sure you're running XQuartz 2.6.0 or newer.

                  Under "Applications/Utilities", click on "XQuartz" (or "X11" if XQuartz doesn't exist).
                  Then, under the "X11" menu, click on "About X11" to check the version.
                  (Note: If you've never before run XQuartz this way, this might also prevent TntMPD from starting.)

3. Make sure you don't have Wine installed into your Applications folder.
         This might affect how TntMPD operates.
             If you have this, and if TntMPD won't start, delete Wine from your Applications folder.

4. You can force TntMPD to reinstall by doing the following: Delete these two folders:

      / Users / YourName / Library / Application Support / Wine /
      / Users / YourName / Library / Application Support / TntWare /

5. Close X11 and/or XQuartz if they are running. Then try to start TntMPD.

          A. Did X11 or XQuartz appear? If not, you might try uninstalling XQuartz and install an older version.

          B. Open this folder, and look for a new file (that was created when you tried starting TntMPD):

              / Users / YourName / Library / Application Support / TntWare / TntMPD / EventLogs /

6.   You might try installing an older version of Wine (1.1.34) into your Applications folder:
            http://darwine.good-day.net/Wine_1.1.34.dmg

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Tue, 12 Apr 2011 17:23:43 GMT
Revision 14 posted to Frequently Asked Questions (English) by Troy Wolbrink on 4/12/2011 1:23:43 PM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

2. Make sure you're running XQuartz 2.6.0 or newer.

                  Under "Applications/Utilities", click on "XQuartz" (or "X11" if XQuartz doesn't exist).
                  Then, under the "X11" menu, click on "About X11" to check the version.
                  (Note: If you've never before run XQuartz this way, this might also prevent TntMPD from starting.)

3. Make sure you don't have Wine installed into your Applications folder.
         This might affect how TntMPD operates.
             If you have this, and if TntMPD won't start, delete Wine from your Applications folder.

4. You can force TntMPD to reinstall by doing the following: Delete these two folders:

      / Users / YourName / Library / Application Support / Wine /
      / Users / YourName / Library / Application Support / TntWare /

5. Close X11 and/or XQuartz if they are running. Then try to start TntMPD.

          A. Did X11 or XQuartz appear? If not, you might try uninstalling XQuartz and installing install an older version.

          B. Open this folder, and look for a new file (that was created when you tried starting TntMPD):

              / Users / YourName / Library / Application Support / TntWare / TntMPD / EventLogs /

6.   You might try installing an older version of Wine (1.1.34) into your Applications folder:
            http://darwine.good-day.net/Wine_1.1.34.dmg

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Tue, 12 Apr 2011 17:23:24 GMT
Revision 13 posted to Frequently Asked Questions (English) by Troy Wolbrink on 4/12/2011 1:23:24 PM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

2. Make sure you're running XQuartz 2.6.0 or newer.

                  Under "Applications/Utilities", click on "XQuartz" (or "X11" if XQuartz doesn't exist).
                  Then, under the "X11" menu, click on "About X11" to check the version.
                  (Note: If you've never before run XQuartz this way, this might also prevent TntMPD from starting.)

3. Make sure you don't have Wine installed into your Applications folder.
         This might affect how TntMPD operates.
             If you have this, and if TntMPD won't start, delete Wine from your Applications folder.

4. You can force TntMPD to reinstall by doing the following: Delete these two folders:

      / Users / YourName / Library / Application Support / Wine /
      / Users / YourName / Library / Application Support / TntWare /

5. Close X11 and/or XQuartz if they are running. Then try to start TntMPD.

          A. Did X11 or XQuartz appear? If not, you might try uninstalling XQuartz and trying installing an older version.

          B. Open this folder, and look for a new file (that was created when you tried starting TntMPD):

              / Users / YourName / Library / Application Support / TntWare / TntMPD / EventLogs /

5

6.   You might try installing an older version of Wine (1.1.34) into your Applications folder:
            http://darwine.good-day.net/Wine_1.1.34.dmg

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Tue, 12 Apr 2011 17:22:31 GMT
Revision 12 posted to Frequently Asked Questions (English) by Troy Wolbrink on 4/12/2011 1:22:31 PM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

2. Make sure you're running XQuartz 2.6.0 or newer.

                  Under "Applications/Utilities", click on "XQuartz" (or "X11" if XQuartz doesn't exist).
                  Then, under the "X11" menu, click on "About X11" to check the version.
                  (Note: If you've never before run XQuartz this way, this might also prevent TntMPD from starting.)

3. Make sure you don't have Wine installed into your Applications folder.
         This might affect how TntMPD operates.
             If you have this, and if TntMPD won't start, delete Wine from your Applications folder.

4. You can force TntMPD to reinstall by doing the following: Delete these two folders:

      / Users / YourName / Library / Application Support / Wine /
      / Users / YourName / Library / Application Support / TntWare /

5. Close X11 and/or XQuartz if they are running. Then try to start TntMPD.

          A. Did X11 or XQuartz appear? If not, you might try uninstalling XQuartz and trying an older version.

          B. Open this folder, and look for a new file (that was created when you tried starting TntMPD):

              / Users / YourName / Library / Application Support / TntWare / TntMPD / EventLogs /

5.   You might try installing an older version of Wine (1.1.34) into your Applications folder:
            http://darwine.good-day.net/Wine_1.1.34.dmg

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Fri, 01 Apr 2011 15:13:40 GMT
Revision 11 posted to Frequently Asked Questions (English) by Troy Wolbrink on 4/1/2011 11:13:40 AM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

2. Make sure you're running XQuartz 2.6.0 or newer.

                  Under "Applications/Utilities", click on "XQuartz" (or "X11" if XQuartz doesn't exist).
                  Then, under the "X11" menu, click on "About X11" to check the version.
                  (Note: If you've never before run XQuartz this way, this might also prevent TntMPD from starting.)

3. Make sure you don't have Wine installed into your Applications folder.
         This might affect how TntMPD operates.
             If you have this, and if TntMPD won't start, delete Wine from your Applications folder.

4. You can force TntMPD to reinstall by doing the following: Deletethis folder these two folders:

      / Users/Users / YourName / Library/Application Support/Wine/prefixes/TntMPD.X.X.XLibrary /

5. You might try deleting your TntMPD settings/preferences by deleting this folder:Application Support / Users/Wine /
      / Users / YourName / Library/Application Support/TntWareLibrary /

6Application Support / TntWare /

5.   You might try installing an older version of Wine (1.1.34) into your Applications folder:
            http://darwine.good-day.net/Wine_1.1.34.dmg

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Fri, 01 Apr 2011 14:51:31 GMT
Revision 10 posted to Frequently Asked Questions (English) by Troy Wolbrink on 4/1/2011 10:51:31 AM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

2. Make sure you're running XQuartz 2.6.0 or newer.

                  Under "Applications/Utilities", click on "XQuartz" (or "X11" if XQuartz doesn't exist).
                  Then, under the "X11" menu, click on "About X11" to check the version.
                  (Note: If you've never before run XQuartz this way, this might also prevent TntMPD from starting.)

3. Make sure you don't have Wine installed into your Applications folder.
         This might affect how TntMPD operates.
             If you have this, and if TntMPD won't start, delete Wine from your Applications folder.

4. You can force TntMPD to reinstall by doing the following: Delete this folder:

      /Users/YourName/Library/Application Support/Wine/prefixes/TntMPD.X.X.X/

5. You might try deleting your TntMPD settings/preferences by deleting this folder:

        /Users/YourName/Library/Application Support/TntWare/

6.   You might try installing an older version of Wine (1.1.34) into your Applications folder:
            http://darwine.good-day.net/Wine_1.1.34.dmg

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Fri, 01 Apr 2011 14:49:15 GMT
Revision 9 posted to Frequently Asked Questions (English) by Troy Wolbrink on 4/1/2011 10:49:15 AM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

2. Make sure you're running XQuartz 2.6.0 or newer.

                  Under "Applications/Utilities", click on "XQuartz" (or "X11" if XQuartz doesn't exist).
                  Then, under the "X11" menu, click on "About X11" to check the version.
                  (Note: If you've never before run XQuartz this way, this might also prevent TntMPD from starting.)

3. Make sure you don't have Wine installed into your Applications folder.
         This might affect how TntMPD operates.
             If you have this, and if TntMPD won't start, delete Wine from your Applications folder.

4. You can force TntMPD to reinstall by doing the following: Delete this folder:

      /Users/YourName/Library/Application Support/Wine/prefixes/TntMPD.X.X.X/

5. You might try deleting your TntMPD settings/preferences by deleting this folder:

        /Users/YourName/Library/Application Support/TntWare/

6.   You might try installing an older version of Wine (1.1.34) into your Applications folder:
            http://darwine.good-day.net/Wine_1.1.34.dmg

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Fri, 04 Mar 2011 20:14:21 GMT
Revision 8 posted to Frequently Asked Questions (English) by Troy Wolbrink on 3/4/2011 3:14:21 PM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

2. Make sure you're running XQuartz 2.6.0 or newer.

                  Under "Applications/Utilities", click on "XQuartz" (or "X11" if XQuartz doesn't exist).
                  Then, under the "X11" menu, click on "About X11" to check the version.
                  (Note: If you've never before run XQuartz this way, this might also prevent TntMPD from starting.)

3. Make sure you don't have Wine installed into your Applications folder.
         This might affect how TntMPD operates.
             If you have this, and if TntMPD won't start, delete Wine from your Applications folder.

4. You can force TntMPD to reinstall by doing the following: Delete this folder:

      /Users/YourName/Library/Application Support/Wine/prefixes/TntMPD.X.X.X/

5.   You might try installing an older version of Wine (1.1.34) into your Applications folder:
            http://darwine.good-day.net/Wine_1.1.34.dmg

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Fri, 04 Mar 2011 20:13:58 GMT
Revision 7 posted to Frequently Asked Questions (English) by Troy Wolbrink on 3/4/2011 3:13:58 PM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

2. Make sure you're running XQuartz 2.6.0 or newer.

                  Under "Applications/Utilities",
                         click ", click on "XQuartz" (or "X11" if XQuartz doesn't exist).
                  Then, under the "X11" menu, click on "About X11" to check the version.

                  (Note: If you've never before run XQuartz this way, this might also prevent TntMPD from starting.)

3. Make sure you don't have Wine installed into your Applications folder.
         This might affect how TntMPD operates.
             If you have this, and if TntMPD won't start, delete Wine from your Applications folder.

4. You can force TntMPD to reinstall by doing the following: Delete this folder:

      /Users/YourName/Library/Application Support/Wine/prefixes/TntMPD.X.X.X/

5.   You might try installing an older version of Wine (1.1.34) into your Applications folder:
            http://darwine.good-day.net/Wine_1.1.34.dmg

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

Why does TntMPD for the Mac not start up, and how can I get past it?

Troy Wolbrink — Fri, 04 Mar 2011 20:13:40 GMT
Revision 6 posted to Frequently Asked Questions (English) by Troy Wolbrink on 3/4/2011 3:13:40 PM

Why does TntMPD for the Mac not start up, and how can I get past it?

1. Make sure you meet the minimum requirements for Mac OS X.
         (On your Mac, click the Apple menu, and then click on "About this Mac" to determine your version.)

Leopard (10.5.8)

Snow Leopard (10.6.4)

2. Make sure you're running XQuartz 2.6.0 or newer.

                  Under "Applications/Utilities",
                         click on "XQuartz" (or "X11" if XQuartz doesn't exist).
                  Then, under the "X11" menu, click on "About X11" to check the version.

                  (Note: If you've never before run XQuartz this way, this might also prevent TntMPD from starting.)

3. Make sure you don't have Wine installed into your Applications folder.
         This might affect how TntMPD operates.
             If you have this, and if TntMPD won't start, delete Wine from your Applications folder.

4. You can force TntMPD to reinstall by doing the following: Delete this folder:

      /Users/YourName/Library/Application Support/Wine/prefixes/TntMPD.X.X.X/

5.   You might try installing an older version of Wine (1.1.34) into your Applications folder:
            http://darwine.good-day.net/Wine_1.1.34.dmg

-------------------

If all else fails...

Finally, there are some other options to consider such as using CrossOver Mac which provides a very similar experience as TntMPD for the Mac, but it comes with commercial support:

More information here: http://www.codeweavers.com/products/cxmac/

Also here are instructions on how to install TntMPD into CrossOver.

How do I mail merge labels from TntMPD on a PC?

Troy Wolbrink — Tue, 24 Jan 2012 19:58:04 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/24/2012 2:58:04 PM

How do I mail merge labels from TntMPD on a PC?

Filed under: Mail Merge

Mail Merging Labels from TntMPD (step by step)

·        Once in TntMPD à tools à Microsoft Word à Create Mail Merge

·        Select Document Type – Mailing Labels - hit OK



A Word Document Opens up

Mail Merge Helper should appear:



If it doesn’t appear go to ***

Click on Setup à 5160 address – ok - close

***Click on    “Word Document setup” icon à Labels à 5160 address – OK – close

Next:

Click icon   (Insert merge fields)    (Not Insert Tables!!! This icon looks similar)



Select :   Mailing_Address_Block            (Insert)    (Close)



It should appear as:

«Mailing_Address_Block»

Click icon      (propagate labels)

Click icon  (view merged data)

Click on icon   (Merge to new documents)   à all à ok

Now print! Done!

How do I mail merge labels from TntMPD?

Troy Wolbrink — Mon, 29 Sep 2008 17:36:57 GMT
Revision 2 posted to Frequently Asked Questions (English) by Troy Wolbrink on 9/29/2008 1:36:57 PM

How do I mail merge labels from TntMPD?

Filed under: Mail Merge

Mail Merging Labels from TntMPD (step by step)

·        Once in TntMPD à tools à Microsoft Word à Create Mail Merge

·        Select Document Type – Mailing Labels - hit OK

                 <v:shapetype coordsize="21600,21600" o:preferrelative="t" o:spt="75" filled="f" stroked="f" path=" m@4@5 l@4@11@9@11@9@5 xe" id="_x0000_t75"><v:stroke joinstyle="miter"></v:stroke><v:formulas><v:f eqn="if lineDrawn pixelLineWidth 0 "></v:f><v:f eqn="sum @0 1 0 "></v:f><v:f eqn="sum 0 0 @1 "></v:f><v:f eqn="prod @2 1 2 "></v:f><v:f eqn="prod @3 21600 pixelWidth "></v:f><v:f eqn="prod @3 21600 pixelHeight "></v:f><v:f eqn="sum @0 0 1 "></v:f><v:f eqn="prod @6 1 2 "></v:f><v:f eqn="prod @7 21600 pixelWidth "></v:f><v:f eqn="sum @8 21600 0 "></v:f><v:f eqn="prod @7 21600 pixelHeight "></v:f><v:f eqn="sum @10 21600 0 "></v:f></v:formulas><v:path o:extrusionok="f" gradientshapeok="t" o:connecttype="rect"></v:path><o:lock aspectratio="t" v:ext="edit"></o:lock></v:shapetype><v:shape coordsize="21600,21600" type="#_x0000_t75" style="width: 248.25pt; height: 265.5pt;" id="_x0000_s1033"><v:imagedata src="/tntmpd/faqs/en/add.aspx/merge_with_word_xp_files/image001.png">

                 </v:imagedata></v:shape>

A Word Document Opens up

Mail Merge Helper should appear:



If it doesn’t appear go to ***

Click on Setup à 5160 address – ok - close

***Click on    “Word Document setup” icon à Labels à 5160 address – OK – close

Next:

Click icon   (Insert merge fields)    (Not Insert Tables!!! This icon looks similar)



Select :   Mailing_Address_Block            (Insert)    (Close)



It should appear as:

«Mailing_Address_Block»

Click icon      (propagate labels)

Click icon  (view merged data)

Click on icon   (Merge to new documents)   à all à ok

Now print! Done!

How do I mail merge labels from TntMPD?

Troy Wolbrink — Mon, 29 Sep 2008 17:34:41 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 9/29/2008 1:34:41 PM

Mail Merging Labels from TntMPD (step by step)

·        Once in TntMPD à tools à Microsoft Word à Create Mail Merge

·        Select Document Type – Mailing Labels - hit OK

                 <v:shapetype coordsize="21600,21600" o:preferrelative="t" o:spt="75" filled="f" stroked="f" path=" m@4@5 l@4@11@9@11@9@5 xe" id="_x0000_t75"><v:stroke joinstyle="miter"></v:stroke><v:formulas><v:f eqn="if lineDrawn pixelLineWidth 0 "></v:f><v:f eqn="sum @0 1 0 "></v:f><v:f eqn="sum 0 0 @1 "></v:f><v:f eqn="prod @2 1 2 "></v:f><v:f eqn="prod @3 21600 pixelWidth "></v:f><v:f eqn="prod @3 21600 pixelHeight "></v:f><v:f eqn="sum @0 0 1 "></v:f><v:f eqn="prod @6 1 2 "></v:f><v:f eqn="prod @7 21600 pixelWidth "></v:f><v:f eqn="sum @8 21600 0 "></v:f><v:f eqn="prod @7 21600 pixelHeight "></v:f><v:f eqn="sum @10 21600 0 "></v:f></v:formulas><v:path o:extrusionok="f" gradientshapeok="t" o:connecttype="rect"></v:path><o:lock aspectratio="t" v:ext="edit"></o:lock></v:shapetype><v:shape coordsize="21600,21600" type="#_x0000_t75" style="width: 248.25pt; height: 265.5pt;" id="_x0000_s1033"><v:imagedata src="/tntmpd/faqs/en/add.aspx/merge_with_word_xp_files/image001.png"></v:imagedata></v:shape>

A Word Document Opens up

Mail Merge Helper should appear:



If it doesn’t appear go to ***

Click on Setup à 5160 address – ok - close

***Click on    “Word Document setup” icon à Labels à 5160 address – OK – close

Next:

Click icon   (Insert merge fields)    (Not Insert Tables!!! This icon looks similar)



Select :   Mailing_Address_Block            (Insert)    (Close)



It should appear as:

«Mailing_Address_Block»

Click icon      (propagate labels)

Click icon  (view merged data)

Click on icon   (Merge to new documents)   à all à ok

Now print! Done!

How do I mail merge using tntmpd on a mac?

Troy Wolbrink — Tue, 24 Jan 2012 19:55:39 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/24/2012 2:55:39 PM

How do I mail merge using tntmpd on a mac?

Filed under: Mail Merge, Macintosh

On the Mac, "TntMPD for Mac" can mail merge through Word:Mac.
   http://www.tntware.com/tntmpd/faqs/en/how-can-i-merge-to-labels-from-word-mac-2011.aspx

If you're using a different word processor, you can perform the mail merge manually. Here's an article that describes this process:
    [[en:how-can-i-manually-perform-a-mail-merge|how-can-i-manually-perform-a-mail-merge]]

How do I mail merge using tntmpd on a mac?

Troy Wolbrink — Tue, 24 Jan 2012 19:55:11 GMT
Revision 8 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/24/2012 2:55:11 PM

How do I mail merge using tntmpd on a mac?

Filed under: Mail Merge, Macintosh

On the Mac, "TntMPD for Mac" can mail merge through Word:Mac. You can download TntMPD For Mac from the Downloads area. http://www.tntware.com/tntmpd/faqs/en/how-can-i-merge-to-labels-from-word-mac-2011.aspx

If you're using a different word processor, you can perform the mail merge manually. Here's an article that describes this process:
[[en:how-can-i-manually-perform-a-mail-merge|how-can-i-manually-perform-a-mail-merge]]

How do I mail merge using tntmpd on a mac?

Troy Wolbrink — Wed, 28 Sep 2011 15:41:31 GMT
Revision 7 posted to Frequently Asked Questions (English) by Troy Wolbrink on 9/28/2011 11:41:31 AM

How do I mail merge using tntmpd on a mac?

Filed under: Mail Merge, Macintosh

To
On the Mac, "TntMPD for Mac" can mail merge on a through Word:Mac. You can download TntMPD For Mac from the Downloads area.

If you're using a different word processor, you can perform the mail merge manually. Here's an article that describes this process:
[[en:how-can-i-manually-perform-a-mail-merge|how-can-i-manually-perform-a-mail-merge]]

Keep in mind that if you are using a word processor on the Mac, you'll have to export the CSV file to a shared folder that can be referenced from the Mac. This can be done using networking, or using most common virtualization packages which provide this as well.

How do I mail merge using tntmpd on a mac?

Troy Wolbrink — Tue, 02 Jun 2009 15:20:21 GMT
Revision 6 posted to Frequently Asked Questions (English) by Troy Wolbrink on 6/2/2009 11:20:21 AM

How do I mail merge using tntmpd on a mac?

Filed under: Mail Merge, Macintosh

To mail merge on a Mac, you can perform the mail merge manually. Here's an article that describes this process:
[[en:how-can-i-manually-perform-a-mail-merge|how-can-i-manually-perform-a-mail-merge]]

Keep in mind that if you are using a word processor on the Mac, you'll have to export the CSV file to a shared folder that can be referenced from the Mac. This can be done using networking, or using most common virtualization packages which provide this as well.

How do I mail merge using tntmpd on a mac?

Troy Wolbrink — Tue, 02 Jun 2009 15:20:21 GMT
Revision 5 posted to Frequently Asked Questions (English) by Troy Wolbrink on 6/2/2009 11:20:21 AM

How do I mail merge using tntmpd on a mac?mac?

Filed under: Mail Merge

To mail merge on a Mac, you can perform the mail merge manually. Here's an article that describes this process:
[[en:how-can-i-manually-perform-a-mail-merge|how-can-i-manually-perform-a-mail-merge]]

Keep in mind that if you are using a word processor on the Mac, you'll have to export the CSV file to a shared folder that can be referenced from the Mac. This can be done using networking, or using most common virtualization packages which provide this as well.

How do I mail merge using tntmpd on a mac??

Troy Wolbrink — Sun, 14 Dec 2008 07:28:06 GMT
Revision 4 posted to Frequently Asked Questions (English) by Troy Wolbrink on 12/14/2008 2:28:06 AM

How do I mail merge using tntmpd on a mac??

Filed under: Mail Merge

To mail merge on a Mac, you can perform the mail merge manually. Here's an article that describes this process:
[en:how-can-i-manually-perform-a-mail-merge|how-can-i-manually-perform-a-mail-merge][en:how-can-i-manually-perform-a-mail-merge|how-can-i-manually-perform-a-mail-merge]]

Keep in mind that if you are using a word processor on the Mac, you'll have to export the CSV file to a shared folder that can be referenced from the Mac. This can be done using networking, or using most common virtualization packages which provide this as well.

How do I mail merge using tntmpd on a mac??

Troy Wolbrink — Sun, 14 Dec 2008 07:27:26 GMT
Revision 3 posted to Frequently Asked Questions (English) by Troy Wolbrink on 12/14/2008 2:27:26 AM

How do I mail merge using tntmpd on a mac??

Filed under: Mail Merge

I have
To mail merge on a Macand purchased Windows & VMWare Fusion to run tntmpd on my mac, you can perform the mail merge manually.I have Word Here's an article that describes this process:
[en:how-can-i-manually-perform-a-mail-merge|how-can-i-manually-perform-a-mail-merge]

Keep in mind that if you are using a word processor on my the Mac, but ityou's not in ll have to export the Windows portion of my CSV file to a shared folder that can be referenced from the Mac.I This can 't currently mail merge be done using Word on my Mac b/c the csv file doesn't show up since it's on my Windows portionnetworking, or using most common virtualization packages which provide this as well.Is there a way to create address labels???

How do I mail merge using tntmpd on a mac??

AdrienneNeusch — Sat, 13 Dec 2008 03:02:44 GMT
Revision 2 posted to Frequently Asked Questions (English) by AdrienneNeusch on 12/12/2008 10:02:44 PM

Mail How do I mail merge using tntmpd on maca mac??

Filed under: Mail Merge

I have a Mac and purchased Windows & VMWare Fusion to run tntmpd on my mac. I have Word on my Mac, but it's not in the Windows portion of my Mac. I can't currently mail merge using Word on my Mac b/c the csv file doesn't show up since it's on my Windows portion. Is there a way to create address labels???

Mail merge using tntmpd on mac

AdrienneNeusch — Fri, 12 Dec 2008 23:27:09 GMT
Revision 1 posted to Frequently Asked Questions (English) by AdrienneNeusch on 12/12/2008 6:27:09 PM

I have a Mac and purchased Windows & VMWare Fusion to run tntmpd on my mac. I have Word on my Mac, but it's not in the Windows portion of my Mac. I can't currently mail merge using Word on my Mac b/c the csv file doesn't show up since it's on my Windows portion. Is there a way to create address labels???

How can I force a fresh install of "TntMPD for Mac"?

Troy Wolbrink — Wed, 18 Jan 2012 15:53:35 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/18/2012 10:53:35 AM

How can I force a fresh install of "TntMPD for Mac"?

1. Close TntMPD.

2. Delete "TntMPD.app" from the "Applications" folder.

3. Empty your Trash in Finder. If you can't, you may have to restart your Mac.

3. Delete the folder:
            "Users / (your name) / Library / Application Support / TntWare / TntMPD"

            (To get to the Library folder on Mac OS X Lion - 10.7:
                  Hold down the Option key, and click the "Go" menu in Finder. Then click on the "Library" menu.)

4. Empty your Trash in Finder (very important step). If you can't, you may have to restart your Mac.

5. Reinstall TntMPD from this download:

            http://www.tntware.com/tntmpd/downloads/p/14018.aspx

5

6. Launch TntMPD.
                If you already had an existing database file:
                        Click "No" when prompted to create a new database.
                        Under the "File" menu, click on "Open" to open your existing database file.

How can I force a fresh install of "TntMPD for Mac"?

Troy Wolbrink — Wed, 18 Jan 2012 15:52:45 GMT
Revision 7 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/18/2012 10:52:45 AM

How can I force a fresh install of "TntMPD for Mac"?

1. Close TntMPD.

2. Delete "TntMPD.app" from the "Applications" folder.

3. Empty your Trash in Finder. If you can't, you may have to restart your Mac.

3. Delete the folder:
            "Users / (your name) / Library / Application Support / TntWare / TntMPD"

            (To get to the Library folder on Mac OS X Lion - 10.7:
                  Hold down the Option key, and click the "Go" menu in Finder. Then click on the "Library" menu.)

4. Reinstall TntMPD from this download:

            http://www.tntware.com/tntmpd/downloads/p/14018.aspx

5. Launch TntMPD.
                If you already had an existing database file:
                        Click "No" when prompted to create a new database.
                        Under the "File" menu, click on "Open" to open your existing database file.

How can I force a fresh install of "TntMPD for Mac"?

Troy Wolbrink — Fri, 06 Jan 2012 02:38:13 GMT
Revision 6 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 9:38:13 PM

How can I force a fresh install of "TntMPD for Mac"?

1. Close TntMPD.

2. Delete "TntMPD.app" from the "Applications" folder. If you can't, you may have to restart your Mac.

3. Delete the folder:
            "Users / (your name) / Library / Application Support / TntWare / TntMPD"

            (To get to the Library folder on Mac OS X Lion - 10.7:
                  Hold down the Option key, and click the "Go" menu in Finder, and then . Then click on the "Library" menu.)

4. Reinstall TntMPD from this download:

            http://www.tntware.com/tntmpd/downloads/p/14018.aspx

5. Launch TntMPD.
                If you already had an existing database file:
                        Click "No" when prompted to create a new database.
                        Under the "File" menu, click on "Open" to open your existing database file.

How can I force a fresh install of "TntMPD for Mac"?

Troy Wolbrink — Fri, 06 Jan 2012 02:37:49 GMT
Revision 5 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 9:37:49 PM

How can I force a fresh install of "TntMPD for Mac"?

1. Close TntMPD.

2. Delete "TntMPD.app" from the "Applications" folder. If you can't, you may have to restart your Mac.

3. Delete the folder:
            "Users / (your name) / Library / Application Support / TntWare / TntMPD"

            (To get to the Library folder on Mac OS X Lion - 10.7:
                  Hold down the Option key, and click the "Go" menu in Finder, and then click on the "Library" menu.)

4. Reinstall TntMPD from this download:

            http://www.tntware.com/tntmpd/downloads/p/14018.aspx

5. Launch TntMPD.
                If you already had an existing database file:
                        Click "No" when prompted to create a new database.
                        Under the "File" menu, click on "Open" to open your existing database file.

How can I force a fresh install of "TntMPD for Mac"?

Troy Wolbrink — Fri, 06 Jan 2012 02:37:15 GMT
Revision 4 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 9:37:15 PM

How can I force a fresh install of "TntMPD for Mac"?

1. Close TntMPD.

2. Delete "TntMPD.app" from the "Applications" folder.

3. Delete the folder:
            "Users / (your name) / Library / Application Support / TntWare / TntMPD/ SavedSettings"

            (To get to the Library folder on Mac OS X Lion - 10.7:
                  Hold down the Option key, and click the "Go" menu in Finder, and then click on the "Library" menu.)

4. Reinstall TntMPD from this download:

            http://www.tntware.com/tntmpd/downloads/p/14018.aspx

5. Launch TntMPD.
                If you already had an existing database file:
                        Click "No" when prompted to create a new database.
                        Under the "File" menu, click on "Open" to open your existing database file.

How can I force a fresh install of "TntMPD for Mac"?

Troy Wolbrink — Fri, 06 Jan 2012 02:35:13 GMT
Revision 3 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 9:35:13 PM

How can I force a fresh install of "TntMPD for Mac"?

1. Close TntMPD.

2. Delete "TntMPD.app" from the "Applications" folder.

3. Delete the folder:
            "Users / (your name) / Library / Application Support / TntWare / TntMPD / SavedSettings"

            (To get to the Library folder on Mac OS X Lion - 10.7:
                  Hold down the Option key, and click the "Go" menu in Finder, and then click on the "Library" menu.)

4. Reinstall TntMPD from this download:

            http://www.tntware.com/tntmpd/downloads/p/14018.aspx

How can I force a fresh install of "TntMPD for Mac"?

Troy Wolbrink — Fri, 06 Jan 2012 02:35:03 GMT
Revision 2 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 9:35:03 PM

How can I force a fresh install of "TntMPD for Mac"?

1. Close TntMPD.

2. Delete "TntMPD.app" from the "Applications" folder.

3. Delete the folder: "Users / (your name) / Library / Application Support / TntWare / TntMPD / SavedSettings"

            (To get to the Library folder on Mac OS X Lion - 10.7)10.7:
                  Hold down the Option key, and click the "Go" menu in Finder, and then click on the "Library" menu.)

4. Reinstall TntMPD from this download:

            http://www.tntware.com/tntmpd/downloads/p/14018.aspx

How can I force a fresh install of "TntMPD for Mac"?

Troy Wolbrink — Fri, 06 Jan 2012 02:34:35 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/5/2012 9:34:35 PM

1. Close TntMPD.

2. Delete "TntMPD.app" from the "Applications" folder.

3. Delete the folder: "Users / (your name) / Library / Application Support / TntWare / TntMPD / SavedSettings"

            (To get to the Library folder on Mac OS X Lion - 10.7):
                       Hold down the Option key, and click the "Go" menu in Finder, and then click on the "Library" menu.)

4. Reinstall TntMPD from this download:

            http://www.tntware.com/tntmpd/downloads/p/14018.aspx

How can I encrypt my TntMPD database file?

Troy Wolbrink — Tue, 17 Jan 2012 14:46:16 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/17/2012 9:46:16 AM

How can I encrypt my TntMPD database file?

I'd recommend using a product like TrueCrypt (http://www.truecrypt.org/). This product creates a virtual encrypted disk within a file and mounts it as a real disk.

You could put your TrueCrypt container inside of your Dropbox folder, if . This gives you were ever concerened about the security backup feature of your data in Dropbox's cloud, although the use of TrueCrypt on Dropbox does increase the chance of a conflict with more than one user making changes at the same time.

If you're wondering where your TntMPD database file is right now on your hard drive, check out this article: http://www.tntware.com/tntmpd/faqs/en/what-and-where-is-my-database.aspx

Be

This product works on the PC and on Macs. But be aware that on the Mac, when you create your TrueCrypt container, you must choose "Mac OS Extended" as your format .for it to be compatible with "TntMPD for the Mac". Unfortunately the "Mac OS Extended" format is not compatible with the PC, so only choose this if you are Mac only.

How can I encrypt my TntMPD database file?

Troy Wolbrink — Tue, 17 Jan 2012 14:43:05 GMT
Revision 2 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/17/2012 9:43:05 AM

How can I encrypt my TntMPD database file?

I'd recommend using a product like TrueCrypt (http://www.truecrypt.org/). This product creates a virtual encrypted disk within a file and mounts it as a real disk.

You could put your TrueCrypt container inside of your Dropbox folder, if you were ever concerened about the security of your data in Dropbox's cloud.

If you're wondering where your TntMPD database file is right now on your hard drive, check out this article: http://www.tntware.com/tntmpd/faqs/en/what-and-where-is-my-database.aspx

Be aware that on the Mac, when you create your TrueCrypt container, you must choose "Mac OS Extended" as your format(unfortunately this makes . Unfortunately the container incompatible "Mac OS Extended" format is not compatible with the PC)PC, so only choose this if you are Mac only.

How can I encrypt my TntMPD database file?

Troy Wolbrink — Tue, 17 Jan 2012 14:42:20 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/17/2012 9:42:20 AM

I'd recommend using a product like TrueCrypt (http://www.truecrypt.org/). This product creates a virtual encrypted disk within a file and mounts it as a real disk.

You could put your TrueCrypt container inside of your Dropbox folder, if you were ever concerened about the security of your data in Dropbox's cloud.

If you're wondering where your TntMPD database file is right now on your hard drive, check out this article: http://www.tntware.com/tntmpd/faqs/en/what-and-where-is-my-database.aspx

Be aware that on the Mac, when you create your TrueCrypt container, you must choose "Mac OS Extended" as your format (unfortunately this makes the container incompatible with the PC).

Troubleshooting Internet Connection Issues

Troy Wolbrink — Wed, 04 Jan 2012 17:05:04 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/4/2012 12:05:04 PM

Troubleshooting Internet Connection Issues

Filed under: Troubleshooting, Gift Input from Web

Sometimes TntMPD can not connect to the internet to download gift information, even though your computer is connected. If you can see your donations at your organization's website using Microsoft Internet Explorer (as opposed to Firefox) than TntMPD should also be able to connect to your organization's website.

If not there are several possible reasons:

1. Your organization's website for providing donation information is temporarily down. If your organization provides a "Staff Web" of "Staff Portal" for viewing donation information, see if you can login using your web browser and view your information online. If not, the website is probably down and unavailable to TntMPD as well.

2. TntMPD can't connect to the internet at all. To test if TntMPD can connect to the internet at all, under the "Help" menu, click on "Check for Updates". If this works, than TntMPD can connect to the internet and the problem is specific to your organization. If this doesn't work, make sure you can visit www.tntware.com using Microsoft Internet Explorer (not Firefox) as TntMPD uses the internet connection settings from Microsoft Internet Explorer.

3. Your organization has moved their website. Click on the "Download Organization List" button.  If your organization is listed, this should ensure you're using the latest configuration settings to connect.

4. You have a personal firewall blocking TntMPD (and not Microsoft Internet Explorer) from connecting to the internet. Try turning off your personal firewall (or reconfiguting it to allow TntMPD) to see if this is the issue. Here's a handy reference to further explore this topic:
http://support.mozilla.com/en-us/kb/firewalls

5. You might need to specify your proxy server setup because of your ISP or content filter. Generally TntMPD can automatically use the proxy settings from Microsoft Internet Explorer or auto-detect them from your Mac settings. But you can also manually set them in TntMPD. Under the "Tools" menu, click on "Network Settings" and you can specify the proxy server for TntMPD to use.

6. Your proxy server might require you to login using a browser.  In this case, pull up Internet Explorer and login to your proxy server. Leave Internet Explorer open while you use TntMPD.

Troubleshooting Internet Connection Issues

Troy Wolbrink — Wed, 04 Jan 2012 16:54:48 GMT
Revision 8 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/4/2012 11:54:48 AM

Troubleshooting Internet Connection Issues

Filed under: Troubleshooting, Gift Input from Web

Sometimes TntMPD can not connect to the internet to download gift information, even though your computer is connected. If you can see your donations at your organization's website using Microsoft Internet Explorer (as opposed to Firefox) than TntMPD should also be able to connect to your organization's website.

If not there are several possible reasons:

1. Your organization's website for providing donation information is temporarily down. If your organization provides a "Staff Web" of "Staff Portal" for viewing donation information, see if you can login using your web browser and view your information online. If not, the website is probably down and unavailable to TntMPD as well.

2. TntMPD can't connect to the internet at all. To test if TntMPD can connect to the internet at all, under the "Help" menu, click on "Check for Updates". If this works, than TntMPD can connect to the internet and the problem is specific to your organization. If this doesn't work, make sure you can visit www.tntware.com using Microsoft Internet Explorer (not Firefox) as TntMPD uses the internet connection settings from Microsoft Internet Explorer.

3. Your organization has moved their website. Click on the "Download "Download Organization List" button.  If your organization is listed, this should ensure you're using the latest configuration settings to connect.

4. You have a personal firewall blocking TntMPD (and not Microsoft Internet Explorer) from connecting to the internet. Try turning off your personal firewall (or reconfiguting it to allow TntMPD) to see if this is the issue. Here's a handy reference to further explore this topic:
http://support.mozilla.com/en-us/kb/firewalls

5. Your operating system is telling TntMPD that you are not connected You might need to specify your proxy server setup because of your ISP or content filter. Generally TntMPD can automatically use the internet (a false negative)proxy settings from Microsoft Internet Explorer or auto-detect them from your Mac settings. But you can also manually set them in TntMPD. Under the "Tools" menu, click on "Network Settings". You'll see a tab for "Proxy" settings, " and under "Advanced" you 'll see:

Force preliminary connection attempts: This is where you tell TntMPD to try to connect to the website of your choosing whenever it thinks no connection is available. Sometimes this can "prime the pump" so that TntMPD can correctly detect specify the internet.

Always report an Internet connection as being available: This is where you tell TntMPD to always think an internet connection is available. When you don't actually have an internet connection, be prepared proxy server for some possible cryptic error message when TntMPD tries to connect. But atleast this might provide you a work arounduse.

6. You might have some complicated Your proxy server setup because of your ISP. Generally TntMPD can automatically use the proxy settings from Microsoft Internet Explorer, but there are some fringe cases where the proxy setting requires a special might require you to login page in using a browserbefore it allows any other connection.  In this case, pull up Internet Explorer and this sometimes makes it near impossible for TntMPD login to connectyour proxy server. Also, Leave Internet Explorer open while you can check any proxy settings defined in use TntMPD, under the "Tools" menu click on "Network Settings"..

Troubleshooting Internet Connection Issues

Troy Wolbrink — Fri, 14 Jan 2011 15:35:32 GMT
Revision 7 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/14/2011 10:35:32 AM

Troubleshooting Internet Connection Issues

Filed under: Troubleshooting, Gift Input from Web

Sometimes TntMPD can not connect to the internet to download gift information, even though your computer is connected. If you can see your donations at your organization's website using Microsoft Internet Explorer (as opposed to Firefox) than TntMPD should also be able to connect to your organization's website.

If not there are several possible reasons:

1. Your organization's website for providing donation information is temporarily down. If your organization provides a "Staff Web" of "Staff Portal" for viewing donation information, see if you can login using your web browser and view your information online. If not, the website is probably down and unavailable to TntMPD as well.

2. TntMPD can't connect to the internet at all. To test if TntMPD can connect to the internet at all, under the "Help" menu, click on "Check for Updates". If this works, than TntMPD can connect to the internet and the problem is specific to your organization. If this doesn't work, make sure you can visit www.tntware.com using Microsoft Internet Explorer (not Firefox) as TntMPD uses the internet connection settings from Microsoft Internet Explorer.

3. Your organization has moved their website. Click on the "Download Organization List" button.  If your organization is listed, this should ensure you're using the latest configuration settings to connect.

4. You have a personal firewall blocking TntMPD (and not Microsoft Internet Explorer) from connecting to the internet. Try turning off your personal firewall (or reconfiguting it to allow TntMPD) to see if this is the issue. Here's a handy reference to further explore this topic:
http://support.mozilla.com/en-us/kb/firewalls

5. Your operating system is telling TntMPD that you are not connected to the internet (a false negative). Under the "Tools" menu, click on "Network Settings". You'll see a tab for "Proxy" settings, and under "Advanced" you'll see:

Force preliminary connection attempts: This is where you tell TntMPD to try to connect to the website of your choosing whenever it thinks no connection is available. Sometimes this can "prime the pump" so that TntMPD can correctly detect the internet.

Always report an Internet connection as being available: This is where you tell TntMPD to always think an internet connection is available. When you don't actually have an internet connection, be prepared for some possible cryptic error message when TntMPD tries to connect. But atleast this might provide you a work around.

6. You might have some complicated proxy server setup because of your ISP. Generally TntMPD can automatically use the proxy settings from Microsoft Internet Explorer, but there are some fringe cases where the proxy setting requires a special login page in a browser before it allows any other connection, and this sometimes makes it near impossible for TntMPD to connect. Also, you can check any proxy settings defined in TntMPD, under the "Tools" menu click on "Network Settings".

Troubleshooting Internet Connection Issues

Troy Wolbrink — Wed, 11 Aug 2010 17:52:33 GMT
Revision 6 posted to Frequently Asked Questions (English) by Troy Wolbrink on 8/11/2010 1:52:33 PM

Troubleshooting Internet Connection Issues

Filed under: Troubleshooting, Gift Input from Web

Sometimes TntMPD can not connect to the internet to download gift information, even though your computer is connected. If you can see your donations at your organization's website using Microsoft Internet Explorer (as opposed to Firefox) than TntMPD should also be able to connect to your organization's website.

If not there are several possible reasons:

1. Your organization's website for providing donation information is temporarily down. If your organization provides a "Staff Web" of "Staff Portal" for viewing donation information, see if you can login using your web browser and view your information online. If not, the website is probably down and unavailable to TntMPD as well.

2. TntMPD can't connect to the internet at all. To test if TntMPD can connect to the internet at all, under the "Help" menu, click on "Check for Updates". If this works, than TntMPD can connect to the internet and the problem is specific to your organization. If this doesn't work, make sure you can visit www.tntware.com using Microsoft Internet Explorer (not Firefox) as TntMPD uses the internet connection settings from Microsoft Internet Explorer.

3. Your organization has moved their website. Click on the "Download Organization List" button.  If your organization is listed, this should ensure you're using the latest configuration settings to connect.

4. You have a personal firewall blocking TntMPD (and not Microsoft Internet Explorer) from connecting to the internet. Try turning off your personal firewall (or reconfiguting it to allow TntMPD) to see if this is the issue. Here's a handy reference to further explore this topic:
http://support.mozilla.com/en-us/kb/firewalls

5. Your operating system is telling TntMPD that you are not connected to the internet (a false negative). Under the "Tools" menu, click on "Options" and then click on "Installation" to find the button "Advanced Internet Connection Network Settings". Click this button to You'll see the 2 optionsa tab for "Proxy" settings, and under "Advanced" you'll see:

Force preliminary connection attempts: This is where you tell TntMPD to try to connect to the website of your choosing whenever it thinks no connection is available. Sometimes this can "prime the pump" so that TntMPD can correctly detect the internet.

Always report an Internet connection as being available: This is where you tell TntMPD to always think an internet connection is available. When you don't actually have an internet connection, be prepared for some possible cryptic error message when TntMPD tries to connect. But atleast this might provide you a work around.

6. You might have some complicated proxy server setup because of your ISP. Generally TntMPD can automatically use the proxy settings from Microsoft Internet Explorer, but there are some fringe cases where the proxy setting requires a special login page in a browser before it allows any other connection, and this sometimes makes it near impossible for TntMPD to connect.

Troubleshooting Internet Connection Issues

Troy Wolbrink — Wed, 11 Aug 2010 17:51:17 GMT
Revision 5 posted to Frequently Asked Questions (English) by Troy Wolbrink on 8/11/2010 1:51:17 PM

Troubleshooting Internet Connection Issues

Filed under: Troubleshooting, Gift Input from Web

Sometimes TntMPD can not connect to the internet to download gift information, even though your computer is connected. If you can see your donations at your organization's website using Microsoft Internet Explorer (as opposed to Firefox) than TntMPD should also be able to connect to your organization's website.

If not there are several possible reasons:

1. Your organization's website for providing donation information is temporarily down. If your organization provides a "Staff Web" of "Staff Portal" for viewing donation information, see if you can login using your web browser and view your information online. If not, the website is probably down and unavailable to TntMPD as well.

2. TntMPD can't connect to the internet at all. To test if TntMPD can connect to the internet at all, under the "Help" menu, click on "Check for Updateson the Web". If this works, than TntMPD can connect to the internet and the problem is specific to your organization. If this doesn't work, make sure you can visit www.tntware.com using Microsoft Internet Explorer (not Firefox) as TntMPD uses the internet connection settings from Microsoft Internet Explorer.

3. Your organization has moved their website. Click on the "Download Organization List" button.  If your organization is listed, this should ensure you're using the latest configuration settings to connect.

4. You have a personal firewall blocking TntMPD (and not Microsoft Internet Explorer) from connecting to the internet. Try turning off your personal firewall (or reconfiguting it to allow TntMPD) to see if this is the issue. Here's a handy reference to further explore this topic:
http://support.mozilla.com/en-us/kb/firewalls

5. Your operating system is telling TntMPD that you are not connected to the internet (a false negative). Under the "Tools" menu, click on "Options" and then click on "Installation" to find the button "Advanced Internet Connection Settings". Click this button to see the 2 options:

Force preliminary connection attempts: This is where you tell TntMPD to try to connect to the website of your choosing whenever it thinks no connection is available. Sometimes this can "prime the pump" so that TntMPD can correctly detect the internet.

Always report an Internet connection as being available: This is where you tell TntMPD to always think an internet connection is available. When you don't actually have an internet connection, be prepared for some possible cryptic error message when TntMPD tries to connect. But atleast this might provide you a work around.

6. You might have some complicated proxy server setup because of your ISP. Generally TntMPD can automatically use the proxy settings from Microsoft Internet Explorer, but there are some fringe cases where the proxy setting requires a special login page in a browser before it allows any other connection, and this sometimes makes it near impossible for TntMPD to connect.

Troubleshooting Internet Connection Issues

Troy Wolbrink — Mon, 10 Nov 2008 16:37:36 GMT
Revision 4 posted to Frequently Asked Questions (English) by Troy Wolbrink on 11/10/2008 11:37:36 AM

Troubleshooting Internet Connection Issues

Filed under: Troubleshooting, Gift Input from Web

Sometimes TntMPD can not connect to the internet to download gift information, even though your computer is connected. If you can see your donations at your organization's website using Microsoft Internet Explorer (as opposed to Firefox) than TntMPD should also be able to connect to your organization's website.

If not there are several possible reasons:

1. Your organization's website for providing donation information is temporarily down. If your organization provides a "Staff Web" of "Staff Portal" for viewing donation information, see if you can login using your web browser and view your information online. If not, the website is probably down and unavailable to TntMPD as well.

2. TntMPD can't connect to the internet at all. To test if TntMPD can connect to the internet at all, under the "Help" menu, click on "Check for Updates on the Web". If this works, than TntMPD can connect to the internet and the problem is specific to your organization. If this doesn't work, make sure you can visit www.tntware.com using Microsoft Internet Explorer (not Firefox) as TntMPD uses the internet connection settings from Microsoft Internet Explorer.

3. Your organization has moved their website. Click on the "Download Organization List" button.  If your organization is listed, this should ensure you're using the latest configuration settings to connect.

4. You have a personal firewall blocking TntMPD (and not Microsoft Internet Explorer) from connecting to the internet. Try turning off your personal firewall (or reconfiguting it to allow TntMPD) to see if this is the issue. Here's a handy reference to further explore this topic:
http://support.mozilla.com/en-us/kb/firewalls

5. Your operating system is telling TntMPD that you are not connected to the internet (a false negative). Under the "Tools" menu, click on "Options" and then click on "Installation" to find the button "Advanced Internet Connection Settings". Click this button to see the 2 options:

Force preliminary connection attempts: This is where you tell TntMPD to try to connect to the website of your choosing whenever it thinks no connection is available. Sometimes this can "prime the pump" so that TntMPD can correctly detect the internet.

Always report an Internet connection as being available: This is where you tell TntMPD to always think an internet connection is available. When you don't actually have an internet connection, be prepared for some possible cryptic error message when TntMPD tries to connect. But atleast this might provide you a work around.

6. You might have some complicated proxy server setup because of your ISP. Generally TntMPD can automatically use the proxy settings from Microsoft Internet Explorer, but there are some fringe cases where the proxy setting requires a special login page in a browser before it allows any other connection, and this sometimes makes it near impossible for TntMPD to connect.

Troubleshooting Internet Connection Issues

Troy Wolbrink — Mon, 10 Nov 2008 16:35:56 GMT
Revision 3 posted to Frequently Asked Questions (English) by Troy Wolbrink on 11/10/2008 11:35:56 AM

Troubleshooting Internet Connection Issues

Sometimes TntMPD can not connect to the internet to download gift information, even though your computer is connected. If you can see your donations at your organization's website using Microsoft Internet Explorer (as opposed to Firefox) than TntMPD should also be able to connect to your organization's website.

If not there are several possible reasons:

1. Your organization's website for providing donation information is temporarily down. If your organization provides a "Staff Web" of "Staff Portal" for viewing donation information, see if you can login using your web browser and view your information online. If not, the website is probably down and unavailable to TntMPD as well.

2. TntMPD can't connect to the internet at all. To test if TntMPD can connect to the internet at all, under the "Help" menu, click on "Check for Updates on the Web". If this works, than TntMPD can connect to the internet and the problem is specific to your organization.

2

3. Your organization has moved their website. Click on the "Download Organization List" button.  If your organization is listed, this should ensure you're using the latest configuration settings to connect.

3

4. You have a personal firewall blocking TntMPD (and not Microsoft Internet Explorer) from connecting to the internet. Try turning off your personal firewall (or reconfiguting it to allow TntMPD) to see if this is the issue. Here's a handy reference to further explore this topic:
http://support.mozilla.com/en-us/kb/firewalls

4

5. Your operating system is telling TntMPD that you are not connected to the internet (a false negative). Under the "Tools" menu, click on "Options" and then click on "Installation" to find the button "Advanced Internet Connection Settings". Click this button to see the 2 options:

Force preliminary connection attempts: This is where you tell TntMPD to try to connect to the website of your choosing whenever it thinks no connection is available. Sometimes this can "prime the pump" so that TntMPD can correctly detect the internet.

Always report an Internet connection as being available: This is where you tell TntMPD to always think an internet connection is available. When you don't actually have an internet connection, be prepared for some possible cryptic error message when TntMPD tries to connect. But atleast this might provide you a work around.

5
6. You might have some complicated proxy server setup because of your ISP. Generally TntMPD can automatically use the proxy settings from Microsoft Internet Explorer, but there are some fringe cases where the proxy setting requires a special login page in a browser before it allows any other connection, and this sometimes makes it near impossible for TntMPD to connect.

Troubleshooting Internet Connection Issues

Troy Wolbrink — Mon, 10 Nov 2008 16:31:23 GMT
Revision 2 posted to Frequently Asked Questions (English) by Troy Wolbrink on 11/10/2008 11:31:23 AM

Troubleshooting Internet Connection Issues

Sometimes TntMPD can not connect to the internet to download gift information, even though your computer is connected. If you can see your donations at your organization's website using Microsoft Internet Explorer (as opposed to Firefox) than TntMPD should also be able to connect to your organization's website.

If not there are 4 several possible reasons:

1.Your organization presents a different domain/website to TntMPD and this domain/website is downcan't connect to the internet at all. To test if TntMPD can connect to the internet at all, under the "Help" "Help" menu, click on "Check "Check for Updates on the Web". ". If this works, than TntMPD can connect to the internet , just not your organization's website, so you'd need and the problem is specific to contact your organization.

2. Your organization has moved their website. Click on the "Download Organization List" button.  If your organization is listed, thisdoesn should ensure you't work, move on re using the latest configuration settings to #2.

2connect.

3. You have a personal firewall blocking TntMPD (and not Microsoft Internet Explorer) from connecting to the internet. Try turning off your personal firewall (or reconfiguting it to allow TntMPD) to see if this is the issue. Here's a handy reference to further explore this topic:
http://support.mozilla.com/en-us/kb/firewalls

3

4. There is some issue with your Your operating system that is causing telling TntMPD that you are not connected to detect no connection the internet (a false negative). Under the "Tools" menu, click on "Options" and then click on "Installation" to find the button "Advanced Internet Connection Settings". Click this button to see the 2 options:

Force preliminary connection attempts.: This is where you tell TntMPD to try to connect to the website of your choosing whenever it thinks no connection is available. Sometimes this can "prime the pump" so that TntMPD can correctly detect the internet.

Always report an Internet connection as being available.: This is where you tell TntMPD to always think an internet connection is available. When you don't actually have an internet connection, be prepared for some possible cryptic error message when TntMPD tries to connect. But atleast this might provide you a work around.

4
5. You might have some complicated proxy server setup because of your ISP. Generally TntMPD can automatically use the proxy settings from Microsoft Internet Explorer, but there are some fringe cases where the proxy setting requires a special login page in a browser before it allows any other connection, and this sometimes makes it near impossible for TntMPD to connect.

Troubleshooting Internet Connection Issues

Troy Wolbrink — Thu, 09 Oct 2008 18:28:49 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/9/2008 2:28:49 PM

Sometimes TntMPD can not connect to the internet to download gift information, even though your computer is connected. If you can see your donations at your organization's website using Microsoft Internet Explorer (as opposed to Firefox) than TntMPD should also be able to connect to your organization's website.

If not there are 4 possible reasons:

1. Your organization presents a different domain/website to TntMPD and this domain/website is down. To test if TntMPD can connect to the internet at all, under the "Help" menu, click on "Check for Updates on the Web". If this works, than TntMPD can connect to the internet, just not your organization's website, so you'd need to contact your organization. If this doesn't work, move on to #2.

2. You have a personal firewall blocking TntMPD (and not Microsoft Internet Explorer) from connecting to the internet. Try turning off your personal firewall (or reconfiguting it to allow TntMPD) to see if this is the issue. Here's a handy reference to further explore this topic:
http://support.mozilla.com/en-us/kb/firewalls

3. There is some issue with your operating system that is causing TntMPD to detect no connection (a false negative). Under the "Tools" menu, click on "Options" and then click on "Installation" to find the button "Advanced Internet Connection Settings". Click this button to see the 2 options:

Force preliminary connection attempts. This is where you tell TntMPD to try to connect to the website of your choosing whenever it thinks no connection is available. Sometimes this can "prime the pump" so that TntMPD can correctly detect the internet.

Always report an Internet connection as being available. This is where you tell TntMPD to always think an internet connection is available. When you don't actually have an internet connection, be prepared for some possible cryptic error message when TntMPD tries to connect. But atleast this might provide you a work around.

4. You might have some complicated proxy server setup because of your ISP. Generally TntMPD can automatically use the proxy settings from Microsoft Internet Explorer, but there are some fringe cases where the proxy setting requires a special login page in a browser before it allows any other connection, and this sometimes makes it near impossible for TntMPD to connect.

I'm on Firefox. Is this supported?

Troy Wolbrink — Wed, 04 Jan 2012 17:04:27 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/4/2012 12:04:27 PM

I'm on Firefox. Is this supported?

Even though TntMPD uses Internet Explorer internally, it's fine if you use Firefox as your default browser.

But do keep in mind that, if you have any special proxy settings for connecting to the Internet, you'll need to have those settings in Internet Exploreras well. or you can specify them manually in TntMPD uses the proxy settings from Internet Explorer(Tools | Network Settings).

I'm on Firefox. Is this supported?

Troy Wolbrink — Mon, 04 May 2009 14:49:54 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 5/4/2009 10:49:54 AM

Even though TntMPD uses Internet Explorer internally, it's fine if you use Firefox as your default browser. But do keep in mind that, if you have any special proxy settings for connecting to the Internet, you'll need to have those settings in Internet Explorer as well. TntMPD uses the proxy settings from Internet Explorer.

How can I configure the internet proxy settings used by TntMPD?

Troy Wolbrink — Wed, 04 Jan 2012 17:02:26 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/4/2012 12:02:26 PM

How can I configure the internet proxy settings used by TntMPD?

By default TntMPD uses the settings in Microsoft Internet Explorer for the proxy. But if you want to override the settings for TntMPD, you can do so. To do this, under the "Tools" menu, click on "Options". Then click the "Installation" tab. Then click the "Advanced Internet "Network Settings" button.".



Note: This requires TntMPD 2.1 or newer.

How can I configure the internet proxy settings used by TntMPD?

Troy Wolbrink — Tue, 11 May 2010 19:23:47 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 5/11/2010 3:23:47 PM

By default TntMPD uses the settings in Microsoft Internet Explorer for the proxy. But if you want to override the settings for TntMPD, you can do so. To do this, under the "Tools" menu, click on "Options". Then click the "Installation" tab. Then click the "Advanced Internet Settings" button.



Note: This requires TntMPD 2.1 or newer.

How do I transfer my database to another computer?

Troy Wolbrink — Fri, 02 Dec 2011 16:21:20 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 12/2/2011 11:21:20 AM

How do I transfer my database to another computer?

Filed under: Managing Database Files

TntMPD's user guide has a great reference on this:
How to copy a TntMPD database to a new location

What follows is additional information and ideas:

If you know how to copy a file to another computer, you can easily transfer your TntMPD database to another computer. It's as easy as 1, 2, 3!

1. First of all, make sure that TntMPD is installed on the target computer. It's best to install the latest version from the TntMPD website.

2. Copy your TntMPD database file (it's a file that ends with .mpddb) to your other computer. (Where is my database file?) Here are a few ideas of how you can do this:

Use a service like Dropbox (www.dropbox.com). By the way, here's more info on how you might continue to use TntMPD with a service like Dropbox.

Email the file (as an attachment) to yourself. (Check with your ISP on size limits of your email.)

Copy the file onto a floppy disk (If the file is too large for a single disk, you can use WinZip to span the file across multiple floppies.)

Copy the file onto a Zip Drive, Jazz drive, CD-ROM, USB Drive, etc.

Copy the file onto a memory stick, compact flash memory card, etc.

Copy the file onto an external hard drive or a network drive.

Copy the file directly to another computer by establishing a peer-to-peer network two computers using Ethernet, USB or Parallel ports.

3. Once you've copied your database file onto the other computer, move it to a folder where you keep your normal documents (such as "My Documents"). Then just double-click on it, and it will open up in TntMPD! (HINT: If you copied the file from a CD-ROM, be sure to right-click on the file, click on "Properties" and turn off "Read Only".)

How do I transfer my database to another computer?

Troy Wolbrink — Wed, 03 Aug 2011 20:12:40 GMT
Revision 10 posted to Frequently Asked Questions (English) by Troy Wolbrink on 8/3/2011 4:12:40 PM

How do I transfer my database to another computer?

Filed under: Managing Database Files

If you know how to copy a file to another computer, you can easily transfer your TntMPD database to another computer. It's as easy as 1, 2, 3!

1. First of all, make sure that TntMPD is installed on the target computer. It's best to install the latest version from the TntMPD website.

2. Copy your TntMPD database file (Where is my database it's a file ?that ends with .mpddb)file to your other computer. (Where is my database file?) Here are a few ideas of how you can do this:

Use a service like Dropbox (www.dropbox.com). By the way, here's more info on how you might continue to use TntMPD with a service like Dropbox.

Email the file (as an attachment) to yourself. (Check with your ISP on size limits of your email.)

Copy the file onto a floppy disk (If the file is too large for a single disk, you can use WinZip to span the file across multiple floppies.)

Copy the file onto a Zip Drive, Jazz drive, CD-ROM, USB Drive, etc.

Copy the file onto a memory stick, compact flash memory card, etc.

Copy the file onto an external hard drive or a network drive.

Copy the file directly to another computer by establishing a peer-to-peer network two computers using Ethernet, USB or Parallel ports.

3. Once you've copied your database file onto the other computer, move it to a folder where you keep your normal documents (such as "My Documents"). Then just double-click on it, and it will open up in TntMPD! (HINT: If you copied the file from a CD-ROM, be sure to right-click on the file, click on "Properties" and turn off "Read Only".)

How do I transfer my database to another computer?

Troy Wolbrink — Sun, 01 Aug 2010 04:20:01 GMT
Revision 9 posted to Frequently Asked Questions (English) by Troy Wolbrink on 8/1/2010 12:20:01 AM

How do I transfer my database to another computer?

Filed under: Managing Database Files

If you know how to copy a file to another computer, you can easily transfer your TntMPD database to another computer. It's as easy as 1, 2, 3!

1. First of all, make sure that TntMPD is installed on the target computer. It's best to install the latest version from the TntMPD we[[en:/tntmpd/downloads/default.aspx|TntMPD website]]bsitewebsite.

2. Copy your TntMPD database file (Where is my database file?) file to your other computer. Here are a few ideas of how you can do this:

Use a service like Dropbox (www.dropbox.com). By the way, here's more info on how you might continue to use TntMPD with a service like Dropbox.

Email the file (as an attachment) to yourself. (Check with your ISP on size limits of your email.)

Copy the file onto a floppy disk (If the file is too large for a single disk, you can use WinZip to span the file across multiple floppies.)

Copy the file onto a Zip Drive, Jazz drive, CD-ROM, USB Drive, etc.

Copy the file onto a memory stick, compact flash memory card, etc.

Copy the file onto an external hard drive or a network drive.

Copy the file directly to another computer by establishing a peer-to-peer network two computers using Ethernet, USB or Parallel ports.

3. Once you've copied your database file onto the other computer, move it to a folder where you keep your normal documents (such as "My Documents"). Then just double-click on it, and it will open up in TntMPD! (HINT: If you copied the file from a CD-ROM, be sure to right-click on the file, click on "Properties" and turn off "Read Only".)

How do I transfer my database to another computer?

Troy Wolbrink — Sun, 01 Aug 2010 04:18:19 GMT
Revision 8 posted to Frequently Asked Questions (English) by Troy Wolbrink on 8/1/2010 12:18:19 AM

How do I transfer my database to another computer?

Filed under: Managing Database Files

If you know how to copy a file to another computer, you can easily transfer your TntMPD database to another computer. It's as easy as 1, 2, 3!

1. First of all, make sure that TntMPD is installed on the target computer. It's best to install the latest version from the TntMPD we[[en:/tntmpd/downloads/default.aspx|TntMPD website]]bsite.

2. Copy your TntMPD database file (Where is my database file?) file to your other computer. Here are a few ideas of how you can do this:

Use a service like Dropbox (www.dropbox.com). By the way, here's more info on how you might continue to use TntMPD with a service like Dropbox.

Email the file (as an attachment) to yourself. (Check with your ISP on size limits of your email.)

Copy the file onto a floppy disk (If the file is too large for a single disk, you can use WinZip to span the file across multiple floppies.)

Copy the file onto a Zip Drive, Jazz drive, CD-ROM, USB Drive, etc.

Copy the file onto a memory stick, compact flash memory card, etc.

Copy the file onto an external hard drive or a network drive.

Copy the file directly to another computer by establishing a peer-to-peer network two computers using Ethernet, USB or Parallel ports.

3. Once you've copied your database file onto the other computer, move it to a folder where you keep your normal documents (such as "My Documents"). Then just double-click on it, and it will open up in TntMPD! (HINT: If you copied the file from a CD-ROM, be sure to right-click on the file, click on "Properties" and turn off "Read Only".)

How do I transfer my database to another computer?

Troy Wolbrink — Sun, 01 Aug 2010 04:17:42 GMT
Revision 7 posted to Frequently Asked Questions (English) by Troy Wolbrink on 8/1/2010 12:17:42 AM

How do I transfer my database to another computer?

Filed under: Managing Database Files

If you know how to copy a file to another computer, you can easily transfer your TntMPD database to another computer. It's as easy as 1, 2, 3!

1. First of all, make sure that TntMPD is installed on the target computer. It's best to install the latest version from the TntMPD websitewe[[en:/tntmpd/downloads/default.aspx|TntMPD website]]bsite.

2. Copy your TntMPD database file (Where is my database file?) file to your other computer. Here are a few ideas of how you can do this:

Use a service like Dropbox (www.dropbox.com). By the way, here's more info on how you might continue to use TntMPD with a service like Dropbox.

Email the file (as an attachment) to yourself. (Check with your ISP on size limits of your email.)

Copy the file onto a floppy disk (If the file is too large for a single disk, you can use WinZip to span the file across multiple floppies.)

Copy the file onto a Zip Drive, Jazz drive, CD-ROM, USB Drive, etc.

Copy the file onto a memory stick, compact flash memory card, etc.

Copy the file onto an external hard drive or a network drive.

Copy the file directly to another computer by establishing a peer-to-peer network two computers using Ethernet, USB or Parallel ports.

3. Once you've copied your database file onto the other computer, move it to a folder where you keep your normal documents (such as "My Documents"). Then just double-click on it, and it will open up in TntMPD! (HINT: If you copied the file from a CD-ROM, be sure to right-click on the file, click on "Properties" and turn off "Read Only".)

How do I transfer my database to another computer?

Troy Wolbrink — Tue, 13 Jul 2010 20:42:09 GMT
Revision 6 posted to Frequently Asked Questions (English) by Troy Wolbrink on 7/13/2010 4:42:09 PM

How do I transfer my database to another computer?

Filed under: Managing Database Files

How do I transfer my database to another computer?

If you know how to copy a file to another computer, you can easily transfer your TntMPD database to another computer. It's as easy as 1, 2, 3!

1. First of all, make sure that TntMPD is installed on the target computer. It's best to install the latest version from the TntMPD website.

2. Copy your TntMPD database file to your other computer. Here are a few ideas of how you can do this:

Use a service like Dropbox (www.dropbox.com)

Email the file (as an attachment) to yourself. (Check with your ISP on size limits of your email.)

Copy the file onto a floppy disk (If the file is too large for a single disk, you can use WinZip to span the file across multiple floppies.)

Copy the file onto a Zip Drive, Jazz drive, CD-ROM, USB Drive, etc.

Copy the file onto a memory stick, compact flash memory card, etc.

Copy the file onto an external hard drive or a network drive.

Copy the file directly to another computer by establishing a peer-to-peer network two computers using Ethernet, USB or Parallel ports.

3. Once you've copied your database file onto the other computer, move it to a folder where you keep your normal documents (such as "My Documents"). Then just double-click on it, and it will open up in TntMPD! (HINT: If you copied the file from a CD-ROM, be sure to right-click on the file, click on "Properties" and turn off "Read Only".)

How do I transfer my database to another computer?

Troy Wolbrink — Tue, 13 Jan 2009 18:46:24 GMT
Revision 5 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/13/2009 1:46:24 PM

How do I transfer my database to another computer?

Filed under: Managing Database Files

How do I transfer my database to another computer?

If you know how to copy a file to another computer, you can easily transfer your TntMPD database to another computer. It's as easy as 1, 2, 3!

1. First of all, make sure that TntMPD is installed on the target computer. It's best to install the latest version from the TntMPD website.

2. Copy your TntMPD database file to your other computer. Here are a few ideas of how you can do this:

Email the file (as an attachment) to yourself. (Check with your ISP on size limits of your email.)

Copy the file onto a floppy disk (If the file is too large for a single disk, you can use WinZip to span the file across multiple floppies.)

Copy the file onto a Zip Drive, Jazz drive, CD-ROM, USB Drive, etc.

Copy the file onto a memory stick, compact flash memory card, etc.

Copy the file onto an external hard drive or a network drive.

Copy the file directly to another computer by establishing a peer-to-peer network two computers using Ethernet, USB or Parallel ports.

3. Once you've copied your database file onto the other computer, move it to a folder where you keep your normal documents (such as "My Documents"). Then just double-click on it, and it will open up in TntMPD! (HINT: If you copied the file from a CD-ROM, be sure to right-click on the file, click on "Properties" and turn off "Read Only".)

How do I transfer my database to another computer?

Troy Wolbrink — Wed, 19 Nov 2008 00:54:15 GMT
Revision 4 posted to Frequently Asked Questions (English) by Troy Wolbrink on 11/18/2008 7:54:15 PM

How do I transfer my database to another computer?

Filed under: Managing Database Files

How do I transfer my database to another computer?

If you know how to copy a file to another computer, you can easily transfer your TntMPD database to another computer. It's as easy as 1, 2, 3!

1. First of all, make sure that TntMPD is installed on the target computer. It's best to install the latest version from the [[en:/tntmpd/install_or_upgrade.htm|TntMPD website]]TntMPD website.

2. Copy your TntMPD database file to your other computer. Here are a few ideas of how you can do this:

Email the file (as an attachment) to yourself. (Check with your ISP on size limits of your email.)

Copy the file onto a floppy disk (If the file is too large for a single disk, you can use WinZip to span the file across multiple floppies.)

Copy the file onto a Zip Drive, Jazz drive, CD-ROM, USB Drive, etc.

Copy the file onto a memory stick, compact flash memory card, etc.

Copy the file onto an external hard drive or a network drive.

Copy the file directly to another computer by establishing a peer-to-peer network two computers using Ethernet, USB or Parallel ports.

3. Once you've copied your database file onto the other computer, move it to a folder where you keep your normal documents (such as "My Documents"). Then just double-click on it, and it will open up in TntMPD! (HINT: If you copied the file from a CD-ROM, be sure to right-click on the file, click on "Properties" and turn off "Read Only".)

How do I transfer my database to another computer?

Troy Wolbrink — Wed, 19 Nov 2008 00:52:44 GMT
Revision 3 posted to Frequently Asked Questions (English) by Troy Wolbrink on 11/18/2008 7:52:44 PM

How do I transfer my database to another computer?

Filed under: Managing Database Files

How do I transfer my database to another computer?

If you know how to copy a file to another computer, you can easily transfer your TntMPD database to another computer. It's as easy as 1, 2, 3!

1. First of all, make sure that TntMPD is installed on the target computer. It's best to install the latest version from the TntMPD website[[en:/tntmpd/install_or_upgrade.htm|TntMPD website]].

2. Copy your TntMPD database file to your other computer. Here are a few ideas of how you can do this:

Email the file (as an attachment) to yourself. (Check with your ISP on size limits of your email.)

Copy the file onto a floppy disk (If the file is too large for a single disk, you can use WinZip to span the file across multiple floppies.)

Copy the file onto a Zip Drive, Jazz drive, CD-ROM, USB Drive, etc.

Copy the file onto a memory stick, compact flash memory card, etc.

Copy the file onto an external hard drive or a network drive.

Copy the file directly to another computer by establishing a peer-to-peer network two computers using Ethernet, USB or Parallel ports.

3. Once you've copied your database file onto the other computer, move it to a folder where you keep your normal documents (such as "My Documents"). Then just double-click on it, and it will open up in TntMPD! (HINT: If you copied the file from a CD-ROM, be sure to right-click on the file, click on "Properties" and turn off "Read Only".)

How do I transfer my database to another computer?

Troy Wolbrink — Mon, 29 Sep 2008 16:39:38 GMT
Revision 2 posted to Frequently Asked Questions (English) by Troy Wolbrink on 9/29/2008 12:39:38 PM

How do I transfer my database to another computer?

Filed under: Managing Database Files

How do I transfer my database to another computer?

If you know how to copy a file to another computer, you can easily transfer your TntMPD database to another computer. It's as easy as 1, 2, 3!

1. First of all, make sure that TntMPD is installed on the target computer. It's best to install the latest version from the TntMPD website.

2. Copy your TntMPD database file to your other computer. Here are a few ideas of how you can do this:

Email the file (as an attachment) to yourself. (Check with your ISP on size limits of your email.)

Copy the file onto a floppy disk (If the file is too large for a single disk, you can use WinZip to span the file across multiple floppies.)

Copy the file onto a Zip Drive, Jazz drive, CD-ROM, USB Drive, etc.

Copy the file onto a memory stick, compact flash memory card, etc.

Copy the file onto an external hard drive or a network drive.

Copy the file directly to another computer by establishing a peer-to-peer network two computers using Ethernet, USB or Parallel ports.

3. Once you've copied your database file onto the other computer, move it to a folder where you keep your normal documents (such as "My Documents"). Then just double-click on it, and it will open up in TntMPD! (HINT: If you copied the file from a CD-ROM, be sure to right-click on the file, click on "Properties" and turn off "Read Only".)

How do I transfer my database to another computer?

Troy Wolbrink — Mon, 29 Sep 2008 16:39:38 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 9/29/2008 12:39:38 PM

How do I transfer my database to another computer?

If you know how to copy a file to another computer, you can easily transfer your TntMPD database to another computer. It's as easy as 1, 2, 3!

1. First of all, make sure that TntMPD is installed on the target computer. It's best to install the latest version from the TntMPD website.

2. Copy your TntMPD database file to your other computer. Here are a few ideas of how you can do this:

Email the file (as an attachment) to yourself. (Check with your ISP on size limits of your email.)

Copy the file onto a floppy disk (If the file is too large for a single disk, you can use WinZip to span the file across multiple floppies.)

Copy the file onto a Zip Drive, Jazz drive, CD-ROM, USB Drive, etc.

Copy the file onto a memory stick, compact flash memory card, etc.

Copy the file onto an external hard drive or a network drive.

Copy the file directly to another computer by establishing a peer-to-peer network two computers using Ethernet, USB or Parallel ports.

3. Once you've copied your database file onto the other computer, move it to a folder where you keep your normal documents (such as "My Documents"). Then just double-click on it, and it will open up in TntMPD! (HINT: If you copied the file from a CD-ROM, be sure to right-click on the file, click on "Properties" and turn off "Read Only".)

How can I merge to labels from Word:mac 2011?

Troy Wolbrink — Tue, 15 Nov 2011 19:02:38 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 11/15/2011 2:02:38 PM

Under the "Tools" menu, click on "Microsoft Word:mac", then "Create Mail Merge".

You should specify that you want to merge to "Mailing Labels".

Once you're in Word, if the "Mail Merge Manager" doesn't appear, select it under the "Tools" menu.

Click the button to "Add or remove placeholders".

Inser the "Mailing Address Block" merge field and click "OK".

Now, you should be all set to merge to a new document, or you can merge directly to the printer. These commands are available on bottom of the "Mail Merge Manager".

How can I run an ad-hoc SQL query within TntMPD?

Troy Wolbrink — Thu, 13 Oct 2011 15:29:07 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/13/2011 11:29:07 AM

Under the "Tools" menu, click on "Microsoft Access", then click on "Link Access Database...".

Click the "New..." button and enter the name of a new Access database.  All the queries you enter will be stored in this database.

(Note: You can share this database with others if you want them to use your queries):

Click "OK".

Under the "Tools" menu, click on "Microsoft Access", then click on "Edit Queries...".

Under where it says "SQL:" type in your query. There's a "Fields..." button you can use to get help on all the available table and field names within the TntMPD database.

After you type in your SQL query, click the "New" button to save it.

(Note: You can only run queries that are first saved.)

Now, you can select your query under where it says "Queries" and then click the "Run" button:

If you enter a query that changes data, the only way to run it is by double-clicking on its name in the "Queries" list:

(Note: If you ever change existing records, you should also update the "LastEdit" field to the current time. Otherwise TntSync won't know the record changed. Also, if you might also need to run "File | Maintenance" and recalculate some contact fields.)

How can I collect an error report when TntMPD crashes?

Troy Wolbrink — Tue, 06 Sep 2011 19:20:33 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 9/6/2011 3:20:33 PM

How can I collect an error report when TntMPD crashes?

Filed under: Troubleshooting

Usually when there's an error in TntMPD, an error dialog with several reporting options is available with helpful error details. Sometimes (rarely) the error is so bad that Windows will simply tell you that TntMPD crashed, or worse, TntMPD will simply dissapear.

If you're on Mac:

You should check for the most recent error logs at this folder:
   / Users / YourName / Library / Application Support / TntWare / TntMPD / EventLogs /

If you're on WIndows:

When this happens, you should check the Windows event log. TntMPD (2.1 r21 or newer) will report errors to the "Windows \ Application" section, and the error report might have made it there even though it didn't reach the error dialog.

There's another way to collect an error report that will help TntWare track down the bug. Using tools found in Windows, you can collect a "mini dump" that will help diagnose the crash. It provides a frozen state of the application at the time of the crash and it's usually quite helpful in tracking down the issue.

The "mini dump" can be quite large (several mega bytes), so it's best to send it using a free service like www.yousendit.com to troy.wolbrink@tntware.com. By using this service, you keep my email inbox from reaching its limit.

To get a mini dump under Windows XP, follow the instructions found here.

To get a mini dump under Windows Vista or newer, follow the instructions found here. (Attached and zipped is a .reg file I use to setup mini dumps for TntMPD to the "%LOCALAPPDATA%\CrashDumps\TntMPD" folder.) [View:http://www.tntware.com/tntmpd/cfs-file.ashx/__key/CommunityServer.Wikis.Components.Files/en/1682.TntMPD_5F00_Dump_5F00_Reg.zip:550:0]

How can I collect an error report when TntMPD crashes?

Troy Wolbrink — Wed, 21 Apr 2010 19:40:00 GMT
Revision 2 posted to Frequently Asked Questions (English) by Troy Wolbrink on 4/21/2010 3:40:00 PM

How can I collect an error report when TntMPD crashes?

Filed under: Troubleshooting

Usually when there's an error in TntMPD, an error dialog with several reporting options is available with helpful error details. Sometimes (rarely) the error is so bad that Windows will simply tell you that TntMPD crashed, or worse, TntMPD will simply dissapear.

When this happens, you should check the Windows event log. TntMPD (2.1 r21 or newer) will report errors to the "Windows \ Application" section, and the error report might have made it there even though it didn't reach the error dialog.

There's another way to collect an error report that will help TntWare track down the bug. Using tools found in Windows, you can collect a "mini dump" that will help diagnose the crash. It provides a frozen state of the application at the time of the crash and it's usually quite helpful in tracking down the issue.

The "mini dump" can be quite large (several mega bytes), so it's best to send it using a free service like www.yousendit.com to troy.wolbrink@tntware.com. By using this service, you keep my email inbox from reaching its limit.

To get a mini dump under Windows XP, follow the instructions found here.

To get a mini dump under Windows Vista or newer, follow the instructions found here. (Attached and zipped is a .reg file I use to setup mini dumps for TntMPD to the "%LOCALAPPDATA%\CrashDumps\TntMPD" folder.)[View:http://www.tntware.com/tntmpd/cfs-file.ashx/__key/CommunityServer.Wikis.Components.Files/en/1682.TntMPD_5F00_Dump_5F00_Reg.zip:550:0]folder.) [View:http://www.tntware.com/tntmpd/cfs-file.ashx/__key/CommunityServer.Wikis.Components.Files/en/1682.TntMPD_5F00_Dump_5F00_Reg.zip:550:0]

How can I collect an error report when TntMPD crashes?

Troy Wolbrink — Wed, 21 Apr 2010 19:39:31 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 4/21/2010 3:39:31 PM

Usually when there's an error in TntMPD, an error dialog with several reporting options is available with helpful error details. Sometimes (rarely) the error is so bad that Windows will simply tell you that TntMPD crashed, or worse, TntMPD will simply dissapear.

When this happens, you should check the Windows event log. TntMPD (2.1 r21 or newer) will report errors to the "Windows \ Application" section, and the error report might have made it there even though it didn't reach the error dialog.

There's another way to collect an error report that will help TntWare track down the bug. Using tools found in Windows, you can collect a "mini dump" that will help diagnose the crash. It provides a frozen state of the application at the time of the crash and it's usually quite helpful in tracking down the issue.

The "mini dump" can be quite large (several mega bytes), so it's best to send it using a free service like www.yousendit.com to troy.wolbrink@tntware.com. By using this service, you keep my email inbox from reaching its limit.

To get a mini dump under Windows XP, follow the instructions found here.

To get a mini dump under Windows Vista or newer, follow the instructions found here. (Attached and zipped is a .reg file I use to setup mini dumps for TntMPD to the "%LOCALAPPDATA%\CrashDumps\TntMPD" folder.)(Please visit the site to view this media)

How do I get past "Internal Error: Cannot find CountryID 0"

Troy Wolbrink — Thu, 11 Aug 2011 00:36:28 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 8/10/2011 8:36:28 PM

How do I get past "Internal Error: Cannot find CountryID 0"

Filed under: Troubleshooting

If this occured while trying to sync with Outlook, then be sure to upgrade to a version 2.1 r63 or newer. Under the "Help" menu, click on "Check for BETA Update".

If you just installed TntMPD and created a new database, and while starting your first database you receive this error, "Internal Error: Can not find CountryID 0", then you need to restart your computer and try creating a new database again. To do this:

Restart your computer.

Start TntMPD and under the "File" menu, click on "New".

How do I get past "Internal Error: Cannot find CountryID 0"

Troy Wolbrink — Sun, 23 May 2010 03:16:28 GMT
Revision 2 posted to Frequently Asked Questions (English) by Troy Wolbrink on 5/22/2010 11:16:28 PM

How do I get past "Internal Error: Can not Cannot find CountryID 0"

Filed under: Troubleshooting

If you just installed TntMPD, and while starting your first database you receive this error, "Internal Error: Can not find CountryID 0", then you need to restart your computer and try creating a new database again. To do this:

Restart your computer.

Start TntMPD and under the "File" menu, click on "New".

How do I get past "Internal Error: Can not find CountryID 0"

Troy Wolbrink — Tue, 27 Jan 2009 21:36:16 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 1/27/2009 4:36:16 PM

If you just installed TntMPD, and while starting your first database you receive this error, "Internal Error: Can not find CountryID 0", then you need to restart your computer and try creating a new database again. To do this:

Restart your computer.

Start TntMPD and under the "File" menu, click on "New".

How can I use Skype as my auto-dialer?

Troy Wolbrink — Fri, 22 Jul 2011 22:21:35 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 7/22/2011 6:21:35 PM

How can I use Skype as my auto-dialer?

Filed under: Skype

Make sure Skype is setup as your "callto:" handler. In Skype, under the Tools menu, click on Options. In the Advanced settings, check the box for "Use Skype to call callto: links on the web".

In TntMPD, under the "Tools" menu, click on "Options". Then under the "User Interface" tab, under where it says "When clicking a phone number", choose "Call the number using Skype, ..."

Still having problems? Check out this Skype forum discussion:
http://forum.skype.com/index.php?showtopic=811823

How can I use Skype as my auto-dialer?

Troy Wolbrink — Mon, 30 May 2011 14:21:29 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 5/30/2011 10:21:29 AM

Make sure Skype is setup as your "callto:" handler. In Skype, under the Tools menu, click on Options. In the Advanced settings, check the box for "Use Skype to call callto: links on the web".

In TntMPD, under the "Tools" menu, click on "Options". Then under the "User Interface" tab, under where it says "When clicking a phone number", choose "Call the number using Skype, ..."

Gifts Removed From TntMPD

Troy Wolbrink — Wed, 13 Jul 2011 16:39:02 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 7/13/2011 12:39:02 PM

Gifts Removed From TntMPD

Filed under: Gift Input from Web

Sometimes when you are downloading gifts, TntMPD will give you the unsettling message, "These gifts will be removed from TntMPD".

Here TntMPD is attempting to reconcile the database on your home computer with the database from your donation system on the Internet. It sees gifts which are in your home database which it doesn't see on the Internet database, therefore it wants to remove them. Why? Well, if the two databases were not the same, your home database wouldn't accurately reflect the database from your donation system, which is the more accurate database. Your home database then wouldn't make sense.

This situation often occurs if you enter your gifts on your home computer first. For example, you may receive a cheque from John Doe, enter it into TntMPD on your home computer, then send the cheque to your donation system for processing. But your donation system may not have added the cheque before the next time that you download your donations from the Internet. TntMPD will see one gift on your home computer but no cooresponding gift in your donation system on the Internet. What is going on? TntMPD then tells you that it wants to remove this gift.

You can reason with TntMPD, however, by unchecking the gift. Then TntMPD will ask you why you want to keep this gift, but will not remove the gift.

You can at this point elect to keep a gift that TntMPD will never find on the Internet. The two databases will not be fully reconciled to each other, but that is a choice which you can make.

What do you do if you know that both databases hold a gift and TntMPD still asks to remove the gift? This can happen if you specify a date range for downloading gifts and the gift on your home computer is not within that range. For example, you may have a gift on your home computer from Jan 1, 2001 that you know is also in the donation system on the Internet. However, you are asking TntMPD to download only gifts from Dec 1, 2001 to Dec 31, 2001. TntMPD sees the gift from Jan 1, 2001 on your home computer, but cannot see it in the gifts on the Internet because they are only from Dec 1, 2001 to Dec 31, 2001.

In this case, click the Prev button in TntMPD and change the date range to include Jan 1, 2001. This will cause TntMPD to download the gift from the donation system on the Internet. Once TntMPD has reconciled that gift with the gift on your home computer, it will not ask you about it again.

TntMPD gives a 30 day grace period before it asks to delete a gift. That is, if you enter a gift on Nov 1, 2001, TntMPD will wait until Dec 1, 2001 before it will ask to delete a gift. This gives your donation system 30 days to enter the gift so that TntMPD can find it on the Internet.

Written by Jim O

Dealing with Manually Entered Gifts

If you are entering gifts manually, and these gifts are not going to be available from an organization that provides TntMPD users a compatible web download or email attachment, then be sure to mark the gifts as "Not available on the web". This causes TntMPD to leave the gifts alone.

You can make this the default action. Under the "Tools" menu, click on "Options". Then under the "Gift" tab, unchceck the box that says, "Mark manually entered gifts as 'Leary (CCC Canada)Available on Web' by default".



Gifts Removed From TntMPD

Troy Wolbrink — Wed, 08 Oct 2008 17:37:23 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/8/2008 1:37:23 PM

Sometimes when you are downloading gifts, TntMPD will give you the unsettling message, "These gifts will be removed from TntMPD".

Here TntMPD is attempting to reconcile the database on your home computer with the database from your donation system on the Internet. It sees gifts which are in your home database which it doesn't see on the Internet database, therefore it wants to remove them. Why? Well, if the two databases were not the same, your home database wouldn't accurately reflect the database from your donation system, which is the more accurate database. Your home database then wouldn't make sense.

This situation often occurs if you enter your gifts on your home computer first. For example, you may receive a cheque from John Doe, enter it into TntMPD on your home computer, then send the cheque to your donation system for processing. But your donation system may not have added the cheque before the next time that you download your donations from the Internet. TntMPD will see one gift on your home computer but no cooresponding gift in your donation system on the Internet. What is going on? TntMPD then tells you that it wants to remove this gift.

You can reason with TntMPD, however, by unchecking the gift. Then TntMPD will ask you why you want to keep this gift, but will not remove the gift.

You can at this point elect to keep a gift that TntMPD will never find on the Internet. The two databases will not be fully reconciled to each other, but that is a choice which you can make.

What do you do if you know that both databases hold a gift and TntMPD still asks to remove the gift? This can happen if you specify a date range for downloading gifts and the gift on your home computer is not within that range. For example, you may have a gift on your home computer from Jan 1, 2001 that you know is also in the donation system on the Internet. However, you are asking TntMPD to download only gifts from Dec 1, 2001 to Dec 31, 2001. TntMPD sees the gift from Jan 1, 2001 on your home computer, but cannot see it in the gifts on the Internet because they are only from Dec 1, 2001 to Dec 31, 2001.

In this case, click the Prev button in TntMPD and change the date range to include Jan 1, 2001. This will cause TntMPD to download the gift from the donation system on the Internet. Once TntMPD has reconciled that gift with the gift on your home computer, it will not ask you about it again.

TntMPD gives a 30 day grace period before it asks to delete a gift. That is, if you enter a gift on Nov 1, 2001, TntMPD will wait until Dec 1, 2001 before it will ask to delete a gift. This gives your donation system 30 days to enter the gift so that TntMPD can find it on the Internet.

Written by Jim O'Leary (CCC Canada)


How can I export my partners to a GPS?

Troy Wolbrink — Fri, 08 Jul 2011 18:29:34 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 7/8/2011 2:29:34 PM

How can I export my partners to a GPS?

Filed under: GPS

There are many ways to do this, but one way that's quite easy in TntMPD 2.1r66 is via Microsoft Streets and Trips 2011. You can lookup your partners in TntMPD (under the "Lookup" menu, click on "Newsletter Recipients", for example). Then under the "Group Actions" menu, click on "Export to Microsoft Streets and Trips":

This process will export all the deliverable mailing addresses (home, business and/or other) for all the contacts in the current group. It will exclude any "P.O. Box" addresses or any addresses marked as undeliverable. This menu will launch you into Microsoft Streets and Trips, and when you return you are given the choice to lookup all the contacts that didn't have a mappable address to export:

Within Microsoft Streets and Trips, you might be prompted to verify and match a few addresses:

Take note of this process. It may suggest a more accurate or standard address to use for a contact. If so, you might consider updating the contact's address in TntMPD to avoid future confusion.

After all the contacts have been matched, I'd suggest you remove any pushpins that aren't accurate down to the Street Address level. You generally need more accuracy than the middle of a zip code to find your partner's house!

Double-click on the set of Pushpins on the left pane:

Then, under the "Matching" tab, sort by "Matched status" by clicking on the column header. Select any that are not "By Street Address" and then right-click and "Cut" to remove those pushpins. Only those with "By Street Address" should remain:

Click "OK", then under the "Data" menu, click on "Export GPX file":

This will prompt you to save a ".gpx" file on your hard drive. Remember the location and name of the file you provide.

For my Garmin, I downloaded a program from their website called "POI Loader" (http://www8.garmin.com/products/poiloader/). I plugged in my Garmin GPS unit to the USB cable on my laptop and ran this program. I told it to load the GPX file I just created from Microsoft Streets and Trips. After a few seconds, it said that it was successful.

Now when I have my GPS in my car, I can find partners nearest me, call them w/ the phone number provided, and have some basic MPD info provided as well!

Here's a little demo of how it looks on my Garmin GPS:

Notice how it shows me my partners in order of who is most close to me at the time:

What's nice about this, is that I can see who's closest to me. If I have time to visit, I can call them and tell them at I'm "in the neighborhood" (because I literally am). If I click their name, I'll see more details. The partner's name is on the first line (all blurred out). I can see their phone number. Also I can see that their last gift was in 2010 for $1000, and that we last met on 2007:

When I call them, I can tell them I'll be there in 8 minutes. Then click the "Go!" button:

How can I export my partners to a GPS?

Troy Wolbrink — Thu, 07 Jul 2011 04:47:43 GMT
Revision 2 posted to Frequently Asked Questions (English) by Troy Wolbrink on 7/7/2011 12:47:43 AM

How can I export my partners to a GPS?

Filed under: GPS

There are many ways to do this, but one way that's quite easy in TntMPD 2.1r66 is via Microsoft Streets and Trips 2011. You can lookup your partners in TntMPD (under the "Lookup" menu, click on "Newsletter Recipients", for example). Then under the "Group Actions" menu, click on "Export to Microsoft Streets and Trips":

This process will export all the deliverable mailing addresses (home, business and/or other) for all the contacts in the current group. It will exclude any "P.O. Box" addresses or any addresses marked as undeliverable. This menu will launch you into Microsoft Streets and Trips, and when you return you are given the choice to lookup all the contacts that didn't have a mappable address to export:

Within Microsoft Streets and Trips, you might be prompted to verify and match a few addresses:

Take note of this process. It may suggest a more accurate or standard address to use for a contact. If so, you might consider updating the contact's address in TntMPD to avoid future confusion.

After all the contacts have been matched, I'd suggest you remove any pushpins that aren't accurate down to the Street Address level. You generally need more accuracy than the middle of a zip code to find your partner's house!

Double-click on the set of Pushpins on the left pane:

Then, under the "Matching" tab, sort by "Matched status" by clicking on the column header. Select any that are not "By Street Address" and then right-click and "Cut" to remove those pushpins. Only those with "By Street Address" should remain:

Click "OK", then under the "Data" menu, click on "Export GPX file":

This will prompt you to save a ".gpx" file on your hard drive. Remember the location and name of the file you provide.

For my Garmin, I downloaded a program from their website called "POI Loader" (http://www8.garmin.com/products/poiloader/). I plugged in my Garmin GPS unit to the USB cable on my laptop and ran this program. I told it to load the GPX file I just created from Microsoft Streets and Trips. After a few seconds, it said that it was successful.

Now when I have my GPS in my car, I can find partners nearest me, call them w/ the phone number provided, and have some basic MPD info provided as well!

Here's a little demo of how it looks on my Garmin GPS:

Notice how it shows me my partners in order of who is most close to me at the time:

The partner's name is on the first line (all blurred out). I can see their phone number. Also I can see that their last gift was in 2010 for $1000, and that we last met on 2007:

When I call them, I can tell them I'll be there in 8 minutes. Then click the "Go!" button:

How can I export my partners to a GPS?

Troy Wolbrink — Thu, 07 Jul 2011 02:54:35 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 7/6/2011 10:54:35 PM

There are many ways to do this, but one way that's quite easy in TntMPD 2.1r66 is via Microsoft Streets and Trips 2011. You can lookup your partners in TntMPD (under the "Lookup" menu, click on "Newsletter Recipients", for example). Then under the "Group Actions" menu, click on "Export to Microsoft Streets and Trips":

This process will export all the deliverable mailing addresses (home, business and/or other) for all the contacts in the current group. It will exclude any "P.O. Box" addresses or any addresses marked as undeliverable. This menu will launch you into Microsoft Streets and Trips, and when you return you are given the choice to lookup all the contacts that didn't have a mappable address to export:

Within Microsoft Streets and Trips, you might be prompted to verify and match a few addresses:

Take note of this process. It may suggest a more accurate or standard address to use for a contact. If so, you might consider updating the contact's address in TntMPD to avoid future confusion.

After all the contacts have been matched, I'd suggest you remove any pushpins that aren't accurate down to the Street Address level. You generally need more accuracy than the middle of a zip code to find your partner's house!

Double-click on the set of Pushpins on the left pane:

Then, under the "Matching" tab, sort by "Matched status" by clicking on the column header. Select any that are not "By Street Address" and then right-click and "Cut" to remove those pushpins. Only those with "By Street Address" should remain:

Click "OK", then under the "Data" menu, click on "Export GPX file":

This will prompt you to save a ".gpx" file on your hard drive. Remember the location and name of the file you provide.

For my Garmin, I downloaded a program from their website called "POI Loader" (http://www8.garmin.com/products/poiloader/). I plugged in my Garmin GPS unit to the USB cable on my laptop and ran this program. I told it to load the GPX file I just created from Microsoft Streets and Trips. After a few seconds, it said that it was successful.

Now when I have my GPS in my car, I can find partners nearest me, call them w/ the phone number provided, and have some basic MPD info provided as well!

How can I make sure I'm using the correct Outlook profile setting?

Troy Wolbrink — Thu, 07 Jul 2011 02:19:01 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 7/6/2011 10:19:01 PM

In TntMPD, when you set the Outlook Sync Settings (Tools | Microsoft Outlook | Settings for Sync with Outlook), there's a place to set the profile:

If this setting is not correct, you may get unexpected results when you try to sync. Most commonly, you'll get an error about the Outlook folder you want to sync to cannot be found.

In the Windows control panel, there's a "Mail" control panel you can set:

When you double-click on it, you'll notice a button for "Show Profiles...":

When you click this button, you'll see the profiles available (often there's only one, and it's called "Outlook", but you might have more than one).

Make sure that the Profiles setting in TntMPD matches the one you want to use from the Mail control panel.

What are the known limitations of the Mac version of TntMPD?

Troy Wolbrink — Mon, 09 May 2011 14:32:09 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 5/9/2011 10:32:09 AM

What are the known limitations of the Mac version of TntMPD?

Filed under: Macintosh

There are some known issues limitations/issues with using TntMPD on the Mac:

Command+Q (Quit X11) will close TntMPD without giving it a chance to save changes.

Command+C, X, V, etc. Clipboard shortcuts need won't work touse manipulate the clipboard. The Control key should be used instead.

The Community View doesn't work correctly.

TntMPD must be closed for Finder to open/sync to a .tntmpd file from Finder. (Can't start a second instance.)

TntMPD on the Mac offers to equivalent to Sync w/ Outlook like it does on Windows.

What are the known limitations of the Mac version of TntMPD?

Troy Wolbrink — Wed, 20 Oct 2010 16:19:09 GMT
Revision 2 posted to Frequently Asked Questions (English) by Troy Wolbrink on 10/20/2010 12:19:09 PM

What are the known limitations of the Mac version of TntMPD?

Filed under: Macintosh

There are some known issues with using TntMPD on the Mac:

Command+Q (Quit X11) will close TntMPD without giving it a chance to save changes.

Command+C, X, V, etc. Clipboard shortcuts need to use the Control key instead.

The Community View doesn't work correctly.

TntMPD must be closed for Finder to open/sync to a .tntmpd file from Finder. (Can't start a second instance.)

What are the known limitations of the Mac version of TntMPD?

Troy Wolbrink — Wed, 15 Sep 2010 13:40:20 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 9/15/2010 9:40:20 AM

There are some known issues with using TntMPD on the Mac:

Command+Q (Quit X11) will close TntMPD without giving it a chance to save changes.

Command+C, X, V, etc. Clipboard shortcuts need to use the Control key instead.

The Community View doesn't work correctly.

How can I get help with logging in through the GCX (The KEY) option?

Troy Wolbrink — Mon, 02 May 2011 12:36:11 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 5/2/2011 8:36:11 AM

How can I get help with logging in through the GCX (The KEY) option?

Filed under: Sign In Issues

It's possible you don't already have an account. If this is the case, click on the "Sign Up" tab.

If you can't remember your password, click on "Forgot your password?".

If neither of these options work, click on the "Help" tab to learn about more support options.
   Currently the "Help" tab links you to: https://help.mygcx.org (more ideas below)

If you already have an account on this website, you might try using a self-help option to login directly to this website via this link: https://www.tntware.com/tntmpd/login.aspx?ReturnUrl=&auto.openid.immediate=&Type=Help

How can I get help with logging in through the GCX (The KEY) option?

Troy Wolbrink — Wed, 13 Apr 2011 14:37:08 GMT
Revision 3 posted to Frequently Asked Questions (English) by Troy Wolbrink on 4/13/2011 10:37:08 AM

How can I get help with logging in through the GCX (The KEY) option?

Filed under: Sign In Issues

When
It's possible you are at the don't already have an account. If this is the GCX (The KEY) logincase, there are several self-help optionsclick on the "Sign Up" tab.

If those arenyou can't working for youremember your password, can also click on "Forgot your password?".

If neither of these options work, click on the "Help" tab to learn about more support options.
   Currentlyit the "Help" tab links you to: https://help.mygcx.org

How can I get help with logging in through the GCX (The KEY) option?

Troy Wolbrink — Thu, 07 Apr 2011 15:17:37 GMT
Revision 2 posted to Frequently Asked Questions (English) by Troy Wolbrink on 4/7/2011 11:17:37 AM

How can I get help with logging in through the GCX (The KEY) option?

Filed under: Sign In Issues

When you are at the the GCX (The KEY) login, there are several self-help options. If those aren't working for you, can also click on the "Help" tab to learn about more support options.

Currently it links to: https://help.mygcx.org

How can I get help with logging in through the GCX (The KEY) option?

Troy Wolbrink — Thu, 07 Apr 2011 15:17:15 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 4/7/2011 11:17:15 AM

When you are at the the GCX (The KEY) login, there are several self-help options. If those aren't working for you, can also click on the "Help" tab to learn about more support options.

Currently it links to: https://help.mygcx.org

How can I develop add-ons for TntMPD?

Troy Wolbrink — Tue, 12 Apr 2011 17:29:43 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 4/12/2011 1:29:43 PM

How can I develop add-ons for TntMPD?

Filed under: Developer Guides

Access Database Add-On

If TntMPD doesn't do exactly what you want, and you know how to use Access 2000, you can develop custom Access solutions to enhance TntMPD. TntMPD has a special feature called "Link to Access Database". This takes an existing database and adds links to tables within TntMPD. This way you can add your own tables, queries, forms and reports and VBA (Visual Basic for Applications) code modules.   For a better explanation follow this link: http://msdn2.microsoft.com/en-us/library/aa141493(office.10).aspx   Keep in mind in this illustration that the "Back End" database is the TntMPD file (*.mpd) and the "Front End" database is the Access 2000 database (*.mdb) that you told TntMPD to link.

Windows Application Add-On

More advanced developers will appreciate the fact that TntMPD provides programmatic ways to create and update linked Access databases via the command line. For help on this feature, run "TntMPD.exe /?" from the command line. The location of TntMPD.exe can be found in the registry at "HKEY_LOCAL_MACHINE\SOFTWARE\TntWare\TntMPD\InstallPath". Each add-on can create and maintain its own link to the database without requiring the user to manually establish the link.

TntMPD's Database Structure

As to the layout of the underlying tables. You will find that most tables use the first field as their primary key. For example, the main table is called "Contact". The primary key is "ContactID". The gift table has a field called "ContactID" that links back to the person who gave the gift.

Changing Data in TntMPD?

If your add-on changes data in TntMPD using your linked database tables, be sure to perform the File|Maintenance task when you are done. Open TntMPD. Click on the "File" menu ... select "Maintenance". From the maintenance screen, recalculate mailing, money and history data. These steps are recommended for the program to operate correctly. Also, each table has a "LastEdit" field that needs to be updated for TntSync to work correctly.

Adding your Add-On to the "Tools" menu in TntMPD

Look in the Windows registry (using regedit.exe) at the key: "HKEY_LOCAL_MACHINE\SOFTWARE\TntWare\TntMPD\ExternalTools\"
(or if you're on 64-bit Windows look at: "HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\TntWare\TntMPD\ExternalTools\")
TntCrypt and TntSync are provided as examples of how you can register your add-on under the "Tools" menu.

Each tool can specify certain values: Category (if you want a sub-menu), Target (what get's executed when you click the menu ... can be anything that runs under the Windows "Start" menu ... "Run"), IconTarget (where you want the menu extracted from for the tool's menu item), and Shortcut (if you want a keyboard hotkey such as "Ctrl+F1" for running your add-on), Parameters for additional command line parameters sent to your application.

In the TargetParameters, you can include "currentgroup.csv" somewhere, and it will be replaced with the name of an actual file which represents an export of the current filtered list of contacts in TntMPD's contacts view. This allows your add-on to do something with the current group.

Mail Merge Handler

TntMPD includes built-in support for merging with Microsoft Word 2000 and newer. You can replace this with your own Mail Merge functionality. For some documentation on how to integrate your add-on with TntMPD, look in TntMPD's installation folder under "\Developer Notes\External Handlers.zip".

App Exit Handler

If you want your add-on program to get called when TntMPD exits, look for the example in TntMPD's installation folder under "\Developer Notes\External Handlers.zip"

Examples

There are some add-ons currently available for TntMPD.

How can I develop add-ons for TntMPD?

Troy Wolbrink — Thu, 06 Aug 2009 04:34:27 GMT
Revision 5 posted to Frequently Asked Questions (English) by Troy Wolbrink on 8/6/2009 12:34:27 AM

How can I develop add-ons for TntMPD?

Filed under: Developer Guides

Access Database Add-On

If TntMPD doesn't do exactly what you want, and you know how to use Access 2000, you can develop custom Access solutions to enhance TntMPD. TntMPD has a special feature called "Link to Access Database". This takes an existing database and adds links to tables within TntMPD. This way you can add your own tables, queries, forms and reports and VBA (Visual Basic for Applications) code modules.   For a better explanation follow this link: http://msdn2.microsoft.com/en-us/library/aa141493(office.10).aspx   Keep in mind in this illustration that the "Back End" database is the TntMPD file (*.mpd) and the "Front End" database is the Access 2000 database (*.mdb) that you told TntMPD to link.

Windows Application Add-On

More advanced developers will appreciate the fact that TntMPD provides programmatic ways to create and update linked Access databases via the command line. For help on this feature, run "TntMPD.exe /?" from the command line. The location of TntMPD.exe can be found in the registry at "HKEY_LOCAL_MACHINE\SOFTWARE\TntWare\TntMPD\InstallPath". Each add-on can create and maintain its own link to the database without requiring the user to manually establish the link.

TntMPD's Database Structure

As to the layout of the underlying tables. You will find that most tables use the first field as their primary key. For example, the main table is called "Contact". The primary key is "ContactID". The gift table has a field called "ContactID" that links back to the person who gave the gift.

Changing Data in TntMPD?

If your add-on changes data in TntMPD using your linked database tables, be sure to perform the File|Maintenance task when you are done. Open TntMPD. Click on the "File" menu ... select "Maintenance". From the maintenance screen, recalculate mailing, money and history data. These steps are recommended for the program to operate correctly. Also, each table has a "LastEdit" field that needs to be updated for TntSync to work correctly.

Adding your Add-On to the "Tools" menu in TntMPD

Look in the Windows registry (using regedit.exe) at the key: "HKEY_LOCAL_MACHINE\SOFTWARE\TntWare\TntMPD\ExternalTools\"
(or if you're on 64-bit Windows look at: "HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\TntWare\TntMPD\ExternalTools\")
TntCrypt and TntSync are provided as examples of how you can register your add-on under the "Tools" menu.

Each tool can specify certain values: Category (if you want a sub-menu), Target (what get's executed when you click the menu ... can be anything that runs under the Windows "Start" menu ... "Run"), IconTarget (where you want the menu extracted from for the tool's menu item), and Shortcut (if you want a keyboard hotkey such as "Ctrl+F1" for running your add-on).

In the Target, you can include "currentgroup.csv" somewhere, and it will be replaced with the name of an actual file which represents an export of the current filtered list of contacts in TntMPD's contacts view. This allows your add-on to do something with the current group.

Mail Merge Handler

TntMPD includes built-in support for merging with Microsoft Word 2000 and newer. You can replace this with your own Mail Merge functionality. For some documentation on how to integrate your add-on with TntMPD, look in TntMPD's installation folder under "\Developer Notes\External Handlers.zip".

App Exit Handler

If you want your add-on program to get called when TntMPD exits, look for the example in TntMPD's installation folder under "\Developer Notes\External Handlers.zip"

Examples

There are some add-ons currently available for TntMPD.

How can I develop add-ons for TntMPD?

Troy Wolbrink — Thu, 06 Aug 2009 04:30:47 GMT
Revision 4 posted to Frequently Asked Questions (English) by Troy Wolbrink on 8/6/2009 12:30:47 AM

How can I develop add-ons for TntMPD?

Filed under: Developer Guides

Access Database Add-On

If TntMPD doesn't do exactly what you want, and you know how to use Access 2000, you can develop custom Access solutions to enhance TntMPD. TntMPD has a special feature called "Link to Access Database". This takes an existing database and adds links to tables within TntMPD. This way you can add your own tables, queries, forms and reports and VBA (Visual Basic for Applications) code modules.   For a better explanation follow this link: http://msdn2.microsoft.com/en-us/library/aa141493(office.10).aspx   Keep in mind in this illustration that the "Back End" database is the TntMPD file (*.mpd) and the "Front End" database is the Access 2000 database (*.mdb) that you told TntMPD to link.

Windows Application Add-On

More advanced developers will appreciate the fact that TntMPD provides programmatic ways to create and update linked Access databases via the command line. For help on this feature, run "TntMPD.exe /?" from the command line. The location of TntMPD.exe can be found in the registry at "HKEY_LOCAL_MACHINE\SOFTWARE\TntWare\TntMPD\InstallPath". Each add-on can create and maintain its own link to the database without requiring the user to manually establish the link.

TntMPD's Database Structure

As to the layout of the underlying tables. You will find that most tables use the first field as their primary key. For example, the main table is called "Contact". The primary key is "ContactID". The gift table has a field called "ContactID" that links back to the person who gave the gift.

Changing Data in TntMPD?

If your add-on changes data in TntMPD using your linked database tables, be sure to perform the File|Maintenance task when you are done. Open TntMPD. Click on the "File" menu ... select "Maintenance". From the maintenance screen, recalculate mailing, money and history data. These steps are recommended for the program to operate correctly. Also, each table has a "LastEdit" field that needs to be updated for TntSync to work correctly.

Adding your Add-On to the "Tools" menu in TntMPD

Look in the Windows registry (using regedit.exe) at the key: "HKEY_LOCAL_MACHINE\SOFTWARE\TntWare\TntMPD\ExternalTools\"
(or if you're on 64-bit Windows look at: "HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\TntWare\TntMPD\ExternalTools\")
TntCrypt and TntSync are provided as examples of how you can register your add-on under the "Tools" menu.

Each tool can specify certain values: Category (if you want a sub-menu), Target (what get's executed when you click the menu ... can be anything that runs under the Windows "Start" menu ... "Run"), IconTarget (where you want the menu extracted from for the tool's menu item), and Shortcut (if you want a keyboard hotkey such as "Ctrl+F1" for running your add-on).

In the Target, you can include "currentgroup.csv" somewhere, and it will be replaced with the name of an actual file which represents an export of the current filtered list of contacts in TntMPD's contacts view. This allows your add-on to do something with the current group.

Mail Merge Handler

TntMPD includes built-in support for merging with Microsoft Word 2000 and newer. You can replace this with your own Mail Merge functionality. For some documentation on how to integrate your add-on with TntMPD, look in TntMPD's installation folder under "\Developer Notes\External Handlers.zip".

App Exit Handler

If you want your add-on program to get called when TntMPD exits, look for the example in TntMPD's installation folder under "\Developer Notes\External Handlers.zip"

Examples

There are some add-ons currently available for TntMPD.

How can I develop add-ons for TntMPD?

Troy Wolbrink — Thu, 06 Aug 2009 04:27:22 GMT
Revision 3 posted to Frequently Asked Questions (English) by Troy Wolbrink on 8/6/2009 12:27:22 AM

How can I develop add-ons for TntMPD?

Filed under: Developer Guides

TntMPD
Access Database Add-OnDeveloper Page

If TntMPD doesn't do exactly what you want, and you know how to use Access 2000, you can develop custom Access solutions to enhance TntMPD. TntMPD has a special feature called "Link to Access Database". This takes an existing database and adds links to tables within TntMPD. This way you can add your own tables, queries, forms and reports and VBA (Visual Basic for Applications) code modules.   For a better explanation follow this link: http://msdn2.microsoft.com/en-us/library/aa141493(office.10).aspx   Keep in mind in this illustration that the "Back End" database is the TntMPD file (*.mpd) and the "Front End" database is the Access 2000 database (*.mdb) that you told TntMPD to link.

Windows Application Add-On

More advanced developers will appreciate the fact that TntMPD provides programmatic ways to create and update linked Access databases via the command line. For help on this feature, run "TntMPD.exe /?" from the command line. The location of TntMPD.exe can be found in the registry at "HKEY_LOCAL_MACHINE\SOFTWARE\TntWare\TntMPD\InstallPath". Thus, each Each add-onshould can create and maintain its own link to the database , and without requiring the user shouldn't have tobe involved. (Note: The MLC add-on was designed before this feature was available and thus requires manually establish the userlink.

TntMPD's involvement in setting up the link.) Database Structure

As to the layout of the underlying tables. You will find that most tables use the first field as their primary key. For example, the main table is called "Contact". The primary key is "ContactID". The gift table has a field called "ContactID" that links back to the person who gave the gift.

Changing Data in TntMPD?

If your add-on changes data in TntMPD tables in Access 2000 using your linked database tables, be sure to performthis the File|Maintenance task when you are done. Open TntMPD. Click on the "File" menu ... select "Maintenance". From the maintenance screen, recalculate mailing, money and history data. These steps are recommended for the program to operate correctly. Also, each table has a "LastEdit" field that needs to be updated for TntSync to work correctly.

Adding your Add-On to the "Tools" menu in TntMPD

Look in the Windows registry (using regedit.exe) at the key: "HKEY_LOCAL_MACHINE\SOFTWARE\TntWare\TntMPD\ExternalTools\"
(or if you're on 64-bit Windows look at: "HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\TntWare\TntMPD\ExternalTools\")
TntCrypt and TntSync are provided as examples of how you can register your add-on under the "Tools" menu.

Each tool can specify certain values: Category (if you want a sub-menu), Target (what get's executed when you click the menu ... can be anything that runs under the Windows "Start" menu ... "Run"), IconTarget (where you want the menu extracted from for the tool's menu item), and Shortcut (if you want a keyboard hotkey such as "Ctrl+F1" for running your add-on).

In the Target, you can include "currentgroup.csv" somewhere, and it will be replaced with the name of an actual file which represents an export of the current filtered list of contacts in TntMPD's contacts view. This allows your add-on to do something with the current group.

Mail Merge Handler

TntMPD includes built-in support for merging with Microsoft Word 2000 and newer. You can replace this with your own Mail Merge functionality. For some documentation on how to integrate your add-on with TntMPD, look in TntMPD's installation folder under "\Developer Notes\External Handlers.zip".

App Exit Handler

If you want your add-on program to get called when TntMPD exits, look for the example in TntMPD's installation folder under "\Developer Notes\External Handlers.zip"

Examples

There are some add-ons currently available for TntMPD.

How can I develop add-ons for TntMPD?

Troy Wolbrink — Mon, 29 Sep 2008 18:17:49 GMT
Revision 2 posted to Frequently Asked Questions (English) by Troy Wolbrink on 9/29/2008 2:17:49 PM

How can I develop add-ons for TntMPD?

Filed under: Developer Guides

TntMPD Add-On Developer Page


    If TntMPD doesn't do exactly what you want, and you know how to use Access 2000, you can develop custom solutions to enhance TntMPD. TntMPD has a special feature called "Link to Access Database". This takes an existing database and adds links to tables within TntMPD. This way you can add your own tables, queries, forms and reports and VBA (Visual Basic for Applications) code modules.

    For a better explanation follow this link:

http://msdn2.microsoft.com/en-us/library/aa141493(office.10).aspx

    Keep in mind in this illustration that the "Back End" database is the TntMPD file (*.mpd) and the "Front End" database is the Access 2000 database (*.mdb) that you told TntMPD to link.

    More advanced developers will appreciate the fact that TntMPD provides programmatic ways to create and update linked Access databases via the command line. For help on this feature, run "TntMPD.exe /?" from the command line. The location of TntMPD.exe can be found in the registry at "HKEY_LOCAL_MACHINE\SOFTWARE\TntWare\TntMPD\InstallPath". Thus, each add-on should create and maintain its own link to the database, and the user shouldn't have to be involved. (Note: The MLC add-on was designed before this feature was available and thus requires the user's involvement in setting up the link.)

    As to the layout of the underlying tables. You will find that most tables use the first field as their primary key. For example, the main table is called "Contact". The primary key is "ContactID". The gift table has a field called "ContactID" that links back to the person who gave the gift.

    If your add-on changes data in TntMPD tables in Access 2000 using your linked database, be sure to perform this task when you are done. Open TntMPD. Click on the "File" menu ... select "Maintenance". From the maintenance screen, recalculate mailing, money and history data. These steps are recommended for the program to operate correctly. Also, each table has a "LastEdit" field that needs to be updated for TntSync to work correctly.

There are some add-ons currently available for TntMPD.

How can I develop add-ons for TntMPD?

Troy Wolbrink — Mon, 29 Sep 2008 18:17:14 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 9/29/2008 2:17:14 PM

TntMPD Add-On Developer Page

    If TntMPD doesn't do exactly what you want, and you know how to use Access 2000, you can develop custom solutions to enhance TntMPD. TntMPD has a special feature called "Link to Access Database". This takes an existing database and adds links to tables within TntMPD. This way you can add your own tables, queries, forms and reports and VBA (Visual Basic for Applications) code modules.

    For a better explanation follow this link:

http://msdn2.microsoft.com/en-us/library/aa141493(office.10).aspx

    Keep in mind in this illustration that the "Back End" database is the TntMPD file (*.mpd) and the "Front End" database is the Access 2000 database (*.mdb) that you told TntMPD to link.

    More advanced developers will appreciate the fact that TntMPD provides programmatic ways to create and update linked Access databases via the command line. For help on this feature, run "TntMPD.exe /?" from the command line. The location of TntMPD.exe can be found in the registry at "HKEY_LOCAL_MACHINE\SOFTWARE\TntWare\TntMPD\InstallPath". Thus, each add-on should create and maintain its own link to the database, and the user shouldn't have to be involved. (Note: The MLC add-on was designed before this feature was available and thus requires the user's involvement in setting up the link.)

    As to the layout of the underlying tables. You will find that most tables use the first field as their primary key. For example, the main table is called "Contact". The primary key is "ContactID". The gift table has a field called "ContactID" that links back to the person who gave the gift.

    If your add-on changes data in TntMPD tables in Access 2000 using your linked database, be sure to perform this task when you are done. Open TntMPD. Click on the "File" menu ... select "Maintenance". From the maintenance screen, recalculate mailing, money and history data. These steps are recommended for the program to operate correctly. Also, each table has a "LastEdit" field that needs to be updated for TntSync to work correctly.

There are some add-ons currently available for TntMPD.

How can I ask a question on the forums?

Troy Wolbrink — Fri, 25 Mar 2011 18:44:28 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 3/25/2011 2:44:28 PM

Click the "Forums" link, and then click on "Write a New Post":

If you don't see that, you might have to click on "Click Here to Report an Issue!".

Why am I asked for an OpenID when logging in to this website w/ GCX using Internet Explorer?

Troy Wolbrink — Wed, 23 Mar 2011 23:46:06 GMT
Current revision posted to Frequently Asked Questions (English) by Troy Wolbrink on 3/23/2011 7:46:06 PM

Why am I asked for an OpenID when logging in to this website w/ GCX using Internet Explorer?

This is probably because your privacy settings are too aggressive in Internet Explorer.

Try this:
1. Under the “Tools” menu in Internet Explorer, click on “Internet Options”.
2. Under the “Privacy” tab, click on “Default” (if it’s not grayed out).

Click “OK”, then close Internet Explorer.

Try logging in again.

If the problem happens again, then try this:

under the “Start Menu”, click on “Programs”, “Accessories”, “System Tools”, then “Internet Explorer (No Add-ons)”.

Try logging in to this website again.

If TntMPD still asks you to Verify your OpenID, enter this as the OpenID and click the button:
https://www.tntware.com/gcxopenid

If you still don’t get any further, I’d suggest you try Firefox (a different web browser than IE):
http://www.mozilla.com/en-US/firefox/ie.html

Why am I asked for an OpenID when logging in to this website w/ GCX using Internet Explorer?

Troy Wolbrink — Wed, 19 May 2010 02:15:58 GMT
Revision 2 posted to Frequently Asked Questions (English) by Troy Wolbrink on 5/18/2010 10:15:58 PM

Why am I asked for an OpenID when logging in to this website w/ GCX using Internet Explorer?

This is probably because your privacy settings are too aggressive in Internet Explorer.

Try this:
1. Under the “Tools” menu in Internet Explorer, click on “Internet Options”.
2. Under the “Privacy” tab, click on “Default” (if it’s not grayed out).

<v:shapetype coordsize="21600,21600" o:spt="75" o:preferrelative="t" path="m@4@5l@4@11@9@11@9@5xe" filled="f" stroked="f" id="_x0000_t75">

<v:stroke joinstyle="miter"></v:stroke><v:formulas><v:f eqn="if lineDrawn pixelLineWidth 0"></v:f><v:f eqn="sum @0 1 0"></v:f><v:f eqn="sum 0 0 @1"></v:f><v:f eqn="prod @2 1 2"></v:f><v:f eqn="prod @3 21600 pixelWidth"></v:f><v:f eqn="prod @3 21600 pixelHeight"></v:f><v:f eqn="sum @0 0 1"></v:f><v:f eqn="prod @6 1 2"></v:f><v:f eqn="prod @7 21600 pixelWidth"></v:f><v:f eqn="sum @8 21600 0"></v:f><v:f eqn="prod @7 21600 pixelHeight"></v:f><v:f eqn="sum @10 21600 0"></v:f></v:formulas><v:path o:extrusionok="f" gradientshapeok="t" o:connecttype="rect"></v:path><o:lock v:ext="edit" aspectratio="t"></o:lock></v:shapetype>

Click “OK”, then close Internet Explorer.

Try logging in again.

If the problem happens again, then try this:

under the “Start Menu”, click on “Programs”, “Accessories”, “System Tools”, then “Internet Explorer (No Add-ons)”.

Try logging in to this website again.

If TntMPD still asks you to Verify your OpenID, enter this as the OpenID and click the button:
https://www.tntware.com/gcxopenid

If you still don’t get any further, I’d suggest you try Firefox (a different web browser than IE):
http://www.mozilla.com/en-US/firefox/ie.html

Why am I asked for an OpenID when logging in to this website w/ GCX using Internet Explorer?

Troy Wolbrink — Wed, 19 May 2010 02:14:02 GMT
Revision 1 posted to Frequently Asked Questions (English) by Troy Wolbrink on 5/18/2010 10:14:02 PM

This is probably because your privacy settings are too aggressive in Internet Explorer.

Try this:
1. Under the “Tools” menu in Internet Explorer, click on “Internet Options”.
2. Under the “Privacy” tab, click on “Default” (if it’s not grayed out).

<v:shapetype coordsize="21600,21600" o:spt="75" o:preferrelative="t" path="m@4@5l@4@11@9@11@9@5xe" filled="f" stroked="f" id="_x0000_t75"> <v:stroke joinstyle="miter"></v:stroke><v:formulas><v:f eqn="if lineDrawn pixelLineWidth 0"></v:f><v:f eqn="sum @0 1 0"></v:f><v:f eqn="sum 0 0 @1"></v:f><v:f eqn="prod @2 1 2"></v:f><v:f eqn="prod @3 21600 pixelWidth"></v:f><v:f eqn="prod @3 21600 pixelHeight"></v:f><v:f eqn="sum @0 0 1"></v:f><v:f eqn="prod @6 1 2"></v:f><v:f eqn="prod @7 21600 pixelWidth"></v:f><v:f eqn="sum @8 21600 0"></v:f><v:f eqn="prod @7 21600 pixelHeight"></v:f><v:f eqn="sum @10 21600 0"></v:f></v:formulas><v:path o:extrusionok="f" gradientshapeok="t" o:connecttype="rect"></v:path><o:lock v:ext="edit" aspectratio="t"></o:lock></v:shapetype>

Click “OK”, then close Internet Explorer.

Try logging in again.

If the problem happens again, then try this:

under the “Start Menu”, click on “Programs”, “Accessories”, “System Tools”, then “Internet Explorer (No Add-ons)”.

Try logging in to this website again.

If TntMPD still asks you to Verify your OpenID, enter this as the OpenID and click the button:
https://www.tntware.com/gcxopenid

If you still don’t get any further, I’d suggest you try Firefox (a different web browser than IE):
http://www.mozilla.com/en-US/firefox/ie.html