var value = [
{'id' : '1-QabBt69U8myXYRDVU-1YiCo2k-JWRfu','name' : 'Sample.png'}
];
var count = 1;
zohobugtracker.entity.store('6573492', value, count).then(function(response)
/* Output
{
  'properties': [
    {
      'key': '6573492',
      'value': '[{\'id\':\'1-QabBt69U8myXYRDVU-1YiCo2k-JWRfu\',\'name\':\'sample.png\'}]',
      'count' : 1,
      'id': 1587134426
    }
  ]
}
*/
);

引数

entity.retrieve

エンティティに対して保存されているデータを取得します。このメソッドの引数には、同じデータを保存したときに使用したキーを指定します。

zohobugtracker.entity.retrieve('6573492').then(function(response)
/*Output
{
  'properties': [
    {
      'key': '6573492',
      'value': '[{\'id\':\'1-QabBt69U8myXYRDVU-1YiCo2k-JWRfu\',\'name\':\'update.png\'}]',
      'id': 1587134426,
      'count: 1
    }
  ]
}
*/
);

entity.update

エンティティに対して保存されているデータを更新します。このメソッドの引数は、次の4つの定義済みキーを含むJSONオブジェクトです。

var valueObj = [
{'id' : '1-QabBt69U8myXYRDVU-1YiCo2k-JWRfu','name' : 'Sample_New.png'}
];
zohoprojects.entity.update({id:'1587134426',key:'6573492',value:valueObj,count:2}).then(function(response)
/*Output
{
  'properties': [
    {
      'key': '6573492',
      'value': '[{\'id\':\'1-QabBt69U8myXYRDVU-1YiCo2k-JWRfu\',\'name\':\'Sample_New.png\'}]',
      'id': 1587134426,
      'count' : 2
    }
  ]
}
*/
);

entity.remove

特定のエンティティに対して保存されているデータを削除します。このメソッドの引数は、'entity.store()'メソッドを使用して同じデータを保存したときに出力として生成されたIDです。

zohobugtracker.entity.remove(1587134426).then(function(response)
/* Output { 'status': 'success' } */
);

エンティティプロパティの制限事項

• キーに対して一度に保存できる値は50KBを超えることはできません。
• このメソッドは、'app_settings'および'top_band'の場所では呼び出せません。
• エンティティプロパティに保存する値は有効なJSON形式である必要があります。
• エンティティプロパティの同時編集では整合性は保証されません。つまり、2人の異なるユーザーが同じエンティティプロパティを同時に変更した場合、最新の変更のみが保存され、以前の変更は失われるか上書きされます。

拡張機能プロパティ

拡張機能プロパティの概要

拡張機能自体に対して保存されるキーと値のペアです。ただし、拡張機能に対して保存されたデータは、その拡張機能を製品からアンインストールすると失われます。一方、エンティティに対して保存されたデータは、拡張機能をアンインストールしても保持されます。削除されるのは拡張機能固有の情報のみで、エンティティ固有のデータは他の拡張機能から引き続きアクセスできるためです。

app.store

拡張機能に対してデータを保存します。

var value = [
{'id' : '1-QabBt69U8myXYRDVU-1YiCo2k-JWRfu','name' : 'Sample.png'}
];
zohobugtracker.app.store('6573492', value).then(function(response)
/* Output
{
  'properties': [
    {
      'key': '6573492',
      'value': '[{\'id\':\'1-QabBt69U8myXYRDVU-1YiCo2k-JWRfu\',\'name\':\'sample.png\'}]',
      'id': 1587134426
    }
  ]
}
*/
);

app.retrieve