Pliki cookie pomagają nam udostępniać nasze usługi. Korzystając z tych usług, zgadzasz się na użycie plików cookie. Więcej informacji
CRM - Extensions. Jak dodać własne opcje do programu?

2011-10-21

Sz@rk to gotowe do użycia środowisko o bogatej funkcjonalności. Pomimo tego, użytkownicy (zwłaszcza systemów CRM) mogą mieć dodatkowe wymagania, których system w standardowej wersji nie może spełnić. Naszą odpowiedzią na takie wymagania jest Sz@rk API. Za pomocą otwartej architektury systemu Sz@rk, udostępniamy użytkownikom swoje zasoby w postaci gotowych rozwiązań.

Zaczniemy od najprostszego przykładu, który pozwoli dodać własne opcje do programu. W tym celu musimy tylko napisać własny moduł SzarkCRM.Extensions.dlli podmienić z oryginalnym, dostarczonym przez TGSoft.

Pod adresem http://programy.tgsoft.pl/dev/SzarkCRM.Extensions111021.zip można pobrać przykładowy projekt z kodem źródłowym. Całość wykonana i skompilowana za pomocą bezpłatnej wersji MS Visual C# 2010 Express.

  • Projekt należy rozpakować do dowolnego katalogu.
  • Do podkatalogu .\bin\Release\ kopiujemy całą zawartość bibliotek DLL dostarczonych przez TGSoft
  • Uruchamiamy Visual C# i otwieramy plik SzarkCRM.Extensions.sln
  • W oknie Solution Explorer powinien być taki widok:

Jeżeli VS nie odczyta prawidłowo Referencji do modułów TGSoft, to należy je usunąć i dodać ponownie:

  • Każda nowa opcja to oddzielna klasa UserControl. W naszym przykładzie są dwie opcje zdefiniowane wUserControl1.cs oraz UserControl2.cs. Są to typowe klasy .NET i każdy programista C# będzie wiedział jak je napisać.
  • Teraz tylko musimy poinformować Sz@rk o naszych dodatkach. W tym celu należy przygotować klasęCRMExt.cs.
using System;
using System.Windows.Forms;
using TGSoft.CRM;
using TGSoft.Data;
 
namespace SzarkCRM.Extensions
{
    public class CRMExt
    {
        private readonly UserControl uc1, uc2;
 
        public CRMExt(object host)
        {
            ICRMExtensions ihost = host as ICRMExtensions;
 
            int group = ihost.AddGroup("MOJA GRUPA", 
                        TGSoft.Repository.Properties.Resources.communications_buzz_32);
            uc1 = new UserControl1();
            ExtClass ex1 = new ExtClass(uc1)
            {
                Group = group,
                Caption = "Opcja 1-jeden",
                Glyph = TGSoft.Repository.Properties.Resources.communications_star_16
            };
            ihost.AddExtension(ex1);
 
            uc2 = new UserControl2();
            ExtClass ex2 = new ExtClass(uc2)
            {
                Group = group,
                Caption = "Opcja 2-DWA",
                Glyph = TGSoft.Repository.Properties.Resources.communications_idle_16
            };
            ihost.AddExtension(ex2);
        }
    }
}

Skompilowaną bibliotekę SzarkCRM.Extensions.dll kopiujemy do katalogu z programem Sz@rk CRM (podmieniamy oryginalną) i gotowe! Po uruchomieniu mamy nową Grupę, a w niej dwie opcje:

Pierwsza opcja użytkownika

Druga opcja użytkownika.

Dokument opisuje prosty sposób na dodanie własnych opcji do Sz@rk CRM, aby stały się jego integralną częścią. Jaka będzie ich funkcjonalność zależy tylko od naszych wymagań i pomysłów programistów. Programista może stosować własne biblioteki .NET, może skorzystać z Sz@rk API, albo łączyć obie co znacznie ułatwi i przyśpieszy proces tworzenia własnych rozszerzeń.

W kolejnych dokumentach opiszemy w jaki sposób korzystać z innych klas i zasobów Sz@rk API, w tym oczywiście możliwość przetwarzania danych!

Jeżeli jesteś programistą, który stosuje różne rozwiązania dla swoich klientów, to wystarczy przygotować kilka projektów opisanej wyżej biblioteki SzarkCRM.Extensions.dlli skopiować każdemu do katalogu Sz@rk CRM. Za pomocą prostej opcji kopiowania uzyskamy aktualizację i nową funkcjonalność programu!

Testy możesz przeprowadzić z naszym serwerem on-line.

Pamiętaj o hasłach do logowania:

Logowanie do programu za pomocą jednego z trzech użytkowników: login: DEMO (lub JAN), (lub MARIA)hasło: demo (każdy użytkownik ma to samo hasło: demo)