Comment envoyer des SMS depuis C# en utilisant SQL Server

Télécharger : Sending_SMS_through_MS_SQL_Server.zip

Découvrez comment envoyer des SMS en insérant des lignes dans une base de données Microsoft SQL via une application C#.NET. Cette technologie est destinée aux développeurs ayant des connaissances de base en C#.NET et SQL. Le code source téléchargeable vous aide à démarrer.

Dans les chapitres suivants, vous trouverez les prérequis nécessaires et une explication détaillée sur l'utilisation du code. Un diagramme de workflow utile vous montre la connexion de base entre l'utilisateur de l'application C# et le téléphone du destinataire.

Le code est utile si vous souhaitez

• ajouter une fonctionnalité SMS à votre application C#.
• intégrer des notifications SMS automatisées.
• sécuriser vos produits en ajoutant une connexion par SMS.

Prérequis

Les exigences logicielles du système sont listées dans le tableau suivant. Veuillez télécharger SMS Gateway et installer le logiciel SMS Gateway avec le framework .NET 4.5 et Microsoft Visual Studio pour exécuter votre code.

Comment ça marche

Vous devez d'abord installer Ozeki SMS Gateway et créer un utilisateur de base de données dans le SMS Gateway. Connectez l'utilisateur à votre base de données MSSQL. Les SMS à envoyer seront SELECT-és depuis la table SQL des messages sortants, qui est appelée 'ozekimessageout' par défaut.

Ensuite, vous devez installer un environnement C#.NET. Votre application C# peut se connecter à votre base de données MSSQL et insérer des SMS dans la table des messages sortants.

Assurez-vous que votre Ozeki SMS Gateway est connecté au réseau GSM via un modem GSM ou un fournisseur de services SMS IP via Internet. Par exemple, CIMD2 ou UCP/EMI sont des connexions très populaires auprès des fournisseurs de services.

Voir le workflow de la connexion C# via MSSQL sur la Figure 1.

En gros, Microsoft SQL Server peut être atteint depuis votre application C# et Ozeki SMS Gateway. Tous les messages entrants et sortants sont stockés sur le serveur MSSQL pour une utilisation ultérieure.

En ajoutant les codes appropriés à votre application C#, vous pouvez la connecter à votre base de données SQL pour lui permettre d'INSÉRER de nouvelles lignes dans la table des messages sortants et de lire les messages entrants.

L'utilisateur de base de données d'Ozeki SMS Gateway est capable de lire la table des messages sortants pour envoyer des SMS et d'INSÉRER de nouvelles lignes dans la table des messages entrants pour que d'autres utilisateurs puissent les lire. Par exemple, l'utilisateur de l'application C# peut les lire.

Comment configurer votre serveur MSSQL

Ajouter un utilisateur de base de données à Ozeki SMS Gateway

Utiliser le code C# téléchargé

Le code téléchargeable en haut de la page peut insérer des messages dans la table 'ozekimessageout'. L'utilisateur de base de données d'Ozeki SMS Gateway vérifie périodiquement 'ozekimessageout' pour trouver de nouvelles lignes de messages et les envoyer au téléphone du destinataire. Chaque ligne de message a un attribut de statut. Après l'envoi du SMS, le statut passera de 'Send' à 'Sent'.

N'oubliez pas de vérifier si votre serveur Microsoft SQL est en cours d'exécution et de modifier les détails de connexion au serveur dans 'DatabaseHandling.cs', que vous pouvez trouver dans le projet exemple.

Classes C# de l'exemple de code

MainForm.cs (Figure 2) :
Cette classe contient la première fenêtre qui s'ouvre. Comme vous pouvez le voir sur la Figure 2, elle peut afficher le contenu de deux tables. Ce contenu est lu par une instruction SELECT à partir de 'ozekimessageout' et 'ozekimessagein'. Elle contient également deux boutons 'Rafraîchir' et un bouton 'Composer un message'. Appuyez dessus pour utiliser la classe suivante, 'ComposeMessageForm.cs'.

ComposeMessageForm.cs (Figure 3) :
C'est la page suivante où vous pouvez remplir les champs de données nécessaires pour créer un nouveau message.

DatabaseHandling.cs :
C'est ici que vous pouvez configurer la connexion à la base de données (Figure 4) et rafraîchir les tables de 'MainForm.cs'.

Comment fonctionne le code d'envoi de messages

Dans 'ComposeMessageForm.cs', vous pouvez remplir les deux champs avec l'adresse du destinataire et le texte du message. En appuyant sur 'Envoyer', vous pouvez démarrer le code suivant :

...
private void buttonSend_Click(object sender, EventArgs e)
{
    CheckAndSendMessage();
}

private void CheckAndSendMessage()
{
    if (textBoxRecipient.Text == "")
    {
        MessageBox.Show("Le champ destinataire ne doit pas être vide !",
                    "Valeur de champ incorrecte");
        return;
    }

    string errorMsg = "";
    DatabaseHandling.insertMessage(textBoxRecipient.Text,
                textBoxMessageText.Text, out errorMsg);

    MessageBox.Show(errorMsg, "Résultat de l'insertion du message");
}
...

La méthode CheckAndSendMessage() est appelée par 'buttonSend_Click(...)'. La méthode commence par vérifier le champ destinataire et exécute insertMessage(...) de 'DatabaseHandling.cs' si le champ destinataire n'est PAS vide (Figure 5). insertMessage(...) peut insérer une nouvelle ligne dans la table 'ozekimessageout' (Figure 6) (La valeur par défaut de l'attribut msgtype est SMS:TEXT). Ozeki SMS Gateway lira les lignes du serveur SQL comme vous pouvez le voir sur le diagramme de flux ci-dessus.

...
public static void insertMessage(string receiver, string messageText,
            out string errorMsg)
{
    Connect(out errorMsg);
    if (errorMsg != "")
       return;

    try
    {
       SqlCommand sqlComm = sqlConn.CreateCommand();
       sqlComm.CommandText = "insert into ozekimessageout " +
                    "(msgtype,receiver,msg,status) " +
                    "values ('SMS:TEXT','" + receiver + "','" +
                    messageText + "','send');";
       if (sqlComm.ExecuteNonQuery() == 0)
       {
            errorMsg = "L'insertion a échoué !";
       }
       else
       {
            errorMsg = "L'insertion a réussi !";
       }
    }
    catch (Exception e)
    {
        errorMsg = e.Message;
    }

    CloseConnection();
}
...

Vous pouvez utiliser d'autres types de messages que 'SMS:TEXT' (par exemple 'SMS:WAPPUSH', 'SMS:VCARD') comme vous pouvez le voir sur Figure 7.

...
sqlComm.CommandText = "insert into ozekimessageout " +
                    "(msgtype,receiver,msg,status) " +
                    "values ('SMS:WAPPUSH','" + receiver + "','" +
                    messageText + "','send');";
...

Questions fréquemment posées

Question : Cet exemple C# peut-il s'exécuter sur un ordinateur différent de celui d'Ozeki SMS Gateway ou du serveur MSSQL ?
Réponse : Oui, c'est possible. Veuillez modifier l'adresse IP dans 'DatabaseHandling.cs' pour correspondre à l'adresse IP de votre serveur MSSQL.

Question : Puis-je changer le numéro de téléphone de l'expéditeur ?
Réponse : Oui. Veuillez INSÉRER également le numéro de l'expéditeur dans la ligne du message (Figure 8).
Cela ne fonctionne que si vous avez une connexion SMS IP.

...
string SenderNumber = "+449876543";
sqlComm.CommandText = "insert into ozekimessageout " +
                    "(msgtype,sender,receiver,msg,status) " +
                    "values ('SMS:TEXT','" + SenderNumber + "','" + receiver + "','" +
                    messageText + "','send');";
...