ビュー
関数
createReviewRequest

createReviewRequest

createReviewRequest は、アクションのレビュー依頼を作成する関数です。

※レビュー依頼を作成するには、事前に対象のアクションにレビュー設定が必要です。

基本的な使い方

import {
  createReviewRequest,
  showSuccessToast,
  showErrorToast,
  Form,
  VStack,
  Box,
  TextInput,
  Checkbox,
  DateTimePicker,
  Button,
} from "@basemachina/view";
 
const App = () => {
  const initialValues = {
    // アクションの引数
    message: "",
    // 以下、createReviewRequest関数のオプション
    redirect: true,
    description: "",
    neverExpires: false,
    expiresIn: null,
  };
 
  const handleSubmit = async ({ values }) => {
    const { message, redirect, description, neverExpires, expiresIn } = values;
    try {
      const { reviewRequestId } = await createReviewRequest(
        // actionId
        "review-test",
        // args
        { message },
        // options
        { redirect, description, neverExpires, expiresIn },
      );
      showSuccessToast(`レビュー依頼: ${reviewRequestId} を作成しました`);
    } catch (err) {
      showErrorToast(err.message);
    }
  };
 
  return (
    <Form initialValues={initialValues} onSubmit={handleSubmit}>
      <VStack>
        <Box>
          <TextInput name="message" label="メッセージ" />
        </Box>
        <Box>
          <TextInput name="description" label="レビューの説明" />
        </Box>
        <Checkbox name="redirect" label="自動でレビュー依頼に遷移する" />
        <Checkbox name="neverExpires" label="レビューを無期限にする" />
        <Box>
          <DateTimePicker name="expiresIn" label="レビュー期限" />
        </Box>
        <Button type="submit" title="レビュー依頼を作成する" color="blue" />
      </VStack>
    </Form>
  );
};
 
export default App;

詳細なインターフェース

引数

引数名必須 ・ 任意説明
actionIdstring必須実行するアクションのID、または識別子。'c3hc2ii23akg0sokf9j0', 'get-user'
argsobject任意アクションを実行するための引数で、 キーがパラメータ名、値がパラメータに渡す値のオブジェクト。{ username: 'JohnDoe' }
optionsobject任意レビュー依頼の詳細設定。{ description: 'レビュー依頼の説明' }
options.descriptionstring任意レビュー依頼の説明。最大文字数は1000文字です。'レビュー依頼の説明'
options.neverExpiresboolean任意レビュー依頼の期限を無期限に指定します。 expiresIn と同時に指定することはできません。true, false
options.expiresInDate | string | number任意レビュー依頼の期限。stringDate型に変換できる値、numberはUnixTimestamp (秒)を入力してください。時間は過去に設定できません。また、neverExpires と同時に指定できません。new Date(), '2023-01-01', 1609459200
options.redirectboolean任意レビュー依頼の作成後に、自動的にレビュー依頼詳細画面へ移動する設定。true, false

なおパラメータの入力値の種類ごとにargsへ渡せる値の型は以下です。

入力値の種類説明
テキストstring-{ company_name: '株式会社ベースマキナ' }
数値number | null-{ user_id: 123 }
日付Date | string | number | nullstringDate型に変換できる値、numberはUnixTimestamp (秒)を入力してください。{ created: '2023-01-01', updated: new Date(), deleted: 1609459200 }
ファイルFile | null-{ upload_text: new File(['test'], 'test.txt', { type: 'text/plain' }) }
真偽値boolean-{ checked: true }
JSON値string | number | Date | nullJSON値の種類ごとに型が異なります。
テキストならstring | null、数値ならnumber | null、日付ならstring | number | Date | nullを渡せます。
日付の場合stringDate型に変換できる値、numberはUnixTimestamp (秒)を入力してください。 
{ company_name: '株式会社ベースマキナ', user_id: 123, created: '2023-01-01', deleted: null }
SQLstring-{ query: 'SELECT * FROM users;' }
システム値string-{ offset: '20' }
配列Array各要素の種類の型は、各入力値の種類の型と同じです。{ user_ids: [10, 11, 12] }
タプルArray各要素の種類の型は、各入力値の種類の型と同じです。{ id_and_name: [123, 'taro'] }

戻り値

プロパティ名説明
reviewRequestIdstring作成したレビュー依頼のID。cpt8gkab5gv1ibk8r5h0