Page Comparison

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <web:remoteAdministrationCall>
         <arg0>
            <loginId>admin@yellowfin.com.au</loginId>
            <password>test</password>
            <orgId>1</orgId>
            <function>ADDUSER<<function>LOGINUSER</function>    
               <person>           
     <userId>binish.sheikh@yellowfin.com.au</userId>                 <emailAddress>binish.sheikh@yellowfin.<userId>admin@yellowfin.com.au</emailAddress>userId>
                <password>admin</password>
                <firstName>Binish</firstName>
                <lastName>Sheikh</lastName>
                <roleCode>YFREPORTCONSUMER</roleCode><password>test</password>
              </person>
                  </arg0>
      </web:remoteAdministrationCall>
   </soapenv:Body>
</soapenv:Envelope>

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
         <return>
            <errorCode>0</errorCode>
            <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages><loginSessionId>689bce5624f1e5a312eb5ef7801ed9fc</loginSessionId>
            <messages>Creating<messages>Successfully NewAuthenticated User: via Webservicesadmin@yellowfin.com..<au</messages>
            <messages>Creating SessionBean for webservices user...</messages>
            <messages>Looking up user...</messages>
            <messages>Web Service Request Complete</messages>
            <sessionId>8090cb7879f7d5e72eab9625772c00b5<<sessionId>c8021e27fcc2ce507ff17ec1846919a5</sessionId>
            <statusCode>SUCCESS</statusCode>
         </return>
      </ns2:remoteAdministrationCallResponse>
   </S:Body>
</S:Envelope>

• こちらは、Yellowfinの新規ユーザーを作成する基礎的なリクエストであり、管理ユーザーとしてのログインと、実行するWebサービスの呼び出しの指定を含みます。今回の例では、admin@yellowfin.com.auをweb サービス管理者ユーザーに使用するため、こちらの呼び出しに以下のリクエストを実行します。
  
  

  Code Block
  language java theme Eclipse language java
  AdministrationServiceRequest rsr = new AdministrationServiceRequest(); rsr.setLoginId("admin@yellowfin.com.au"); rsr.setPassword("test"); rsr.setOrgId(1); rsr.setFunction("ADDUSERLOGINUSER");

  特定のクライアント組織に新規ユーザーを作成する場合は、こちらをコードに追加します。 

• LOGUINUSER関数は、ログインするユーザーを特定するために、AdministrationPersonオブジェクトを要求します。以下に例を示します。
  
  

  Eclipse

  Code Block
  theme

  ADDUSER関数は、新規Yellowfinユーザーの詳細を定義するために、AdministrationPersonオブジェクトを要求します。
  

  Code Block
  language java
  rsr.setOrgRef("org1"); // A new user will be added to the client org with "org1" as an organization reference ID

  orgRefパラメーターを定義しない場合は、新規ユーザーはデフォルト（プライマリー）組織内に作成されます。

• theme Eclipse language java

  AdministrationPerson ap = new AdministrationPerson();

  新規ユーザーを作成するには、これら必須パラメーターの提供が必要です。：UserId、FirstName、LastName、RoleCode、Password、EmailAddress
  

  Code Block
  theme Eclipse language java
  ap.setUserId("johnuser@yellowfin.smith@yellowfin.com.au"); // if Yellowfin authentication option is set to "email address" ap.setFirstNamesetPassword("Johnusertest"); aprsr.setLastNamesetPerson("Smith"); ap.setRoleCode("YFREPORTCONSUMER"); // Yellowfin role codes can be found performing this query against // Yellowfin configuration database: SELECT * FROM OrgRole ap.setPassword("test"); // Password must comply with your Yellowfin password policy ap.setEmailAddress("john.smith@yellowfin.com.au");

  AdministrationPersonオブジェクトのその他のパラメーターの設定はオプションです。

• リクエストに「ap」オブジェクトを渡します。
  

  Code Block
  language java
  rsr.setPerson(ap);

  ap);

  
  

• ユーザーが複数のクライアント組織に所属する場合、特定の組織を指定してログインさせることができます。例：
  
  

  Code Block
  language java theme Eclipse
  rsr.setOrgRef("org1");

  この場合「org1」はクライアント組織参照IDです。この参照IDが提供されない場合、ユーザーはログインをするために、クライアント組織選択ページに誘導されます。

  
  

• ユーザーアカウントがYellowfinに存在しない場合、webサービスエラー25が発生します：COULD_NOT_AUTHENTICATE_USER

  
  

• LOGUINUSER関数は、setParameter()メソッドを使用することで、異なるログインセッションパラメーターを指定することができます。

  例えば、以下のコードは、user@yellowfin.com.auをYellowfinにログインさせますが、Yellowfinのヘッダーは表示されず、呼び出しを実行することで、ユーザーはタイムラインページへ誘導されます。
  
  

  Code Block
  language java theme Eclipse
  String[] parameters = new String[] {"ENTRY=TIMELINE","DISABLEHEADER=TRUE"}; rsr.setParameters(parameters);

  類似のログインセッションオプションの詳細については、こちらをクリックしてください。

  
  
  

• リクエストを構成したら、呼び出しを実行します。
  
  

  Code Block
  language java
  AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

  管理サービスを初期化します。実行方法の詳細は、こちらを参照してください。

• 返される応答には、StatusCodeパラメーターが含まれます。詳細については、上記の応答パラメーターの表を参照してください。

• 管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。

• 返される応答には、以下のパラメーターが含まれます。
  StatusCode: String - Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

  • SUCCESS
  • FAILURE

  LoginSessionId: String - 一意のログイントークンです。こちらのトークンは、ユーザーをYellowfinへ直接誘導するために、ログインURLへ付加されます。

<%           
/*              ws_adduserws_admin_singlesignon.jsp         */       */  %>    
%>
<%@ page language="java" contentType="text/html; charset=UTF-8" %>
<%@ page import="com.hof.util.*, java.util.*, java.text.*" %>
<%@ page import="com.hof.web.form.*" %>
<%@ page import="com.hof.mi.web.service.*" %>
<%
String url = "http://localhost:8080";         //provide your Yellowfin URL
 
AdministrationServiceService s_adm = new AdministrationServiceServiceLocator("localhost",8080, "/services/AdministrationService", false);        // adjust host and port number
 
 
AdministrationServiceSoapBindingStub adminService = (AdministrationServiceSoapBindingStub) s_adm.getAdministrationService();
 
AdministrationServiceRequest rsr = new AdministrationServiceRequest();
 
 
rsr.setLoginId("admin@yellowfin.com.au");          // provide your Yellowfin webwebservices service admin account
rsr.setPassword("test");                            // change thisto tobe the password of the account above
account
rsr.setOrgId(1);
rsr.setFunction("ADDUSERLOGINUSER");
 
 
AdministrationPerson ap = new AdministrationPerson();
 
 
ap.setUserId("johnuser@yellowfin.smith@yellowfin.com.au");      // If Yellowfin authentication option is set to "email address"
ap.setFirstName("John");
ap.setLastName("Smith");
ap.setRoleCode("YFREPORTCONSUMER");                // Yellowfinprovide roleexisting codesYellowfin canuser beto found performing this query againstlogin
ap.setPassword("usertest");                             // password of the user above
 
rsr.setPerson(ap);
 
String[] parameters = new String[] {"ENTRY=TIMELINE","DISABLEHEADER=TRUE"};
rsr.setParameters(parameters);
 
AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
 
// Yellowfin
configurationString database:token SELECT= *"";
FROM OrgRole
 
ap.setPasswordif ("test");  SUCCESS".equals(rs.getStatusCode()) ) {
               token = rs.getLoginSessionId();
      // Password must comply with your Yellowfin password policy apresponse.setEmailAddresssendRedirect("john.smith@yellowfin.com.au");
rsr.setPerson(apurl + "/logon.i4?LoginWebserviceId=" + token);
} else {
 AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);   if ("SUCCESS".equals(rs.getStatusCode()) ) {     out.write("SuccessSingle Sign on Failure");
} else {     out.write("Failure");     out.write(" Code: " + rs.getErrorCode()) return;
}
%>