翻訳コネクタ・フレームワークの概要

Oracle Content Management翻訳フレームワークを使用すると、外部言語サービス・プロバイダを使用してサイトおよびアセットを翻訳できます。

新しい翻訳コネクタの構築を支援するために、Oracle Content Managementには翻訳コネクタSDKが用意されています。

コネクタ・フレームワークによって、エンド・コネクタによって提供および実装される機能が抽象化されます。これは、翻訳コネクタを構成するためのREST APIインタフェースを提供し、サイトから翻訳ジョブをダウンロードし、結果の翻訳をOracle Content Managementにアップロードするための翻訳コネクタ機能をコールすることで行います。

翻訳コネクタSDK

Translation Connector SDK for Oracle Content Managementは、翻訳コネクタREST APIのサンプルNodeJS実装です。サンプルでは翻訳ジョブのzipファイルを受け入れ、ファイル内のすべてのリソースを翻訳します。これには、サイト・ページのメタデータ・ファイル、およびアセットのメタデータ・ファイルとネイティブ・ファイルの両方が含まれるため、すべての翻訳を含む新しいzipファイルが返されます。

翻訳コネクタSDKは、GitHubから入手可能なContent Toolkitの一部です。新しい翻訳コネクタの作成を支援するため、このSDKには、サンプルの翻訳コネクタが含まれています:

サンプル翻訳コネクタ用のJSDoc
RESTインタフェースのNodeJSサンプル翻訳コネクタの実装
サンプルが実行されるNodeJS mock Language Serverプロバイダ

ノート:

翻訳コネクタSDKでは、ユーザーが実際の文字列の翻訳を行うために、言語サービス・プロバイダ(LSP)へのアクセス権を持っている必要があります。モックLSPサーバーは、ターゲット指定されたロケールを文字列に単に前に追加することで、LSPからのレスポンスを模倣するためにSDKに組み込まれます。

このSDKは、次の3つのメイン・モジュールで構成されます:

SampleConnector: 必要なOracle Content Management翻訳コネクタAPIを実装するサンプル翻訳コネクタ。
SampleJobManager: 翻訳時にコネクタ・ジョブの状態を保持するファイルシステム・ベースのサンプル・ジョブ・マネージャ。
TranslationProviderInterface: 翻訳用のドキュメントを発行し、翻訳済ドキュメントを取得するために言語サービス・プロバイダを呼び出すために使用するAPIのセット。

サンプル翻訳コネクタ・コードは、次の3つの領域に分割されます:

/translation-connector:
- /connector: 必要なOracle Content Management Cloud Translation Connector APIを実装します。
- /job-manager: このファイルベースの永続ストアの実装は、翻訳ジョブを解凍し、翻訳を翻訳してから圧縮します。
- /provider: ドキュメントのアップロード、翻訳およびダウンロードを行うために言語サービス・プロバイダAPIを実装します。

また、モックLSPをテストに使用できます:

/mockserver: モックLSPは、リクエストされた翻訳ロケールをすべての文字列に単に追加します。

翻訳コネクタは、Oracle Content Managementで定義されたRESTインタフェース(SPI/SDK)を実装するリモート・ストアに対してRestfulサービスを使用するデプロイ可能なパッケージです。外部ストアのネイティブSDKsを使用してリモート・システムに接続します。

翻訳コネクタREST API

翻訳コネクタは、REST APIを通じてOracle Content Managementから呼び出すことができるかぎり、任意のテクノロジ・スタックとともにデプロイおよび実行することができます。

翻訳コネクタSDKには、次のAPIクラスが含まれています:

ConnectorApi
MockTranslationProvider
PersistenceStoreInterface
SampleBasicAuth
SampleConnector
SampleConnectorRouter
SampleFileDownloader
SampleFileImporter
SampleFilePersistenceStore
SampleFileTranslator
SampleJobManager
TranslationFilter
TranslationProviderInterface

翻訳コネクタでは、翻訳コネクタREST APIをサポートしている必要があります。

次の表では、Oracle Content Management翻訳コネクタのREST APIについて説明します。

API	説明
`GET http://host:port/connector/rest/api`	コネクタがサポートする翻訳コネクタREST APIのバージョンを返します。例: ["v1"]
`GET http://host:port/connector/rest/api/v1/server`	コネクタの構成情報(ユーザーがコネクタに渡す必要がある必須パラメータなど)を返します。
`POST http://host:port/connector/rest/api/v1/job`	コネクタで新規ジョブを作成し、一意の翻訳済ジョブを返します。
`GET http://host:port/connector/rest/api/v1/job/{id}`	指定したジョブに関するステータス情報を返します。
`POST http://host:port/connector/rest/api/v1/job/{id}/translate`	翻訳するジョブのOracle Content Management翻訳zipファイルを送信します。
`GET http://host:port/connector/rest/api/v1/job/{id}/translation`	Oracle Content Management翻訳済zipファイル形式での翻訳済ジョブを返します
`DELETE http://host:port/connector/rest/api/v1/job/{id}`	コネクタから(および必要に応じてLSPから)ジョブを削除