ワークフロー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以降