Alert.png The wiki is deprecated and due to be decommissioned by the end of September 2022.
The content is being migrated to other supports, new updates will be ignored and lost.
If needed you can get in touch with EGI SDIS team using operations @ egi.eu.

Difference between revisions of "GGUS:VO Biomed Dashboard Interface FAQ"

From EGIWiki
Jump to navigation Jump to search
 
(16 intermediate revisions by the same user not shown)
Line 4: Line 4:
[[Category:FAQ Interfaces (GGUS)]]
[[Category:FAQ Interfaces (GGUS)]]
<hr />'''FAQ for the Biomed VO dashboard interface'''
<hr />'''FAQ for the Biomed VO dashboard interface'''
; Updated: 2012-07-06
=!!!This page is currently under construction!!!=


The content of this page has been moved to [[GGUS:VO_TEAM_Ticket_Interface_FAQ]]
<!--
=Purpose=
=Purpose=
This document describes the interface used by Biomed VO dashboard for submitting and updating team tickets in GGUS. <br>
This document describes the interface used by Biomed VO dashboard for submitting and updating team tickets in GGUS. <br>
Line 30: Line 29:
{|border="1"
{|border="1"
!      XML element !! Mode        !! Comments
!      XML element !! Mode        !! Comments
|-
|GHD_Affected_Site       || Optional    || Site affected by the problem. Possible values are site names from GOCDB and OIMDB.
|-
|-
|GHD_Affected_VO       || '''Mandatory'''  || VO affected by the problem. Please set to "biomed".
|GHD_Affected_VO       || '''Mandatory'''  || VO affected by the problem. Please set to "biomed".
|-
|GHD_Carbon_Copy       || Optional    || Add mail addresses for notifying people on this ticket. Please use semi-colon as delimiter.
|-
|GHD_Date_Time_Prob       || Optional    || Date and time the problem occurred. Please use format YYYY-MM-DD hh:mm:ss. Defaults to the submit time.
|-
|GHD_Description       || Optional    || Detailed description of the problem.Length is up to 4000 chars.
|-
|-
|GHD_E_Mail                    || '''Mandatory'''|| Mail address of ticket submitter.
|GHD_E_Mail                    || '''Mandatory'''|| Mail address of ticket submitter.
|-
|GHD_VO_Specific       || Optional    || Flag indicating whether a problem is specific to a given VO or not. Possible values are "Yes" and "No". Defaults to "No".
|-
|-
|GHD_Last_Login               || '''Mandatory'''|| Account used by the SOAP client.
|GHD_Last_Login               || '''Mandatory'''|| Account used by the SOAP client.
Line 50: Line 39:
|-
|-
|GHD_Cert_DN               || '''Mandatory'''|| DN string of the certificate used by the ticket submitter
|GHD_Cert_DN               || '''Mandatory'''|| DN string of the certificate used by the ticket submitter
|-
|GHD_Name               || Optional    || Name of ticket submitter.
|-
|-
|GHD_Notification_Recipients  || '''Mandatory'''|| Manages whether only the submitter or the whole team should be notified on ticket updates. Please provide value "Team". Defaults to "Submitter".
|GHD_Notification_Recipients  || '''Mandatory'''|| Manages whether only the submitter or the whole team should be notified on ticket updates. Please provide value "Team". Defaults to "Submitter".
|-
|GHD_Priority               || Optional    || Ticket priority level. Possible values are "less urgent", "urgent", "very urgent" and "top priority". Defaults to "less urgent".
|-
|-
|GHD_Subject          || '''Mandatory'''|| Ticket subject.
|GHD_Subject          || '''Mandatory'''|| Ticket subject.
Line 63: Line 48:
|GHD_Ticket_Update_Mode       || '''Mandatory'''|| Manages who will be able to update the ticket. Please provide value "Team". Defaults to "Submitter".
|GHD_Ticket_Update_Mode       || '''Mandatory'''|| Manages who will be able to update the ticket. Please provide value "Team". Defaults to "Submitter".
|-
|-
|GHD_Type_Of_Problem       || Optional    || Possible values are given here: [[GGUS:Type_Of_Problem]]. Defaults to "Other Services".
|GHD_Affected_Site       || Optional    || Site affected by the problem. Possible values are site names from GOCDB and OIMDB.
|-
|GHD_Carbon_Copy       || Optional    || Add mail addresses for notifying people on this ticket. Please use semi-colon as delimiter.
|-
|GHD_Date_Time_Prob       || Optional    || Date and time the problem occurred. Please use format YYYY-MM-DD hh:mm:ss. Defaults to the submit time.
|-
|GHD_Description       || Optional    || Detailed description of the problem.Length is up to 4000 chars.
|-
|GHD_Involve               || Optional    || Mail addresses of people involved in ticket solution process.
|-
|GHD_Priority               || Optional    || Ticket priority level. Possible values are "less urgent", "urgent", "very urgent" and "top priority". Defaults to "less urgent".
|-
|GHD_Problem_Type       || Optional    || Possible values are given here: [[GGUS:Type_Of_Problem]]. Defaults to "Other".
|-
|GHD_Routing_Type       || Optional    || Manages whether the ticket will be routed to an NGI/ROC directly or to TPM. Please provide value "SITE/ROC" for bypassing the TPM. Defaults to "TPM".
|-
|GHD_Soap_Client_Data          || Optional    || Hidden free text field for keeping soap client data.
|-
|GHD_Submitter               || Optional    || Name of ticket submitter.
|-
|-
|GHD_User_Notification       || Optional    || Manages the submitter notifications. Possible values are "Solution", "Every Change" and "Never". Defaults to "Solution".
|GHD_User_Notification       || Optional    || Manages the submitter notifications. Possible values are "Solution", "Every Change" and "Never". Defaults to "Solution".
|-
|-
|GHD_Routing_Type       || Optional    || Manages whether the ticket will be routed to an NGI/ROC directly or to TPM. Please provide value "SITE/ROC" for bypassing the TPM. Defaults to "TPM".
|GHD_VO_Specific       || Optional    || Flag indicating whether a problem is specific to a given VO or not. Possible values are "Yes" and "No". Defaults to "No".
|}
|}


Line 80: Line 83:
{|border="1"
{|border="1"
!      XML element !! Mode        !! Comments
!      XML element !! Mode        !! Comments
|-
|GHD_Last_Login       || '''Mandatory'''|| Account used by the SOAP client.
|-
|GHD_Last_Modifier    || '''Mandatory'''|| Name of the person who did the last ticket update.
|-
|GHD_Request_ID        || '''Mandatory'''|| GGUS ticket ID.
|-
|-
|GHD_Affected_Site    || Optional    || Site affected by the problem. Possible values are site names from GOCDB and OIMDB.
|GHD_Affected_Site    || Optional    || Site affected by the problem. Possible values are site names from GOCDB and OIMDB.
|-
|GHD_Responsible_Unit  || Optional    || Support unit in charge of the ticket. GGUS support units are listed at https://ggus-helmut.ggus.eu/pages/resp_unit_info.php.
|-
|-
|GHD_Assign_To        || Optional    || Add mail address for assigning a ticket to a dedicated person.
|GHD_Assign_To        || Optional    || Add mail address for assigning a ticket to a dedicated person.
Line 89: Line 96:
|GHD_Carbon_Copy      || Optional    || Add mail addresses for notifying people on this ticket. Please use semi-colon as delimiter.
|GHD_Carbon_Copy      || Optional    || Add mail addresses for notifying people on this ticket. Please use semi-colon as delimiter.
|-
|-
|GHD_VO_Specific      || Optional    || Flag indicating whether a problem is specific to a given VO or not. Possible values are "Yes" and "No". Defaults to "No".
|GHD_Detailed_Solution || Optional    || Solution text required if changing status to "solved" or "unsolved".
|-
|-
|GHD_Last_Login       || '''Mandatory'''|| Account used by the SOAP client.
|GHD_Involve       || Optional    || Mail addresses of people involved in ticket solution process.
|-
|-
|GHD_Last_Modifier    || '''Mandatory'''|| Name of the person who did the last ticket update.
|GHD_Internal_Diary    || Optional    || Internal comment for support staffs only.
|-
|-
|GHD_Priority       || Optional    || Ticket priority level. Possible values are "less urgent", "urgent", "very urgent" and "top priority". Defaults to "less urgent".
|GHD_Priority       || Optional    || Ticket priority level. Possible values are "less urgent", "urgent", "very urgent" and "top priority". Defaults to "less urgent".
|-
|-
|GHD_Short_Description || Mandatory  || Ticket subject.
|GHD_Problem_Type      || Optional    || Possible values are given here: [[GGUS:Type_Of_Problem]]. Defaults to "Other Services".
|-
|-
|GHD_Type_Of_Problem  || Optional    || Possible values are given here: [[GGUS:Type_Of_Problem]]. Defaults to "Other Services".
|GHD_Public_Diary      || Optional    || Public comment that will trigger a notification to the ticket submitter.
|-
|-
|GHD_Detailed_Solution || Optional    || Solution text required if changing status to "solved" or "unsolved".
|GHD_Responsible_Unit  || Optional    || Support unit in charge of the ticket. GGUS support units are listed at https://ggus.eu/pages/resp_unit_info.php.
|-
|-
|GHD_Public_Diary      || Optional    || Public comment that will trigger a notification to the ticket submitter.
|GHD_Soap_Client_Data  || Optional    || Hidden free text field for keeping soap client data.
|-
|-
|GHD_Internal_Diary    || Optional    || Internal comment for support staffs only.
|GHD_Status            || Optional    || Ticket status. Possible status values are listed here: [[GGUS:Status_Values]]
|-
|-
|GHD_Request_ID        || '''Mandatory'''|| GGUS ticket ID.
|GHD_Subject          || Optional    || Ticket subject.
|-
|-
|GHD_Status            || Optional    || Ticket status. Possible status values are listed here: [[GGUS:Status_Values]]
|GHD_VO_Specific      || Optional    || Flag indicating whether a problem is specific to a given VO or not. Possible values are "Yes" and "No". Defaults to "No".
|}
|}


===Output values===
===Output values===
In case of success this operation will return the ticket ID used for calling the OpModifyTeam operation.
In case of success this operation will return the ticket ID used for calling the OpModifyTeam operation.


==OpGetTeam==
==OpGetTeam==
This operation is being used for getting the data of a team ticket searching by ticket ID. The result gives the fields like listed in the table below.  
This operation is being used for getting the data of a team ticket searching by ticket ID. The result gives the fields like listed below.  
 
===Input values===
* GHD_Request_ID


{|border="1"
===Output values===
!      XML element !! Mode        !! Comments
* GHD_Affected_Site
|-
* GHD_Affected_VO
|GHD_Affected_Site       || Optional    || Site affected by the problem. Possible values are site names from GOCDB and OIMDB.
* GHD_Assign_To
|-
* GHD_Carbon_Copy
|GHD_Affected_VO       || Mandatory  || VO affected by the problem. Please set to "biomed".
* GHD_Create_Date
|-
* GHD_Description
|GHD_Carbon_Copy       || Optional    || Add mail addresses for notifying people on this ticket. Please use semi-colon as delimiter.
* GHD_Detailed_Solution
|-
* GHD_Internal_Diary
|GHD_Ticket_Category       || Optional    || Defaults to "Incident". Other values are "Change Request" and "Documentation".
* GHD_Involve
|-
* GHD_Last_Modifier
|GHD_Date_Time_Prob       || Optional    || Date and time the problem occurred. Please use format YYYY-MM-DD hh:mm:ss. Defaults to the submit time.
* GHD_Meta_Status
|-
* GHD_Modified_Date
|GHD_Description       || Optional    || Detailed description of the problem.Length is up to 4000 chars.
* GHD_Priority
|-
* GHD_Problem_Type
|GHD_E_Mail                    || Mandatory  || Mail address of ticket submitter.
* GHD_Public_Diary
|-
* GHD_Responsible_Unit
|GHD_VO_Specific       || Optional    || Flag indicating whether a problem is specific to a given VO or not. Possible values are "Yes" and "No". Defaults to "No".
* GHD_Soap_Client_Data
|-
* GHD_Status
|GHD_Last_Login               || Mandatory  || Account used by the SOAP client.
* GHD_Subject
|-
* GHD_Submitter
|GHD_Last_Modifier       || Mandatory  || Name of the person who did the last ticket update.
* GHD_VO_Specific
|-
|GHD_Cert_DN               || Mandatory  || DN string of the certificate used by the ticket submitter
|-
|GHD_MoU_Area               || Mandatory  || Possible values are given on [[GGUS:MoU]]. As all these values refer to an MoU of the WLCG VOs I suggest using "Other".
|-
|GHD_Name               || Optional    || Name of ticket submitter.
|-
|GHD_Notification_Recipients  || Optional    || Manages whether only the submitter or the whole team should be notified on ticket updates. Please provide value "Team". Defaults to "Submitter".
|-
|GHD_Priority               || Optional    || Ticket priority level. Possible values are "less urgent", "urgent", "very urgent" and "top priority". Defaults to "less urgent".
|-
|GHD_Short_Description       || Mandatory  || Ticket subject.
|-
|GHD_Ticket_Type       || Optional    || Please set to "TEAM"! Not providing the value "TEAM" will lead to a simple "USER" ticket!
|-
|GHD_Ticket_Update_Mode       || Optional    || Manages who will be able to update the ticket. Please provide value "Team". Defaults to "Submitter".
|-
|GHD_Type_Of_Problem       || Optional    || Possible values are given here: [[GGUS:Type_Of_Problem]]. Defaults to "Other Services".
|-
|GHD_User_Notification       || Optional    || Manages the submitter notifications. Possible values are "Solution", "Every Change" and "Never". Defaults to "Solution".
|-
|GHD_Routing_Type       || Optional    || Manages whether the ticket will be routed to an NGI/ROC directly or to TPM. Possible values are "Site/ROC" and "TPM". Defaults to "Solution".
|}




==OpGetListTeam==
==OpGetListTeam==
This operation is being used for getting the data of a boundle of team ticket searching by any criteria. The result gives the fields like listed in the table below.  
This operation is being used for getting all records of type "TEAM" affecting VO "biomed". The result is limited to the latest 500 records. <br>
 
===Input values===
None.


{|border="1"
===Output values===
!      XML element !! Mode        !! Comments
The result gives a couple of basic fields for getting an idea about what each ticket is related to. For getting details an OpGetTeam operation should be executed.
|-
 
|GHD_Affected_Site       || Optional    || Site affected by the problem. Possible values are site names from GOCDB and OIMDB.
* GHD_Affected_Site
|-
* GHD_Affected_VO
|GHD_Affected_VO       || Mandatory  || VO affected by the problem. Please set to "biomed".
* GHD_Last_Modifier
|-
* GHD_Modified_Date
|GHD_Carbon_Copy       || Optional    || Add mail addresses for notifying people on this ticket. Please use semi-colon as delimiter.
* GHD_Priority
|-
* GHD_Problem_Type
|GHD_Ticket_Category       || Optional    || Defaults to "Incident". Other values are "Change Request" and "Documentation".
* GHD_Request_ID
|-
* GHD_Responsible_Unit
|GHD_Date_Time_Prob       || Optional    || Date and time the problem occurred. Please use format YYYY-MM-DD hh:mm:ss. Defaults to the submit time.
* GHD_Status
|-
* GHD_VO_Specific
|GHD_Description       || Optional    || Detailed description of the problem.Length is up to 4000 chars.
* GHD_Subject
|-
 
|GHD_E_Mail                    || Mandatory  || Mail address of ticket submitter.
-->
|-
|GHD_VO_Specific       || Optional    || Flag indicating whether a problem is specific to a given VO or not. Possible values are "Yes" and "No". Defaults to "No".
|-
|GHD_Last_Login               || Mandatory  || Account used by the SOAP client.
|-
|GHD_Last_Modifier       || Mandatory  || Name of the person who did the last ticket update.
|-
|GHD_Cert_DN               || Mandatory  || DN string of the certificate used by the ticket submitter
|-
|GHD_MoU_Area               || Mandatory  || Possible values are given on [[GGUS:MoU]]. As all these values refer to an MoU of the WLCG VOs I suggest using "Other".
|-
|GHD_Name               || Optional    || Name of ticket submitter.
|-
|GHD_Notification_Recipients  || Optional    || Manages whether only the submitter or the whole team should be notified on ticket updates. Please provide value "Team". Defaults to "Submitter".
|-
|GHD_Priority               || Optional    || Ticket priority level. Possible values are "less urgent", "urgent", "very urgent" and "top priority". Defaults to "less urgent".
|-
|GHD_Short_Description       || Mandatory  || Ticket subject.
|-
|GHD_Ticket_Type       || Optional    || Please set to "TEAM"! Not providing the value "TEAM" will lead to a simple "USER" ticket!
|-
|GHD_Ticket_Update_Mode       || Optional    || Manages who will be able to update the ticket. Please provide value "Team". Defaults to "Submitter".
|-
|GHD_Type_Of_Problem       || Optional    || Possible values are given here: [[GGUS:Type_Of_Problem]]. Defaults to "Other Services".
|-
|GHD_User_Notification       || Optional    || Manages the submitter notifications. Possible values are "Solution", "Every Change" and "Never". Defaults to "Solution".
|-
|GHD_Routing_Type       || Optional    || Manages whether the ticket will be routed to an NGI/ROC directly or to TPM. Possible values are "Site/ROC" and "TPM". Defaults to "Solution".
|}


==  What if I have questions which are not dealt with by this FAQ? ==  
=  What if I have questions which are not dealt with by this FAQ? =
Open a {{GGUS ticket}} indicating that it should be directed at the GGUS team.
Open a [https://ggus.eu/pages/ticket.php GGUS ticket] indicating that it should be directed at the GGUS team.
{{GGUS search}}
{{GGUS search}}

Latest revision as of 09:02, 24 July 2013

GGUS-logo.jpg


GGUS wiki / GGUS FAQ / GGUS Documentation / GGUS Helpdesk


FAQ for the Biomed VO dashboard interface

The content of this page has been moved to GGUS:VO_TEAM_Ticket_Interface_FAQ

What if I have questions which are not dealt with by this FAQ?

Open a GGUS ticket indicating that it should be directed at the GGUS team.

Search