PlatioPut - Platioへの出力

■ストリーム情報

{
	"id": "rwq62qghjcveobpxgfcijp4b123",
	"values": {
		"c4b3de11": {
			"type": "String",
			"value": "infoteria"
		}
	}
}
				

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

■ループ処理

なし。

■トランザクション処理

■エラー処理

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

■エラー処理フローへのストリームについて

エラー発生時に、コンポーネントがエラー処理フローへ渡すストリームは、基本的にコンポーネントの入力ストリームを使用します。ただし、レコードの作成・更新処理の途中でエラーが発生した場合で入力ストリームがRecordストリームの時は、入力ストリームの各レコードに次のような２つのフィールドを追加してエラー処理フローへ渡します。

エラー処理フローへ渡されるストリームの例：

<?xml version="1.0" encoding="utf-8"?>
<RecordSet xmlns="http://www.infoteria.com/asteria/flowlibrary/record">
  <Record>
    <Field name="名前" type="String">AAA</Field>
    <Field name="アプリ１ 番号" type="Decimal">1</Field>
    <Field name="アプリ１ 名前" type="String">AAA</Field>
    <Field name="_Status" type="String">success</Field>
    <Field name="_ErrorMessage" type="String"></Field>
  </Record>
  <Record>
    <Field name="名前" type="String">BBB</Field>
    <Field name="アプリ１ 番号" type="Decimal">999</Field>
    <Field name="アプリ１ 名前" type="String">BBB</Field>
    <Field name="_Status" type="String">failure</Field>
    <Field name="_ErrorMessage" type="String">指定した参照先 [999] が存在していません。</Field>
  </Record>
  <Record>
    <Field name="名前" type="String">CCC</Field>
    <Field name="アプリ１ 番号" type="Decimal">3</Field>
    <Field name="アプリ１ 名前" type="String">CCC</Field>
    <Field name="_Status" type="String">unprocessed</Field>
    <Field name="_ErrorMessage" type="String"></Field>
  </Record>
</RecordSet>

■Platioのフィールドへのマッピングについて

Platioのカラム型とデータ型

Platioから取得した値、設定する値と、フィールド定義のデータ型の対応を以下に示します。

■APIトークンの取得方法

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

■Platio APIリクエスト回数

PlatioPutコンポーネントのPlatio APIリスエスト回数は以下のようになります。

API		説明
レコードリスト・レコード・ユーザーリスト・アプリケーション定義の取得		アプリケーション定義の取得を必ず1回実行します。 更新する場合は、処理するレコード数の回数リクエストします。更新するレコードを検索する必要がない場合（「実行する処理」で「更新」を指定し、キーとして_RecordIdを指定する/「実行する処理」で「更新/追加（ユニークキー指定）」を指定する）は、100レコード(*1)ごとにリクエスト回数が増加します。 レコード内にUser型カラムがある場合、ユーザー情報を取得するためにレコード数、User型カラム数に関係なく、ユーザー数に応じて１回以上増加します。 レコード内にReferenceString型、ReferenceNumber型、ReferenceUser型カラムがある場合、カラム数×レコード数の回数増加します。 ※ただし、User型、ReferenceString型、ReferenceNumber型、ReferenceUser型の値はコンポーネント内部で参照先の情報をキャッシュしていますので、同じレコードを参照している場合はリクエスト回数が上記回数より減少することがあります。 (*1)Platioアプリケーションのデフォルトの最大値です。
レコードの作成・更新・削除		100レコード(*1)ごとにリクエスト回数が増加します。 (*1)Platioアプリケーションのデフォルトの最大値です。
添付ファイルの作成		添付ファイル数の回数リクエストします。 ※複数のレコードへ同じ添付ファイルを指定する場合もレコード数の回数リクエストします。

例：入力ストリーム１レコードでキー指定し、検索されたUser型カラム、Reference型カラムを持たないPlatioの１レコードを添付ファイル１つで更新の場合
「レコードリスト・レコード・ユーザーリスト・アプリケーション定義の取得」：２回
「レコードの作成・更新・削除」：１回
「添付ファイルの作成」：１回

例：入力ストリーム１レコードでレコードIDを指定しUser型カラム、Reference型カラムを持たないPlatioの１レコードを更新の場合
「レコードリスト・レコード・ユーザーリスト・アプリケーション定義の取得」：１回
「レコードの作成・更新・削除」：１回

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

■Platioビルダーの使い方

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

●Platioビルダーを起動する

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

• PlatioPutコンポーネントをダブルクリック
• PlatioPutコンポーネントを右クリックして表示されるメニューから「Platioビルダー」をクリック

●コネクションの選択

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

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

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

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

注意

• (1)画面上部：アプリケーションへの接続情報と「実行する処理」を表示する領域
• (2)画面左：コレクション一覧を表示する領域
• (3)画面中央：フィールド一覧を表示する領域
• (4)画面右：取得条件のオプションとして設定するプロパティを表示する領域

●実行する処理を指定する

(1)の実行する処理プルダウンリストから実行する処理を選択します。

●作成または更新するレコードで使用するフィールドを指定する

(2)のコレクション一覧からコレクションを選択すると(3)に選択したコレクションから取得したフィールド一覧が表示されます。 フィールド一覧で選択チェックボックスをオンにします。指定したカラムを取り消すには、チェックボックスをオフにします。
実行する処理が「更新」、「更新/追加」の場合で、選択しないフィールドのカラムの値は更新されません。カラムの値を削除したい場合は、nullをマッピングする必要があります。

●更新時のキーにするフィールドを指定する

実行する処理が「更新」、「更新/追加」の場合は(3)のフィールド一覧でキーにするフィールドのキーのチェックボックスをオンにします。キーの指定を取り消すには、キーのチェックボックスをオフにします。
キーに指定されたフィールドの値で検索されたレコードを更新します。検索されたレコードが複数レコードの場合、それらすべてのレコードを更新します。
キーに指定できるフィールドには、Platioの「検索可能」なカラム以外に「_RecordId」「$from」「$to」「$fromTimestamp」「$toTimestamp」「$timezone」があります。キーに「$from」「$to」「$fromTimestamp」「$toTimestamp」を指定した場合、直前のマッパーでは検索で使用する日時の文字列をマッピングします。日時の文字列にミリ秒を含めたい場合は、YYYY-MM-DD'T'HH:mm:ss.SSS'Z'形式の日時の文字列をマッピングします。この場合、タイムゾーンはUTCとなります。
例：「$from」の値に「2017-01-13」を設定した場合
　検索条件「$from:2017-01-13」でレコードの更新時刻による検索を指定することになります。
「$timezone」は「$from」「$to」「$fromTimestamp」「$toTimestamp」を指定した場合にUTC以外のタイムゾーンを指定したい場合に使用します。

キーに「_RecordId」を指定した場合、対象のレコードが１つ特定されますので、他のキー指定は無視されます。

●取得条件オプション

Arrayセパレーターを指定もしくは入力する

Array型のセパレーターをプルダウンリストから選択します。

他の文字列をセパレーターとして使用したい場合は、文字列を入力します。