目次
1.Integration Serviceの概要とユースケース
2.サポートされているエンドポイント
3.Integration Serviceの構成
4.Integration Serviceの管理
5.Integration Serviceの接続テスト
1.Integration Serviceの概要とユースケース
概要
Integration Serviceは、外部システムまたはデータソースとのアプリケーションの相互作用を表すアプリケーションコンポーネントである。
構成は必要に応じて
サービスタイプ、エンドポイントURL、サービスID、タイプ (HTTP / HTTPS)、リクエストパラメーター、レスポンスパラメーター、プリプロセッサーとポストプロセッサー、および認証資格情報にすることが可能。
ユースケース
ユーザーがトップニュース、科学、技術、スポーツ、気象条件などのさまざまなカテゴリのニュースヘッドラインを閲覧できるようにするアプリを開発する場合、
Kony FabricのIntegration Serviceを使用して、ニュースAPIや天気APIからデータを取得する必要があり、これにより、アプリのフロントエンドに同じデータが入力される。
2.サポートされているエンドポイント
Kony Integration Serviceは、XML、JSON、JavaScript、データベース、SalesforceなどのWebサービスへのバックエンド接続をサポートする。
KonyのIntegration Serviceは、次のエンドポイントへの接続をサポートしている。
| エンドポイント | 説明 |
|---|---|
| XML | XMLは、HTTPプロトコルを介してXMLエンドポイントを使用して外部データソースと通信する。 |
| SOAP | Simple Object Access Protocol(略SOAP)は、WSDLを使用してSOAPベースのwebサービスの機能を記述するメッセージングプロトコルである。 ※WSDLとはWebサービスを外部のソフトウェアから接続・利用するための仕様（インターフェース）を記述することができる言語。 |
| JSON | JavaScriptObjectNotation(JSON)はHTTPプロトコルを介して外部データソースと通信し、JSON形式でレスポンスを返す。 |
| Java | カスタムJavaコードを使用してRESTful APIをサポートしないソフトウェアアプリケーションに対応する。 |
| JavaScript | プレーンなJavaScriptサービスをKony Fabricのアプリケーションに統合する。 |
| API Proxy | APIプロキシは、中間変換なしで（実際のリクエストとレスポンスに影響を与えることなく）リクエストとレスポンスを転送する。 |
| Mock Data | Kony Mock Data機能は、アプリが接続するバックエンドサービスを活用する準備ができていない場合、アプリの開発を継続するのに役立つ。 |
| RAML | RESTful API Modeling Language（RAML）は、RESTful APIを記述するためのYAMLベースの言語である。 ※YAMLとは、構造化データやオブジェクトを文字列に直列化するためのデータ形式の一種。 |
| Kony SAP Gateway | Kony SAP Gatewayは、サポートされているHTTPメソッドを介して外部SAPサービスと通信する。 |
| MuleSoft | MuleSoft（Anypoint Platform™）は、アプリ開発者がカスタムAPIを設計し、Mule Enterprise Service Busランタイム（ESB）にデプロイするのに役立つプラットフォームである。 |
| AWS API Gateway | AWS API Gatewayは、Amazon Web ServicesのAPI Gatewayサービスで設定とデプロイされたサービスに接続する。 |
| Database | Kony Fabricデータベースを使用すると、エンドポイントとして独自のデータベースに接続することができる。 Kony Fabric Consoleによりデータベースを構成することで、テーブル内のデータに対して作成、読み取り、更新、削除（CRUD）操作を実行し、ストアドプロシージャ、関数、ビューを呼び出すことが可能となる。 |
| MongoDB | Kony Fabric MongoDBデータベースを使用すると、エンドポイントとして独自のMongoDBデータベースに接続することができる。 MongoDBを構成することで、MongoDBのコレクションとドキュメントに対して作成、読み取り、更新、削除（CRUD）操作を実行が可能となる。 |
| Salesforce | Salesforceは、プロトコル固有のアダプターを使用して外部システムに接続し、そのデータにアクセスする。 |
| IBM MQ | IBM MQサーバー(ver.9.0.0)は、複数のプラットフォームにわたって多様なアプリケーションとビジネスデータの統合を簡素化し、加速させるメッセージングミドルウェアである。 Konyは、IBM MQサービスを使用してメッセージ配信を保護し、データ損失のリスクを低減する。 |
| SAP JCo | Kony Fabricでは、カスタムSAPコネクタを使用して外部SAPサービスにアクセスして使用することができる。 SAPサービスを定義するには、必要なBusiness Application Programming Interface（BAPI）関数をロードする必要がある。 BAPIファイルには、SAPのメソッドと機能が含まれている。 |
| Open API(Swagger) | Swaggerは、RESTful APIの設計、構築、文書化、使用を支援するツールの大規模なエコシステムに支えられたオープンAPI仕様フレームワークである。 |
3.Integration Serviceの構成
1.アプリケーションを作成した後、KonyFabricConsoleにて、
Configure Servicesタブで、Integrationタブをクリックする。Integrationページが表示され、
既存のIntegration Service（存在する場合）が一覧表示される。
2. CONFIGURE NEWをクリックして、Integration Serviceを作成する。
以下の詳細がIntegration Service Designerに表示される。
Integrationページでは、エンドポイントに対し次のセクションが表示される。
| No | セクション | 説明 |
|---|---|---|
| 1 | Add | 以下を追加できる： 新しいサービスの追加,既存の使用,新しい操作の追加 |
| 2 | Clone | 既存のサービスを複製できる。複製されたサービスに加えられた変更は、元のサービスには影響しない。 |
| 3 | SampleCode | 動的コードは、サービスの構成に基づいて生成される。 SDKでこのコードを使用できる。 |
| 4 | Unlink | アプリのIntegration Serviceセクションからサービスを削除できる。 サービスのリンクが解除されると、特定のアプリとの関連付けが解除される。 |
| 5 | Deletebutton | サービスを削除できる。 |
| 6 | Searchbutton | サービスと操作を検索できる。 |
| 7 | Service Section | サービスの展開ボタンまたは折りたたみボタンをクリックして、サービスの操作を表示または非表示にすることができる。 |
| 8 | Show/Hide Button | ツリーの表示または非表示を許可する。 ツリーセクションを非表示にすると、サービス定義または操作の詳細に右側のペインが使用される。 |
| 9 | Service Definition Tab | サービスの定義を構成できる。 |
| 10 | OperationsList Tab | Service Definition Tabで詳細を保存した後にのみ表示される。 |
4.Integration Serviceの管理
サービスのバージョンを保存する方法
Integration Serviceを新しいバージョンに保存することができる。
新しいバージョンを保存すると、現在のバージョンのサービスがKony Fabricアプリケーションからリンク解除され、新しいバージョンがリンクされる。
Kony Fabricアプリは、インテグレーションサービスの1つのバージョンにのみ関連付けることができる。
Integration Serviceの異なるバージョンを使用するには、次の手順を実行する
1.Integrationタブで、既存のサービスのリストでサービスの名前をクリックする。
サービスのOperationsメニューからEditを選択することもできる。
Service Definitionタブが表示される。
2.Versionメニューをクリックする。
3.サービスのバージョンを選択する。
4.Alertダイアログが表示される。Alertは、現在の関連バージョンのサービスをアプリケーションからリンク解除していることを警告する。
5.OKをクリックする。
Kony Fabricは、選択したバージョンをKony Fabricアプリケーションにリンクする。
サービスのバージョンを使用する方法
既存のサービスから一度に複数のサービスを追加または複製できる。
Integration Serviceの異なるバージョンを使用するには、次の手順を実行する
1.Integrationタブに移動する。ページには、既存のサービス（存在する場合）がリストされる。
2.Integrationで、左ペインまたは右ペインのツリーからUSE EXISTINGをクリックする。
[The Existing service]ダイアログが表示され、既存のサービスのリストが表示される
3. 異なるバージョンを使用するには、必要なサービスのVersionメニューをクリックして、サービスのバージョンを選択する。
4. 目的のサービスのチェックボックスを選択する。複数のサービスを追加または複製する場合は、既存のサービスから必要なチェックボックスをオンにする。
5. CLONEまたはADDボタンをクリックする。
・ADDをクリックして、既存のサービスを再利用（リンク）する。
→このサービスに変更が加えられた場合、変更はこのサービスを使用するすべてのアプリに影響する。
・CLONEをクリックして、既存のサービスを複製する。
→このサービスに加えられた変更が元のサービスに影響を与えない。
6. サービスが正常に追加または複製されたら、CLOSEをクリックしてダイアログを閉じる。
画像メニューには次のオプションが存在します
本記事上部の4.Integration Serviceの構成で説明している部分については省略いたします。
| セクション | 説明 |
|---|---|
| Edit | サービスを編集することができる。 |
| Audit Logs | サービスで実行されたすべてのユーザーアクティビティをキャプチャする。 |
| Console Access Control | アプリケーションとアプリケーションのサービスへのアクセスを制御する。 |
| Export | Integration Serviceをローカルシステムにエクスポートできる。 エクスポートされたファイルは.xmlファイルである。 ※既存システムで変更を加える際最初にExportして置くことでバックアップをとって置くことを推奨します。 |
Audit Logsの詳細に関してはこちら参照ください。
https://docs.kony.com/konylibrary/konyfabric/kony_fabric_user_guide/Content/Settings_Cloud.htm#AuditLogs-Cloud
5.Integration Serviceの接続確認テスト
Integration Serviceのテスト方法 pic.twitter.com/51pUgWZR3o
— Kony (@Kony12763790) March 30, 2020