如何使用 PHP 工具包从 salesforce force.com 检索元数据?

Question

我想从我的 salesforce 实例中检索参数的值。例如，我想恢复受信任的 IP 范围： https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_securitysettings.htm

为此，请使用元数据 API。为了访问此API，我使用PHP的 force.com 工具包。

但是，给出的示例仅涉及参数的创建或更新：

https://developer.salesforce.com/blogs/developer-relations/2011/11/extending-the-force-com-toolkit-for-php-to-handle-the-metadata-api.html

如何简单地获取参数的值(例如受信任的 IP 范围(？

Answer 1

Salesforce附带的PHP工具包已经过时，不应该使用。有更近的分叉/社区项目(一，二(试图实现现代PHP客户端，也许其中一个会适合你。

一个简单的(r(解决方案是通过对元数据API的纯SOAP调用来检索SecuritySettings。API 版本设置为46.0的请求有效负载应为

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
<types>
<members>Security</members>
<name>Settings</name>
</types>
<version>46.0</version>
</Package>

响应看起来像这样(仅显示相关部分，实际响应要大得多(

<?xml version="1.0" encoding="UTF-8"?>
<SecuritySettings xmlns="http://soap.sforce.com/2006/04/metadata">
<networkAccess>
<ipRanges>
<description>...</description>
<end>1.255.255.255</end>
<start>0.0.0.0</start>
</ipRanges>
</networkAccess>
</SecuritySettings>

翻译成 PHP：

$wsdl = PUBLIC_PATH . '/wsdl-metadata.xml'; 
$apiVersion = 46.0;
$singlePackage = true;
$members = 'Security';
$name = 'Settings';
$params = new StdClass();
$params->retrieveRequest = new StdClass();
$params->retrieveRequest->apiVersion = $apiVersion;
$params->retrieveRequest->singlePackage = $singlePackage;
$params->retrieveRequest->unpackaged = new StdClass();
$params->retrieveRequest->unpackaged->version = $apiVersion;
$params->retrieveRequest->unpackaged->type = new stdClass();
$params->retrieveRequest->unpackaged->type->members = $members;
$params->retrieveRequest->unpackaged->type->name = $name;
$option = [
'trace' => TRUE,
];
// Namespaces
$namespace = 'http://soap.sforce.com/2006/04/metadata';
$client = new SoapClient($wsdl, $option);
$header = new SoapHeader($namespace, "SessionHeader", array ('sessionId' => $token)); // NEED: access token
$client->__setSoapHeaders($header);
$client->__setLocation($serverUrl); // NEED: service endpoint URL
$serviceResult = $client->retrieve($params);

需要提供访问令牌 ($token( 和服务终结点 ($serverUrl(。

Answer 2

对于任何试图让它工作的人来说，identigral 的例子对我不起作用，必须执行以下操作：

将$client->setEndpoint($serverUrl);更改为$client->__setLocation($serverUrl);

我正在使用 Oauth 登录，因此您需要从响应中构造$serverUrl：+ '/services/Soap/m/46.0/' +

例： "https://your-production-or-sandbox-name.my.salesforce.com/services/Soap/m/46.0/your-org-id">