
ここでは kintone における、アプリの各フィールドの入力可否を操作する方法を解説します。

ルックアップと関連付けたフィールドなど、強制的にフィールドが入力不可になる設定がありますが、今回紹介する方法で手入力可能にできます。

ルックアップについては、再度ルックアップを取得したタイミングや、データの取り込みを行ったタイミングで手入力部分は消えてしまうため、その点は注意してください。

## ソースコード

フィールドの入力可否は[kintone JavaScript API](https://developer.cybozu.io/hc/ja/articles/360000361686)を利用することで実現できます。

### kintone.events.on のコールバック関数内で実行する場合

```javascript
kintone.events.on('...', (event) => {
  event.record['フィールドID'].disabled = false;

  return event;
});
```

### 予め設置したボタンのクリック時など、独自のタイミングで実行する場合

```javascript
/** 実行時のレコード情報 */
const { record } = kintone.app.record.get();

// フィールドの入力可否を設定
record['フィールドID'].disabled = false;

// レコード情報をセット
kintone.app.record.set({ record });
```

上記のコードで実装可能です。

### 注意点

kintone JavaScript API には実行時点のフィールド情報を取得する機能がいくつか用意されていますが、フィールド情報を操作した場合、必ず変更後のフィールド情報を API に返さなければなりません。

`kintone.events.on`のコールバック関数では、`return event` の部分。ボタンクリック時では、`kintone.app.record.set({ record });`の部分がないと、正しく反映されません。

また、kintone で javascript カスタマイズを長くされている方であればわかると思いますが、kintone.app.record.get で取得できるオブジェクトの直下に各フィールドプロパティがあるのではなく、取得したオブジェクトに record プロパティがあり、その中に各フィールドプロパティがあります。
そして、`kintone.app.record.set`の引数にするオブジェクトは、`kintone.app.record.get`で取得したオブジェクトの構造でなければなりません。

```javascript
// レコード情報を取得
const { record } = kintone.app.record.get();

// フィールドの入力可否を設定
record['フィールドID'].disabled = false;

// レコード情報をセット
kintone.app.record.set(record); // これはエラー
kintone.app.record.set({ record }); // これはOK
```

また、event から取得できる record オブジェクトをそのままセットしたい場合は、オブジェクトの構造を少し操作しておく必要があります。

```javascript
const events = ['app.record.create.show', 'app.record.edit.show'];

// 処理をイベントに登録します
kintone.events.on(events, (event) => {
  // このオブジェクトはそのままセットできない
  const record = event.record;

  // オブジェクトを整形した後セット
  kintone.app.record.set({ record });
});
```


アプリの各フィールドの入力可否を操作する方法を解説します。ルックアップと関連付けたフィールドは入力不可になりますが、今回紹介する方法で手入力可能にできます。再度ルックアップを取得したタイミングや、データの取り込みを行ったタイミングで手入力部分は消えてしまうため、その点は注意してください。

【kintone】フィールドの入力制限・可否を変更する

kintone の JavaScript カスタマイズにおいて、パフォーマンスに最も影響があるのは REST API の実行、もしくは外部 API の実行である場合が多いかと思います。

REST API のパフォーマンス改善を考えた際、まず検討すべきポイントはレコードの取得条件と取得フィールドを最小限にすることです。

ただ、取得フィールドを制限することで、取得したものと勘違いしてフィールドを参照し、エラーになる経験をされた方は多いんじゃないでしょうか。

TypeScript を使用していれば、厳格な型定義を行うことで防ぐことが可能ですが、今まではどうしても冗長な定義が必要になっていました。

TypeScript 4.9 から実装された satisfies operator を使用することで、無駄のない型定義をもって安全に REST API のレコード情報を取り扱えるようになりました。

今回は satisfies operator を使った絶対にコケない REST API の実装方法を紹介します。

## 必要な環境

- TypeScript 4.9 以上

## サンプルコード

```typescript
/** dts-genで作成したアプリの型定義 */
type SavedFields = sample.SavedFields;

/** REST APIで取得するアプリのフィールド */
const FIELD_CODES = [
 'フィールドコードA',
 'フィールドコードB'
] as const satisfies Readonly<(keyof SavedFields)[]>;

/** REST APIで取得するアプリのフィールド */
type FieldCodes = typeof FIELDS[number];

/** 取得したフィールドに限定したレコード情報 */
type ReferencedFields = Pick<SavedFields, FieldCodes>;

const client = new KintoneRestAPIClient({
 /* ... */
});

const getRecords = async (): Promise<ReferencedFields[]> => {
 const app = 9999;
 const query = 'ID = 99999';

 const records = await client.record.getAllRecordsWithCursor<ReferencedFields>({
 app,
 query,
 fields: FIELD_CODES,
 });

 return records;
};
```

## 解説

satisfies operator で実現できるようになったのは以下の部分です。

```typescript
const FIELD_CODES = [
 'フィールドコードA',
 'フィールドコードB'
] as const satisfies Readonly<(keyof SavedFields)[]>;
```

今までは使用するフィールドコードを定数として定義しようとした場合、以下のように定義する必要がありました。

```typescript
const FIELD_CODES: (keyof SavedFields)[] = ['フィールドコードA', 'フィールドコードB'];
```

これによって、「指定したフィールドコードが確かに存在しているか」をチェックすることは可能です。

ただ、型推論が働かず、取得するレコード情報の型としてこの定数を利用することができませんでした。

```typescript
const FIELD_CODES: (keyof SavedFields)[] = ['フィールドコードA', 'フィールドコードB'];

type FieldCodes = typeof FIELD_CODES[number]; // keyof SavedFields と推論され、厳格ではない
```

定数を REST API のレコード情報として反映したい場合は as const を使用することで実現できますが、今度は「指定したフィールドコードが確かに存在しているか」をチェックすることができません。

```typescript
const FIELD_CODES = ['フィールドコードA', 'フィールドコードB'] as const;

type FieldCodes = typeof FIELD_CODES[number]; // "フィールドコードA" | "フィールドコードB"
```

satisfies operator を使用することで、前述したコードの両方の条件を満たした定数定義・型定義が可能になります。

```typescript
const FIELD_CODES = [
 'フィールドコードA',
 'フィールドコードB'
] as const satisfies Readonly<(keyof SavedFields)[]>;
```

JavaScript からルックアップフィールドの参照元レコードを取得する方法を紹介します。また、参照しやすいアプリデザインについても言及します。

satisfies operatorを使った絶対にコケないREST APIの実装方法【kintone】

API を使ってレコードを更新したい場合、基本的には[PUT API](https://developer.cybozu.io/hc/ja/articles/201941784-%E3%83%AC%E3%82%B3%E3%83%BC%E3%83%89%E3%81%AE%E6%9B%B4%E6%96%B0-PUT-)を使用します。

ただ、仕様や安全性を考慮し、一定条件のレコードを全て削除したうえで、レコードを再生成しなければならない。といったこともあるのではないでしょうか。

今回はそういった場合のコードサンプルを紹介いたします。

## サンプルコード

### 関数の定義

まず、クエリーを指定して複数のレコードを削除する関数を定義します

```javascript
/**
 * @param { number | string } app 処理対象アプリID
 * @param { string } query 削除対象を絞り込むクエリー
 * @returns { Promise<{}> } DELETE APIの実行結果
 */
const deleteByQuery = async (app, query) => {
 /** APIエンドポイント */
 const url = kintone.api.url('/k/v1/records.json', true);

 /** 削除対象のレコード(IDのみ) */
 const records = await kintone.api(url, 'GET', {
 app,
 query,
 fields: ['$id'],
 });

 // レコードIDの配列を定義します
 const ids = records.map((r) => r.$id.value);

 return kintone.api(url, 'DELETE', { app, ids });
};
```

上記コードでは、1 度の実行で、DELETE のレコード上限である 100 件までしか処理できません。

上限を意識せず使用したい場合は、以下の記事をご参照ください。

[上限を気にせず POST, PUT, DELETE する【kintone】](/blog/kintone-unlimited)

### 例 1: 日付を指定した更新

```javascript
/** サンプルデータ */
const CLIENTS = [
 ['株式会社サンプル', '2022-01-01', 'A'],
 ['株式会社テスト', '2022-01-05', 'B'],
 ['ダミー株式会社', '2022-01-10', 'C'],
];

const deleteInsert = async () => {
 /** 処理対象アプリID */
 const app = 15;

 /** 登録するレコード一覧 */
 const records = CLIENTS.map((client) => ({
 顧客名: { vaule: client[0] },
 日付: { value: client[1] },
 確度: { value: client[2] },
 }));

 /** 削除対象を絞り込むクエリー */
 const query = '日付 >= "2021-01-01" and 日付 <= "2021-01-31"';

 // クエリーに当てはまるレコードを一括削除
 await deleteByQuery(app, query);

 // 作成したレコードを一括登録
 await kintone.api(kintone.api.url('/k/v1/records.json', true), 'POST', {
 app,
 records,
 });
};
```

## コードの安全性について

レコードの削除 → 登録を行う場合、気を付けなければいけないのは、レコードの削除後に異常終了してしまうケースです。

削除の完了を待って、登録を行うようなコードを記述していた場合、削除処理だけ完了し、登録が実行されずデータに齟齬が発生します。

これを避けるには、bulkRequest を使用する方法が効果的です。

bulkRequest にも上限が存在しますが、削除、登録のいずれかでエラーが発生した場合、処理を巻き戻し(ロールバック)、実行前の状態に戻すことが可能です。

[複数アプリへのレコード一括処理](https://developer.cybozu.io/hc/ja/articles/201941814-%E8%A4%87%E6%95%B0%E3%82%A2%E3%83%97%E3%83%AA%E3%81%B8%E3%81%AE%E3%83%AC%E3%82%B3%E3%83%BC%E3%83%89%E4%B8%80%E6%8B%AC%E5%87%A6%E7%90%86)

bulkRequest を使ったサンプルは以下の記事でも紹介しています。

[上限を気にせず POST, PUT, DELETE する【kintone】](/blog/kintone-unlimited)

APIを使ってレコードを更新したい場合、基本的にはPUT APIを使用します。ただ、仕様や安全性を考慮し、一定条件のレコードを全て削除したうえで、レコードを再生成しなければならない状況も起こりえます。今回はそういった場合のコードサンプルを紹介いたします。

【kintone】APIを使ったレコードの削除→登録による更新【デリートインサート】


kintone へカスタマイズした JavaScript を任意のタイミングで実行させるためには、kintone.events.on 関数への登録が必要です。

ただカスタマイズを拡張していくと、1 つのイベントだけでは機能を実現できず、複数回 kintone.events.on を使ってイベントを登録しないといけない場合も出てくると思います。

今回はそういった場合の JavaScript ファイルの記述方法を紹介します。

ちなみに kintone.events.on を複数書かなくても効率よくイベントを登録する方法を以下のページで紹介しているので、よろしければご覧ください。

[こちらも合わせてご参照ください](/blog/kintone-events-on)

## はじめに結論

kintone に反映する javascript ファイルについて、**ファイルを分割することで発生する制約はありますが、同一ファイルで記述することで発生する制約はありません**

即時関数を使っておけばグローバル汚染もありませんし、深く考えず複数の実装を縦に並べれば完成です。

## 即時関数を 2 つに分けるパターン

即時関数を 2 つに分ければ、それぞれのイベント内で定義した変数が競合することはありません。逆に複数のイベント間で変数を共有したい場合は、後述する即時関数 1 つのパターンを使ってください。

```javascript
(() => {
  const text = 'イベント1つ目';

  kintone.events.on(['app.record.index.show', 'app.record.detail.show'], (event) => {
    console.log(text); //イベント1つ目
    return event;
  });
})();

(() => {
  const text = 'イベント2つ目'; // 同じ変数名でもエラーにはならない

  kintone.events.on(['app.record.create.show'], (event) => {
    console.log(text); //イベント2つ目
    return event;
  });
})();
```

## 1 つの即時関数で実現するパターン

１つの即時関数に複数のイベントを登録すれば、グローバル変数を使用せずイベント間で変数を共有できます。
レコード作成時のフィールドの値を保持し、レコード保存時に反映するような処理もこれで実現できます。

```javascript
(() => {
  const text = '共有の変数';

  let initialValue;

  kintone.events.on(['app.record.create.show', 'app.record.edit.show'], (event) => {
    console.log(text); // 共有の変数

    initialValue = event.record['フィールド'].value;

    return event;
  });

  kintone.events.on(['app.record.create.submit', 'app.record.edit.submit'], (event) => {
    console.log(text); // 共有の変数

    if (initialValue !== event.record['フィールド'].value) {
      console.log('「フィールド」の値が変更されました！');
    }

    return event;
  });
})();
```

## まとめ

- 1 つのファイルにいくつでも kintone.events.on を記述して良い
- 即時関数で囲う範囲によって、変数の共有有無を制御できる
- グローバル変数を使うことなく、レコード編集開始時と終了時の差分を簡単に判別できる


kintoneにカスタマイズしたJavaScriptの処理を任意のタイミングで実行させるためには、kintone.events.on関数への登録が必要ですただカスタマイズを拡張していくと、1つのイベントだけでは機能を実現できず、複数回kintone.events.onを使ってイベントを登録しないといけない場合も出てくると思います。そういった場合のJavaScriptファイルの記述方法を紹介します。

1つのJavaScriptファイルに複数のkintone.events.onを登録する


kintone で作成できるアプリには様々なフィールドが存在し、その全てにフィールド名とフィールドコードを割り振る必要があります。

フィールド名は主にユーザーが見える部分に、フィールドコードは主にアプリ管理者および JavaScript で参照するために使用します。

今回はフィールドコードの命名規則と、私が JavaScript 上でフィールドコードを使用する際に気を付けていることを紹介します。

## この記事のまとめ

- JavaScript は日本語の変数名を許容しているので、日本語でもかまわない。
- チームでルールを決めることが大切
- 基本的にはフィールド名と合わせるべき

## 正解はない

_命名規則については、kintone のガイドラインに明記されていません。_

_JavaScript は変数名を日本語で定義することを制限していません。_

上記の 2 点から命名について、必ずこうしましょう。という正解はありません。

みなさんのやりやすいようにやるのが良いでしょう。エラーが出ないわけですし。

## 大切なのは統一していること

正解はありませんが、明らかに不正解と言えるものはいくつかあると思います。

その一つがチームで開発している場合に、各メンバーの命名ルールが統一されていないことです。

- フィールド名に対応する英語にする。
- フィールド名と同じ日本語にする。
- 一意になるキーと名前を組み合わせる。

いずれにしても、命名ルールを共有して統一していることが大切だと思います。

## フィールド名と合わせるのがいいと思う

ここからは私が使用しているルールにそった個人的な意見になりますが、例えばフィールドの名前が「顧客名」であれば、フィールドコードは「顧客名」でいいと思います。

理由としてはいくつかありますが、

- developer network でそのルールを使用しているサンプルが多い。
- フィールド名と対応するフィールドコードを確認しやすい。
- コーディングしない人もフィールドコードを管理しないといけないことがある。

などでしょうか。

## JavaScript で気を付けていること

前述しましたが、JavaScript では日本語を変数名に使うことが特に制限されていません。
ただ私がコード上でフィールドコードを使う際は、いくつか気を付けていることがあります。
注意点をいくつか紹介します。

### プロパティのつなげ方

record オブジェクトから各フィールドデータを取得する際は以下のように行うようにしています。

```javascript
const { record } = kintone.app.record.get();

// OK: このように書く
record['コード1'].value;

// NG: このようには書かない
record.コード1.value;
```

developer network でよくこの書き方をする方が多かったので、このようにしています。

### 分割代入を使わない

分割代入を使うことで、各フィールドコードを以下のようにまとめて変数に代入できるんですが、これはやらないようにしています。

```javascript
const { record } = kintone.app.record.get();

// NG: 日本語が直接変数になることを避ける
const { コード1, コード2 } = record;

if (コード1.value === 'フィールドのデータ') {
  console.log(コード1.value);
} else {
  console.log(コード2.value);
}

// N/A: ちょっと微妙
const { コード1: code1, コード2: code2 } = record;

// OK: 素直に書く
const code1 = record['コード1'];
const code2 = record['コード2'];
```

record 以下に日本語のプロパティがいるのはギリギリ許容できますが、日本語の変数がそのままオブジェクトとしていることにどうしても違和感があるので使わないようにしています。

文法として間違ってはいないため、この方が分かりやすいと思う方は積極的に使っても良いと思います。


kintoneで作成できるアプリには様々なフィールドが存在し、その全てにフィールド名とフィールドコードを割り振る必要があります。フィールド名は主にユーザーが見える部分に、フィールドコードは主にアプリ管理者およびJavaScriptで参照するために使用します。今回はフィールドコードの命名規則と、私がJavaScript上でフィールドコードを使用する際に気を付けていることを紹介します。

kintoneのフィールドコードの命名規則と、JavaScript上で使用する際に気を付けること


この記事は、kintone で JavaScript カスタマイズを始めようとされている中でも、JavaScript に詳しくない、またはほとんど触ったことのない方向けの内容になります。

JavaScript そのものの入門記事については、私より詳しい方が解説したものがたくさんあると思いますので、基礎的な変数定義や関数についてはここでは割愛致します。

JavaScript の基礎を押さえていただいた上で、kintone でよく利用するコードやイベントなどを解説していきます。

## javascript ファイルの構造

javascript ファイルを取り込む際、多くの場合、以下のような構造になります。

```javascript
// サンプル：画面上の特定のフィールドを非表示にする
(() => {
  'use strict';
  /** JavaScriptを実行する対象となるイベント */
  const events = ['app.record.create.show', 'app.record.detail.show', 'app.record.edit.show'];
  // 処理をイベントに登録します
  kintone.events.on(events, (event) => {
    // 対象項目を非表示にします
    kintone.app.record.setFieldShown('文字列__1行__0', false);
    kintone.app.record.setFieldShown('文字列__1行__1', false);
    kintone.app.record.setFieldShown('文字列__1行__2', false);

    return event;
  });
})();
```

全体をざっくりと説明すると、以下の通りです。

```javascript
// ↓ 定義した変数の使用できる範囲を限定する(おまじない)
(() => {
  // ↓ エラーを気付きやすくする(おまじない)
  'use strict';

  // ↓ 定義した処理が実行されるタイミングを指定
  const events = ['...'];

  // ↓ 処理をあらかじめ登録しておく
  kintone.events.on(events, (event) => {
    // --------------------------------------
    // ⛅ 実際の処理はここに記載 ⛅
    // --------------------------------------

    return event;
  });
})();
```

全体を覆っている`(() => .... })();`の部分と`'use strict;'`に関しては、「カスタマイズを行う際は必ず記載する」という認識で問題ありません。

それぞれ重要な役割がありますが、覚える優先度は低いです。

`(() => .... })();`はこのページの最後で説明しているので、気になる方は先にご覧ください。

このページでは、前述したコードを例として解説を進めていきます。

### kintone.events.on について

kintone の javascript カスタマイズを使う上で欠かせないのが kintone.events.on 関数です。これは、_アプリのどの画面で javascript を適用したいかを設定することができます。_

kintone.events.on を使用せず、そのまま記述することもできますが、そうした場合は、対象アプリのあらゆる画面で javascript が適用されます。

「編集画面でだけ動作させたい」

「印刷時の画面レイアウトだけ修正したい」

など、部分的に適用させるためにも、余分な負荷をかけないためにも、kintone.events.on 関数の使用は javascript カスタマイズを行う上で重要となります。

具体的な使い方の紹介です。

```javascript
kintone.events.on(events, func);
```

- events (文字列または配列) : 後述する関数を実行させたい画面を指定します。
- func (関数) : events で指定した画面で実際に実行する関数を指定します。

javascript は記述方法の自由度が高いので、一度変数に定義してから関数を実行しても良いですし、リテラルと無名関数を利用しても良いです。

```javascript
// 変数に定義する場合
(() => {
  'use strict';

  /** JavaScriptを実行する対象となるイベント */
  const events = ['app.record.create.show', 'app.record.detail.show', 'app.record.edit.show'];

  const func = (event) => {
    // 対象項目を非表示にします
    kintone.app.record.setFieldShown('文字列__1行__0', false);
    kintone.app.record.setFieldShown('文字列__1行__1', false);
    kintone.app.record.setFieldShown('文字列__1行__2', false);

    return event;
  };
  // 処理をイベントに登録します
  kintone.events.on(events, func);
})();
```

```javascript
(() => {
  'use strict';

  kintone.events.on(
    ['app.record.create.show', 'app.record.detail.show', 'app.record.edit.show'],
    (event) => {
      // 対象項目を非表示にします
      kintone.app.record.setFieldShown('文字列__1行__0', false);
      kintone.app.record.setFieldShown('文字列__1行__1', false);
      kintone.app.record.setFieldShown('文字列__1行__2', false);

      return event;
    }
  );
})();
```

上記 2 点より、大枠の即時関数と、events.on 関数は定型的に使用して、その中でコードを記述する。という認識で問題ないかと思います。以下のコードを使いまわすイメージです。

```javascript
(() => {
  'use strict';

  // ↑↑これ以前は常にコピペ↑↑

  /** JavaScriptを実行する対象となるイベント */
  const events = [
    // ここに実行したい画面(トリガー)
  ];

  const func = function (event) {
    // ここに実行したいコード
  };

  // ↓↓これ以降は常にコピペ↓↓

  // 処理をイベントに登録します
  kintone.events.on(events, func);
})();
```

## アプリレコードの各フィールドの操作について

JavaScript カスタマイズが必要となるのは、多くの場合レコード内の特定のフィールドを操作したい時になると思います。

JavaScript から現在のレコード情報を取得する方法は主に以下の 3 つです。

1. kintone.events.on のコールバック関数に含まれる引数から取得する
2. kintone.app.record.get から取得する
3. REST API を使って取得する

今回は 1 と 2 について説明します。

### kintone.events.on のコールバック関数から取得する

kintone の第二引数に指定するコールバック関数では、引数としてオブジェクトを取得できます。

このオブジェクトでは、実行時点のレコード情報をはじめ、様々な環境情報を取得することができます。

以下のコードでは、受け取ったオブジェクトから実行時点のレコード情報を取得しています。

```javascript
kintone.events.on('app.record.edit.show', (event) => {
  /** 実行時点のレコード情報 */
  const currentRecord = event.record;

  return event;
});
```

取得したレコードの各フィールドの値を修正することで、変更が反映されます。

```javascript
kintone.events.on('app.record.edit.show', (event) => {
  /** 実行時点のレコード情報 */
  const currentRecord = event.record;

  currentRecord['文字列__1行__0'].value = 'JavaScriptによって変更されました';

  return event;
});
```

:::caution 変更が反映されるタイミング

注意が必要なのは、変更が反映されるのは、*コールバック関数から受け取った引数が返却されたタイミング*だというところです。

ですので前述のコードでいうと、return event;を記述していないと変更が反映されません。

:::

### kintone.app.record.get から取得する

次に、kintone.app.record.get()を使用して取得するケースです。こちらは主に、_イベントを登録したタイミングとは別のタイミングのレコードを取得する際に使用します。_

以下のコードは、レコード編集時にスペースフィールドにボタンを設置し、ボタンがクリックされた際に処理を動かすサンプルです。

```javascript
kintone.events.on('app.record.edit.show', (event) => {
  /** 設置するボタン */
  const button = document.createElement('button');

  /** アプリ設定で作成したスペース情報 */
  const space = kintone.app.record.getSpaceElement('space_id');

  // ボタンを設置
  space.append(button);

  // ボタンクリック時のイベントを登録
  button.addEventListener('click', (clickEvent) => {
    // ボタンクリック時点のレコードを取得
    const current = kintone.app.record.get();

    // フィールドを修正
    current.record['文字列__1行__0'].value = 'JavaScriptによって変更されました';

    // 変更を適用
    kintone.app.record.set(current);
  });

  return event;
});
```

## サンプルコード

「じゃあやりたいことを実現するためにはどうすればいいの？」となってしまわないよう、いくつか具体的なサンプルコードを用意しました。

[レコード編集時のサンプルコード集](/blog/kintone/app-record-edit-show)

[レコード一覧表示時のサンプルコード集](/blog/kintone/app-record-index-show)

### コード全体を覆っているファンクション

コード全体を覆っている、

```javascript
(() => {
  //・・・略・・・
})();
```

の部分について説明します。_これは即時関数と言い、書かなくても挙動に影響はありません。_

なぜ記述するのかというと、kintone には今回利用する javascript API の他にも、標準で動作している javascript など複数の js ファイルが動作しています。

そのため、複数 js 間で同じ変数・定数が定義されていると、定義が重複してしまい予期しない動作になる危険性があります。

即時関数は書かなくても動作しますが、書いておくことで、_その中で定義された変数・定数のスコープを限定することができます。_

これにより、いわゆるグローバル汚染を避けることができ、それぞれの js ファイルが想定される動作を実現することができます。

また、即時関数については、別の記事でも詳細をまとめておりますので、詳しく知りたい方はご一読ください。

[Javascript の即時関数と省略記法【先頭の！やカッコの意味】](/blog/javascript-iife)


実用的なサンプルを交えながら、kintoneにおけるJavaScriptカスタマイズの使い方を紹介します。基本的なプログラムの構造から、スペースフィールドにボタンを設置する方法までを解説しています。

kintoneで始めるjavascript入門【全体の構造、events onの紹介】

kintone で JavaScript カスタマイズを利用する場合、組み込む JavaScript を直接記述することもできますが、Node.js を活用することで、kintone で利用できる様々なモジュールを使用することができます。

[@kintone/rest-api-client](https://www.npmjs.com/package/@kintone/rest-api-client)もその一つで、サイボウズ株式会社が公式に開発している、REST API を使いやすくするためのモジュールです。

今回は REST API Client を活用するうえで、私が注意しているポイントを紹介します。

## シングルトンで使う

REST API Client を使用する際、以下のようにクラスをモジュールからインポートし、新しいインスタンスを作成して利用します。

```javascript
import { KintoneRestAPIClient } from '@kintone/rest-api-client';

const client = new KintoneRestAPIClient({
 baseUrl: https://xxxxxxxx.cybozu.com,
 auth: {
 username: xxxxxxxxxxxx,
 password: xxxxxxxxxxxx,
 },
});

const response = await client.record.getAllRecordsWithCursor({ app: 16 });
```

ただ実装したい機能の中で、複数のアプリから繰り返しレコードを取得や更新したい場合もあるかと思います。

API トークンを使用する場合はアプリの数だけインスタンスを作成する必要がありますが、パスワードを使用する場合、インスタンスをシングルトンとして定義しておく方法が使いやすいです。

`kintone-api-client.js`のようなファイルを 1 つ作成し、インスタンスをエクスポートするコードだけ記述します。

[dotenv](https://github.com/motdotla/dotenv)で環境変数を定義しておくと便利だと思います。

```javascript
import { KintoneRestAPIClient } from '@kintone/rest-api-client';

// ユーザー名とパスワードを使用する場合
export const kintoneClient = new KintoneRestAPIClient({
 baseUrl: process.env.KINTONE_BASE_URL,
 auth: {
 username: process.env.KINTONE_USERNAME,
 password: process.env.KINTONE_PASSWORD,
 },
});

// APIトークンを活用する場合
export const kintoneClient = new KintoneRestAPIClient({
 baseUrl: process.env.KINTONE_BASE_URL,
 auth: { apiToken: process.env.KINTONE_API_TOKEN },
});
```

実際に使う際に、先ほど定義したファイルからインスタンスをインポートします。

```javascript
import { kintoneClient } from './kintone-api-client';

const response = await kintoneClient.record.getAllRecordsWithCursor({ app: 16 });
```

## ゲストスペースに対応する

kintone REST API はゲストスペースにも対応しており、コンストラクタの引数に`guestSpaceId`を指定することで、対象ゲストスペースにアクセスできます。

あくまで実行される場所がゲストスペースであることが前提ですが、ゲストスペースを自動判定する方法を紹介します。

:::caution

自動判定ロジックは公式に提供されているものではないため、アップデートにより動作しなくなる可能性があります。

:::

TypeScript で記述していますが、JavaScript の場合は`ConstructorParameters<typeof KintoneRestAPIClient>`を削除してください。

```javascript
import { KintoneRestAPIClient } from '@kintone/rest-api-client';

class FlexKintone extends KintoneRestAPIClient {
 constructor(...options: ConstructorParameters<typeof KintoneRestAPIClient>) {
 const url = kintone.api.url('/k/v1/app', true);
 const found = url.match(/k\/guest\/([0-9]+)\//);

 if (found && found.length > 1) {
 super({
 guestSpaceId: found[1],
 ...(options[0] || {}),
 });
 return;
 }

 super(...options);
 }
}
```

REST API Client を活用するうえで、私が注意しているポイントを紹介します。

Node.js環境でのREST API Clientの便利な使い方【kintone】

kintone では現在、[フロントエンド基盤の刷新](https://jp.cybozu.help/k/ja/admin/new_feature/changes_design_layout.html)が進んでいます。

これに伴い、僕が開発したプラグインにどのような影響があり、どのような対処が必要なのかをまとめます。

完全に UI が刷新されるまで、都度更新していきます。

:::caution

このページで評価している対応状況は、あくまで現時点までで分かっている情報をもとに影響範囲を予測しています。

プロジェクトの進捗により、対応状況に変化がある可能性があります。

また、実際に導入された際に、想定しない互換性の不具合が発生する可能性があることにご注意ください。

:::

## プラグインと想定される影響の一覧

| プラグイン | 対応 |
| :----------------------------------------- | :-------------------------------------------------------------------- |
| 高速一覧検索・絞り込みプラグイン | 対応済み。ユーザー側で対応が必要な可能性有り |
| タブ表示プラグイン | 一部の機能が動作しなくなる可能性有り |
| 年齢自動計算プラグイン | 影響無し |
| Excel 出力プラグイン | 影響無し |
| 同一アプリ(自アプリ)ルックアッププラグイン | 一部の機能が動作しなくなる可能性有り |
| フィールドデータコピープラグイン | 影響無し |
| 動的入力制御プラグイン | 影響無し |
| 関連付けないルックアッププラグイン | 一部の機能が動作しなくなる可能性有り |
| スライダープラグイン | 一部の機能が動作しなくなる可能性有り |
| マークダウンエディタ | 一部の機能が動作しなくなる可能性有り |
| ツールチップ プラグイン | 一部の機能が動作しなくなる可能性有り |
| カレンダープラグイン | 機能に影響無し。UI に問題が生じる可能性有り |
| タグ付けプラグイン | 一部の機能が動作しなくなる可能性有り |
| リアルタイムテーマ変更プラグイン | 影響無し |

## 高速一覧検索・絞り込みプラグイン

:::caution 変更に伴う影響

レコード一覧表示に影響する可能性があります。

:::

フロントエンド刷新によって、設定したレコード一覧にテーブルがレンダリングされない可能性があります。

既に問題は解決済みですが、プラグインを設定してからしばらく経過しているアプリでは対応前の状態が保存されているため、影響する可能性があります。

当プラグインを実装されているアプリそれぞれについて、プラグイン設定から再度「設定を保存」ボタンを押していただくことで、修正後の設定に更新されます。

## タブ表示プラグイン

:::caution 変更に伴う影響

一部の機能が動作しなくなる可能性があります。

:::

レコード詳細、レコード編集・追加画面で動作するプラグインですが、スクロールに追従して表示させるため、レコードの領域を JavaScript API ではない方法で取得しています。

フロントエンド刷新によって DOM の構造が変わり、タブがレンダリングできなくなる可能性があります。

## 年齢自動計算プラグイン

:::tip 変更に伴う影響

現時点で影響は確認されていません

:::

## Excel 出力プラグイン

:::tip 変更に伴う影響

現時点で影響は確認されていません

:::

## 同一アプリ(自アプリ)ルックアッププラグイン

:::caution 変更に伴う影響

一部の機能が動作しなくなる可能性があります。

:::

レコード編集・追加時、設定したフィールドを独自のルックアップフィールドに置き換えていますが、この際に JavaScript API ではない方法で取得しています。

フロントエンド刷新によって DOM の構造が変わり、フィールドがレンダリングできなくなる可能性があります。

どのように修正すべきかについては、テスト機能としてレコード編集・追加画面にも新 UI を適用できるようになり次第決定することになります。

## フィールドデータコピープラグイン

:::tip 変更に伴う影響

現時点で影響は確認されていません

:::

## 動的入力制御プラグイン

:::tip 変更に伴う影響

現時点で影響は確認されていません

:::

## 関連付けないルックアッププラグイン

:::caution 変更に伴う影響

一部の機能が動作しなくなる可能性があります。

:::

レコード編集・追加時、設定したフィールドを独自のルックアップフィールドに置き換えていますが、この際に JavaScript API ではない方法で取得しています。

フロントエンド刷新によって DOM の構造が変わり、フィールドがレンダリングできなくなる可能性があります。

どのように修正すべきかについては、テスト機能としてレコード編集・追加画面にも新 UI を適用できるようになり次第決定することになります。

## スライダープラグイン

:::caution 変更に伴う影響

一部の機能が動作しなくなる可能性があります。

:::

レコード編集・追加時、設定したフィールドを独自のスライダーフィールドに置き換えていますが、この際に JavaScript API ではない方法で取得しています。

フロントエンド刷新によって DOM の構造が変わり、フィールドがレンダリングできなくなる可能性があります。

どのように修正すべきかについては、テスト機能としてレコード編集・追加画面にも新 UI を適用できるようになり次第決定することになります。

## マークダウンエディタ

:::caution 変更に伴う影響

一部の機能が動作しなくなる可能性があります。

:::

レコード編集・追加時、設定したフィールドを独自のマークダウンエディタに置き換えていますが、この際に JavaScript API ではない方法で取得しています。

フロントエンド刷新によって DOM の構造が変わり、エディタがレンダリングできなくなる可能性があります。

どのように修正すべきかについては、テスト機能としてレコード編集・追加画面にも新 UI を適用できるようになり次第決定することになります。

## ツールチップ プラグイン

:::caution 変更に伴う影響

一部の機能が動作しなくなる可能性があります。

:::

レコード一覧表示またはレコード編集・追加時、設定したフィールドの近くにアイコンを設置していますが、この際に JavaScript API ではない方法で取得しています。

フロントエンド刷新によって DOM の構造が変わり、アイコンがレンダリングできなくなる可能性があります。

どのように修正すべきかについては、テスト機能としてレコード編集・追加画面にも新 UI を適用できるようになり次第決定することになります。

## カレンダープラグイン

:::tip 変更に伴う影響

現時点で影響は確認されていません

:::

## タグ付けプラグイン

:::caution 変更に伴う影響

一部の機能が動作しなくなる可能性があります。

:::

レコード編集・追加時、設定したフィールドを独自の入力フィールドに置き換えていますが、この際に JavaScript API ではない方法で取得しています。

フロントエンド刷新によって DOM の構造が変わり、フィールドがレンダリングできなくなる可能性があります。

どのように修正すべきかについては、テスト機能としてレコード編集・追加画面にも新 UI を適用できるようになり次第決定することになります。

## リアルタイムテーマ変更プラグイン

:::tip 変更に伴う影響

現時点で影響は確認されていません

:::

kintone のフロントエンド基盤の刷新に伴い、当方プラグインで想定される影響を紹介します

フロントエンド刷新に伴うプラグインの影響【kintone】


@[chat](Windowsによく分からないアプリがたくさん入ってる・・・)
@[json]({ "type": "chat", "name": "AI コーギー", "img": "/img/corgi-chat.webp", "position": "right", "message": "なにそれ気になる w"})
@[chat](メーカー製のアプリとか、スポンサーのアプリとか)
@[json]({ "type": "chat", "name": "AI コーギー", "img": "/img/corgi-chat.webp", "position": "right", "message": "間違いないー!健康になってくれたらこっちも考えてくれるのに"})
@[chat](健康？)
@[json]({ "type": "chat", "name": "AI コーギー", "img": "/img/corgi-chat.webp", "position": "right", "message": "健康だよー!w たまに筋トレするけどさすがに行く気にならんくなったんよね"})
@[chat](健康は大事だね)
@[json]({ "type": "chat", "name": "AI コーギー", "img": "/img/corgi-chat.webp", "position": "right", "message": "健康に暮らしたい!幸せなママになりたいっ"})

話がそれてしまいましたが、皆さんは購入してすぐの PC を操作していて、よくわからないアプリが次々と立ち上がってきて、どれを消していいのか分からなくなったことはないでしょうか。

BTO などで購入した PC であればクリーンな状態で納品されることもありますが、メジャーなメーカー製のノート PC であれば、多くの場合そのメーカー製のアプリや、スポンサーのアプリが最初からインストールされていることがあります。

今回はそういった不要なアプリを削除して、PC を軽快に立ち上げるための方法を紹介します。

## とりあえず立ち上がらないようにしておきたい場合

![通行止めの画像](//images.unsplash.com/photo-1660620942289-9416dac07d72?ixlib=rb-1.2.1&ixid=MnwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8&auto=format&fit=crop&w=936&q=70)

まず最初に、不必要なアプリが立ち上がらないように設定する方法を紹介します。

アプリがインストールされたままでも、PC 起動と同時に立ち上がらなければ大きな影響はないので、まずはこちらを試していただくのが良いかと思います。

### 設定アプリを開く

まず、Windows キーを押して、スタートメニューに「設定」と入力します。

設定アプリが候補にでてくるので、設定アプリを開きましょう。

![「設定」と検索して、設定アプリを開く](/img/blog/remove-preinstall-apps1.webp)

### スタートアップ アプリを開く

設定アプリの検索画面に、「スタートアップ」と入力します。

候補にでてくる「スタートアップ アプリ」を選択します。

![設定アプリから、スタートアップアプリを開く](/img/blog/remove-preinstall-apps2.webp)

### スタートアップの設定をする

ここが目的の画面です。

一覧に表示されている、スイッチが ON になっているアプリが、PC 起動と同時に立ち上がるアプリです。

必須となるのはドライバー関係とセキュリティソフトぐらいなので、それ以外の不要なアプリは OFF にしておけば、PC 起動時に煩わしい思いをすることはなくなります。

![スタートアップアプリを選択する](/img/blog/remove-preinstall-apps3.webp)

## アプリをアンインストールする

起動しなくするだけではなく、PC から削除してしまいたい場合は、対象アプリをアンインストールする必要があります。

Windows11 になり、アンインストールしたいアプリが一覧に表示されなくなる場合があります。

そのため、コントロールパネルを使った方法と、設定アプリを使った方法それぞれ紹介します。

消したいアプリが見つからない場合は、いずれかのアプリに存在する可能性がありますので、ご確認ください。

### ショートカットの削除

デスクトップにあるアプリやスタートメニューに存在するアプリは、実はインストールされておらず、クリックして初めてインストールされるタイプもあります。

特にメーカー製の PC ではこのパターンが多いです。

アンインストールの前に、このショートカットを削除しておきましょう。

デスクトップの場合は直接削除、スタートメニューの場合は、以下のフォルダに表示されているアプリがあります。

```shell
C:\ProgramData\Microsoft\Windows\Start Menu
```

### コントロールパネルからアンインストールする

Windows キーを押して、スタートメニューに「control」と入力します。

コントロールパネルが候補にでてくるので、選択して起動しましょう。

![スタートアップアプリを選択する](/img/blog/remove-preinstall-apps4.webp)

項目一覧から、プログラム → プログラムのアンインストールと進みます。

![スタートアップアプリを選択する](/img/blog/remove-preinstall-apps5.webp)

## 上級編: Windows 標準のアプリを Power Shell を使って削除する

最後に、使わないアプリは標準機能であっても許さないという、断固たる決意を持つ読者様向けの情報です。

通常のアンインストール操作では削除することのできない、Windows に標準搭載している機能も、管理者権限の Power Shell を使うことで削除することが可能です。

標準搭載アプリの削除方法を以下にまとめています。

Power Shell を開き削除したいアプリのコマンドを実行してください。

```shell
# 3Dビューアー
Get-AppxPackage Microsoft.Microsoft3DViewer | Remove-AppxPackage
# Cortana
Get-AppxPackage Microsoft.549981C3F5F10 | Remove-AppxPackage

# ゲーム系
# Candy Crush Friends
Get-AppxPackage king.com.CandyCrushFriends | Remove-AppxPackage
# Farm Heroes Saga
Get-AppxPackage king.com.FarmHeroesSaga | Remove-AppxPackage

# モバイル通信プラン
Get-AppxPackage Microsoft.OneConnect | Remove-AppxPackage
# メッセージング
Get-AppxPackage Microsoft.Messaging | Remove-AppxPackage
# メール（カレンダー）
Get-AppxPackage microsoft.windowscommunicationsapps | Remove-AppxPackage
# マップ
Get-AppxPackage Microsoft.WindowsMaps | Remove-AppxPackage
# ボイスレコーダー
Get-AppxPackage Microsoft.WindowsSoundRecorder | Remove-AppxPackage
# ペイント3D
Get-AppxPackage Microsoft.MSPaint | Remove-AppxPackage
# 付箋
Get-AppxPackage Microsoft.MicrosoftStickyNotes | Remove-AppxPackage
# フォト
Get-AppxPackage Microsoft.Windows.Photos | Remove-AppxPackage
# フィードバックHub
Get-AppxPackage Microsoft.WindowsFeedbackHub | Remove-AppxPackage
# ヒント
Get-AppxPackage Microsoft.Getstarted | Remove-AppxPackage
# 電卓
Get-AppxPackage Microsoft.GetHelp | Remove-AppxPackage
```

@[chat](部屋もパソコンも綺麗なのが良いね)
@[json]({ "type": "chat", "name": "AI コーギー", "img": "/img/corgi-chat.webp", "position": "right", "message": "でもやっぱりお布団とお友達だよね"})
@[chat](たまには掃除しようね)
@[json]({ "type": "chat", "name": "AI コーギー", "img": "/img/corgi-chat.webp", "position": "right", "message": "言われなくてもします(キッパリ)"})


Windowsにプリインストールされている不必要なアプリや、メーカーPCに付属しているアプリなど、最初から勝手に入っているアプリを削除して、PCの軽快に動作させるための方法を紹介します。

ゴミだらけの初期状態Windowsをきれいにする【重い状態も解決！】

パソコンを選ぶ際にどの部分にお金をかければ良いのか、またどの部分はお金をかける必要がないのかを分かりやすく解説！会計ソフトの使用を含む、会計事務所で行うすべての業務を快適にこなすことが目的であれば、10万円以下のパソコンでも十分に可能です。もちろんOffice付きの端末であってもです。

記事一覧