Insert system data / commands

In Inxmail Professional, you can integrate system data into your mailing, such as the name of the mailing list in which the mailing was created, or the current date. To do so, you must insert the corresponding commands into your mailing.

Step by step

  1. Open the mailing in the Editing workflow step.
  2. Click the position in your mailing where you would like to insert the system data.

  3. Click the Insert commands button and select one of the following entries from the drop-down list:

    Note: You may also enter the commands manually. After inserting commands, you can use the quick preview ( (Show/hide quick preview) button) to see which information will be displayed to the recipients of your mailing.

    • Insert list name: This entry inserts the [%list-name] command into your mailing, to display the name of the current mailing list.

      • Enter the following text in the editing area:

        Dear subscriber of the ‘[%list-name]’ mailing list

      • After dispatch, the recipients of your mailing will see the following text, for example:

        Dear subscriber of the ‘News Channel’ mailing list

    • Insert list size: This entry inserts the [%list-size] command into your mailing to display the number of recipients in the mailing list. The number of recipients will be formatted according to the regional settings and number formats configured for the mailing list.

      • Enter the following text in the editing area:

        This newsletter has [%list-size] subscribers.

      • After dispatch, the recipients of your mailing will then see the following text, for example:

        This newsletter has 10,121 subscribers.

    • Insert recipient ID: This entry inserts the [%id] command into your mailing, to display the internal recipient identification number. This number may be inserted to uniquely identify a recipient. This number is output without formatting.

    • Insert date: This entry inserts the [%date] command into your mailing to display the mailing dispatch date (or, if the mailing was not yet sent, the current date). The date will be formatted according to the regional settings configured for the mailing list (for example, for the ‘France’ regional setting, the date will be displayed as ‘13/06/2010’, for the ‘Germany’ regional setting, as ‘13.06.2010’ and for the ‘English (US)’ regional setting, as ‘06/13/2010’).

      More options are available using the Date() and SendDate() date functions. You can access individual date and time fields:

      • Date() returns the current (server) date and the current time.

      • SendDate() returns the send time of the mailing. If the mailing has not been sent yet, the function will return the current date.

      The Format() function allows you to format the date and time values. Various control characters are available.

      • You can insert the issue number of a mailing. For this to appear to your recipients as, for example, ‘Issue 02-2007’, you must manually enter the following function:

        Issue[%=Format(Date(), "MM-yyyy")]

      • You may also specify the issue number, for example, using the calendar week:

        Issue Week:[%=Format(Date(), "ww")]

      • To display the sentence ‘Our current monthly tip for February:’ in your mailing, enter the following:

        ‘Our current monthly tip for [%=Format(Date() "MMMM")]:’

      The following functions allow you to determine the date value from a specific column in the recipients table:

      • Day(<date column>)
      • Month(<date column>)

      • Year(<date column>)

        Thank you for your subscription to our newsletter since Year(SubscriptionDate)!

      You can use the following functions to convert date values:

      • CVDate

        This function returns the date from a value of the ‘Date’ data type (without e.g. time details).
        CvDate( Date()) returns the current date.

      • CvTime

        This function returns the time from a value of the ‘Date’ data type (without date details, for example).
        CvTime( Date()) returns the current time.

      • CvText

        This function converts a number or a Yes/No value into text.

      • CvInt

        This function converts text or a Yes/No value into a number.

       

      • Insert time: This entry inserts the [%time] command into your mailing, to display the mailing dispatch time. The time will be formatted according to the regional settings configured for the mailing list (for example, for most regional settings as ‘14:05:03’).
  4. Save your entries.
  • You have successfully integrated system data into your mailing.

Related topics