概要
チュートリアル第3回の今回は、データソースを作成します(前回の記事はこちら)。本プラグインにおけるデータソースとは、FileMakerデータベースとFMPress Formsプラグイン間でデータをやり取りする際に必要となる接続情報のことです。「データベースの登録」と置き換えると分かりやすいかもしれません。
データソースの作成方法は、FileMaker ServerとFileMaker Cloudでは若干異なります。利用環境に合わせてご覧ください。
Claris ID 更新トークンの発行
(この作業はFileMaker Cloudをお使いの場合のみ必要な手順です)
FileMaker Cloudを利用する場合は、データソースを作成する前にClaris ID 更新トークンを発行する必要があります。
本チュートリアルの第1回でインストールしたfmctokenを使ってClaris ID 更新トークンを発行します。まず、WebブラウザーでClaris IDにアクセスしてサインインします。
![Claris IDにサインイン](https://forms.fmpress.jp/wp-content/uploads/2022/07/2022-07-28-17.52.26-1024x670.png)
同じ環境でfmctokenを実行してClaris ID 更新トークンを取得します。macOSの場合はターミナルアプリケーションを起動します。Windowsの場合 にはPowerShellやコマンドプロンプト等を起動します。
下記のコマンドを実行します。
fmctoken get refreshtoken
![Claris ID 更新トークンの発行](https://forms.fmpress.jp/wp-content/uploads/2022/07/2022-07-28-17.55-1024x557.webp)
メールアドレスを尋ねられますので、入力してenterキー(またはreturnキー)を押します。
![Claris ID 更新トークンの発行](https://forms.fmpress.jp/wp-content/uploads/2022/07/2022-07-28-17.55.49-1024x557.webp)
パスワードを尋ねられますので、入力してenterキー(またはreturnキー)を押します。
![Claris ID 更新トークンの発行](https://forms.fmpress.jp/wp-content/uploads/2022/07/2022-07-28-17.57.37-1024x557.webp)
2要素認証の確認 コード(6桁の数字)を尋ねられますので、、入力してenterキー(またはreturnキー)を押します。なお、2要素認証が未設定である場合は何も入力せずにenterキー(またはreturnキー)を押します。
![Claris ID 更新トークンの発行](https://forms.fmpress.jp/wp-content/uploads/2022/07/2022-07-28-17.57.53-1024x557.webp)
Claris ID 更新トークンが発行されました。このトークンは保存しておきます。
![Claris ID 更新トークンの発行](https://forms.fmpress.jp/wp-content/uploads/2022/07/2022-07-28-17.57.56-1024x557.webp)
データソースの作成
FileMaker Cloudの場合
WordPressの管理画面からFMPressを選択し、新規追加を押します。
![データソースの作成](https://forms.fmpress.jp/wp-content/uploads/2022/07/6e02baab608303ea961386707b175277-1024x670.png)
必要な情報を入力します。
- タイトル: データソースの名称(データベース名など、識別しやすいもの)
- ドライバー: FileMaker Cloud
- サーバー: FileMaker Cloudのホスト名(.account.filemaker-cloud.comを含む)
- データベース: データベース名(拡張⼦は不要)
- Claris ID 更新トークンのセットを押します。
![データソースの作成(FileMaker Cloud)](https://forms.fmpress.jp/wp-content/uploads/2022/10/2022-10-14-14.07.21-1024x541.png)
fmctokenを利用して取得したClaris ID 更新トークンをセットして公開(更新トークンの設定が2回目以降の場合は更新)を選択します。
![データソースの作成(FileMaker Cloud)](https://forms.fmpress.jp/wp-content/uploads/2022/10/2022-10-14-14.10.48-1024x539.png)
FileMaker Serverの場合
WordPressの管理画面からFMPressを選択し、新規追加を押します。
![データソースの作成](https://forms.fmpress.jp/wp-content/uploads/2022/07/6e02baab608303ea961386707b175277-1024x670.png)
必要な情報を入力します。なお、アカウント名に[ゲスト]
を利用する場合はアカウントとパスワードは空欄とします。
- タイトル: データソースの名称(データベース名など、識別しやすいもの)
- ドライバー:
FileMaker Server
(FMPress Formsバージョン1.1.0以前ではFileMaker
) - サーバー: データベースを共有しているサーバーのホスト名(Webサーバーと同一サーバーの場合は
localhost
) - データベース: データベース名(拡張子は不要)
- アカウント: データベースのアカウント名
- パスワードのセットを押します。
![データソースの作成(FileMaker Server)](https://forms.fmpress.jp/wp-content/uploads/2022/10/2022-10-14-13.49.26-1024x547.png)
1にパスワードを入力して、2の公開(パスワードの設定が2回目以降の場合は更新)を押します。
![データソースの作成(FileMaker Server)](https://forms.fmpress.jp/wp-content/uploads/2022/10/2022-10-14-13.52.32-1024x545.png)
接続テスト
接続テストを押すとデータソースの接続テストを実行でき、WordPressとFileMaker間の通信が確立されているかを確認できます(テスト方法は、FileMaker CloudとFileMaker Server共に同様の方法です)。
![接続テスト](https://forms.fmpress.jp/wp-content/uploads/2022/10/2022-10-14-13.57.20-1024x547.png)
接続テストの結果が、HTTP: OK (200) FileMaker Server: No error (0)
と表示されると正常に接続ができている状態です。
![接続テストの結果](https://forms.fmpress.jp/wp-content/uploads/2022/10/2022-10-14-13.59.35-1024x546.png)
よくあるエラーと対処方法
cURL error 7: Failed to connect to localhost port 3000 after 0 ms: Connection refused
FileMaker Data API
が稼働しているかを確認します。
cURL error 6: Could not resolve host: サーバー(ホスト名)
サーバー(ホスト名)が正しいかを確認します。
HTTP: Internal Server Error (500) FileMaker Server: Invalid user account or password (212)
データベースのアカウントまたはパスワード(またはその両方)が正しいかを確認します。
HTTP: Unauthorized (401) FileMaker Server: Unable to open file (802)
データベース名が正しいか、またデータベースファイルがサーバーにアップロードされているかを確認します。
接続テストが完了したら次の記事(フォームの作成)に進みましょう。お疲れ様でした。