ワークフローAPIで使用するデータの構造
目次
- WorkflowApplicationType
- OperationType
- ItemType
- FileItemType
- FolderType
- WorkflowFolderType
- StatusType
- WorkflowStatusType
- StepTypeType
- WorkflowGetManageRequestFilter
- WorkflowAvailabilityUserType
- WorkflowGetRequestType
- WorkflowGetAttachedFileBodyType
- RequestManageFormType
- CategoriesType
- CategoryType
- ChildCategoriesType
- RequestFormType
- FileAttachedDetail
- WorkflowHandleApplicationOperationType
- ApproverType
WorkflowApplicationType
1つの申請を表す型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
データ構造
| パラメーター名 | 型 | パラメーター数 | 説明 | 
|---|---|---|---|
| @id | base:IDType | 1 | 申請ID | 
| @version | base:VersionType | 1 | 申請のバージョン情報 | 
| @status | workflow:StatusType | 1 | 申請の状態(日本語) | 
| @date | xsd:dateTime | 1 | 申請日時 | 
| @processing_step | base:IDType | 1 | 現在の経路 | 
| @name | xsd:string | 0~1 | 申請名 | 
| @number | base:NonBlankStringType | 0~1 | 申請番号 | 
| @urgent | xsd:boolean | 0~1 | 優先度 
 | 
| @status_type | workflow:WorkflowStatusType | 0~1 | 申請の状態 | 
| appilcant | - | 1 | 申請者 | 
| applicant/@id | base:IDType | 0~1 | 申請者のGaroonユーザーID | 
| applicant/@name | base:NonBlankStringType | 1 | 申請者名 | 
| applicant/プロキシ | - | 0~1 | 代理申請者 | 
| applicant/プロキシ/@id | base:IDType | 0~1 | 代理申請者のGaroonユーザーID | 
| applicant/プロキシ/@name | base:NonBlankStringType | 1 | 代理申請者名 | 
| items | - | 1 | 申請の項目一覧 | 
| items/item | workflow:ItemType | 0~ 無制限 | 単一の項目 | 
| items/files_item | workflow:FileItemType | 0~ 無制限 | ファイル添付の項目 | 
| items/blank_item | - | 0~ 無制限 | 空行 | 
| steps | - | 1 | 承認経路の情報 | 
| steps/step | - | 1~ 無制限 | 経路ステップ | 
| steps/step/@id | base:IDType | 1 | 経路ステップID | 
| steps/step/@name | base:NonBlankStringType | 1 | 経路ステップ名 | 
| steps/step/@type | workflow:StepTypeType | 1 | 経路ステップの種別 | 
| steps/step/@is_approval_step | xsd:integer | 1 | -1の場合に承認ステップを表す | 
| steps/step/processor | - | 1~ 無制限 | 処理者 | 
| steps/step/processor/@id | base:IDType | 0~1 | 処理者のGaroonユーザーID | 
| steps/step/processor/@processor_name | xsd:string | 0~1 | 処理者名 | 
| steps/step/processor/@date | xsd:dateTime | 0~1 | 処理日時 | 
| steps/step/processor/@comment | xsd:string | 0~1 | 処理者コメント | 
| steps/step/processor/@result | base:NonBlankStringType | 0~1 | 処理結果 | 
| steps/step/processor/プロキシ | - | 0~1 | 代理承認者 | 
| steps/step/processor/プロキシ/@id | base:IDType | 0~1 | 代理承認者のGaroonユーザーID | 
| steps/step/processor/プロキシ/@processor_name | xsd:string | 1 | 代理承認者名 | 
| operation | workflow:OperationType | 0~ 無制限 | 操作情報。API実行ユーザーがこの申請に対して操作可能なオペレーション一覧を示す。 | 
| folder | - | 0~ 無制限 | フォルダー | 
| folder/@id | base:IDType | 1 | フォルダーID | 
| folder_type/text() | workflow:WorkflowFolderType | 0~ 無制限 | フォルダーの種別 | 
OperationType
申請への操作を表す型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
データ構造
| パラメーター名 | 型 | パラメーター数 | 説明 | 変更履歴 | 
|---|---|---|---|---|
| sent_back | - | 0~1 | 差し戻し | |
| sent_back/applicant | - | 0~1 | 差し戻したユーザー | |
| sent_back/step | - | 0~1 | 経路ステップ | |
| sent_back/step@step_id | base:IDType | 1 | 差し戻された時点での経路ステップID | |
| approve | - | 0~1 | 承認 | |
| reject | - | 0~1 | 却下 | |
| withdraw | - | 0~1 | 取り消し | |
| cancel | - | 0~1 | 取り消し | |
| confirm | - | 0~1 | 回覧の確認 | |
| acknowledge | - | 0~1 | 申請処理済の通知の確認 | パッケージバージョン3.7.3で追加 | 
ItemType
申請に含まれる項目の内の1つの項目を表します。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
データ構造
| パラメーター名 | 型 | パラメーター数 | 説明 | 
|---|---|---|---|
| @name | base:NonBlankStringType | 1 | 項目名 | 
| @value | xsd:string | 1 | 入力された値 | 
| @right_align | xsd:boolean | 0~1 | 
 | 
FileItemType
ファイル添付項目を表します。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
リクエスト
| パラメーター名 | 型 | パラメーター数 | 説明 | 
|---|---|---|---|
| @name | base:NonBlankStringType | 1 | 項目名 | 
| @inline | xsd:boolean | 0~1 | 
 | 
| file | - | 0~ 無制限 | 添付ファイル | 
| file/@name | base:NonBlankStringType | 1 | ファイル名 | 
| file/@file_id | base:IDType | 1 | ファイルID | 
| file/@size | xsd:unsignedLong | 0~1 | ファイルサイズ | 
| file/@mime_type | xsd:string | 0~1 | ファイルのMIMEタイプ | 
FolderType
フォルダー情報を表す型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
データ構造
| パラメーター名 | 型 | パラメーター数 | 説明 | 
|---|---|---|---|
| @id | base:IDType | 1 | フォルダーID | 
| @name | base:NonBlankStringType | 1 | フォルダー名 | 
| application | - | 0~ 無制限 | フォルダー内に存在する申請 | 
| application/@id | base:IDType | 1 | 申請ID | 
WorkflowFolderType
ワークフローのフォルダーの種類を表す型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
データ構造
この型は単一の文字列を表すスカラー値です。また、この型が取り得る値は次のいずれかです。
| 値 | 説明 | 
|---|---|
| unprocessed | 未処理一覧 | 
| sent | 送信一覧 | 
| received | 受信一覧 | 
| draft | 下書き | 
| finish | 結果一覧 | 
StatusType
申請の状態を表す文字列です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
データ構造
この型は単一の文字列を表すスカラー値です。また、この型が取り得る値は次のいずれかです。
- 進行中
- 承認
- 却下
- 取消
- 完了
- 下書き
WorkflowStatusType
ワークフロー状態の種類を表す型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
データ構造
この型は単一の文字列を表すスカラー値です。また、この型が取り得る値は次のいずれかです。
| 値 | 説明 | 
|---|---|
| unprocessing | 未処理 | 
| inprogress | 進行中 | 
| sent_back | 差し戻し | 
| approved | 承認 | 
| rejected | 却下 | 
| withdrawn | 取り消し | 
| cancelled | 取り消し | 
| completed | 完了 | 
StepTypeType
経路ステップのタイプを表す文字列です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
データ構造
この型は単一の文字列を表すスカラー値です。また、この型が取り得る値は次のいずれかです。
| 値 | 説明 | 
|---|---|
| 承認(全員) | 全員の承認が必要であることを表します。 | 
| 承認(誰か1人) | 誰か一人でも承認すればその経路は承認されることを表します。 | 
| 回覧 | その経路は回覧のみで承認プロセスがないことを表します。 | 
WorkflowGetManageRequestFilter
ワークフローの検索対象状況を表す型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.1以降
データ構造
この型は単一の文字列を表すスカラー値です。また、この型が取り得る値は次のいずれかです。
| 値 | 説明 | 
|---|---|
| All | すべて | 
| In progress | 進行中 | 
| Approved | 承認 | 
| Rejected | 却下 | 
| Cancel | 取り消し | 
| Complete | 完了 | 
WorkflowAvailabilityUserType
ユーザーのアプリケーションの利用許可を表す型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.1以降
データ構造
| パラメーター名 | 型 | パラメーター数 | 説明 | 
|---|---|---|---|
| @id | base:IDType | 1 | GaroonユーザーID | 
| @workflow | xsd:boolean | 1 | ワークフローの利用許可 
 | 
| @keitai | xsd:boolean | 1 | ワークフローケータイの利用許可 
 | 
WorkflowGetRequestType
取得したい申請データの条件を表す型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.1以降
データ構造
| パラメーター名 | 型 | パラメーター数 | 説明 | 
|---|---|---|---|
| @request_form_id | base:IDType | 1 | 取得するフォームのID | 
| @filter | workflow:WorkflowGetManageRequestFilter | 0~1 | 検索対象状況 | 
| @start_request_date | xsd:dateTime | 0~1 | 申請日時の検索先頭 | 
| @end_request_date | xsd:dateTime | 0~1 | 申請日時の検索末尾 | 
| @start_approval_date | xsd:dateTime | 0~1 | 承認日時の検索先頭 承認日時が@start_approval_dateに指定した日時より後のワークフローが検索対象です。 | 
| @end_approval_date | xsd:dateTime | 0~1 | 承認日時の検索末尾 | 
| @appilcant | base:IDType | 0~1 | 申請者のGaroonユーザーID | 
| @last_approval | base:IDType | 0~1 | 最終承認者 | 
| @start_to_get_information_from | base:IDType | 0~1 | 検索結果の表示の開始点 | 
| @maximum_request_amount_to_get | xsd:string | 0~1 | 検索結果の表示の最大数 | 
WorkflowGetAttachedFileBodyType
取得したい添付ファイルの情報を表す型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.1以降
データ構造
| パラメーター名 | 型 | パラメーター数 | 説明 | 
|---|---|---|---|
| @request_form_id | base:IDType | 1 | 申請フォームID | 
| @file_id | base:IDType | 1 | ファイルID | 
RequestManageFormType
フォームなどの条件を指定した申請リストを表す型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.1以降
データ構造
| パラメーター名 | 型 | パラメーター数 | 説明 | 変更履歴 | 
|---|---|---|---|---|
| manage_request_form | - | 0~1 | 申請フォームの情報 | |
| manage_request_form/manage_item_detail | - | 0~1 | 申請データの詳細情報 | |
| manage_request_form/manage_item_detail/@pid | base:IDType | 1 | 申請データID | |
| manage_request_form/manage_item_detail/@number | base:IDType | 1 | 申請番号 | |
| manage_request_form/manage_item_detail/@priority | xsd:string | 1 | 優先度 
 | |
| manage_request_form/manage_item_detail/@subject | xsd:string | 1 | 標題 | |
| manage_request_form/manage_item_detail/@status | workflow:StatusType | 1 | 申請の状態 | |
| manage_request_form/manage_item_detail/@applicant | base:IDType | 1 | 申請者のGaroonユーザーID | |
| manage_request_form/manage_item_detail/@last_approver | workflow:ApproverType | 1 | 最終承認者 | パッケージバージョン4.0以前の型は base:IDType | 
| manage_request_form/manage_item_detail/@request_date | xsd:dateTime | 1 | 申請日時 | |
| manage_request_form/@id_request_form | base:IDType | 0~1 | 申請フォームのID | |
| manage_request_form/@name_request_form | xsd:string | 0~1 | 申請フォーム名 | |
| @id_category | base:IDType | 0~1 | カテゴリID | |
| @name_category | xsd:string | 0~1 | カテゴリ名 | 
CategoriesType
ワークフローのカテゴリ一覧を表す型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.1以降
データ構造
| パラメーター名 | 型 | パラメーター数 | 説明 | 
|---|---|---|---|
| child_cagtegory | workflow:CategoryType | 1 | 子カテゴリ | 
| @id | base:IDType | 1 | カテゴリID | 
| @code | base:NonBlankStringType | 1 | カテゴリコード | 
| @name | base:NonBlankStringType | 1 | カテゴリ名 | 
| @parenet_category | base:IDType | 0~1 | 親カテゴリID | 
| @memo | base:NonBlankStringType | 0~1 | カテゴリの説明 | 
CategoryType
カテゴリの情報を表す型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.1以降
データ構造
| パラメーター名 | 型 | パラメーター数 | 説明 | 
|---|---|---|---|
| child_cagtegory | workflow:CategoryType | 1 | 子カテゴリ | 
| @id | base:IDType | 1 | カテゴリID | 
| @code | base:NonBlankStringType | 1 | カテゴリコード | 
| @name | base:NonBlankStringType | 1 | カテゴリ名 | 
| @parenet_category | base:IDType | 0~1 | 親カテゴリID | 
| @memo | base:NonBlankStringType | 0~1 | カテゴリの説明 | 
| @created | xsd:integer | 0~1 | カテゴリ作成時刻(Timestamp) | 
| @last_update | xsd:integer | 0~1 | カテゴリ更新時刻(Timestamp) | 
ChildCategoriesType
子カテゴリ一覧を表す型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.1以降
データ構造
| パラメーター名 | 型 | パラメーター数 | 説明 | 
|---|---|---|---|
| child_cagtegory | workflow:CategoryType | 1 | 子カテゴリ | 
| @id | base:IDType | 1 | カテゴリID | 
| @code | base:NonBlankStringType | 1 | カテゴリコード | 
| @name | base:NonBlankStringType | 1 | カテゴリ名 | 
| @parenet_category | base:IDType | 0~1 | 親カテゴリID | 
| @memo | base:NonBlankStringType | 0~1 | カテゴリの説明 | 
RequestFormType
カテゴリ内のフォーム情報を表す型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.1以降
データ構造
| パラメーター名 | 型 | パラメーター数 | 説明 | 
|---|---|---|---|
| requestForm | - | 1~ 無制限 | フォーム情報 | 
| requestForm/@fid | base:IDType | 1 | フォームID | 
| requestForm/@type | base:NonBlankStringType | 1 | 
 | 
| requestForm/@name | base:NonBlankStringType | 1 | フォーム名 | 
| requestForm/@active | base:IDType | 0~1 | 
 | 
| requestForm/@icon_type | base:NonBlankStringType | 0~1 | 
 | 
| requestForm/@icon_id | base:IDType | 0~1 | アイコンID | 
| requestForm/@icon_url | base:IDType | 0~1 | URL指定アイコンのURL | 
| @category_id | base:IDType | 1 | カテゴリID | 
FileAttachedDetail
添付ファイルの詳細情報を表す型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.1以降
データ構造
| パラメーター名 | 型 | パラメーター数 | 説明 | 
|---|---|---|---|
| file_header | - | 1 | 添付ファイル情報 | 
| file_header/@file_id | base:IDType | 1 | ファイルID | 
| file_header/@request_form_id | base:IDType | 1 | フォームID | 
| file_header/@name | base:NonBlankStringType | 1 | ファイル名 | 
| file_header/@size | base:NonBlankStringType | 1 | ファイルサイズ | 
| file_information | - | 1 | 添付ファイル情報 | 
| file_information/@subject | base:NonBlankStringType | 1 | タイトル | 
| file_information/@versioning | base:NonBlankStringType | 1 | バージョン管理 | 
| file_information/@create_time | base:IDType | 0~1 | 作成日時 | 
| file_information/@modify_time | base:IDType | 0~1 | 更新日時 | 
| file_information/@description | base:NonBlankStringType | 0~1 | ファイルの説明 | 
WorkflowHandleApplicationOperationType
申請に対して操作する際に使用する型です。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
データ構造
| パラメーター名 | 型 | パラメーター数 | 説明 | 
|---|---|---|---|
| @application_id | base:IDType | 1 | 申請ID | 
| @delegator_id | base:IDType | 0~1 | 代理人ID | 
| @comment | xsd:string | 0~1 | コメント | 
| operation | workflow:OperationType | 1 | 操作 | 
ApproverType
承認者を表す型です。このタイプは、xsd:string、もしくはbase:IDTypeと同じです。
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 4.2以降