第5章 Dropbox への接続

手順

1. Fuse Online で以下を行います。

   1. 左側のパネルで Settings をクリックします。
   2. Settings ページで、上部付近にあるコールバック URL の右側で をクリックし、Fuse Online 環境のコールバック URL をクリップボードにコピーします。この手順の最後の方でこの URL が必要になります。

2. 別のブラウザータブで https://www.dropbox.com にアクセスし、以下を行います。

   1. インテグレーションでアクセスするデータがある Dropbox アカウントにログインします。
   2. ログインした後に https://www.dropbox.com/developers/apps にアクセスします。
   3. Create App をクリックします。
   4. Dropbox API を選択します。
   5. この手順の最初にクリップボードにコピーした URL を、ページの上部近くにある During registration, enter this callback URL: で始まる文に貼り付けます。たとえば、貼り付ける URL は https://app-proj9128.7b63.fuse-ignite.openshiftapps.com/api/v1/credentials/callback のようになります。
   6. Fuse Online が単一のフォルダーにアクセスするか、またはすべてのフォルダーやファイルにアクセスするかを選択します。
   7. Dropbox アプリケーションの名前を指定します。たとえば、Fuse Online Access From Aslan LLC を指定します。Dropbox アプリケーションで一意となる名前を指定する必要があります。
   8. ボックスにチェックマークを入れ、Dropbox API の利用規約に同意します。
   9. Create App をクリックします。
   10. 新しいアプリケーションの Dropbox Settings ページにある OAuth2 Redirect URIs の入力フィールドに、この手順の始めにクリップボードにコピーした Fuse Online URL を貼り付けます。
   11. Add をクリックします。

手順

1. 新しいのブラウザータブで https://www.dropbox.com にアクセスし、以下を行います。

   1. Fuse Online 環境からのアクセスを登録するアプリケーションを作成した Dropbox アカウントにログインします。
   2. https://www.dropbox.com/developers/apps にアクセスします。
   3. Fuse Online アプリケーションをクリックし、その設定を表示します。

2. Fuse Online の別のブラウザータブで以下を行います。

   1. 左側のパネルで Connections をクリックし、利用できるコネクションを表示します。
   2. 右上の Create Connection をクリックし、利用可能なコネクターを表示します。
   3. Dropbox コネクターをクリックします。

3. アプリケーションの Dropbox 設定表示に戻り、以下を行います。

   1. 下にスクロールして Generated Access Token を確認します。
   2. Generate をクリックします。
   3. 生成されたアクセストークンをクリップボードにコピーします。
4. Fuse Online に戻り、Configure Connection ページの Access Token フィールドに生成されたアクセストークンを貼り付けます。
5. Client Identifier フィールドに Dropbox アプリケーションを作成したときに指定した名前を入力します。
6. Validate をクリックします。Fuse Online はこのコネクションを検証できるかを示すメッセージを表示します。検証に失敗した場合は、入力した値が正しいことを確認し、再度検証を行ってください。
7. 検証に成功したら、右上の Next をクリックします。
8. Connection Name フィールドに、このコネクションを別のコネクションと区別するために使用する名前を入力します。たとえば、Dropbox Connect 1 を入力します。
9. Description は任意のフィールドで、このコネクションに関する便利な情報を入力します。たとえば、Sample Dropbox connection that can access all content in our company Dropbox account. を入力します。
10. 右上にある Create をクリックし、作成したコネクションが利用可能になったことを確認します。上記の例の名前を入力した場合は、インテグレーションに追加できるコネクションとして Dropbox Connect 1 が表示されます。

手順

1. Fuse Online パネルの左側にある Integrations をクリックします。
2. Create Integration をクリックします。
3. Choose a Start Connection ページで、インテグレーションを開始するために使用する Dropbox コネクションをクリックします。
4. Choose an Action ページで Download アクションをクリックし、このコネクションがアクセスする Dropbox アカウントから 1 つまたは複数のファイルを取得します。
5. アクションを設定するには、Folder or file name path to download フィールドにインテグレーションが取得するコンテンツのファイル名のパスを指定します。本リリースでは、単一のファイルのみをダウンロードできます。
6. Next をクリックして、アクションの出力タイプを指定します。

7. データタイプの認識が必要がない場合は、Select Type フィールドで Type specification not required を受け入れ、下部にある Done をクリックします。残りの手順を行う必要はありません。

   その他の場合は、以下の 1 つをスキーマタイプとして選択します。

   • JSON schema は JSON データの構造を記述するドキュメントです。ドキュメントのメディアタイプは application/schema+json です。
   • JSON instance は JSON データが含まれるドキュメントです。ドキュメントのメディアタイプは application/json です。
   • XML schema は XML データの構造を記述するドキュメントです。このドキュメントのファイル拡張子は .xsd です。
   • XML instance は XML データが含まれるドキュメントです。このドキュメントのファイル拡張子は .xml です。
8. Definition 入力ボックスに、選択したスキーマタイプに準拠する定義を貼り付けます。たとえば、JSON schema を選択した場合は、メディアタイプが application/schema+json の JSON スキーマファイルの内容を貼り付けます。

9. Data Type Name フィールドにはデータタイプに選択した名前を入力します。たとえば、ベンダーの JSON スキーマを指定する場合は、データ型名として Vendor を指定できます。

   このタイプを指定するコネクションを使用するインテグレーションを作成または編集するときにこのデータタイプ名が表示されます。Fuse Online では、インテグレーション仮想化パネルとデータマッパーにタイプ名が表示されます。

10. Data Type Description フィールドには、このタイプを区別するのに便利な情報を提供します。データマッパーでこのタイプを処理するステップにカーソルを合わせると、この説明が表示されます。
11. Done をクリックします。

手順

1. Choose a Finish Connection ページで、インテグレーションの終了に使用する Dropbox コネクションをクリックします。
2. Choose an Action ページで Upload アクションをクリックし、このコネクションがアクセスする Dropbox アカウントに現在のインテグレーションデータを追加します。
3. Remote Path フィールドにアップロードするファイルのローカルファイル名パスを入力します。Dropbox は同じパスと名前でファイルを格納します。本リリースでは、単一のファイルのみをアップロードできます。

4. Upload mode では以下を行います。

   • 同じ Dropbox フォルダーに同じ名前のファイルがない場合のみ Add を選択してファイルをアップロードします。同じ名前のファイルが同じ Dropbox フォルダーに存在する場合は、ファイルはアップロードされず、インテグレーションが続行されます。これは、アップロードするファイルのコンテンツが更新されたかどうかに関わらず、同じ動作になります。
   • 同じ名前のファイルが同じ Dropbox フォルダーにある場合でも確実にファイルをアップロードするには Force を選択します。既存のファイルはアップロードするファイルによって上書きされます。
5. Next をクリックしてアクションの入力タイプを指定します。

6. データタイプの認識が必要がない場合は、Select Type フィールドで Type specification not required を受け入れ、下部にある Done をクリックします。残りの手順を行う必要はありません。

   その他の場合は、以下の 1 つをスキーマタイプとして選択します。

   • JSON schema は JSON データの構造を記述するドキュメントです。ドキュメントのメディアタイプは application/schema+json です。
   • JSON instance は JSON データが含まれるドキュメントです。ドキュメントのメディアタイプは application/json です。
   • XML schema は XML データの構造を記述するドキュメントです。このドキュメントのファイル拡張子は .xsd です。
   • XML instance は XML データが含まれるドキュメントです。このドキュメントのファイル拡張子は .xml です。
7. Definition 入力ボックスに、選択したスキーマタイプに準拠する定義を貼り付けます。たとえば、JSON schema を選択した場合は、メディアタイプが application/schema+json の JSON スキーマファイルの内容を貼り付けます。

8. Data Type Name フィールドにはデータタイプに選択した名前を入力します。たとえば、ベンダーの JSON スキーマを指定する場合は、データ型名として Vendor を指定できます。

   このタイプを指定するコネクションを使用するインテグレーションを作成または編集するときにこのデータタイプ名が表示されます。Fuse Online では、インテグレーション仮想化パネルとデータマッパーにタイプ名が表示されます。

9. Data Type Description フィールドには、このタイプを区別するのに便利な情報を提供します。データマッパーでこのタイプを処理するステップにカーソルを合わせると、この説明が表示されます。
10. Done をクリックします。

手順

1. インテグレーションが使用する Dropbox コネクションをクリックします。

2. Choose an Action ページで Upload をクリックし、このコネクションがアクセスする Dropbox アカウントに現在のインテグレーションデータを追加します。このアクションを設定するには、以下を行います。

   1. Remote Path フィールドにアップロードするファイルのローカルパスとファイル名を指定します。Dropbox は同じパスと名前でファイルを格納します。本リリースでは、単一のファイルのみをアップロードできます。

   2. Upload mode では以下を行います。

      • 同じ Dropbox フォルダーに同じ名前のファイルがない場合のみ Add を選択してファイルをアップロードします。同じ名前のファイルが同じ Dropbox フォルダーに存在する場合は、ファイルはアップロードされず、インテグレーションが続行されます。これは、アップロードするファイルのコンテンツが更新されたかどうかに関わらず、同じ動作になります。
      • 同じ名前のファイルが同じ Dropbox フォルダーにある場合でも確実にファイルをアップロードするには Force を選択します。既存のファイルはアップロードするファイルによって上書きされます。
3. Next をクリックし、アクションの入力および出力タイプを指定します。

4. データタイプの認識が必要がない場合は、Select Type フィールドで Type specification not required を受け入れ、下部にある Done をクリックします。残りの手順を行う必要はありません。

   その他の場合は、以下の 1 つをスキーマタイプとして選択します。

   • JSON schema は JSON データの構造を記述するドキュメントです。ドキュメントのメディアタイプは application/schema+json です。
   • JSON instance は JSON データが含まれるドキュメントです。ドキュメントのメディアタイプは application/json です。
   • XML schema は XML データの構造を記述するドキュメントです。このドキュメントのファイル拡張子は .xsd です。
   • XML instance は XML データが含まれるドキュメントです。このドキュメントのファイル拡張子は .xml です。
5. Definition 入力ボックスに、選択したスキーマタイプに準拠する定義を貼り付けます。たとえば、JSON schema を選択した場合は、メディアタイプが application/schema+json の JSON スキーマファイルの内容を貼り付けます。

6. Data Type Name フィールドにはデータタイプに選択した名前を入力します。たとえば、ベンダーの JSON スキーマを指定する場合は、データ型名として Vendor を指定できます。

   このタイプを指定するコネクションを使用するインテグレーションを作成または編集するときにこのデータタイプ名が表示されます。Fuse Online では、インテグレーション仮想化パネルとデータマッパーにタイプ名が表示されます。

7. Data Type Description フィールドには、このタイプを区別するのに便利な情報を提供します。データマッパーでこのタイプを処理するステップにカーソルを合わせると、この説明が表示されます。
8. Done をクリックします。