構造体に対するアクション

構造体プロパティの値は、構造体パラメーターで指定された値を使用して、アクションで作成および変更できます。

構造体パラメーター

構造体パラメーターは、ベースタイプが STRUCT のパラメーターです。このデータ型には、それぞれ独自の名前とベースタイプを持つパラメーターフィールドがネストされています。構造体パラメーターは、構造体プロパティに値を指定するためにのみ使用できます。構造体パラメーターのフィールドで対応しているベースタイプは、BOOLEAN、DATE、DOUBLE、GEOPOINT、INTEGER、LONG、STRING、TIMESTAMP です。

以下は、チケットを作成アクションの Resolution 構造体パラメーターです。ネストされた summary、resolutionTime、owner のフィールドにより、チケットがどのように解決されたかに関する情報が1個のパラメーターにまとめられます。

構造体プロパティに対するアクションを定義する

構造体パラメーターを持つアクションを使用すると、構造体プロパティを持つオブジェクトタイプを作成および変更できます。構造体プロパティの値は、そのプロパティにマッピングされた構造体パラメーターで送信されます。構造体プロパティの各フィールドは、構造体パラメーターの特定のフィールドにマッピングされます。以下の例では、Resolution 構造体パラメーターの各フィールドが、Ticket オブジェクトタイプの Resolution 構造体プロパティ内の対応するフィールドにマッピングされています。

構造体プロパティと構造体パラメーターのマッピングは、構造体プロパティの各フィールドが構造体パラメーターのフィールドにマッピングされた、完全なものである必要があります。構造体パラメーターのフィールドのベースタイプは、マッピング先の構造体プロパティのフィールドのベースタイプと一致する_必要があります_。構造体のプロパティタイプに破壊的変更を加える場合（たとえば、新しいフィールドの追加、フィールドの削除、フィールドのベースタイプの変更）、関連するアクションタイプも、その変更を反映するように変更する必要があります。

アクションフォーム内の構造体パラメーター

構造体パラメーターは、ほかのパラメーターのデータ型と同様に、アクションフォームで値を入力できます。ただし、構造体パラメーターのフィールドは、フォーム内で個別に表示されるのではなく、グループとして表示されます。

構造体パラメーターのフィールドのデフォルト値

デフォルト値は、構造体パラメーターのフィールドごとに定義されます。構造体パラメーターの各フィールドは、指定されたオブジェクトタイプの構造体プロパティのフィールドにマッピングされます。構造体パラメーターのすべてのフィールドにデフォルト値を定義する必要があり、それらは同じオブジェクトタイプの構造体プロパティのフィールドにマッピングされている必要があります。構造体パラメーターのフィールドのデフォルト値として使用できるのは、構造体プロパティのフィールドのみです。構造体プロパティのフィールドをデフォルト値として使用するオブジェクトタイプは、ObjectReference パラメーターで指定します。

アクションを実行するときに、ObjectReference パラメーターで指定されたタイプのオブジェクトのインスタンスを指定すると、そのオブジェクトの構造体プロパティのフィールド値が、対応する構造体パラメーターのフィールドに自動的に入力されます。

構造体パラメーターのフィールドの制約

通常のパラメーターと同様に、構造体パラメーターのフィールドにも個別に制約を設定できます。たとえば、文字列型の構造体パラメーターのフィールドに文字列長の制約を定義し、10文字以上500文字以下の文字列値のみを許可できます。この場合、Resolution 構造体パラメーターの summary フィールドは、10文字以上500文字以下である必要があります。

構造体パラメーターの値は、_すべて_のフィールドが定義された制約を満たす場合に_のみ_有効です。ユーザーは、各フィールドの値がそのフィールドに定義された制約を満たしている場合にのみ、構造体パラメーターの値を送信できます。summary フィールドに定義されている制約では、10文字未満の値は無効になります。

制限事項

アクションで構造体パラメーターを作成または変更する際は、以下の制限事項を考慮してください。

• 構造体プロパティの値は、_構造体パラメーター_でのみ作成または変更できます。固定値やオブジェクトプロパティへの参照など、ほかの入力形式には対応していません。
• 構造体プロパティは、_1個_の構造体パラメーターでのみ作成または変更できます。アクション内の構造体プロパティのマッピングに、複数のパラメーターを使用することはできません。
• 構造体パラメーターは、_構造体_プロパティの作成または変更にのみ使用できます。構造体パラメーターのフィールドを個別に使用して、構造体以外のプロパティを作成または変更することはできません。
• 構造体パラメーターのフィールドのデフォルト値として使用できるのは、_単一のオブジェクトタイプの構造体プロパティの値_への参照のみです。固定値など、ほかの入力形式には対応していません。