Langkau tajuk talian

Perkaitan fail plugin

Antara muka FileAssociations menyediakan jenis yang membolehkan plugin mendaftar, mengubah suai dan mengendalikan sambungan fail secara fleksibel. Dengan jenis tersebut, pembangun boleh mengekod plugin untuk menguruskan perkaitan fail. Apabila plugin didayakan, cTrader mengenali dan mengarahkan fail yang berkaitan kepada plugin untuk diproses.

Dengan plugin yang dikonfigurasi untuk mengendalikan fail secara langsung dalam UI cTrader, pengguna mungkin tidak lagi perlu bertukar antara pelbagai aplikasi semasa bekerja dengan fail. Sebagai contoh, plugin boleh dicipta untuk membuka dan menguruskan semua fail yang digunakan dengan strategi dagangan tertentu.

Kes penggunaan

Berikut ialah contoh plugin yang menggunakan ciri FileAssociations:

  • Penukar sejarah dagangan menerima dan mengendalikan fail CSV dan TXT yang mengandungi sejarah dagangan daripada platform lain, menukarkannya kepada format yang serasi dengan cTrader untuk analisis atau mengimportnya secara langsung ke dalam jurnalnya.
  • Pemproses isyarat dagangan membaca fail XML atau JSON yang mengandungi isyarat dagangan daripada pembekal luar atau sistem dagangan automatik, membolehkan pengguna melaksanakan dagangan dengan cepat berdasarkan isyarat tersebut.
  • Pengimport templat pengurusan risiko menerima dan mengendalikan fail JSON atau CSV yang mengandungi konfigurasi pengurusan risiko, membolehkan pengguna menggunakan tetapan yang telah ditentukan dalam cTrader.
  • Pengurus portfolio memproses fail CSV dan XML yang mengandungi butiran portfolio pedagang, menyediakan pandangan ringkas aset, posisi dan metrik prestasi sambil meningkatkan pengurusan portfolio.
  • Pemuat templat carta memproses fail XML atau JSON untuk templat carta, membolehkan pengguna menyimpan dan memuatkan dengan cepat konfigurasi atau persediaan carta pilihan mereka.
  • Pemuat tetapan penunjuk memproses fail JSON atau CSV untuk tetapan penunjuk tersuai, membolehkan pengguna menyimpan dan menggunakan dengan cepat konfigurasi pilihan mereka untuk penunjuk.

Operasi

Pasang plugin

Apabila pengguna cTrader memasang dan mendayakan plugin yang menyokong jenis fail tertentu buat kali pertama, dialog akan muncul. Pengguna digesa untuk mengaitkan sambungan fail dengan plugin.

Selepas pengguna mengesahkan operasi tersebut, komputer mereka mengemas kini tetapan perkaitan fail seluruh sistem mereka, dan konfigurasi baharu digunakan serta-merta.

Ikon baharu untuk jenis fail menjadi kelihatan dalam Penjelajah Fail. Jika ikon tidak disediakan untuk jenis fail, ikon plugin lalai akan digunakan.

Amaran

Plugin tidak dibenarkan memproses sambungan fail terhad seperti .algo.

Gunakan plugin

Jika plugin yang menyokong sambungan fail didayakan dalam cTrader, plugin dipanggil untuk bekerja dengan fail apabila pengguna melakukan mana-mana perkara berikut:

  • Seret dan lepas fail - pengguna boleh menyeret fail yang disokong dan melepaskannya ke dalam UI cTrader.

  • Buka fail dalam Penjelajah Fail - pengguna boleh klik dua kali pada fail untuk membukanya atau menggunakan pilihan Buka dengan dan memilih cTrader.

    • Jika aplikasi cTrader dibuka, plugin menerima fail dengan serta-merta.
    • Jika aplikasi cTrader ditutup, cTrader dilancarkan terlebih dahulu dan kemudian plugin menerima fail.

Fail yang diterima disalin ke folder data untuk plugin dan dipadam sebaik sahaja plugin selesai memprosesnya.

Laluan ke folder data untuk plugin: …/Documents/cAlgo/Data/Plugins/{PluginName}/Temp.

Dalam kes di mana sambungan fail dikaitkan dengan beberapa plugin yang didayakan, setiap plugin memproses fail tersebut secara bebas.

Apabila perkaitan fail dialih keluar kerana plugin yang berkaitan dinyahdayakan dalam contoh cTrader, perkaitan fail secara automatik ditambah semula dalam contoh cTrader lain di mana plugin yang sama didayakan.

Lakukan pengatasan manual

Jika pengguna kemudiannya menukar program lalai untuk jenis fail dalam tetapan komputer biasa mereka, cTrader akan berhenti mengendalikan jenis fail tersebut secara automatik.

Untuk menetapkan cTrader sebagai program lalai untuk mengendalikan fail dalam format tersebut semula, pengguna perlu mewujudkan semula perkaitan fail dengan cara berikut:

  1. Buka cTrader dan nyahdayakan plugin yang berkaitan.
  2. Dayakan plugin tersebut. Apabila dialog muncul, sahkan operasi tersebut.

Persediaan ini membantu plugin dan aplikasi cTrader mengurus sambungan fail sambil mengelakkan gangguan daripada program lain.

Nota

Plugin boleh menambah dan mengalih keluar perkaitan fail semasa masa jalan tanpa memerlukan mula semula algoritma atau aplikasi cTrader.

Plugin contoh

Plugin contoh hanya menambah perkaitan fail untuk jenis fail berikut:

  • CSV
  • PNG
  • PDF
  • TXT
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
using System;
using cAlgo.API;
using cAlgo.API.Collections;
using cAlgo.API.Indicators;
using cAlgo.API.Internals;

namespace cAlgo.Plugins
{
    [Plugin(AccessRights = AccessRights.None)]
    public class FileAssociationSample : Plugin
    {
        private const string FileExtension1 = ".csv";
        private const string FileExtension2 = ".png";
        private const string FileExtension3 = ".pdf";
        private const string FileExtension4 = ".txt";

        protected override void OnStart()
        {
            AddFileAssociations();
            FileAssociations.FileOpened += FileAssociations_FileOpened;

            Print("File associations have been added.");
        }

        private void AddFileAssociations()
        {
            FileAssociations.Add(FileExtension1);
            FileAssociations.Add(FileExtension2);
            FileAssociations.Add(FileExtension3);
            FileAssociations.Add(FileExtension4);
        }

        private void FileAssociations_FileOpened(FileAssociationsFileOpenedEventArgs obj)
        {
            Print($"File opened: {obj.FilePath}");
        }

        protected override void OnException(Exception exception)
        {
            Print($"Exception: {exception}");
        }
    }
}

Image title