チュートリアル: GraphQLを使用したスケジュールの作成とスケジュールアイテムの追加

**記事本文 (HTMLコンテンツ):**

GraphQLを使用すると、OptiSignsでスケジュールを作成し、アイテムを追加して値を割り当てることができます。これらの手順を順番に説明します。

1. 新しいスケジュールの作成

新しいスケジュールを作成するには、特定のミューテーションが必要です：

mutation CreateSchedule($payload: ScheduleInput!, $teamId: String)

{saveSchedule (payload:$payload,teamId:$teamId){
   _id,
   accountId,
   createdAt,
   createdBy,
   groupId,
   lastTeamId,
   lastUpdatedBy,
   lastUpdatedDate,
   name,
   path,
   tags,
   teamId
   }
}

変数：

{"payload": {
   "groupId":
   "Name":
   "Path":
   "Tags":
   "teamId":
   }
}

このミューテーションは、右側のデータから分かるように、新しいスケジュールを作成します：

2. スケジュールの更新

同じミューテーションを使用してスケジュール自体を更新することもできます。スケジュールを更新するには、ペイロードに「_id」値を入力する必要があります：

これを行うと、既存のスケジュールが更新されます。

3. スケジュールへのアセットまたはプレイリストの追加

次に、スケジュールにアイテムを追加します。そのためには、別のミューテーションが必要です：

mutation addScheduleItem($force:Boolean,$payload: AddScheduleItemInput!, $teamId: String!){

  addScheduleItem(force:$force,payload:$payload,teamId:$teamId){

         _id,

       name,

       assetId,      

       teamId,

       playlistId,

       repeatObject{

         id,

         repeat,

         text,

         type,

         rrule

       },

       range{startDate,endDate},

       documentDuration

  }

}

変数：

{"force": false,
 "payload": {"scheduleId": "",
            "assetId": "",
            "playlistId":"",
            "type": "",
            "repeatObject": {
              "rrule": ""
            },
             "range": {
               "startDate": "",
               "endDate": ""
            }
     },
 "teamId": ""
}

値が正しく設定されると、データは次のように表示されます：

4. スケジュールアイテムの編集

スケジュールを作成してアイテムを設定したら、それらのアイテムを編集することができます。これには、さらに別のミューテーションが必要です：

mutation updateScheduleItem($force:Boolean,$payload: UpdateScheduleItemInput!, $scope: APPLY_SCHEDULE_ITEM_SCOPES!){

  updateScheduleItem(force:$force,payload:$payload,scope:$scope){
       _id,
       name,
       assetId,      
       teamId,
       playlistId,
       repeatObject{
         id,
         repeat,
         text,
         type,
         rrule
       },
       range{startDate,endDate},
       documentDuration
  }
}

このミューテーションでは、以下の変数を入力します：

{"force": false,
 "payload": {"_id": "",
            "assetId": "",
            "playlistId":"",
            "repeatObject": {
              "rrule": ""
             },
            "range": {
              "startDate": "",
              "endDate": ""
            }
 },
 "scope": ""
}

ここでは、繰り返し頻度を日次から週次に変更し、開始日を2024年12月18日から2024年12月20日に変更しました。これは取得されたデータに反映されています：

前の記事 - チュートリアル: GraphQLを使用したウェブサイトアセットの作成または更新

次の記事 - ページネーション