PlatioDelete - Platioレコードの削除

Platioアプリケーションのコレクションからレコードを削除します。
Platioビルダーを使ってコレクション プロパティやフィールド定義を取得します。詳細についてはPlatioDleteコンポーネント「Platioビルダーの使い方」を参照してください。

■ストリーム情報

入力フォーマットRecord
接続数1
説明削除方法 が「キーを指定」の場合に、入力ストリームのフィールド定義をPlatioビルダーで行います。
このフィールド定義は直前に連結したマッパーの出力ストリームのフィールド定義にコピーされ、そこに対して値のマッピングを行います。そのため、このコンポーネントに連結できるコンポーネントはマッパーのみとなっています。

削除方法 が「全レコード」「クエリー」の場合には使用されません。
出力フォーマットRecord
説明 次のようなフィールド定義の固定のレコードが出力されます。
フィールド名データ型説明
IdString削除したレコードのIDを出力します。
一括削除 で「はい」を指定した場合は空のストリームが出力されます。

■コンポーネントプロパティ

名前プロパティ型マッピング説明
コネクションを使用boolean- 接続先に以下のコネクション名 を使用するかどうか選択します。
はい [true] - 以下のコネクション名 で指定されたPlatio接続名を接続先として使用します。
いいえ [false] - コネクション情報 以下のプロパティを使ってPlatioに接続を行います。
コネクション名connection-コネクションを使用 が「はい」の場合に、Platioアプリケーションへの接続用コネクションを指定します。
コネクションペインまたは管理コンソールにて作成した接続名を選択します。
コネクション情報group-コネクションを使用 プロパティが「いいえ」の場合に使用されるプロパティ群です。
アプリケーションベースURLstring入力&出力 PlatioのアプリケーションベースURLを指定します。
指定するURLは「 https://api.plat.io/v1/[アプリケーションのID] 」の形式で指定します。 コネクションを使用 が「いいえ」の場合にこの設定が参照されます。
トークンIDstring入力&出力 Platioの開発者向け情報ページから取得したAPIトークンのトークンIDを指定します。
詳細については下記トピック「APIトークンの取得方法」を参照してください。
コネクションを使用 が「いいえ」の場合にこの設定が参照されます。
秘密トークンpassword入力&出力 Platioの開発者向け情報ページから取得したAPIトークンの秘密トークンを指定します。
詳細については下記トピック「APIトークンの取得方法」を参照してください。
コネクションを使用 が「いいえ」の場合にこの設定が参照されます。
プロキシ設定を使用boolean- 管理コンソールで設定したプロキシ設定を使用するかどうかを指定します。
コネクションを使用 が「いいえ」の場合にこの設定が参照されます。
はい [true] - プロキシ設定を使用します。
いいえ [false] - プロキシ設定を使用しません。
コレクションstring入力&出力 コレクションのIDかコレクションの名前を指定します。
Platioビルダーで選択することができます。
削除方法choice-削除方法を選択します。
全レコード [All] - コレクションの全てのレコードを削除します。
キーを指定 [Key] - Platioアダプターで指定したキーにマッチするレコードを削除します。
各キーの値は入力ストリームで指定します。
クエリー [Query] - 検索条件で指定した条件のレコードを削除します。

検索条件string入力&出力 検索条件を指定します。
削除方法 が「クエリー」の場合にこの設定が参照されます。
指定する「レコード検索書式」については、Platioのヘルプを参照してください。
Platioビルダーで「検索可能」なカラムを指定して検索条件を作成することができます。
検索条件内タイムゾーンchoice入力&出力検索条件 プロパティで指定された$from、$toの検索条件で使用するタイムゾーンを指定します。
選択項目に無い場合タイムゾーンを入力することも可能です。
削除方法 が「クエリー」の場合にこの設定が参照されます。
一括削除boolean- 削除方法を指定します。
はい」を選択した場合、APIのリクエスト回数を削減できますが、削除したレコードのIDは出力ストリームへと渡されません。
はい [true] - 一括削除します。APIのリクエスト回数を少なくすることができます。
いいえ [false] - 1レコードずつ削除します。削除したレコードのIDを受け取ることができます。

■ループ処理

なし。

■トランザクション処理

コミット何もしません。
ロールバック何もしません。

■エラー処理

タイプパラメーターエラー処理フロー
へのストリーム
エラー
コード
説明
APIエラー「APIエラーのパラメーター 」
を参照してください。
コンポーネントの入力ストリーム1 Platio APIがエラーを返した場合
  • パラメーターが不正な場合
  • ユーザー認証に失敗した場合
  • リクエストが許可されていない場合
  • 幾つかのリソースが見つからない場合
  • リクエスト数の制限に達した場合
  • サーバー上で問題が発生した場合
  • 一時的にサービスを使用することができない場合
接続エラー なし コンポーネントの入力ストリーム2Platioとの通信中にエラーが発生した場合
3Platioとの通信中、もしくは通信前処理でエラーが発生した場合
汎用 なし コンポーネントの入力ストリーム5コネクション名 に指定したコネクションが見つからない場合
9Platioに関連するその他のエラーが発生した場合

■「APIエラー」のパラメーター

No.名前説明
1ErrorCodePlatio APIのエラーコードが返されます。
2StatusCodeHTTPのステータスコードが返されます。
3ErrorResponseエラーレスポンスのJSONが返されます。

■APIトークンの取得方法

Platio APIを使用するためにはAPIトークンを生成する必要があり、PlatioDeleteコンポーネントは生成したAPIトークンを指定する必要があります。
APIトークンには「トークンID」と「秘密トークン」がありPlatioの「開発者向け情報」ページで生成することができます。
「トークンID」はAPIトークンを生成後、Platioの「開発者向け情報」ページよりいつでも確認することができますが、「秘密トークン」はAPIトークン生成時のみ表示され、その後、値を確認することはできません。
「秘密トークン」はAPIトークン生成時に「クリップボードにコピー」アイコンをクリックしてコピーし保存してください。

■Platio APIリクエスト回数

PlatioDeleteコンポーネントのPlatio APIリスエスト回数は以下のようになります。
API説明
レコードリスト・レコード・ユーザーリスト・アプリケーション定義の取得 削除対象のレコード件数、100レコードごとにリクエスト回数が増加します。
レコードの作成・更新・削除 削除するレコード数の回数リクエストします。
例:250レコードのコレクションを全件削除する場合
「レコードリスト・レコード・ユーザーリスト・アプリケーション定義の取得」:4回
「レコードの作成・更新・削除」:250回


一括削除 で「はい」を指定することでAPIリクエスト回数を劇的に減らすことができます。

例:250レコードのコレクションを全件削除する場合
「レコードリスト・レコード・ユーザーリスト・アプリケーション定義の取得」:2回
「レコードの作成・更新・削除」:1回


※Platio APIは、Platioビルダー使用時にも使用されます。

■Platioビルダーの使い方

Platioビルダーは、コネクション名 で接続できるPlatioアプリケーションからコレクション一覧を取得し、そのコレクションのカラムを入力ストリームのフィールドとして設定する専用ツールです。

●Platioビルダーを起動する

以下のいずれかの操作でPlatioビルダーを起動します。

●コネクションの選択

コネクションを使用 で「はい」を設定し、コネクション名 が設定されていない場合、Platioビルダー起動時にコネクションダイアログが表示されます。
新規にコネクションを作成する場合は「新規コネクション」を選択してください。
既存のコネクションを使用する場合は「名前」のプルダウンリストより使用するコネクション名を選択してください。選択したコネクションを使用してPlatioアプリケーションへ接続します。

●新規コネクションの作成

「新規コネクション」を選択した場合「コネクションの作成」ダイアログが表示されますので、作成するコネクション名を入力し「OK」ボタンをクリックしてください。



コネクションのプロパティ入力するダイアログが表示されますので、コネクションの各プロパティを設定し「保存」ボタンをクリックしてください。

注意

この時点で新規コネクションが保存されます。

作成したコネクションでPlatioアプリケーションへ接続します。


●Platioビルダーの画面(削除方法が「全レコード」の場合)

●削除方法を指定する

(1)の削除方法プルダウンリストから削除方法を選択します。

●全レコードを削除するコレクションを指定する

(2)のコレクション一覧からレコードを削除するコレクションを選択します。

●Platioビルダーの画面(削除方法が「キーを指定」の場合)

●削除のキーにするフィールドを指定する

(2)のコレクション一覧からコレクションを選択すると(3)に選択されたコレクションのフィールド一覧が表示されます。フィールド一覧でキーチェックボックスをオンにします。指定したフィールドを取り消すには、チェックボックスをオフにします。
キーに指定されたフィールドの値で検索されたレコードを削除します。検索されたレコードが複数レコードの場合、それらすべてのレコードを削除します。
キーに指定できるフィールドには、Platioの「検索可能」なカラム以外に「_RecordId」「$from」「$to」「$timezone」があります。「$from」「$to」に対応する入力ストリーム値は日時を設定して検索条件として使用します。
例:「$from」の値に「2017-01-13」を設定した場合
 検索条件「$from:2017-01-13」でレコードの更新時刻による検索を指定することになります。
「$timezone」は「$from」「$to」を指定した場合にUTC以外のタイムゾーンを指定したい場合に使用します。

キーに「_RecordId」を指定した場合、対象のレコードが1つ特定されますので、他のキーを指定したとしても使用されません。

●Platioビルダーの画面(削除方法が「クエリーを指定」の場合)

●検索条件

検索条件を指定する

(3)のフィールド一覧でフィールドをクリックし、右クリックして表示されるメニューから「検索条件へ追加」を選択します。 (4)に指定したフィールドを選択した検索条件の行が追加されます。追加された行で演算子を選択し、値を入力します。
検索条件に指定できる名前は、「検索可能」なカラム名の他に「$from」「$to」があります。この検索条件はレコードの更新時刻で検索する場合に使用します。 「$from」「$to」で使用できる演算子は「:」のみとなります。
例:2017年1月13日の0時よりも新しい(この時刻を含む)レコード

			$from:2017-01-13
			
例:2016年10月3日の15時よりも古い(この時刻を含まない)レコード
			$to:2016-10-03T15:00:00
			

検索条件を編集する

(4)の条件一覧で編集する条件を直接編集します。

検索条件を削除する

(4)の条件一覧で削除する条件をクリックし、右クリックして表示されるメニューから「検索条件削除」を選択します。 (4)から指定した条件が削除されます。

●取得条件オプション

タイムゾーンを指定する

(4)の検索条件で日時を扱う場合にタイムゾーンを選択します。