カスタムフィールド名前空間

最後の更新
PDFとして保存

このページは機械翻訳を使用して翻訳されています。

概要

Coupa 21以前は、追加したカスタムフィールドはすべてAPIグローバル名前空間に含まれていました（ルート要素外）。これにより、どのフィールドがCoupaの標準であり、どのフィールド（もしあれば）が顧客によって追加されたのかを識別することが困難になりました。これで、新しいカスタムフィールドが親要素 <custom-fields>に追加されました。

仕組み

既存のカスタムフィールドやカスタムフィールドの追加方法は変更していませんが、作成した新しいカスタムフィールドはAPIに表示されるとラップされます（API）。

UIで

R21より前に追加されたカスタムフィールドを編集すると、[ APIグローバル名前空間] チェックボックスが選択されていることがわかります。これは、カスタムフィールド がカスタムフィールドの名前空間に含まれておらず 、通常どおりに動作することを意味します。このチェックボックスをオフにして変更を保存すると、レガシーカスタムフィールドがカスタムフィールドの名前空間に追加されます。

新しく作成されたカスタムフィールドには、 APIグローバル名前空間 オプションがありません。デフォルトでは、新しいカスタムフィールドの名前空間にあります。既存のカスタムフィールドのグローバル名前空間オプションを無効にすると、それらはカスタムフィールドの名前空間に配置され、チェックボックスが非表示になり、グローバル名前空間に再度追加できなくなります。

経費カテゴリのカスタムフィールドと出席者タイプのカスタムフィールドは、カスタムフィールドの名前空間への追加をまだサポートしていません。

インテグレーション

統合は、カスタムフィールドでAPIグローバル名前空間 オプションが有効になっている限り、古い形式をサポートし続けます。新しい形式では、統合オブジェクトの新しいカスタムフィールドのAPIをラップします。以下の例でこれがどのようになるかを示しています。

APIの場合、Coupaは設定に関係なく、新しい名前空間の既存のカスタムフィールドをサポートします。カスタムフィールドが新しいフォーマットと古いフォーマットの両方で渡される場合、Coupaは新しいフォーマットを利用し、古いフォーマットを無視します。

XMLを使用したAPIの例

APIの場合、新しいカスタムフィールドは親 <custom-fields>属性でラップされます。

<custom-fields>
    <custom-field-1>Name of first custom field</custom-field-1>
    <custom-field-2>Name of second custom field</custom-field-2>
</custom-fields>

JSONを使用したAPIの例

APIの場合、新しいカスタムフィールドは親 custom-fields属性に含まれています。

{
  "custom-fields": {
    "custom-field-1": "Name of first custom field",
    "custom-field-2": "Name of second custom field"
  }
}