upsertMetadata()

構文

使用方法

upsertMetadata() コールは、メタデータを拡張するすべてのコンポーネントの作成または更新に使用します。同一コール内のすべてのコンポーネントは、同じ種類である必要があります。詳細は、「Metadata コンポーネントおよびメタデータ型」を参照してください。

指定されたコンポーネントがすでに組織に存在する場合、upsertMetadata() コールはこれらのコンポーネントを更新します。存在しない場合、upsertMetadata() はこれらのコンポーネントを作成します。コンポーネントは fullname 項目によって照合されます。このコールは同期して実行されます。つまり、コールは、操作が完了した後にのみ戻ります。

API バージョン 34.0 以降、このコールで AllOrNoneHeader ヘッダーがサポートされます。デフォルトでは、AllOrNoneHeader が API バージョン 34.0 以降で使用されていない場合、このコールでエラーのない一部のレコードを保存できます (AllOrNoneHeader=false に相当)。API バージョン 33.0 以前の場合、デフォルトでは、コール内のどのレコードにもエラーがない場合にのみ、すべてのレコードが保存されます (AllOrNoneHeader=true に相当)。

バージョン

API バージョン 31.0 以降で利用できます。

権限

クライアントアプリケーションは、「すべてのデータの編集」権限または「メタデータ API 関数を使用したメタデータを変更」権限でログインしている必要があります。

必須項目

コンポーネント内のすべての必須項目に値を指定する必要があります。

有効な項目値

整数項目については整数 (英字は不可)、項目のデータ型に対して有効な値を入力する必要があります。クライアントアプリケーションでは、プログラム言語および開発ツールで指定されているデータ形式ルールに従ってください。(開発ツールは、SOAP メッセージのデータ型の適切な対応付けを処理します)。

文字列値

String 項目に値を保存する場合、API は先頭および末尾の空白文字を削除します。たとえば、label 項目の値に "MyObject " と入力されると、その値はデータベースに "MyObject" として保存されます。

メタデータコンポーネント更新/挿入の基本手順

サンプルコード —Java

引数

応答

UpsertResult[]