記事を作成する

このピースでできること

  • Runbook で指定したブック配下に新しい記事を作成します。フォルダーやカテゴリーの指定、公開/下書きの選択もできます。

Runbook の接続方法

workrun と Runbook を接続するには、Runbook の サブドメインAPI トークン が必要です。

ステップ 1:API トークンを取得する

  1. Runbook のワークスペースのトップ画面を開きます。
  1. 坓面右上のアイコンから 「ワークスペースの設定」 をクリックします。
  1. 「API トークン」 セクションに進み、トークンを発行します。
  1. 発行された API トークンをコピーしておきます。
      • また、接続時に必要な サブドメイン を確認しておきます。サブドメインはワークスペースの URL(例: )の 部分です。

ステップ 2:workrun に接続を追加する

  1. workrun で Runbook のアクションをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 「サブドメイン」 フィールドに、ステップ 1 で確認したサブドメインを入力します。
  1. 「API トークン」 フィールドに、ステップ 1 でコピーした API トークンを貼り付けます。
  1. 「保存」 をクリックして接続を完了します。

ピースの設定項目

1. ブック(必須)

  • 記事を作成する先のブックをドロップダウンから選択します。接続を設定すると選択肢が自動表示されます。ブックが300件を超える場合は一部のみ表示されます。
[設定例]

2. 記事の名称(必須)

  • 作成する記事のタイトルを入力します。
[設定例]

3. パス名(任意)

  • 記事のURL上のパス名(スラッグ)を半角英数字やハイフンで入力します。省略すると自動生成されます。
[設定例]

4. フォルダーのUID(任意)

  • 記事を配置するフォルダーのUIDを入力します。UIDは「ブック設定 > フォルダーと記事」から対象フォルダーをクリックした画面のURLのfollow=に続く文字列で確認できます。
[設定例]

5. カテゴリー(任意)

  • 記事に設定するカテゴリーをドロップダウンから選択します(複数選択可)。「ブック」を選択した後に選択肢が表示されます。カテゴリーが300件を超える場合は一部のみ表示されます。
[設定例]

6. 記事の本文(マークダウン形式)(任意)

  • 記事の本文をマークダウン形式で入力します。未入力の場合は本文なしの下書きとして作成されます。
[設定例]

7. 公開/下書き(任意)

  • 記事を公開状態で作成するか、下書きで作成するかを選択します。未選択の場合は下書きとして作成されます。「公開」を選択しても、本文が未入力の場合は下書きとして作成されます。
[設定例]