Skip to content

Commit

Permalink
Moji: Update translations
Browse files Browse the repository at this point in the history
  • Loading branch information
boxmoji committed Feb 20, 2024
1 parent e90c44e commit 22cb100
Show file tree
Hide file tree
Showing 18 changed files with 387 additions and 387 deletions.
112 changes: 56 additions & 56 deletions guides/embed/ui-elements/explorer.md

Large diffs are not rendered by default.

18 changes: 9 additions & 9 deletions pages/sign/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,31 +14,31 @@ previous_page_id: ''
source_url: 'https://github.com/box/developer.box.com/blob/main/content/pages/sign/index.md'
fullyTranslated: true
---
# Working with Box Sign
# Box Signの使用

<ImageFrame center>

![Working with box sign image](images/working-with-box-sign.png)
![Box Signの使用の画像](images/working-with-box-sign.png)

</ImageFrame>

This learning page provides developers with practical insights into working with [Box Sign][sign], aiming to facilitate the integration of the Box Platform Sign engine into their applications.
この学習ページでは、アプリケーションへのBox Platform Signエンジンの統合を促進することを目的に、[Box Sign][sign]の使用に関する実践的なインサイトを開発者に提供します。

## クイックスタート

Use the [Quick start][quick-start] to go straight into the creation of a signature request.
[クイックスタート][quick-start]を使用すると、すぐに署名リクエストの作成に着手することができます。

## Technical use cases
## 技術的なユースケース

In the [Technical use cases][technical-use-cases], you will learn how to handle the different types of documents that can be used in a signature request: from unstructured documents that require a preparation step, through templates, to generated ready to sign documents.
[技術的なユースケース][technical-use-cases]では、準備手順が必要な非構造化ドキュメントから、テンプレート、署名する準備ができている生成済みドキュメントまで、署名リクエストで使用できるさまざまな種類のドキュメントを処理する方法について説明します。

## Request Options
## リクエストのオプション

In the [Request options][request-options], you will find a detailed exploration of the available customization and configuration options when sending signing requests through the Box Sign API. Learn how to tailor the signing experience to match your application's user interface, workflow, and specific requirements.
[リクエストのオプション][request-options]では、Box Sign APIを使用して署名リクエストを送信する際に利用できるカスタマイズと構成のオプションについて詳しく説明します。アプリケーションのユーザーインターフェース、ワークフロー、特定の要件に合うように署名エクスペリエンスを調整する方法を確認してください。

<!-- ## Business Use Cases The [Business use cases][[advanced-use-cases]] delves into a few of the business use cases, requirements, and workflows you may encounter. See how the Box Platform features come together to provide a seamless signing experience for your users. -->

Let's get started!
それでは、始めましょう。

[sign]: https://www.box.com/esignature

Expand Down
40 changes: 20 additions & 20 deletions pages/sign/quick-start/api-basics.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,42 +15,42 @@ source_url: >-
https://github.com/box/developer.box.com/blob/main/content/pages/sign/10-quick-start/10-api-basics.md
fullyTranslated: true
---
# API Basics
# APIの基本

## Sign API

The Sign request endpoint is used to create and manage signature requests. You can create, resend, and cancel signature requests. You can also list all signature requests and get details of a specific signature request.
署名リクエストを作成して管理するには、署名リクエストのエンドポイントを使用します。署名リクエストは、作成、再送信、キャンセルできます。また、すべての署名リクエストのリストを取得したり、特定の署名リクエストの詳細を取得したりすることもできます。

The endpoint is `https://{api.box.com}/2.0/sign_requests`. The following table lists the operations that you can perform on this endpoint.
エンドポイントは`https://{api.box.com}/2.0/sign_requests`です。次の表に、このエンドポイントで実行できる操作を示します。

| 操作 | エンドポイント | 説明 |
| ---- | ------------------------- | -------------------------------------------- |
| GET | /sign_requests | List all signature requests. |
| GET | /sign_requests/:id | Get details of a specific signature request. |
| POST | /sign_requests | Create a signature request. |
| POST | /sign_requests/:id/resend | Resend a signature request. |
| POST | /sign_requests/:id/cancel | Cancel a signature request. |
| 操作 | エンドポイント | 説明 |
| ---- | ------------------------- | ---------------------- |
| GET | /sign_requests | すべての署名リクエストのリストを取得します。 |
| GET | /sign_requests/:id | 特定の署名リクエストの詳細を取得します。 |
| POST | /sign_requests | 署名リクエストを作成します。 |
| POST | /sign_requests/:id/resend | 署名リクエストを再送信します。 |
| POST | /sign_requests/:id/cancel | 署名リクエストをキャンセルします。 |

For full details on the request and response parameters, see the [Sign request API reference][sign-api-reference].
リクエストとレスポンスのパラメータの詳細については、[署名リクエストAPIリファレンス][sign-api-reference]を参照してください。

## Sign templates API
## SignテンプレートAPI

The Sign templates endpoint is used to list and get details of a template.
テンプレートのリストと詳細を取得するには、Signテンプレートエンドポイントを使用します。

<Message type="notice">

You can not create, edit, or delete templates using the API. These templates are exclusively managed in the Box web application.
このAPIを使用してテンプレートを作成、編集、削除することはできません。これらのテンプレートは、Boxウェブアプリでのみ管理されます。

</Message>

The endpoint is `https://{api.box.com}/2.0/sign_templates`. The following table lists the operations that you can perform on this endpoint.
エンドポイントは`https://{api.box.com}/2.0/sign_templates`です。次の表に、このエンドポイントで実行できる操作を示します。

| 操作 | エンドポイント | 説明 |
| --- | ------------------- | ----------------------------------- |
| GET | /sign_templates | List all templates. |
| GET | /sign_templates/:id | Get details of a specific template. |
| 操作 | エンドポイント | 説明 |
| --- | ------------------- | --------------------- |
| GET | /sign_templates | すべてのテンプレートのリストを取得します。 |
| GET | /sign_templates/:id | 特定のテンプレートの詳細を取得します。 |

For a full details on the request and response parameters, see the [Sign template request API reference][sign-api-template-ref]
リクエストとレスポンスのパラメータの詳細については、[SignテンプレートリクエストAPIリファレンス][sign-api-template-ref]を参照してください。

[sign-api-reference]: https://developer.box.com/reference/resources/sign-request/

Expand Down
8 changes: 4 additions & 4 deletions pages/sign/quick-start/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,13 +17,13 @@ fullyTranslated: true
---
# クイックスタート

Get a sense of how the [Box Sign API][api-basics] is structured and how to create your first signature request.
[Box Sign API][api-basics]の構造と、最初の署名リクエストの作成方法の趣旨を把握しましょう。

The Sign API does not follow the traditional CRUD model. You can create, resend, and cancel signature requests. You can also list all signature requests and get details of a specific signature request.
Sign APIは従来のCRUDモデルに従っていません。署名リクエストは、作成、再送信、キャンセルできます。また、すべての署名リクエストのリストを取得したり、特定の署名リクエストの詳細を取得したりすることもできます。

Sign Templates API is read-only. You can list all templates and get details of a specific template.
SignテンプレートAPIは読み取り専用です。すべてのテンプレートのリストを取得したり、特定のテンプレートの詳細を取得したりすることができます。

Once you get a sense of the API, you can create [your first signature request][quick-start].
APIの趣旨を把握したら、[最初の署名リクエスト][quick-start]を作成できます。

[api-basics]: page://sign/quick-start/api-basics

Expand Down
60 changes: 30 additions & 30 deletions pages/sign/quick-start/your-first-request.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,13 +15,13 @@ source_url: >-
https://github.com/box/developer.box.com/blob/main/content/pages/sign/10-quick-start/20-your-first-request.md
fullyTranslated: true
---
# Your first request
# 最初のリクエスト

Imagine that you have a document stored in Box and you want to send it to a customer for signature. At a minimum your app needs to know what document to sign, where to store the signed document, and the signer email.
Boxに保存されているドキュメントがあり、署名をもらうために顧客に送信することを想像してみてください。少なくとも、アプリでは、署名対象のドキュメント、署名済みドキュメントの保存先、署名者のメールアドレスを認識する必要があります。

## Creating a signature request
## 署名リクエストの作成

You can use the Box Sign API or one of the available SDKs to create a signature request. See the example:
署名リクエストの作成には、Box Sign APIまたは使用可能ないずれかのSDKを使用できます。次の例を参照してください。

<Tabs>

Expand Down Expand Up @@ -56,7 +56,7 @@ curl --location 'https://api.box.com/2.0/sign_requests' \

</Tab>

<Tab title="Python Gen SDK">
<Tab title="Pythonの次世代SDK">

```python

Expand Down Expand Up @@ -101,7 +101,7 @@ def main():

</Tabs>

This will result in a signature request with a prepare document URL (simplified):
この結果、ドキュメント準備のURL (簡略化されています) を含む署名リクエストが作成されます。

<Tabs>

Expand Down Expand Up @@ -152,7 +152,7 @@ This will result in a signature request with a prepare document URL (simplified)

</Tab>

<Tab title="Python Gen SDK">
<Tab title="Pythonの次世代SDK">

```YAML

Expand All @@ -167,52 +167,52 @@ Prepare url: https://app.box.com/sign/document/xyz-abc-123/.../prepare_doc/
</Tabs>
## Check the status of the signature request
## 署名リクエストのステータスの確認
Creating the signature request is an asynchronous process, and can generate errors. Your application should check the status of the request before proceeding, and handle any errors.
署名リクエストの作成は非同期処理であり、エラーが発生する可能性があります。アプリケーションでは、処理を進める前にリクエストのステータスを確認し、エラーがあれば処理する必要があります。
A signature request can have the following statuses:
署名リクエストのステータスを以下に示します。
![Signature flow](images/basic-sign-flow.png)
![署名のフロー](images/basic-sign-flow.png)
* `converting`: 署名リクエストが送信された後、ファイルが署名プロセスのために`.pdf`に変換されている。
* `error_converting`: An issue occurred while converting the file to a `.pdf`.
* `created`: When the `document_preparation_is_needed` is set to `true`, but the `prepare_url` has not yet been visited.
* `error_converting`: ファイルを`.pdf`に変換中に問題が発生した。
* `created`: `document_preparation_is_needed``true`に設定されているが、`prepare_url`がまだアクセスされていない。
* `sent`: リクエストが正常に送信されたが、どの署名者も対応していない。
* `error_sending`: An issue occurred while sending the request.
* `viewed`: The first, or only, signer clicked on **Review document** in the signing email or visited the signing URL.
* `downloaded`: The document was downloaded by the signer.
* `error_sending`: リクエストの送信中に問題が発生した。
* `viewed`: 最初 (または唯一) の署名者が署名用メールの \[**ドキュメントをレビュー**] をクリックするか、署名用URLにアクセスした。
* `downloaded`: 署名者がドキュメントをダウンロードした。
* `signed`: すべての署名者がリクエストの処理を完了した。
* `signed and downloaded`: The document was signed and downloaded by the signer.
* `signed and downloaded`: 署名者がドキュメントに署名してダウンロードした。
* `declined`: いずれかの署名者がリクエストを拒否した。
* `cancelled`: リクエストがUIまたはAPIを介してキャンセルされた。
* `expired`: 署名が未完了、不十分のまま、有効期限が過ぎた。
* `finalizing`: All signers have signed the request, but the final document with signatures and the signing log have not been generated yet.
* `error_finalizing`: The `finalizing` phase did not complete successfully.
* `finalizing`: すべての署名者がリクエストに署名済みでも、署名された最終的なドキュメントと署名ログがまだ生成されていない。
* `error_finalizing`: `finalizing`フェーズが正常に完了しなかった。

## Preparing the document
## ドキュメントの準備

Depending on your technical use case you may need to prepare the document. In this specific example, we are signing a PDF, and the Box Sign engine has no idea where to place the signature pad field or any other inputs. This is why we used the `is_document_preparation_needed` flag.
技術的なユースケースによっては、ドキュメントの準備が必要になる場合があります。この具体的な例では、PDFに署名していますが、Box Signエンジンは、署名フィールドやその他の入力データの配置場所を認識しません。そのため、`is_document_preparation_needed`フラグを使用しました。

If a prepare URL is present, then your application should open the prepare URL in a browser, where the requester can add the signature pad field and any other inputs needed for the signer to complete the document.
準備のURLが存在する場合、アプリケーションはそのURLをブラウザで開く必要があります。そこで、リクエスト送信者は、署名者がドキュメントでの作業を完了するために必要な署名フィールドやその他の入力データを追加できます。

Once the document is prepared, the requester can send the signature request to the signer.
ドキュメントが準備できたら、リクエスト送信者は署名リクエストを署名者に送信できます。

This preparation step is not always necessary. Take a look at the [technical use cases][technical-use-cases] for more information.
この準備手順は必須ではありません。詳細については、[技術的なユースケース][technical-use-cases]を参照してください。

## Completing the signature request
## 署名リクエストの完了

The signer then receives an email from Box with a link to the signature request. The signer can click the link and sign the document.
署名者には、署名リクエストへのリンクが記載されたメールがBoxから届きます。署名者はリンクをクリックしてドキュメントに署名できます。

When the process is completed, both a signature log containing metadata and the signed document are stored in the destination folder.
処理が完了すると、メタデータを含む署名ログと署名済みドキュメントの両方が保存先フォルダに格納されます。

Congratulations! You have successfully created your first signature request.
これで、最初の署名リクエストを正常に作成できました。

<Message type="notice">

This represents the basic use case for Box Sign. The `create` method has many options that you can use to customize your signature request.
これは、Box Signの基本的なユースケースを示しています。`create`メソッドには、署名リクエストのカスタマイズに使用できる多くのオプションがあります。

Be sure to check the [request options][request-options], and the [technical use cases][technical-use-cases] sections for more information.
詳細については、[リクエストのオプション][request-options]と[技術的なユースケース][technical-use-cases]のセクションをぜひ確認してください。

</Message>

Expand Down
Loading

0 comments on commit 22cb100

Please sign in to comment.