{"id":937,"date":"2011-09-29T14:25:40","date_gmt":"2011-09-29T13:25:40","guid":{"rendered":"http:\/\/evemaps.dotlan.net\/blog\/?page_id=937"},"modified":"2012-02-24T10:20:22","modified_gmt":"2012-02-24T09:20:22","slug":"corporation-management-tools-faq","status":"publish","type":"page","link":"https:\/\/evemaps.dotlan.net\/blog\/corporation-management-tools-faq\/","title":{"rendered":"Corporation Management Tools FAQ"},"content":{"rendered":"<h2>Current state of the corporation management tools<\/h2>\n<p>The tools are currently in a beta state and only selected corporations are testing the waters. I&#8217;ll publically announce if I&#8217;ll allow more beta tester or release it to the public.<\/p>\n<h2>How do I get access to my corporation tools<\/h2>\n<ol>\n<li><strong><a href=\"\/user\/register\">Register<\/a><\/strong> yourself on DOTLAN EveMaps<\/li>\n<li>Generate a new API Key (preferable Account) on <strong><a href=\"https:\/\/support.eveonline.com\/api\">https:\/\/support.eveonline.com\/api<\/a><br \/>\n<\/strong>Your old limited\/full API Key won&#8217;t work!<\/li>\n<li><strong><a href=\"\/user\/api\">Add your API Keys<\/a><\/strong> to your account (all keys including your alts).<\/li>\n<ol>\n<li>Give the backend some time to initialize your keys. (New keys are initialized every 5 minutes)<\/li>\n<\/ol>\n<li>After the Keys are &#8220;Valid&#8221; you can &#8220;<strong>Verify<\/strong>&#8221; API Key with an ingame action.<\/li>\n<ol>\n<li>Since you create multipe keys for every Character you must verify your API key to ensure you&#8217;re the rightful owner and not somebody trying to get access to your corporation management tools.<\/li>\n<li>Check the API Key Details. You&#8217;ll find instructions how to verify your key using either Wallet\/<strong>ISK transaction<\/strong> or via <strong>EveMail<\/strong>.<\/li>\n<li>Make sure you&#8217;re using the <strong>right Character<\/strong> for the transaction\/mail verification. Only the character that&#8217;s linked with your custom API Key is allowed to verify your key.<\/li>\n<li>Since we&#8217;ve to wait for EveMail &amp; Wallet APIs to update the database this verify process can take up to 30 minutes.<\/li>\n<li>Repeat this process for every API key you&#8217;ve entered<\/li>\n<\/ol>\n<li>You can now enter the corporation management tools. Here you&#8217;ve to <strong>allow the corporation access<\/strong> to your account and api keys. Without this confirmation you and your corporation will not be able to use your data. Without this confirmation you won&#8217;t get access either. You can revoke this permission at any time.<\/li>\n<\/ol>\n<h2>Access Rights &amp; Roles<\/h2>\n<p>The access rights to the various modules in the corp management tools are bundled with the access rights of your ingame character. If one of your characters is a director ingame you&#8217;ll have full rights in the corp tools aswell. If you&#8217;re a starbase caretaker you&#8217;ll be able to access the starbase listing and details here aswell. Access to the AssetViewer is similar. If you&#8217;ve read only access to &#8220;all&#8221; hangar sections you&#8217;ll have access to the online asset viewer aswell.<\/p>\n<h2>Wrong fuel usage numbers on starbases<\/h2>\n<p>[OUTDATED] Since CCP change starbases to use fuel blocks, there&#8217;s no need anymore for fuel calculation based on CPU\/PG.<\/p>\n<p><em>The starbases and the fuel usage is managed and calculated\u00a0completely\u00a0automatic. The starbase listing is updated every 6 hours (api cache timer). The fuel usage is calculated on the real usage basis. The background daemon will compare the pos fuel bays between 2 api calls \u00a0to calculate the actual usage. New starbases, changes on the fuel bay (refueling) and starbase configuration changes may take up to 2 hours (2 api calls) to fix the usage calculation and display the real numbers. So don&#8217;t be scared directly. Be calm and wait for the next update.<\/em><\/p>\n<h2>Roles &amp; Titles<\/h2>\n<p>The roles overview is simplified compared to the ingame version. The tools\u00a0completely\u00a0ignore the various sections (HQ, Base, Other, etc) If the character has a role in one the sections the the role will be highlighted. I hope this will provide you an easy way to get an overview over your corporation. You can do the fine checks ingame for greater detail.<\/p>\n<h2>API Keys:\u00a0Will others in my corporation see and steal my API keys?<\/h2>\n<p>No. With confirming access to the corporation management tool you allow the directors of your corporation to see details of your account and the linked API keys. But the important thing: All the vCode field is truncated. They might see the first 16 characters and not the rest. So the truncated key is not useable for them outside of DOTLAN EveMaps.<\/p>\n<h2>API Keys: My key is flagged invalid &#8211; what now?<\/h2>\n<p>This can happen due to bugs\/invalid calls on my side, or you have changed your API keys on CCPs server. In the API keys details you&#8217;ll find the last error that was logged. If the key is still valid, press the double arrow to\u00a0reinitialize\u00a0your API key. Withing 5 minutes the API should be active again. If this was your corporation key, it will take another cycle to rescan the corp management API keys to restart the updates.<\/p>\n<h2>Admin: Which API Keys are needed?<\/h2>\n<p>For the full functionality you need a <strong>valid + verified corporation key<\/strong> with all access levels ticket on and a <strong>valid + verified directory character<\/strong> key with notifications and notificationText enabled. If you decided not to provide everything via api, you&#8217;ll not be able to use all features the tools providing. If you don&#8217;t provide starbase api informations you won&#8217;t be able to monitor your starbases.<\/p>\n<p>Essential api methods for the corporation management tools are: CorporationSheet and MemberSecurity. Every other api call will provide you with more informations. Which API will provide me what features:<\/p>\n<ul>\n<li>CorporationSheet: Basic infos about your corporation, division names, wallet names, etc<\/li>\n<li>MemberSecurity: Character listings + roles<\/li>\n<li>MemberTracking: Character listing + join date<\/li>\n<li>MemberTrackingExtended: Character location + login\/logoff timestamps<\/li>\n<li>Titles: Needed for full Roles&amp;Titles overview<\/li>\n<li>AccountBalance, WalletJournal: For the wallet tool<\/li>\n<li>AssetList: Access your assets online<\/li>\n<li>ContactList: Access your standings<\/li>\n<li>Notifications, NotificationsText: The notifications are taken from a Character Key, but only the corp relevant notifications are shown in the corp management tool module.<\/li>\n<\/ul>\n<div>More features \/ api calls maybe needed in the future.<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Current state of the corporation management tools The tools are currently in a beta state and only selected corporations are testing the waters. I&#8217;ll publically announce if I&#8217;ll allow more beta tester or release it to the public. How do I get access to my corporation tools Register yourself on DOTLAN EveMaps Generate a new [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"open","template":"","meta":[],"_links":{"self":[{"href":"https:\/\/evemaps.dotlan.net\/blog\/wp-json\/wp\/v2\/pages\/937"}],"collection":[{"href":"https:\/\/evemaps.dotlan.net\/blog\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/evemaps.dotlan.net\/blog\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/evemaps.dotlan.net\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/evemaps.dotlan.net\/blog\/wp-json\/wp\/v2\/comments?post=937"}],"version-history":[{"count":14,"href":"https:\/\/evemaps.dotlan.net\/blog\/wp-json\/wp\/v2\/pages\/937\/revisions"}],"predecessor-version":[{"id":942,"href":"https:\/\/evemaps.dotlan.net\/blog\/wp-json\/wp\/v2\/pages\/937\/revisions\/942"}],"wp:attachment":[{"href":"https:\/\/evemaps.dotlan.net\/blog\/wp-json\/wp\/v2\/media?parent=937"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}