> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/workflows/ja/burokku/blocks/custom-blocks/salesforce-work-order-block.md).

# Salesforce作業指示ブロック

あらゆるWorkflow検知から、証拠画像を添付したSalesforce作業指示を作成するカスタムPythonブロック。

検知は、誰かが実際にそれを修正してこそ役立ちます。この例は完全な [カスタム Python ブロック](https://docs.roboflow.com/workflows/ja/burokku/blocks/custom-blocks.md) Workflow が直前に見た内容、つまり注釈付きフレーム、モデルの予測、サイトのコンテキストを受け取り、それをフレームを Files に添付した Salesforce Work Order として登録します。同じブロックで代わりに Salesforce Case を作成することも、ペイロードを ServiceNow、Jira、または独自のミドルウェア向けの webhook に POST することもできます。

任意の Roboflow モデル出力で動作します: オブジェクト検出、インスタンスセグメンテーション、キーポイント、分類。

## コンフィギュレーター

送信先、Salesforce org、重大度、サイト、チーム、スケジュール、SLA 時間を入力してください。このページは、それらの値をすでに埋め込んだブロックコードと、ビルダー内の各ブロックフィールドの正確な値を書き込みます。入力した内容がページの外に出ることはなく、Salesforce トークンが出力に含まれることもありません。

{% embed url="<https://roboflow.github.io/workflow-examples/>" %}
Work Order ブロック コンフィギュレーター
{% endembed %}

埋め込みが読み込まれない場合は、コンフィギュレーターを直接開いてください: <https://roboflow.github.io/workflow-examples/>.

## Workflow にどう組み込まれるか

このブロックは通常の検知ワークフローの最後に配置され、前段のブロックが生成した内容を受け取ります。

![検知モデル、バウンディングボックスとラベルの可視化ブロック、カスタムブロック、そして Outputs ノードを備えた Workflow キャンバス](https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-b28f8529548741d47cbfe11afd69dfac2159852d%2Fcustom-block-work-order-canvas.png?alt=media)

1. 追加する **オブジェクト検出モデル** ブロック（または他の任意のモデルブロック）と可視化を追加します。
2. 追加する **カスタム Python ブロック**、クリックして **コードを編集**をクリックして、コンフィギュレーターのコードを貼り付けます。
3. 以下で入力と出力を宣言します。入力名は `run`.
4. 接続する `image` を可視化出力に、 `predictions` をモデルに、そして `access_token` という名前の Workflow 入力に `salesforce_token`.

![ビルダーで設定されたカスタムブロック: image と predictions がチップとして接続され、destination は salesforce\_work\_order、severity は Critical](https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-ca6c1080ee734be105a795e38609f55045308b8a%2Fcustom-block-work-order-configured.png?alt=media)

### 入力

| 入力                  | 型                                                                                                                              | 内容                                                                                    |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- |
| image               | image                                                                                                                          | 証拠として添付するフレーム。                                                                        |
| predictions         | object\_detection\_prediction, instance\_segmentation\_prediction, keypoint\_detection\_prediction, classification\_prediction | 任意のモデルの予測。4 種類すべてを選択してください。                                                           |
| 送信先                 | 文字列                                                                                                                            | `salesforce_work_order`, `salesforce_case`, `webhook` または `dry_run`.                  |
| destination\_config | 辞書                                                                                                                             | シークレットではない設定: `instance_url`, `api_version`, `extra_fields`、webhook `URL` および `ヘッダー`. |
| access\_token       | 文字列                                                                                                                            | Salesforce ベアラートークン。定義に保存されないよう、Workflow 入力に接続してください。                                 |
| 重大度                 | 文字列                                                                                                                            | 重大、高、中、低。Priority と SLA を決定します。                                                       |
| アラート種別              | 文字列                                                                                                                            | 次のような短い機械用ラベル: `equipment_fault`.                                                     |
| 説明                  | 文字列                                                                                                                            | 見えた内容を説明する人間向けの文。                                                                     |
| サイト                 | 辞書                                                                                                                             | 場所: name、zone、asset\_id、camera\_id、address、lat、lon。                                   |
| 要員                  | 辞書                                                                                                                             | 担当者: skills、headcount、team。                                                           |
| スケジュール              | 辞書                                                                                                                             | いつ、何を: requested\_start、due\_by、duration\_hours、parts、access\_notes、instructions。     |

![宣言された入力とその型を一覧表示する Custom Block 編集パネル](https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-abd156e0d665ac73dbbf5cb4caf51417507a5f04%2Fcustom-block-work-order-inputs.png?alt=media)

### 出力

| 出力    | 型    | 内容                                                     |
| ----- | ---- | ------------------------------------------------------ |
| ペイロード | 辞書   | このブロックが作成した一般的な作業指示ペイロード。                              |
| 結果    | 辞書   | 送信先の応答: `ステータス`、レコード `ID`, `URL`, `添付ファイル ID`.         |
| エラー状態 | ブール値 | 何かが失敗した場合は True。ブロックは例外を投げないため、Workflow はそのまま実行を継続します。 |
| メッセージ | 文字列  | 結果を要約する一行。                                             |

## 作成されるもの

Work Order には、alert\_type と site から作られた Subject、severity から決まる Priority、SLA テーブルから導かれる Start Date と End Date、そして読みやすい要約に続けて完全な JSON ペイロードを含む Description が設定されます。注釈付きフレームはレコードにリンクされた ContentVersion としてアップロードされるため、Files に表示されます。

![Priority が Critical で、severity、観測時刻、場所、検知内容、requested start、due by を記載した description を持つ Salesforce Work Order レコード](https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-e7f8c5515589321fa742722a7137d7317c1718f1%2Fcustom-block-work-order-salesforce.png?alt=media)

## 認証

このブロックは bearer トークンを `Authorization` ヘッダーに送ります。簡単なテストでは Salesforce CLI セッションのトークンを使用してください。本番では、client credentials フローと、Work Order（または Case）および ContentVersion レコードを作成できる run-as ユーザーを持つ Connected App を作成してください。

トークンを Workflow 定義の外に置いてください。 `salesforce_token`という名前の Workflow 入力を追加し、ブロックの `access_token` フィールドをそれに接続し、実行時にトークンを渡します。ビルダーの Run パネル、または `parameters` マップで Workflow を呼び出す際に指定します:

```python
from inference_sdk import InferenceHTTPClient

client = InferenceHTTPClient(api_url="https://serverless.roboflow.com", api_key=ROBOFLOW_API_KEY)
result = client.run_workflow(
    workspace_name="your-workspace",
    workflow_id="detect-and-dispatch",
    images={"image": "frame.jpg"},
    parameters={"salesforce_token": SALESFORCE_TOKEN},
)
print(result[0]["message"], result[0]["result"].get("url"))
```

## 調整するには

チームが通常変更するものはすべてコードの先頭にあります。重大度ごとの SLA 時間、デフォルトのジョブ継続時間、各レコードに設定される Salesforce フィールドです。検知そのものから来るカスタムフィールドは `work_order_fields` 関数に 1 フィールド 1 行で追加します。新しい送信先は `dispatch` 関数に分岐を 1 つ追加するだけです。ビジョン側は何も変わりません。

〜で実行する `送信先` に設定する `dry_run` 最初にして、 `ペイロード` 出力を確認し、送信先が何を受け取るかを正確に把握してください。

## 次のステップ

* [カスタムブロック](https://docs.roboflow.com/workflows/ja/burokku/blocks/custom-blocks.md) — カスタム Python ブロックの実行方法と実行場所。
* [動的 Python ブロック](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/dynamic-python-blocks.md) — マニフェスト、入力と出力、そして `run(...)` メソッドの完全リファレンス。
