API を使用したサポート Case の表示

以下のサンプル要求に示すように、API を使用してプログラマチックにサポート Case を表示できます。 詳細については、「 ケース管理 API 」を参照してください。

Case を表示するには、以下のサンプルを参照してください。

curl -X GET 'https://support-center.cloud.ibm.com/case-management/v1/cases/{case_number}?fields=number,updated_at,resources' -H 'Authorization: TOKEN' \

GetCaseOptions getCaseOptions = new GetCaseOptions.Builder()
  .caseNumber(caseNumber)
  .addFields(GetCaseOptions.Fields.DESCRIPTION)
  .addFields(GetCaseOptions.Fields.STATUS)
  .addFields(GetCaseOptions.Fields.SEVERITY)
  .addFields(GetCaseOptions.Fields.CREATED_BY)
  .build();
Response<Case> response = service.getCase(getCaseOptions).execute();
Case xCase = response.getResult();
System.out.println(xCase);

const fieldsToReturn = [
  CaseManagementV1.GetCaseConstants.Fields.DESCRIPTION,
  CaseManagementV1.GetCaseConstants.Fields.STATUS,
  CaseManagementV1.GetCaseConstants.Fields.SEVERITY,
  CaseManagementV1.GetCaseConstants.Fields.CREATED_BY,
];
const params = {
  caseNumber: caseNumber,
  fields: fieldsToReturn,
};
caseManagementService.getCase(params)
  .then(res => {
    console.log(JSON.stringify(res.result, null, 2));
  })
  .catch(err => {
    console.warn(err)
  });

fields_to_return = [
  GetCaseEnums.Fields.DESCRIPTION,
  GetCaseEnums.Fields.STATUS,
  GetCaseEnums.Fields.SEVERITY,
  GetCaseEnums.Fields.CREATED_BY,
]
case = case_management_service.get_case(
  case_number=case_number,
  fields=fields_to_return
).get_result()
print(json.dumps(case, indent=2))

getCaseOptions := caseManagementService.NewGetCaseOptions(
  caseNumber,
)
getCaseOptions.SetFields([]string{
  casemanagementv1.GetCaseOptionsFieldsDescriptionConst,
  casemanagementv1.GetCaseOptionsFieldsStatusConst,
  casemanagementv1.GetCaseOptionsFieldsSeverityConst,
  casemanagementv1.GetCaseOptionsFieldsCreatedByConst,
})
caseVar, response, err := caseManagementService.GetCase(getCaseOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(caseVar, "", "  ")
fmt.Println(string(b))

API を使用したサポート Case の更新

以下のサンプル要求は、サポート Case をプログラムで更新する方法を示しています。 詳細については、「 ケース管理 API 」を参照してください。

curl -X PUT '/case-management/v1/cases/{case_number}/status' -H 'Authorization: TOKEN' -d '{
  "action": "resolve",
  "comment": "The issue is resolved. Thank you!",
  "resolution_code": 1
}'

ResolvePayload statusPayloadModel = new ResolvePayload.Builder()
  .action("resolve")
  .comment("The problem has been resolved.")
  .resolutionCode(1)
  .build();
UpdateCaseStatusOptions updateCaseStatusOptions = new UpdateCaseStatusOptions.Builder()
  .caseNumber(caseNumber)
  .statusPayload(statusPayloadModel)
  .build();
Response<Case> response = service.updateCaseStatus(updateCaseStatusOptions).execute();
Case xCase = response.getResult();
System.out.println(xCase);

const statusPayloadModel = {
  action: 'resolve',
  comment: 'The problem has been resolved.',
  resolution_code: 1,
};
const params = {
  caseNumber: caseNumber,
  statusPayload: statusPayloadModel,
};
caseManagementService.updateCaseStatus(params)
  .then(res => {
    console.log(JSON.stringify(res.result, null, 2));
  })
  .catch(err => {
    console.warn(err)
  });

status_payload_model = {
  'action': 'resolve',
  'comment': 'The problem has been resolved.',
  'resolution_code': 1,
}
case = case_management_service.update_case_status(
  case_number=case_number,
  status_payload=status_payload_model
).get_result()
print(json.dumps(case, indent=2))

statusPayloadModel := &casemanagementv1.ResolvePayload{
  Action:         core.StringPtr("resolve"),
  Comment:        core.StringPtr("The problem has been resolved."),
  ResolutionCode: core.Int64Ptr(int64(1)),
}
updateCaseStatusOptions := caseManagementService.NewUpdateCaseStatusOptions(
  caseNumber,
  statusPayloadModel,
)
caseVar, response, err := caseManagementService.UpdateCaseStatus(updateCaseStatusOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(caseVar, "", "  ")
fmt.Println(string(b))

API を使用したサポート Case へのコメントの追加

以下のサンプル要求は、サポート Case にプログラムでコメントを追加する方法を示しています。 詳細については、「 ケース管理 API 」を参照してください。

curl -X PUT '/case-management/v1/cases/{case_number}/comments' -H 'Authorization: TOKEN' -d '{
  "comment": "Test comment api"
}'

AddCommentOptions addCommentOptions = new AddCommentOptions.Builder()
  .caseNumber(caseNumber)
  .comment("This is an example comment.")
  .build();
Response<Comment> response = service.addComment(addCommentOptions).execute();
Comment comment = response.getResult();
System.out.println(comment);

const params = {
  caseNumber: caseNumber,
  comment: 'This is an example comment,',
};
caseManagementService.addComment(params)
  .then(res => {
    console.log(JSON.stringify(res.result, null, 2));
  })
  .catch(err => {
    console.warn(err)
  });

comment = case_management_service.add_comment(
  case_number=case_number,
  comment='This is an example comment.'
).get_result()
print(json.dumps(comment, indent=2))

addCommentOptions := caseManagementService.NewAddCommentOptions(
  caseNumber,
  "This is an example comment.",
)
comment, response, err := caseManagementService.AddComment(addCommentOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(comment, "", "  ")
fmt.Println(string(b))

サポートケースの更新

サポートケースを更新するには、ケース番号を選択します。 コメントの追加、ファイルの添付や削除、リソースの追加、ウォッチリストの更新ができます。 サポートケースを更新するには、以下の手順に従ってください：

1. IBM Cloud コンソールのメニューバーから、 ヘルプアイコン > Support center をクリックします。
2. 「 最近のサポートケース 」タイルからサポートケースを選択してください。
3. コメントを追加し、 Submitをクリックします。
4. 必要に応じて、以下のフィールドを更新することができます：
   • ユーザーをウォッチリストに追加する
   • ファイルの添付または削除
   • テクニカルサポートケースに特定のリソースを追加する

サポート Case の監視リストの更新

ユーザーを監視リストに追加することで、サポート Case に関する通知を受信できるアカウント内のユーザーを更新できます。 サポートケースの作成 時、または作成後に、ユーザーをウォッチリストに追加することができます。

デフォルトでは、アカウント・ユーザーは、Case を作成、更新、検索、表示するためのアクセス権限はいずれも持っていません。 アカウント、 Identity and Access Management （IAM）アクセスポリシーを割り当てることで、ユーザーにアクセス権を付与する必要があります。 詳しくは、サポート Case を処理するためのユーザー・アクセスの割り当てを参照してください。

作成した既存のサポート Case の更新情報についてユーザーに通知するには、以下の手順を実行してユーザーを監視リストに追加します。

1. IBM Cloud コンソールのメニューバーから、 ヘルプアイコン > Support center をクリックします。

2. 「 最近のサポートケース 」タイルからサポートケースを選択してください。

3. 「ウォッチリスト」セクションで、 設定アイコン 設![定アイコン] 定 ] をクリックします。

4. アカウント内のユーザーを選択して、監視リストに追加します。

   監視リストに追加するユーザーは、Case が作成されたアカウントのメンバーでなければなりません。 アカウントへのアクセス権限をユーザーに割り当てる方法について詳しくは、Case 管理アクセス・グループへのユーザーの追加を参照してください。

サポート Case の検索

「 ケースの管理 」ページでは、ケースのステータスで絞り込みを行ったり、検索バーのクエリパラメータを使用して、すべてのサポートケースを検索したりすることができます。 デフォルトのフィルタは、オープンケースのみを表示するように設定されています。 解決済みまたは終了した案件を表示するには、ステータスフィルターを更新してください。 すべてのパラメータは組み合わせて使用でき、入力順序は問いません。 また、「 すべての症例 」、「 私の症例 」、「 ウォッチリストの症例 」を選択して症例を絞り込むこともできます。

検索パラメーターについて詳しくは、以下の表を参照してください。

パラメーターを指定しないで用語を入力すると、サポート Case 番号および Case サブジェクトに対する検索結果が表示されます。

信頼できるプロファイルを使用して開かれたケースの通知を受け取る

信頼できるプロファイルで作業しているときにサポートケースを開くと、通知を受け取るために2つのオプションから選択できます。

オプション1：通知をEメールアドレスに送信することができます。

オプション2：信頼済みプロファイルに関連付けられている電子メールアドレスに通知を送信することができます。

2つ目のオプションを使用するには、サービスID、クラウドリソース、またはコンピュータリソースではない電子メールアドレスが信頼済みプロファイルに関連付けられている必要があります。