Contact

Contactクラスは顧客コンタクト先や案件コンタクト先の各コンタクトに対して操作を行うためのメンバーを持っています。

継承

Target

インスタンスプロパティ

contactMasterChoices読み取り専用

コンタクト先マスタの選択肢の配列です。

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  //選択肢を確認
  console.log(contact.contactMasterChoices);
  // [{ selectName:"キーマン",value:1 },{ selectValue:"担当者",value:2 }]
});

contactMaster

コンタクト先マスタ id を示す数値です。

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  //選択肢を確認
  console.log(contact.contactMasterChoices);
  // [{ selectName:"キーマン",value:1 },{ selectValue:"担当者",value:2 }]

  console.log(contact.contactMaster); //1

  contact.contactMaster = 2;

  console.log(contact.contactMaster); //2
});

motivationChoices読み取り専用

意欲の選択肢の配列です。

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  //選択肢を確認
  console.log(contact.motivationChoices);
  // [{ selectName:"前向き",value:1 },{ selectValue:"後ろ向き",value:2 }]
});

motivation

意欲の id を示す数値です。

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  //選択肢を確認
  console.log(contact.motivationChoices);
  // [{ selectName:"前向き",value:1 },{ selectValue:"後ろ向き",value:2 }]

  console.log(contact.motivation); //1

  contact.motivation = 2;

  console.log(contact.motivation); //2
});

positionChoices読み取り専用

立場の選択肢の配列です。

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  //選択肢を確認
  console.log(contact.positionChoices);
  // [{ selectName:"推進者",value:1 },{ selectValue:"決裁者",value:2 }]
});

position

立場の id を示す数値です。

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  //選択肢を確認
  console.log(contact.positionChoices);
  // [{ selectName:"前向き",value:1 },{ selectValue:"後ろ向き",value:2 }]

  console.log(contact.position); //1

  contact.position = 2;

  console.log(contact.position); //2
});

remarks

備考を示す文字列です。

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  console.log(contact.remarks); //""

  contact.remarks = "次回の会議で新製品の詳細を確認したいとのこと";

  console.log(contact.remarks); //次回の会議で新製品の詳細を確認したいとのこと
});

businesscardId

名刺情報に紐づいている名刺の ID です。テキスト名刺の場合、NaNを返します。

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  const businessCardId = contact.businesscardId;

  if (!isNaN(businessCardId)) {
    console.log(`名刺のIDは：${businessCardId}`); // 名刺のID：111111
  } else {
    console.log("テキスト名刺です。"); //テキスト名刺です。
  }
});

businesscardName

名刺情報に紐づいている名刺の名前です。

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  const businessCardName = contact.businesscardName;

  console.log(`名刺の名前：${businessCardName}`); // 名刺の名前：佐藤
});

referable

名刺情報に紐づいている名刺の閲覧権限があるかどうかの真偽値です。
名刺が紐づいていない場合はundefinedとなります。

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  const referable = contact.referable;

  console.log("閲覧権限", referable); // 閲覧権限：false
});

インスタンスメソッド

setBusinesscard

名刺情報に名刺をセットします。

構文

setBusinesscard(value, type);

引数

value

名刺、一時名刺の ID かテキスト名刺名です。

type

名刺のタイプです。 businesscard, tempBusinesscard, textBusinesscard の中から選択してください。

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  contact.setContact("佐藤", "textBusinesscard");

  console.log(contact.businesscardName); // 佐藤
});

setContactMaster

コンタクト先マスタを変更します。

構文

setContactMaster(contactMasterId);

引数

contactMasterId

contactMasterChoicesの value に対応する ID です。

返値

なし

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  //選択肢を確認
  console.log(contact.contactMasterChoices);
  // [{ selectName:"キーマン",value:1 },{ selectValue:"担当者",value:2 }]

  console.log(contact.contactMaster); //1

  contact.setContactMaster(2);

  console.log(contact.contactMaster); //2
});

setMotivation

意欲を変更します。

構文

setMotivation(motivationId);

引数

motivationId

motivationChoicesの value に対応する ID です。

返値

なし

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  //選択肢を確認
  console.log(contact.motivationChoices);
  // [{ selectName:"前向き",value:1 },{ selectValue:"後ろ向き",value:2 }]

  console.log(contact.motivation); //1

  contact.setMotivation(2);

  console.log(contact.motivation); //2
});

setPosition

立場を変更します。

構文

setPosition(positionId);

引数

positionId

positionChoicesの value に対応する ID です。

返値

なし

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  //選択肢を確認
  console.log(contact.positionChoices);
  // [{ selectName:"推進者",value:1 },{ selectValue:"決裁者",value:2 }]

  console.log(contact.position); //1

  contact.setPosition(2);

  console.log(contact.position); //2
});

setRemarks

備考を変更します。

構文

setRemarks(remark);

引数

remark

備考を示す文字列です。

返値

なし

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  console.log(contact.remarks); //""

  contact.setRemarks("次回の会議で新製品の詳細を確認したいとのこと");

  console.log(contact.remarks); //次回の会議で新製品の詳細を確認したいとのこと
});

isBusinesscard

名刺情報に紐づいている名刺が名刺であることを判定します。

構文

isBusinesscard();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  console.log(contact.isBusinesscard()); // true
});

isTempBusinesscard

名刺情報に紐づいている名刺が一時名刺であることを判定します。

構文

isTempBusinesscard();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  console.log(contact.isTempBusinesscard()); // true
});

isTextBusinesscard

名刺情報に紐づいている名刺がテキスト名刺であることを判定します。

構文

isTextBusinesscard();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  console.log(contact.isTextBusinesscard()); // true
});

isBusinesscardEmpty

名刺情報に名刺が紐づいていないことを判定します。

構文

isBusinesscardEmpty();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  console.log(contact.isBusinesscardEmpty()); // true
});

isReferable

referableの値を返します。

構文

isReferable();

引数

なし

返値

真偽値またはundefined

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const contactItem = SheetSaveScreen.getSheetItem(
    "customers.customer.relational_business_card_info"
  );

  const contact = contactItem.getContacts().entities[0]; //Contactインスタンス

  console.log(contact.isReferable()); // true
});

関連情報

• Contacts
• ContactItem
• Target