レコードを作成する
このピースでできること楽楽販売 の接続方法ステップ 1：接続に必要な情報を準備するステップ 2：workrun に接続を追加するピースの設定項目1. DBスキーマID（必須）2. 登録する値（必須）3. キー項目の登録モード（任意）4. 承認フローID（任意）5. 従属項目を取得する（任意）
このピースでできること
- 楽楽販売の指定したデータベース（DB）にレコードを1件新規登録します。
- 項目IDと値のペアを複数指定することで、柔軟に各フィールドに値を登録できます。
- 承認フローやキー項目の採番モードなど、登録オプションも設定できます。
楽楽販売 の接続方法
workrun と楽楽販売を接続するには、楽楽販売の APIトークン および ドメイン・アカウント情報 が必要です。
ステップ 1：接続に必要な情報を準備する
- 楽楽販売で 「API連携オプション」 を契約します。
- 楽楽販売の管理者設定で、workrun のサーバーIPアドレスをIPアクセス制限に登録します。
- 「管理者設定 > セキュリティ設定タブ > IPアクセス制限に関する設定」を開きます。
- ヘルプページ に記載されているIPアドレスを登録してください。
- APIトークンを発行します。
- 「管理者設定 > ユーザ設定タブ > ユーザ管理 > 設定」でユーザー設定画面を開きます。
- APIトークン欄の 「生成」 をクリックし、続けて 「確定」 ボタンをクリックします。
- ⚠️「生成」しただけで「確定」を押していないトークンは無効です。必ず「確定」まで行ってください。
- 楽楽販売のURLからドメインとアカウントを確認します。
- 例: の場合
- ドメイン:
- アカウント:
ステップ 2：workrun に接続を追加する
- workrun で楽楽販売のアクションをフローに追加します。
- 「接続を選択」の横にある 「＋ 新しい接続」 をクリックします。
- 以下の3項目を入力します：
- 「ドメイン」: ステップ 1 で確認したドメイン（例: ）
- 「アカウント」: ステップ 1 で確認したアカウント（例: ）
- 「APIトークン」: ステップ 1 で発行したAPIトークン
- 「保存」 をクリックします。入力した情報で楽楽販売への接続テストが自動で実行され、成功すると接続が完了します。
ピースの設定項目
1. DBスキーマID（必須）
- 登録先データベースのIDを入力します。
- 楽楽販売の「管理者設定 > メンテナンス機能 > APIパラメータ情報」で「レコード登録API」と対象データベースを選ぶと確認できます。
2. 登録する値（必須）
- 登録したい項目IDと値のペアを一行ずつ追加します。
- 項目IDは「管理者設定 > メンテナンス機能 > APIパラメータ情報」で「レコード登録API」と対象データベースを選び「DB項目の項目IDと値（values）」で確認できます。
- DBの項目設定で必須としている項目は必ず入力してください。
- 複数選択の項目は値を｜で区切って入力します（例：A|B）。値が1つだけの複数選択項目は末尾に｜を付けてください（例：A|）。
- ユーザ選択肢の値はユーザー名を入力します。
- 明細行（details）は入力できません。明細を含む場合は「カスタムAPI呼び出し」アクションを使用してください。
3. キー項目の登録モード（任意）
- キー項目の採番方法に「自動採番」「選択肢＋自動採番」「年（西暦）＋自動採番」「年（和暦）＋自動採番」が設定されている場合は必須です。
- 「自動採番を優先」または「入力したキーの値を優先」から選びます。
4. 承認フローID（任意）
- 適用する承認フローのIDを入力します。
- 「管理者設定 > メンテナンス機能 > APIパラメータ情報」で「レコード登録API」と対象データベースを選ぶと確認できます。
- 承認全体設定で承認フローが必須に設定されている場合は、未指定だと登録できません。
5. 従属項目を取得する（任意）
- オンにすると従属項目もレスポンスに含もれます。デフォルトはオフです。