クラウドプロファイル ​

単一のWorkatoオンプレミスエージェント（OPA）は、複数のオンプレミスアプリケーションに接続できます。 クラウドプロファイルを使用すると、Workatoで直接コネクションを設定できます。 このオプションは、新しいオンプレミスグループを作成するときに選択できます。

基本 ​

• クラウドプロファイルとは
• どのようなタイプのシステムに接続できますか
• 新しい設定を適用するには

クラウドプロファイルとは ​

クラウドプロファイルは、オンプレミスエージェント用のコネクションを設定する新しい方法です。 OPAバージョン2.15.0以降では、ローカルのオンプレミスエージェント設定ファイルを編集する代わりに、Workatoでオンプレミスコネクションを直接設定できます。 これにより、エージェントがインストールされているマシンに直接アクセスする必要がなくなるため、既存のプロセスが大幅に簡素化されます。 エージェントが稼働中であることを確認してください。

コネクションを作成すると、Connection typeという入力フィールドが表示されます。 これは既存のオンプレミスグループのリストです。 一部のクラウドコネクターには、デフォルトのCloud設定がある場合があります。 Workatoで直接コネクションを作成できるように、クラウドプロファイルをサポートするオンプレミスグループを選択してください。

以下は、クラウドプロファイルを持つオンプレミスグループが選択されている場合のSQL Serverコネクションの例です。 ご覧のように、データベースコネクションのプロパティは通常のクラウドコネクターと同様に設定できます。

SQL Serverクラウドプロファイルコネクション

接続できるシステムの種類 ​

クラウドプロファイルは次のシステムタイプでサポートされています:

• データベース
• オンプレミスファイルシステム
• SAP
• Java Messaging Service
• Apache Kafka
• Active Directory
• コマンドラインスクリプト

新しい設定を適用するには ​

新しいコネクションを作成すると、詳細は特定のオンプレミスグループ内のすべてのエージェントに自動的に伝播されます。 ほぼ即時に行われますが、場合によってはエージェントが更新されたコネクションの詳細を取得するまでに時間がかかることがあります。

データベースクラウドプロファイル ​

データベースクラウドプロファイルは、オンプレミスエージェント（OPA）がデータベースに接続するために使用する情報を提供します。

すべてのデータベースコネクターでは、オンプレミスエージェント経由で接続できます。 コネクションフィールドで、Connection typeフィールドからオンプレミスグループを選択します。

クラウドプロファイル設定をサポートするオンプレミスグループを作成した後、Workatoでコネクションをクラウドコネクターとして設定できます。 必須フィールドに入力し、接続をクリックします。

クラウドプロファイルを使用したデータベースコネクション

このセクションでは、次について説明します。

• プロファイルプロパティ
• サポートされているデータベースタイプ

プロファイルプロパティ ​

データベースクラウドコネクションプロファイルには、次のプロパティを含めることができます:

サポートされているデータベース ​

次の表には、OPAが現在サポートしているデータベースに関する情報が含まれています。

オンブレミスファイルクラウドプロファイル ​

詳細については、オンブレミスファイルコネクターのドキュメントを参照してください。

FTP(S)クラウドプロファイル ​

FTPコネクターのドキュメントを参照してください。

SFTPクラウドプロファイル ​

SFTPコネクターのドキュメントを参照してください。

SMBクラウドプロファイル ​

追加情報については、SMBコネクターのドキュメントを参照してください。

SAPクラウドプロファイル ​

SAPコネクターがサポートするコネクションタイプは、直接コネクションまたはMessage Serverコネクションの2つです。

ポートがデフォルトと異なる場合は、'Client MS Server'および'MS Server'のオプション入力を使用して、コネクションの詳細にポート上書きが含まれていることを確認してください。

jco_overrides:
  opt.idoc_reception_strategy: 'LEGACY'   # Value is case-insensitive

SAP - 直接コネクション ​

以下は、Directコネクションタイプの例です。 SAPシステムがアプリケーションサーバーとして直接公開されている場合は、このコネクションタイプを使用します。

クラウドプロファイルを使用したオンプレミスSAP直接コネクション

パラメーター	説明	画像をクリックして拡大
ゲートウェイホスト (jco.client.ashost)	DNS名またはIPアドレスのいずれかを指定できます。 存在する場合、これはSAPホストへの直接コネクションを表します。 xx.xx.xx.xx形式にできます。 これは、直接接続するSAPアプリケーションサーバーのIPアドレスです。 これは、オンプレミスSAP Application serverへのログインに使用するSAP Logon Padで確認できます。
システム番号 (jco.client.sysnr)	2桁のSAPシステム番号。 アプリケーションサーバーが受信リクエストをリッスンしている論理ポートを識別します。 通常はTCP Port 33XXから確認でき、XXはシステム番号です。 指定しない場合、デフォルトは00です。
Program ID (jco.server.progid)	これは、Tcode SM59でWorkatoにリンクされたRFC宛先に付与されたProgram IDと一致します。
保護品質 (jco.client.snc_qop)	オプション。 Secure Network communicationを設定する場合にのみ必要です。 選択すると、JCOプロパティjco.client.snc_modeが1に設定されます。 指定しない場合、デフォルトはNo encryptionです
SAPcryptoライブラリパス (jco.client.snc_lib)	オプション。 Secure Network communicationを設定している場合にのみ必要です。 OPAがホストされているサーバー内のlibsapcrypto.so（Linux）、libsapcrypto.dylib（Mac）、sapcrypto.dll（Windows）へのファイルシステムパスを指定します。 例: C:\sec\sapcrypto.dll
SNCパートナー名 (jco.client.snc_partnername)	オプション。 Secure Network communicationを設定している場合にのみ必要です。 SNC SAPCryptolib配下のSTRUSTで見つかるSNCパートナー。 文字"p:"を先頭に付ける必要があります。 例: p:CN=EH8, OU=I0021153688, OU=SAP Web AS, O=SAP Trust Community, C=DE
クライアント (jco.client.client)	コネクションに使用する予定のSAPクライアント。 これは常に3桁の値です。 例: 100または080
言語 (jco.client.lang)	オプション。 ログオン言語を表します。 言語プロパティが指定されていない場合、デフォルトでSAPでユーザーに設定された言語になります。 有効な値は2文字のISO言語コードまたは1文字のSAP言語コードです。
ユーザー (jco.client.user)	Workato用にプロビジョニングされたSAPユーザー。 バックグラウンドユーザーを使用し、ダイアログプロパティを無効にすることをお勧めします。
パスワード (jco.client.passwd)	SAPユーザーのパスワード。
metadata_refresh_interval	SAPからメタデータを更新する間隔（分単位、JCoキャッシュを除く）。 デフォルトは1440分（24時間）です。
SNC名 (jco.client.snc_myname)	オプション。 コネクションに使用する予定のクライアント証明書の正規名。
トレース (jco.client.trace)	オプション。 これにより、RFCトレースを有効または無効にします。 有効な値は0または1です。
SAP Router (jco.client.saprouter)	オプション。 /H/<Hostname/Public IP of the SAP Router>/S/<Port>形式で渡すSAP Router文字列。
コネクションプール容量	オプション。 コネクションプール内で開いたまま保持されるアクティブなコネクションの最大数。 このパラメーターの値を設定するには、SAP管理者に相談してください。
コネクションピークリミット	オプション。 需要が高い期間に、プール容量を超えて作成できるアクティブなコネクションの最大数。 負荷が低下すると、追加のコネクションは閉じられます。 このパラメーターの値を設定するには、SAP管理者に相談してください。
コネクション数 (jco.server.connection_count)	オプション。 サーバーコネクションの数を入力します。 有効範囲は1～100です。 デフォルト値は2です。
IDocスキーマキャッシュの有効期間	オプション。 IDocスキーマキャッシュの有効期間を秒単位で指定します。 値が0の場合、イベントごとに更新されます（デフォルト）。 値が3600の場合、1時間ごとに更新されます。 オンプレミスエージェント（OPA）v32.0以降に適用されます。

SAP - Message Serverコネクション ​

以下は、Message serverコネクションタイプの例です。 SAPシステムがMessage Serverゲートウェイの背後にある場合は、このコネクションタイプを使用します。

クラウドプロファイルを使用したオンプレミスSAP Message Serverコネクション

パラメーター	説明	画像をクリックして拡大
Message Serverホスト (jco.client.mshost)	xx.xx.xx.xx形式のMessage Serverホスト。 これは、接続先のMessage ServerのIPアドレスです。
System ID	Message Serverが属するシステムのSystem ID。 コネクションエラーの場合はSAP Note 52959を参照してください。
ログオングループ (jco.client.group)	オプション。 アプリケーションサーバーの論理グループ名。 SAP Tcode SMLGで確認できます。
Program ID (jco.server.progid)	これは、Tcode SM59でWorkatoにリンクされたRFC宛先に付与されたProgram IDと一致します。	Program ID
保護品質 (jco.client.snc_qop)	オプション。 Secure Network communicationを設定する場合にのみ必要です。 デフォルトはNo encryptionです。 選択すると、JCOプロパティjco.client.snc_modeが1に設定されます。
SAPcryptoライブラリパス (jco.client.snc_lib)	オプション。 Secure Network communicationを設定している場合にのみ必要です。 OPAがホストされているサーバー内のlibsapcrypto.so（Linux）、libsapcrypto.dylib（Mac）、sapcrypto.dll（Windows）へのファイルシステムパスを指定します。 例: C:\sec\sapcrypto.dll
SNCパートナー名 (jco.client.snc_partnername)	オプション。 Secure Network communicationを設定している場合にのみ必要です。 SNC SAPCryptolib配下のSTRUSTで見つかるSNCパートナー。 文字"p:"を先頭に付ける必要があります。 例: p:CN=EH8, OU=I0021153688, OU=SAP Web AS, O=SAP Trust Community, C=DE
クライアント (jco.client.client)	Workatoへの接続に使用される実際のクライアント番号。 SAP Logon Padでログインするときと同じものを使用します。 これは常に3桁の整数です。
言語 (jco.client.lang)	オプション。 ログオン言語を表します。 言語プロパティが指定されていない場合、デフォルトでSAPでユーザーに設定された言語になります。 有効な値は2文字のISO言語コードまたは1文字のSAP言語コードです。
ユーザー (jco.client.user)	Workato用にプロビジョニングされたSAPユーザー。 バックグラウンドユーザーを使用し、ダイアログプロパティを無効にすることをお勧めします。
パスワード (jco.client.passwd)	SAPユーザーのパスワード。
metadata_refresh_interval	SAPからメタデータを更新する間隔（分単位、JCoキャッシュを除く）。 デフォルトは1440分（24時間）です。
SNC名 (jco.client.snc_myname)	オプション。 コネクションに使用する予定のクライアント証明書の正規名。
Client MS Server (jco.client.msserv)	オプション。 クライアントポート番号。 デフォルトの3600ポート番号を上書きします。
MS Server (jco.server.msserv)	オプション。 Message Serverポート番号。 デフォルトの3600ポート番号を上書きします。
トレース (jco.client.trace)	オプション。 これにより、RFCトレースを有効または無効にします。 有効な値は0または1です。
SAP Router (jco.client.saprouter)	オプション。 /H/<Hostname/Public IP of the SAP Router>/S/<Port>形式で渡すSAP Router文字列。
コネクションプール容量	オプション。 コネクションプール内で開いたまま保持されるアクティブなコネクションの最大数。 このパラメーターの値を設定するには、SAP管理者に相談してください。
コネクションピークリミット	オプション。 需要が高い期間に、プール容量を超えて作成できるアクティブなコネクションの最大数。 負荷が低下すると、追加のコネクションは閉じられます。 このパラメーターの値を設定するには、SAP管理者に相談してください。
コネクション数 (jco.server.connection_count)	オプション。 サーバーコネクションの数を入力します。 有効範囲は1～100です。 デフォルト値は2です。
IDocスキーマキャッシュの有効期間	オプション。 IDocスキーマキャッシュの有効期間を秒単位で指定します。 値が0の場合、イベントごとに更新されます（デフォルト）。 値が3600の場合、1時間ごとに更新されます。 オンプレミスエージェント（OPA）v32.0以降に適用されます。

JMSクラウドプロファイル ​

次のJMSプロバイダーは、クラウドプロファイルオンプレミスエージェントでサポートされています:

• Amazon Simple Queue Service
• Apache ActiveMQ
• Azure Service Bus

Amazon SQS ​

Amazon SQSに接続する場合は、次の設定プロパティが必要です:

オンプレミスクラウドプロファイルAmazon

メッセージを送信する前に、SQSキューが存在することを確認してください。

Apache ActiveMQ ​

実行中のActiveMQブローカーに接続するには、ブローカーURLを指定するだけです:

オンプレミスクラウドプロファイルActiveMQ

ActiveMQブローカーをエージェントに埋め込むことはできません。 OPAはvm://ブローカーコネクションをサポートしていません。

Azure Service Bus ​

Azure Service BusはカスタムJMSプロバイダーを使用します。 接続するには、次の設定プロパティを使用し、<HOST_NAME>、<POLICY_NAME>、および<PRIMARY_KEY>をAzure Service Busの値に置き換えます:

jms:
  azureServiceBus:
    provider: custom
    class: org.apache.qpid.jms.JmsConnectionFactory
    remoteURI: amqps://<HOST_NAME>.servicebus.windows.net
    username: <POLICY_NAME>
    password: "<PRIMARY_KEY>"

必要なJARファイルと依存関係をダウンロードし、lib_extフォルダに配置します。

config.ymlファイル内にclasspathを追加します。

server:
  classpath: lib_ext

Apache Kafkaクラウドプロファイル ​

Apache Kafkaコネクターのドキュメントを参照してください。

Active Directoryクラウドプロファイル ​

Active Directoryコネクターのドキュメントを参照してください。

HTTP NTLMクラウドプロファイル ​

HTTPコネクターNTLMドキュメントを参照してください。

コマンドラインスクリプトクラウドプロファイル ​

詳細については、オンブレミスファイルコネクターのドキュメントを参照してください。