Studio ガイド

最終更新日時 2025年3月24日

カスタムサービスを登録する

コード化されたオートメーションを強化するには、カスタムサービスの登録を検討してください。カスタムサービスを登録すると、プロジェクトでグローバルに使用できます。これにより、単一のコード化されたオートメーションだけでなく、プロジェクト内のすべてのコード化されたオートメーションでアクセスできます。

コードソースファイルを作成し、作成するサービス名を指定してパブリックインターフェイスを定義します。
このインターフェイスには、カスタムサービスで使用するメソッドが一覧表示されます。各メソッドは、インターフェイスを定義するのと同じファイルを継承する別のクラスに実装する必要があります。

この例では、インターフェイスに IMyService という名前を付けて、その中のメソッド DoMyMethod を呼び出します。
```
 {
    public interface IMyService
    {
        void DoMyMethod();
    }
}{
    public interface IMyService
    {
        void DoMyMethod();
    }
}
```

別のコードソースファイルに進み、以前に作成したインターフェイスからメソッドを実装します。

このクラスは、パブリックインターフェイスが作成されたのと同じコードソースファイルから継承する必要があります。

この例では、変数の値を出力するための DoMyMethod メソッドを実装します。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]public class MyService : IMyService
    {
        public void DoMyMethod()
        {
            var a = "hello world";
            Console.WriteLine(a);
        }
    }
}

部分クラスを構築してカスタムサービスをラップし、このクラスを継承するコード化されたワークフローからアクセスできるようにします。

別のコードソースファイルを作成し、Coded Workflow という名前のパブリック部分クラスを宣言します。このクラスに CodedWorkflowBase クラスを継承させます。
作成したカスタムサービスを取得するための専用のプロパティを作成し、サービスインターフェイスのインスタンスへのアクセスを許可します。
インスタンスは、serviceContainer.Resolve<IMyService>() メソッドを使用した依存関係のインジェクションによって取得されます。これにより、部分クラス内のカスタムサービスとの対話方法が提供されます。
```
 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]public IMyService myService { get => serviceContainer.Resolve<IMyService>()};
```
クラスをさらに拡張するには、RegisterServices メソッドを追加します。
このメソッドを呼び出すと、UiPath サービスコンテナー内にカスタムサービスが登録されます。
```
 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]protected override void RegisterServices(ICodedWorkflowsServiceLocator serviceLocator)
		{
			serviceLocator.RegisterType<IMyService, MyService>();
		}
```
RegisterType の代わりに RegisterInstance を使用することもできます。2 つの実装とその署名方法について、次の違いを確認してください。
- RegisterType - RegisterType を使用する場合は、呼び出すたびにサービスの新しいコピーまたはインスタンスを作成するコンテナーを指定します。RegisterType は、毎回新しいサービスを構築するための基準となる詳細計画を示します。
  - TService: これは、サービスによって使用されるサービスインターフェイスの種類です。これは、サービス用に作成するインターフェイスです。この例では、IMyService です。
  - TServiceImplementation: これは TService インターフェイスを実装するクラスです。このクラスは、TService 型のサービスが要求されたときに作成されます。
  - registrationType: 既定値は CodeServiceRegistrationType.Singleton です。サービス登録ポリシーを設定します。
  [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]void RegisterType<TService, TServiceImplementation>(CodeServiceRegistrationType registrationType = CodeServiceRegistrationType.Singleton) where TService : class where TServiceImplementation : class, TService;
- RegisterInstance - RegisterInstance を使用する場合は、前に作成したそのサービスの既製のインスタンスをコンテナーに提供します。サービスを呼び出すたびに、コンテナーは正確にこの既成のサービスを返します。RegisterInstance は、作成したサービスの正確なコピーを返します。
  - TServiceImplementation: これは、すでに作成したクラスの既製のインスタンスです。このインスタンスは、この型のサービスを解決する必要があるたびに返されます。たとえば、MySecondService です。
  - serviceTypes: これは、インスタンスを呼び出すときにインスタンスが使用可能であることを示す型の配列です。
  void RegisterInstance(TServiceImplementation instance, params Type[] serviceTypes) where TServiceImplementation : class;void RegisterInstance<TServiceImplementation>(TServiceImplementation instance, params Type[] serviceTypes) where TServiceImplementation : class;

以下のコードスニペットは、パブリック部分クラスの実装方法の例を示してします。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]public partial class CodedWorkflow : CodedWorkflowBase
    {
		public IMyService myService { get => serviceContainer.Resolve<IMyService>() ; }
		
		protected override void RegisterServices(ICodedWorkflowsServiceLocator serviceLocator)
		{
                    // Implementation using 'RegisterType'
			serviceLocator.RegisterType<IMyService, MyService>();
                    // Implementation using 'RegisterInstance'
                    var secondService = new MySecondService();
                    serviceLocator.RegisterInstance<MySecondService>(secondService);
		}

次のステップ

作成したカスタムサービスを使用するには、using ステートメントを使用して、作業中のファイル内でそのサービスの名前空間を参照します。カスタムサービスの名前空間には、プロジェクトの名前と .cs ファイルが存在する可能性のあるフォルダー/サブフォルダーの名前が含まれます。つまり、名前空間の形式は「<ProjectName>.<Folder>.<SubFolder>」のようになります。

たとえば、MyCustomService フォルダーにある GeneralCustomServices という名前のプロジェクト内にカスタムサービスを作成した場合、そのサービスの名前空間は GeneralCustomServices.MyCustomService になります。