콘텐츠로 이동

플러그인 파일 연관

FileAssociations 인터페이스는 플러그인이 파일 확장자를 유연하게 등록, 수정 및 처리할 수 있도록 하는 타입을 제공합니다. 이러한 타입을 사용하여 개발자는 파일 연관을 관리하는 플러그인을 코딩할 수 있습니다. 플러그인이 활성화되면 cTrader는 관련 파일을 인식하고 이를 플러그인으로 전달하여 처리합니다.

cTrader UI에서 파일을 직접 처리하도록 구성된 플러그인을 사용하면, 사용자는 파일 작업 시 여러 애플리케이션을 번갈아 사용할 필요가 없어질 수 있습니다. 예를 들어, 특정 트레이딩 전략과 함께 사용되는 모든 파일을 열고 관리하는 플러그인을 생성할 수 있습니다.

사용 사례

다음은 FileAssociations 기능을 사용하는 플러그인 예시입니다:

  • 트레이딩 히스토리 변환기는 다른 플랫폼의 트레이딩 히스토리가 포함된 CSV 및 TXT 파일을 수락하고 처리하여 cTrader 호환 형식으로 변환하거나 이를 직접 저널로 가져옵니다.
  • 트레이딩 신호 프로세서는 외부 제공자나 자동화된 트레이딩 시스템의 트레이딩 신호가 포함된 XML 또는 JSON 파일을 읽어 사용자가 신호를 기반으로 빠르게 거래를 실행할 수 있도록 합니다.
  • 리스크 관리 템플릿 임포터는 리스크 관리 구성이 포함된 JSON 또는 CSV 파일을 수락하고 처리하여 사용자가 cTrader에서 미리 정의된 설정을 적용할 수 있도록 합니다.
  • 포트폴리오 매니저는 트레이더의 포트폴리오 세부 정보가 포함된 CSV 및 XML 파일을 처리하여 자산, 포지션 및 성과 지표에 대한 간소화된 뷰를 제공하며 포트폴리오 관리를 강화합니다.
  • 차트 템플릿 로더는 차트 템플릿을 위한 XML 또는 JSON 파일을 처리하여 사용자가 선호하는 구성 또는 설정을 저장하고 빠르게 로드할 수 있도록 합니다.
  • 인디케이터 설정 로더는 사용자 정의 인디케이터 설정을 위한 JSON 또는 CSV 파일을 처리하여 사용자가 선호하는 구성을 저장하고 빠르게 적용할 수 있도록 합니다.

작업

플러그인 설치

cTrader 사용자가 특정 파일 형식을 지원하는 플러그인을 처음으로 설치하고 활성화할 때, 대화 상자가 나타납니다. 사용자는 파일 확장자를 플러그인과 연관시키라는 메시지를 받습니다.

사용자가 작업을 확인하면 컴퓨터의 시스템 전체 파일 연관 설정이 업데이트되고 새 구성이 즉시 적용됩니다.

파일 형식에 대한 새 아이콘이 파일 탐색기에 표시됩니다. 파일 형식에 대한 아이콘이 제공되지 않은 경우 기본 플러그인 아이콘이 사용됩니다.

경고

플러그인은 .algo와 같은 제한된 파일 확장자를 처리할 수 없습니다.

플러그인 사용

파일 확장자를 지원하는 플러그인이 cTrader에서 활성화된 경우, 사용자가 다음 중 하나를 수행할 때 플러그인이 파일 작업을 위해 호출됩니다:

  • 파일 드래그 앤 드롭 - 사용자는 지원되는 파일을 드래그하여 cTrader UI에 드롭할 수 있습니다.

  • 파일 탐색기에서 파일 열기 - 사용자는 파일을 더블 클릭하여 열거나 열기 옵션을 사용하여 cTrader를 선택할 수 있습니다.

    • cTrader 애플리케이션이 열려 있는 경우, 플러그인은 즉시 파일을 받습니다.
    • cTrader 애플리케이션이 닫혀 있는 경우, cTrader가 먼저 실행된 후 플러그인이 파일을 받습니다.

받은 파일은 플러그인의 데이터 폴더로 복사되며 플러그인이 처리를 완료하면 삭제됩니다.

플러그인의 데이터 폴더 경로: …/Documents/cAlgo/Data/Plugins/{PluginName}/Temp.

파일 확장자가 여러 활성화된 플러그인과 연관된 경우, 각 플러그인은 파일을 독립적으로 처리합니다.

파일 연관이 cTrader 인스턴스에서 관련 플러그인이 비활성화되어 제거되면, 동일한 플러그인이 활성화된 다른 cTrader 인스턴스에서 파일 연관이 자동으로 다시 추가됩니다.

수동 재정의 수행

사용자가 나중에 일반 컴퓨터 설정 내에서 파일 형식에 대한 기본 프로그램을 변경하면 cTrader는 자동으로 해당 파일 형식 처리를 중단합니다.

해당 형식의 파일 처리를 위해 cTrader를 기본 프로그램으로 다시 설정하려면 사용자는 다음과 같이 파일 연관을 다시 설정해야 합니다:

  1. cTrader를 열고 관련 플러그인을 비활성화합니다.
  2. 플러그인을 활성화합니다. 대화 상자가 나타나면 작업을 확인합니다.

이 설정은 플러그인과 cTrader 애플리케이션이 파일 확장자를 관리하면서 다른 프로그램의 간섭을 피할 수 있도록 도와줍니다.

참고

플러그인은 알고리즘이나 cTrader 애플리케이션을 재시작하지 않고도 런타임 중에 파일 연관을 추가 및 제거할 수 있습니다.

예제 플러그인

예제 플러그인은 단순히 다음 파일 형식에 대한 파일 연관을 추가합니다:

  • 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