Difference between revisions of "Service Discovery (SERF)"
(No difference)
|
Revision as of 15:48, October 28, 2014
The Service Entry Resource Format (SERF) is a NASA documentation dialect for service discovery, selection and usage.
SERF for Service Description - Required
Concept | Description | Dialect (Fit) Paths |
---|---|---|
Metadata Identifier | A phrase or string which uniquely identifies the metadata file/record. | ISO /*/gmd:fileIdentifier/gco:CharacterString ISO-1 /mdb:MD_Metadata/mdb:metadataIdentifier/mcc:MD_Identifier DIF /dif:DIF/dif:Entry_Id SERF /serf:SERF/serf:Entry_ID |
Resource Title | A short description of the resource. The title should be descriptive enough so that when a user is presented with a list of titles the general content of the data set can be determined. | ISO /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:title/gco:CharacterString ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:citation/cit:CI_Citation/cit:title/gco:CharacterString ECHO /*/echo:ShortName>/*/echo:LongName DIF /dif:DIF/dif:Entry_Title DIF /dif:DIF/dif:Data_Set_Citation/dif:Dataset_Title ECS /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:ShortName > /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:LongName SERF /serf:SERF/serf:Entry_Title |
Keyword | A word or phrase that describes some aspect of a resource. Can be one of several types. Note: The general identification keywords usually have a type of "theme" and are refered to as "theme keywords". Other types and vocabularies are used for other information. Service Entry Resource Format (SERF) requires a Science and a Service GCMD Keyword. This concept is called "Subject" in the CSW Specification. | ISO (1) /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords[gmd:type/gmd:MD_KeywordTypeCode='theme']/gmd:keyword/gco:CharacterString ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:descriptiveKeywords/mri:MD_Keywords[mri:type/mri:MD_KeywordTypeCode='theme']/mri:keyword/gco:CharacterString ECHO (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:CategoryKeyword ECHO (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:TopicKeyword ECHO (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:TermKeyword ECHO (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel1Keyword/echo:Value ECHO (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel2Keyword/echo:Value ECHO (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel3Keyword ECHO (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:DetailedVariableKeyword DIF (1) /dif:DIF/dif:Parameters/dif:Category DIF (1) /dif:DIF/dif:Parameters/dif:Topic DIF (1) /dif:DIF/dif:Parameters/dif:Term DIF (1) /dif:DIF/dif:Parameters/dif:Variable_Level_1 DIF (1) /dif:DIF/dif:Parameters/dif:Variable_Level_2 DIF (1) /dif:DIF/dif:Parameters/dif:Variable_Level_3 DIF (1) /dif:DIF/dif:Parameters/dif:Detailed_Variable ECS (1) /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:DisciplineKeyword ECS (1) /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:TopicKeyword ECS (1) /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:TermKeyword ECS (1) /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:VariableKeyword SERF /serf:SERF/serf:Keyword |
Distribution Contact | Contact information for the organization or individual that distributes the resource. | ISO /gmd:MD_Metadata/gmd:distributionInfo/gmd:MD_Distribution/gmd:distributor/gmd:MD_Distributor/gmd:distributorContact/gmd:CI_ResponsibleParty ISO-1 /mdb:MD_Metadata/mdb:distributionInfo/mrd:MD_Distribution/mrd:distributor/mrd:MD_Distributor/mrd:distributorContact/cit:CI_Responsibility ECHO /echo:Collection/echo:Contacts/echo:Contact DIF /dif:DIF/dif:Data_Center/dif:Personnel/dif:Role SERF /serf:SERF/serf:Service_Provider |
Abstract | A paragraph describing the resource. Note: This concept is called "Desciption" in Catalog Services for the Web. | ISO /*/gmd:identificationInfo/*/gmd:abstract/gco:CharacterString ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:abstract/gco:CharacterString ECHO /*/echo:Description DIF /dif:DIF/dif:Summary/dif:Abstract ECS /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:CollectionDescription SERF /serf:SERF/serf:Summary/serf:Abstract |
Purpose | A paragraph describing the original purpose for collecting the dataset. | ISO (1) /*/gmd:identificationInfo/*/gmd:purpose/gco:CharacterString ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:purpose/gco:CharacterString ECHO (1) /*/SuggestedUsage DIF (1) /dif:DIF/dif:Summary/dif:Purpose ECS (1) /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:SuggestedUsage1 SERF /serf:SERF/serf:Summary/serf:Purpose |
SERF for Data Service Selection - Highly Recommended
Concept | Description | Dialect (Fit) Paths |
---|---|---|
Resource Citation | Citation for the resource. | ISO /*/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/srv:SV_ServiceIdentification/mri:citation/cit:CI_Citation SERF /serf:SERF/serf:Service_Citation |
Media | Media on which the resource is available | ISO /gmd:MD_Metadata/gmd:distributionInfo/gmd:MD_Distribution/gmd:transferOptions/gmd:MD_DigitalTransferOptions/gmd:offLine/gmd:MD_Medium/gmd:name/gmd:MD_MediumNameCode/@codeListValue ISO-1 /mdb:MD_Metadata/mdb:distributionInfo/mrd:MD_Distribution/mrd:transferOptions/mrd:MD_DigitalTransferOptions/mrd:offLine/mrd:MD_Medium/mrd:name/cit:CI_Citation/cit:title/gco:CharacterString DIF /dif:DIF/dif:Distribution/dif:Distribution_Media SERF /serf:SERF/serf:Distribution/serf:Distribution_Media |
Resource Contact | The organization or person responsible for answering questions about the resource. | ISO /*/gmd:identificationInfo/*/gmd:pointOfContact ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:pointOfContact/cit:CI_Responsibility[cit:role/cit:CI_RoleCode='pointOfContact'] ECHO /*/echo:ArchiveCenter ECHO /*/echo:Contacts/echo:Contact DIF /dif:DIF/dif:Personnel[dif:Role='INVESTIGATOR'] ECS /CollectionMetaDataFile/CollectionMetaDataSets/Collections/CollectionMetaData/Contact[Role='User Services'] SERF /serf:SERF/serf:Personnel |
Resource Cost or Fees | Cost associated with access to the resource | ISO /*/gmd:distributionInfo/gmd:MD_Distribution/gmd:distributor/gmd:MD_Distributor/gmd:distributionOrderProcess/gmd:MD_StandardOrderProcess/gmd:fees/gco:CharacterString ISO-1 /mdb:MD_Metadata/mdb:distributionInfo/mrd:MD_Distribution/mrd:distributionFormat/mrd:MD_Format/mrd:formatDistributor/mrd:MD_Distributor/mrd:distributionOrderProcess/mrd:MD_StandardOrderProcess/mrd:fees/gco:CharacterString ECHO /*/echo:Price DIF /dif:DIF/dif:Distribution/dif:Fees SERF /serf:SERF/serf:Distribution/serf:Fees |
Resource Format | The physical or digital manifestation of the resource | ISO /*/gmd:distributionInfo/gmd:MD_Distribution/gmd:distributor/gmd:MD_Distributor/gmd:distributorFormat/gmd:MD_Format/gmd:name/gco:CharacterString ISO /*/gmd:distributionInfo/gmd:MD_Distribution/gmd:distributionFormat/gmd:MD_Format/gmd:name/gco:CharacterString ISO-1 /mdb:MD_Metadata/mdb:distributionInfo/mrd:MD_Distribution/mrd:distributionFormat/mrd:MD_Format ISO-1 /mdb:MD_Metadata/mdb:distributionInfo/mrd:MD_Distribution/mrd:distributor/mrd:MD_Distributor/mrd:distributorFormat/mrd:MD_Format ECHO /*/echo:DataFormat DIF /dif:DIF/dif:Distribution/dif:Distribution_Format SERF /serf:SERF/serf:Distribution/serf:Distribution_Format |
Instrument Keyword | Keywords that describe the instrument used to collect the resource. | ISO /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords[gmd:type/gmd:MD_KeywordTypeCode='instrument']/gmd:keyword/gco:CharacterString ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:descriptiveKeywords/mri:MD_Keywords[mri:type/mri:MD_KeywordTypeCode='instrument']/mri:keyword/gco:CharacterString ECHO //echo:Platforms/echo:Platform/echo:Instruments/echo:Instrument/echo:ShortName ECHO //echo:Platforms/echo:Platform/echo:Instruments/echo:Instrument/echo:LongName DIF /dif:DIF/dif:Sensor_Name/dif:Short_Name DIF /dif:DIF/dif:Sensor_Name/dif:Long_Name SERF /serf:SERF/serf:Sensor_Name/serf:Short_Name SERF /serf:SERF/serf:Sensor_Name/serf:Long_Name |
Resource Title | A short description of the resource. The title should be descriptive enough so that when a user is presented with a list of titles the general content of the data set can be determined. | ISO /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:title/gco:CharacterString ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:citation/cit:CI_Citation/cit:title/gco:CharacterString ECHO /*/echo:ShortName>/*/echo:LongName DIF /dif:DIF/dif:Entry_Title DIF /dif:DIF/dif:Data_Set_Citation/dif:Dataset_Title ECS /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:ShortName > /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:LongName SERF /serf:SERF/serf:Entry_Title |
Platform Keyword | Keywords that describe the platform used to collect the resource. | ISO /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords[gmd:type/gmd:MD_KeywordTypeCode='platform']/gmd:keyword/gco:CharacterString ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:descriptiveKeywords/mri:MD_Keywords[mri:type/mri:MD_KeywordTypeCode='platform']/mri:keyword/gco:CharacterString ECHO //echo:Platforms/echo:Platform/echo:ShortName ECHO //echo:Platforms/echo:Platform/echo:LongName SERF /serf:SERF/serf:Source_Name/serf:Short_Name SERF /serf:SERF/serf:Source_Name/serf:Long_Name |
Resource Quality Description | Description of the quality of the resource or any quality assurance procedures followed in producing the resource. Note: ISO-1 provides free text fields for describing quality information in the DQ_MeasureReference, DQ_EvaluationMethod, and DQ_DescriptiveResult objects. | DIF /dif:DIF/Quality SERF /serf:SERF/serf:Quality |
Project Keyword | Keywords that describe the Project used to collect the resource. | ISO /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords[gmd:type/gmd:MD_KeywordTypeCode='project']/gmd:keyword/gco:CharacterString ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:descriptiveKeywords/mri:MD_Keywords[mri:type/mri:MD_KeywordTypeCode='project']/mri:keyword/gco:CharacterString SERF /serf:SERF/serf:Project/serf:Short_Name SERF /serf:SERF/serf:Project/serf:Long_Name |
Resource Access Constraints | Information about any constraints for accessing the data set. This includes any special restrictions, legal prerequisites, limitations and/or warnings on obtaining the data set. Some words that may be used in this field include: Public, In-house, Limited, Additional detailed instructions on how to access the data can be entered in this field. | ISO /*/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:resourceConstraints/gmd:MD_LegalConstraints/gmd:legalConstraints/gmd:MD_RestrictionCode ISO /*/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:resourceConstraints/gmd:MD_LegalConstraints/gmd:otherConstraints/gco:CharacterString ISO /*/gmd:identificationInfo/srv:SV_ServiceIdentification/srv:restrictions/gmd:MD_LegalConstraints/gmd:legalConstraints/gco:CharacterString ISO /*/gmd:identificationInfo/srv:SV_ServiceIdentification/srv:restrictions/gmd:MD_LegalConstraints/gmd:otherConstraints/gco:CharacterString ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:resourceConstraints/mco:MD_Constraints ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:resourceConstraints/mco:MD_LegalConstraints ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:resourceConstraints/mco:MD_SecurityConstraints ECHO /*/echo:RestrictionFlag ECHO /*/echo:RestrictionComment DIF /dif:DIF/dif:Access_Constraints ECS /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:AccessConstraints SERF /serf:DIF/serf:Access_Constraints |
Resource Use Constraints | Information about how the data may or may not be used after access is granted to assure the protection of privacy or intellectual property. This includes any special restrictions, legal prerequisites, terms and conditions, and/or limitations on using the data set. Data providers may request acknowledgement of the data from users and claim no responsibility for quality and completeness of data. | ISO /*/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:resourceConstraints/gmd:MD_Constraints/gmd:useLimitation/gco:CharacterString ISO /*/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:resourceConstraints/gmd:MD_LegalConstraints/gmd:useConstraints/gmd:MD_RestrictionCode ISO /*/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:resourceConstraints/gmd:MD_LegalConstraints/gmd:otherConstraints/gco:CharacterString ISO /*/gmd:identificationInfo/srv:SV_ServiceIdentification/srv:restrictions/gmd:MD_LegalConstraints/gmd:legalConstraints/gco:CharacterString ISO /*/gmd:identificationInfo/srv:SV_ServiceIdentification/srv:restrictions/gmd:MD_LegalConstraints/gmd:otherConstraints/gco:CharacterString ISO /*/gmd:identificationInfo/srv:SV_ServiceIdentification/srv:restrictions/gmd:MD_Constraints/gmd:useLimitation/gco:CharacterString ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:resourceConstraints/mco:MD_Constraints ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:resourceConstraints/mco:MD_LegalConstraints ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:resourceConstraints/mco:MD_SecurityConstraints ECHO /*/echo:RestrictionFlag ECHO /*/echo:RestrictionComment DIF /dif:DIF/dif:Use_Constraints SERF /serf:DIF/serf:Use_Constraints |
Distribution Contact | Contact information for the organization or individual that distributes the resource. | ISO /gmd:MD_Metadata/gmd:distributionInfo/gmd:MD_Distribution/gmd:distributor/gmd:MD_Distributor/gmd:distributorContact/gmd:CI_ResponsibleParty ISO-1 /mdb:MD_Metadata/mdb:distributionInfo/mrd:MD_Distribution/mrd:distributor/mrd:MD_Distributor/mrd:distributorContact/cit:CI_Responsibility ECHO /echo:Collection/echo:Contacts/echo:Contact DIF /dif:DIF/dif:Data_Center/dif:Personnel/dif:Role SERF /serf:SERF/serf:Service_Provider |
Service Location | Endpoint for accessing the service. | ISO /*/gmd:identificationInfo/srv:SV_ServiceIdentification/srv:containsOperations/srv:SV_OperationMetadata/srv:connectPoint/gmd:CI_OnlineResource/gmd:linkage/gmd:URL ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/srv:SV_ServiceIdentification/srv:containsOperations/srv:SV_OperationMetadata/srv:connectPoint/cit:CI_OnlineResource/cit:linkage/gco:CharacterString SERF /serf:SERF/serf:Service_Citation/serf:URL |
Resource Language | The language of the resource. | ISO /*/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:language/gco:CharacterString ISO-1 /mdb:MD_Metadata/mdb:defaultLocale/lan:PT_Locale/lan:language/lan:LanguageCode ISO-1 /mdb:MD_Metadata/mdb:otherLocale/lan:PT_Locale/lan:language/lan:LanguageCode DIF /dif:DIF/dif:Data_Set_Language SERF /serf:SERF/serf:Service_Language |
xPath Note: The xPaths included in this table use several wildcards. // means any path, so //gmd:CI_ResponsibleParty indicates a gmd:CI_ResponsibleParty anywhere in an XML file. /*/ indicates a single level with several possible elements. This usually indicates one of several concrete realizations of an abstract object. For example /*/gmd:identificationInfo could be gmd:MD_Metadata/gmd:identificationInfo or gmi:MI_Metadata/gmd:identificationInfo and gmd:identificationInfo//*/gmd:descriptiveKeywords could be gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords or gmd:identificationInfo/srv:SV_ServiceIdentification/gmd:descriptiveKeywords. Fit: The fit of the dialect path with the concept is estimated on a scale of 1 = excellent two-way fit, 2 = one-way fit or some other problem, 3 - extension required.