createLibraries インターフェイス

createLibraries インターフェイスは、新しいライブラリを作成するために使用されます。すべての呼び出しの HTTP の応答には、変更されたライブラリの XML 構造が含まれます。新しいコードの識別子は、更新された XML ライブラリの構造から取得できます。

次の表は、createLibraries インターフェイスのパラメータを表しています。

インターフェイス URL	パラメータ	説明
`http://<front-end URL>/servicesExchange?hid=createLibraries`	sid	ユーザー認証用の Web サービストークンまたはセッション識別子。Web サービストークンは、Silk Central UI の設定ページから生成できます。このページにアクセスするには、Silk Central メニューに表示されているユーザー名にマウスカーソルを移動し、ユーザー設定を選択します。セッション識別子は、利用可能な Web サービスのうちの logonUser メソッドを呼び出すことで取得できます。

例：http://<front-end URL>/servicesExchange?hid=createLibraries&sid=<webServiceToken>

ライブラリを検証するために使用される XML スキーマ定義ファイルは、フロントエンドサーバー URL http://<フロントエンド URL>/silkroot/xsl/libraries.xsd を使用してダウンロードするか、フロントエンドサーバーのインストールフォルダ <Silk Central インストールフォルダ>/wwwroot/silkroot/xsl/libraries.xsd からコピーできます。

createLibraries Web サービスの例

以下のコードでは、Apache HttpClient を使用して、ライブラリが作成されます。

import org.apache.commons.httpclient.*; // Apache HttpClient

String webServiceToken = "e39a0b5b-45db-42db-84b2-b85028d954d5";

URL service = new URL("http", mWebServiceHelper.getHost(),
  mWebServiceHelper.getPort(), String.format("/servicesExchange?hid=%s&sid=%s",
  "createLibraries", webServiceToken));
	
HttpClient client = new HttpClient();
PostMethod filePost = new PostMethod(service.toExternalForm());
String xmlFile = loadTestPlanUtf8("libraries.xml");
StringPart xmlFileItem = new StringPart("libraries", xmlFile, "UTF-8");
xmlFileItem.setContentType("text/xml");
Part[] parts = {xmlFileItem};

filePost.setRequestEntity(new MultipartRequestEntity(parts, filePost.getParams()));
client.getHttpConnectionManager().getParams().setConnectionTimeout(60000);
int status = client.executeMethod(filePost);
System.out.println(filePost.getStatusLine());

Apache HttpComponents をダウンロードするには、http://hc.apache.org/downloads.cgi を参照してください。必要なライブラリについては、コンポーネントのドキュメントを参照してください。

ライブラリの例

次のコードは、createLibraries サービスを使用して Silk Central へアップロードすることができるライブラリの例を示しています。GrantedProjects セクションで 1 つまたは複数のプロジェクトが定義されている場合を除き、新しいライブラリは特定のプロジェクトでの使用に限定されません。

<?xml version="1.0" encoding="UTF-8"?>
<LibraryStructure xmlns="http://www.borland.com/TestPlanSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://<front-end URL>/silkroot/xsl/libraries.xsd">

  <Library name="Library 1">
    <Folder name="Folder 1">
      <Folder name="Folder 1.1">
        <SharedSteps name="Basic create user steps">
          <Step name="Login">
            <ActionDescription>
              Login with user admin.
            </ActionDescription>
            <ExpectedResult>Succesful login.</ExpectedResult>
            <CustomStepProperty name="Step Property 1">
                        <propertyValue>Step Property Value</propertyValue>
            </CustomStepProperty>
          </Step>
          <Step name="Create User">
            <ActionDescription>Create user tester</ActionDescription>
            <ExpectedResult>User created</ExpectedResult>
            <CustomStepProperty name="Step Property 1">
                        <propertyValue>Step Property Value</propertyValue>
            </CustomStepProperty>
          </Step>
          <Step name="Logout">
            <ActionDescription>
              Logout using start menu
            </ActionDescription>
            <ExpectedResult>Logged out.</ExpectedResult>
            <CustomStepProperty name="Step Property 1">
                        <propertyValue>Step Property Value</propertyValue>
            </CustomStepProperty>
          </Step>
        </SharedSteps>
      </Folder>
    </Folder>
    <GrantedProjects>
      <ProjectId>0</ProjectId>
      <ProjectId>1</ProjectId>
    </GrantedProjects>
  </Library>
</LibraryStructure>