267
edits
Changes
Jump to navigation
Jump to search
no edit summary
Alert is a visual or/audio/e-mail notification triggered when the market conditions meet the criteria specified in the study. Audio/visual/e-mail alerts can be enabled simultaneously.
<div style="background-color: #98FB98;">Alerts can only be triggered in studies containing [[Alert]] Triggering Conditions in their code. To learn how to add alerts to studies’ code refer to the PowerLanguage manual.</div>
A check for the alert triggering conditions is performed whenever one of the following events occurs:
* Workspace is opened
* Data series (symbol) is replaced with another data series (symbol)
* A bar is closed or a new tick is received
<br>
== Enabling Alerts ==
Alerts can be enabled from the '''Format Indicator''' window:
# Open the '''Format Indicator''' window.<br><span>{{FormatIndicator}}</span>
# Select the '''Alerts''' tab.
# Check the '''Enable Alerts''' check box to enable alerts; uncheck the box to disable the alerts.
<div style="background-color: #E5F6FF;">Tip: To use these alert settings as the default for all indicators, check '''Use as Default''' check box.</div>
<br>
== Alert Conditions Check ==
You can elect whether to check for Alert Triggering Conditions every time a new tick is received, or only at the close of each bar.
<br>Alert Conditions Check can be set from the '''Format Indicator''' window:
# Open the '''Format Indicator''' window.<br><span>{{FormatIndicator}}</span>
# Select the '''Alerts''' tab.
# In the '''Alert Conditions Check''' section click the '''On Bar Close''', '''Every Tick''' or the '''Once Per Bar''' radio button, to select the alert triggering conditions to be checked at the close of each bar only, every time a new tick is received or every time a new tick is received once per bar only, respectively.
<div style="background-color: #E5F6FF;">Tip: To use these alert settings as the default for all indicators, check '''Use as Default''' check box.</div>
<br>
== Audio Alerts ==
A PC speaker beep or a sound file played by the PCs sound card can be set as the audio alert type.
<br>
=== Setting Beep Alert ===
Alerts can be set from the '''Format Indicator''' window:
# Open the '''Format Indicator''' window.<br><span>{{FormatIndicator}}</span>
# Select the '''Alerts''' tab.
# In the '''Audio Alert''' section, check the '''Audio Alert''' check box to enable audio alerts; uncheck the box to disable the audio alerts.
# Click the '''Beep''' radio button to set the PC speaker beep as the audio alert type.
<div style="background-color: #E5F6FF;">Tip: To use these alert settings as the default for all indicators, check '''Use as Default''' check box.</div>
<br>
=== Setting Sound Alert ===
Alerts can be set from the '''Format Indicator''' window:
# Open the '''Format Indicator''' window.<br><span>{{FormatIndicator}}</span>
# Select the '''Alerts''' tab.
# In the '''Audio Alert''' section, check the '''Audio Alert''' check box to enable audio alerts; uncheck the box to disable the audio alerts.
# Click the '''Sound''' radio button to select a .wav sound file as the audio alert type.
# Enter the path and name of the wave (.wav) sound file to be used into the '''File''' text box, or click the '''...''' button on the right side of the text box for '''Open''' dialog box, navigate to and select a sound file, and click the '''Open''' button.
# Click the '''Test''' button to test the alert.
# Click the '''Play Once''' or the '''Repeat''' radio button, for the alerts to be played once or repeatedly, respectively.
<div style="background-color: #E5F6FF;">Tip: To use these alert settings as the default for all indicators, check '''Use as Default''' check box.</div>
<br>
== Visual Alert ==
Alerts can be set from the '''Format Indicator''' window:
# Open the '''Format Indicator''' window.<br><span>{{FormatIndicator}}</span>
# Select the '''Alerts''' tab.
# In the '''Visual Alert''' section, check the '''Visual Alert''' check box to enable visual alerts; uncheck the box to disable the visual alerts.
# In the '''Display Notify Window for''' drop-down list box select the length of time that the alert notification window is to be displayed for.
<div style="background-color: #E5F6FF;">Tip: To use these alert settings as the default for all indicators, check '''Use as Default''' check box.</div>
<br>
== E-mail Alert ==
E-mail alerts can be sent when market conditions meet your defined criteria.
This feature can be used to stay informed about market conditions while away from the computer.
To add alert to study:
<ol>
<li>Make sure the study's PowerLanguage code contains alert code so that alerts will be triggered.
<li>Open the '''Format Indicator''' window.<br><span>{{FormatIndicator}}</span>
<li>Select the '''Alerts''' tab.
<li> Check '''Enable Alerts''' checkbox to enable alerts.
<li>Check the '''E-mail Alert''' checkbox.
<li>Press the '''Settings''' button. The '''E-mail Alert''' window will appear.
<li>Enter the email address of the sender.
<li>Enter the email address of the recipient. To send the email to multiple recipients, separate each email address with a semi-colon.
<ol><div style="background-color: #98FB98;"> NOTE: verify that the email addresses in the Sender and Recipients sections are inserted correctly with no extra spaces before or after. </div></ol>
<li>Enter the '''SMTP Server Name or IP address''', and '''Port''' number into the textboxes. Please get this information from your email provider.
<li>Check the SMTP Server authentication data checkbox if your SMTP server requires authentication to send emails. Enter the '''User name''' and '''Password'''.
<li>Press the '''Test''' button to send a test email.<br>
<ol>If the sending process has been successful a message will appear in the pop-up window<br>http://www.multicharts.com/img/wiki/Messages/AlertEmailOK.gif<br><br>If the sending process has been unsuccessful a message will appear in the pop-up window:<br>http://www.multicharts.com/img/wiki/Messages/AlertEmailFailed.gif </ol>
<li>Press '''OK''' to close the '''E-mail Alert''' window.<br>
<br><div style="background-color: #E5F6FF;">Example of Email Alert Message:<br><br>01.10.2008 17:48:50 (alert time and date) <br>Source: Bollinger Bands (study that triggered alert) <br>Symbol: ESZ8 (traded symbol name) <br>Resolution: 1 Tick Bar (resolution used) <br>Price: 1157,5000 (price value at the moment when defined conditions has been met) <br>Message: Price crossing over lower price band (message carrying information about the study condition that has been met)</div><br>
<div style="background-color: #FFFF00;">Note: Not all e-mail service providers are supported. For instance, Office365.com accounts are not supported! E-mail alerts configuration should be tested prior to use.</div>
=== GMAIL E-mail Alert Settings===
==== Configuration 1 ====
Gmail SMTP server address: smtp.gmail.com<br>
Gmail SMTP user name: Your full Gmail address (e.g. example@gmail.com)<br>
Gmail SMTP password: A 16-digit app password generated in your Google Account as per [https://support.google.com/accounts/answer/185833 the guide]<br>
Gmail SMTP port: 465<br>
Gmail SMTP TLS/SSL required: yes (SSL)<br>
==== Configuration 2 ====
Gmail SMTP server address: smtp.gmail.com<br>
Gmail SMTP user name: Your full Gmail address (e.g. example@gmail.com)<br>
Gmail SMTP password: A 16-digit app password generated in your Google Account as per [https://support.google.com/accounts/answer/185833 the guide]<br>
Gmail SMTP port: 587<br>
Gmail SMTP TLS/SSL required: yes (TLS)<br>
<div style="background-color: #E5F6FF;">Since “Less secure apps access” was disabled by Gmail, it is required to configure the “App Password” for your Gmail account and use it in MultiCharts Email Alert settings. Please find more info about configuring “Sign in with App Passwords” [https://support.google.com/accounts/answer/185833 here]. Follow the instructions to generate the app password and insert it in the '''Password''' field in the '''Using''' section.
</div>
<br>
==Using alerts in drawings==
Drawings are intended to work with symbol data and they react to price changes. So alerts can be triggered only by the drawings applied to symbols. Drawings applied to indicators won’t give any alerts as long as indicators don't have prices, but only plots, so drawings can never cross a price and therefore no alerts will be triggered when drawings cross indicator plots.
[[Category:Studies]]
