AI-generated Key Takeaways
-
An Attribute object represents an XML attribute and is used in conjunction with XmlService.
-
Attributes have methods to get and set their name, namespace, and value.
-
The provided example demonstrates how to parse XML, retrieve attributes, and add a new attribute with a combined value.
A representation of an XML attribute.
// Reads the first and last name of each person and adds a new attribute with // the full name. let xml = '<roster>' + '<person first="John" last="Doe"/>' + '<person first="Mary" last="Smith"/>' + '</roster>' ; const document = XmlService . parse ( xml ); const people = document . getRootElement (). getChildren ( 'person' ); for ( let i = 0 ; i < people . length ; i ++ ) { const person = people [ i ]; const firstName = person . getAttribute ( 'first' ). getValue (); const lastName = person . getAttribute ( 'last' ). getValue (); person . setAttribute ( 'full' , ` ${ firstName } ${ lastName } ` ); } xml = XmlService . getPrettyFormat (). format ( document ); Logger . log ( xml );
Methods
| Method | Return type | Brief description |
|---|---|---|
String
|
Gets the local name of the attribute. | |
Namespace
|
Gets the namespace for the attribute. | |
String
|
Gets the value of the attribute. | |
Attribute
|
Sets the local name of the attribute. | |
Attribute
|
Sets the namespace for the attribute. | |
Attribute
|
Sets the value of the attribute. |
Detailed documentation
get
Name()
Gets the local name of the attribute. If the attribute has a namespace prefix, use get
. get
to get the prefix.
Return
String
— the local name of the attribute
get
Namespace()
get
Value()
Gets the value of the attribute.
Return
String
— the value of the attribute
set
Name(name)
Sets the local name of the attribute. To set a namespace prefix for the attribute, use set
in conjunction with Xml
.
Parameters
| Name | Type | Description |
|---|---|---|
name
|
String
|
the local name to set |
Return
Attribute
— the attribute, for chaining
set
Namespace(namespace)
set
Value(value)
Sets the value of the attribute.
Parameters
| Name | Type | Description |
|---|---|---|
value
|
String
|
the value to set |
Return
Attribute
— the attribute, for chaining

