describeNamedMaps

Descripción

Considera una lista de mapas como la entrada en la solicitud y entrega la descripción de dichos mapas.

Flujo de autorización de ACL

Para obtener la descripción de los mapas, será necesario que el usuario (o las funciones a las que pertenezca) ejecute permisos en los mapas con nombre asignado de la siguiente manera:

  • "EJECUTAR" para el tipo de entidad "Location Intelligence.Named Resources"

Mensajes

La siguiente tabla enumera los mensajes de solicitud y de respuesta para la operación describeNamedMaps.

Haga clic en el nombre de un mensaje para obtener más información acerca de este.

Mensaje Descripción
DescribeNamedMapsRequest El mensaje de solicitud de la operación describeNamedMaps.
DescribeNamedMapsResponse El mensaje de respuesta de la operación describeNamedMaps.

Ejemplos

Solicitud SOAP de ejemplo: 

<?xml version="1.0"?>   
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:v1="http://www.mapinfo.com/midev/service/mapping/v1">  
   <S:Header/>  
   <S:Body>  
      <v1:DescribeNamedMapsRequest>  
        <v1:NamedMap>/Samples/NamedMaps/MapWithLayerStyle</v1:NamedMap>  
        <v1:NamedMap>/Samples/NamedMaps/USAWithGradSymLayer</v1:NamedMap>  
        <v1:NamedMap>/DoesNotExist</v1:NamedMap>  
      </v1:DescribeNamedMapsRequest>  
   </S:Body>  
</S:Envelope>
Respuesta SOAP de ejemplo: 

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
       <soap:Body>
              <DescribeNamedMapsResponse 
		xmlns="http://www.mapinfo.com/midev/service/mapping/v1" 
		xmlns:ns2="http://www.mapinfo.com/midev/service/mappingcommon/v1" 
		xmlns:ns3="http://www.mapinfo.com/midev/service/table/v1" 
		xmlns:ns4="http://www.mapinfo.com/midev/service/style/v1" 
		xmlns:ns5="http://www.mapinfo.com/midev/service/featurecollection/v1" 
		xmlns:ns6="http://www.mapinfo.com/midev/service/geometries/v1" 
		xmlns:ns7="http://www.mapinfo.com/midev/service/theme/v1" 
		xmlns:ns8="http://www.mapinfo.com/midev/service/common/v1" 
		xmlns:ns9="http://www.mapinfo.com/midev/service/units/v1">
                     <Map name="/Samples/NamedMaps/MapWithLayerStyle">
                           ...
                     </Map>
                     <Map name="/Samples/NamedMaps/USAWithGradSymLayer">
                           ...
                     </Map>
                     <ErrorMessages>
                           <ns8:ErrorMessage name="/DoesNotExist">
				RepositoryEx_ResourceNotFound: 
				Resource was not found - /DoesNotExist</ns8:ErrorMessage>
                     </ErrorMessages>
              </DescribeNamedMapsResponse>
       </soap:Body>
</soap:Envelope>
Auxiliar SOAP de ejemplo para Java:
package mapping.sample;

import mapping.utility.Preference;
import mapping.utility.PrintMappingResponse;

import com.mapinfo.midev.service.mapping.v1.DescribeNamedMapsRequest;
import com.mapinfo.midev.service.mapping.v1.DescribeNamedMapsResponse;
import com.mapinfo.midev.service.mapping.ws.v1.MappingServiceInterface;
import com.mapinfo.midev.service.mapping.ws.v1.ServiceException;

public class DescribeNamedMaps {
	private static DescribeNamedMapsRequest createDescribeNamedMapsRequest() throws Exception {
		DescribeNamedMapsRequest request = new DescribeNamedMapsRequest();
		request.getNamedMap().add("/Samples/NamedMaps/MapWithLayerStyle");
		request.getNamedMap().add("/Samples/NamedMaps/MapWithLayer");
		request.getNamedMap().add("/Samples/NamedMaps/USAWithGradSymLayer");
		return request;
	}

	public static void main(String[] args) {
		try {
			MappingServiceInterface mapping = Preference.getServiceinterface();
			DescribeNamedMapsRequest request = createDescribeNamedMapsRequest();
			DescribeNamedMapsResponse response = mapping.describeNamedMaps(request);
			PrintMappingResponse.printDescribeNamedMapsResponse(response);
		} catch (ServiceException se) {
			PrintMappingResponse.printError(se);
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}
Auxiliar SOAP de ejemplo para NET:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

using System.ServiceModel;
using MappingSamples.MappingService;

namespace MappingSamples
{
    class DescribeNamedMaps
    {
        static void Main(string[] args)
        {
            try
            {
                // create the client to communicate to the service
                MappingServiceInterfaceClient client = Preference.getServiceInterface();

                // create the DescribeNamedMapsRequest.
                DescribeNamedMapsRequest request = createDescribeNamedMapsRequest();

                // call the describeNamedMaps function.
                DescribeNamedMapsResponse response = client.describeNamedMaps(request);
                if (response.Map == null)
                {
                    Console.WriteLine("No maps found on the server.");
                }
                else
                {
                    foreach (Map map in response.Map)
                    {
                        if (map != null)
                        {
                            Console.WriteLine("Map information:");
                            PrintUtils.printMap(map);
                            Console.WriteLine("------");
                        }
                    }
                }
            }
            catch (FaultException<MapInfoDeveloperException> ee)
            {
                String s = ee.Message;
                Console.Out.WriteLine("Service Error returned: " + s);
            }
            catch (Exception ex)
            {
                String e = ex.ToString();
                Console.Out.WriteLine("Error: " + ex.ToString());
            }
            Console.Read();
        }

        // This creates a DescribeNamedMapsRequest.
        private static DescribeNamedMapsRequest createDescribeNamedMapsRequest()
        {
            // create the DescribeNamedMapsRequest
            DescribeNamedMapsRequest req = new DescribeNamedMapsRequest();
            req.NamedMap = new string[3];
            req.NamedMap[0] = "/Samples/NamedMaps/MapWithLayerStyle";
            req.NamedMap[1] = "/Samples/NamedMaps/MapWithLayer";
            req.NamedMap[2] = "/Samples/NamedMaps/USAWithGradSymLayer"; 

            return req;
        }
    }
}