L'interface utilisateur de GIS Enterprise Reporter est conçue pour avoir peu d'options dans l'espoir qu'elle soit relativement simple à exécuter. <\/P>
En principe, vous lui fournissez un "Target" Portal for ArcGIS, avec un identifiant administratif pour ce Portal, cochez quelques cases, cliquez sur "Execute", et attendez que cela se termine. <\/P>
<\/span><\/P> <\/P>Il y a certaines choses qui bénéficient d'une explication. Cet article offrira des informations sur les sujets suivants:<\/P>Où devrais-je exécuter cette application ?<\/LI>Comment devrais-je exécuter cette application ?<\/LI>Quelle valeur devrais-je mettre dans le "Target" ?<\/LI>Quels sont quelques problèmes courants (et solutions) ?<\/LI>Que signifient les options (cases à cocher) ?<\/LI><\/OL>Où cette application doit-elle être exécutée ?<\/STRONG><\/U><\/P>GIS Enterprise Reporter peut, en principe, être exécuté de n'importe où où il peut communiquer avec votre Portal for ArcGIS. <\/P>Cependant, il y a des emplacements meilleurs et pires. L'application fonctionne en interrogeant Portal à propos de lui-même et de ses ArcGIS Servers fédérés. Cela signifie que Reporter veut communiquer avec les Servers fédérés de la même manière que Portal le fait. Divers aspects de votre configuration et des règles réseau peuvent signifier que communiquer depuis votre ordinateur personnel avec Server ne peut pas se faire par les mêmes moyens que Portal. <\/P>Comment le sauriez-vous ? Pas facilement. Alors, comment pourriez-vous vous protéger contre cette possibilité ? La façon la plus simple de le faire est d'exécuter l'application depuis votre réseau serveur. Par exemple, vous pourriez l'exécuter sur la machine où Portal fonctionne.<\/EM><\/P>Comment cette application doit-elle être exécutée ?<\/STRONG><\/U><\/P>Il n'est pas nécessaire d'exécuter Reporter en tant qu'administrateur local de la machine. Cependant, le faire permettra généralement de recueillir plus d'informations pour vous. Et, cela peut vous aider à surmonter certains défis potentiels d'exécution.<\/P>Si vous souhaitez exécuter l'application en tant qu'administrateur local de la machine (en supposant que vous êtes membre du groupe Administrateurs local), faites un clic droit sur l'exécutable enterprise_reporter.exe et sélectionnez "Run as administrator" dans le menu contextuel.<\/P>
<\/span><\/P> <\/P>Vous pouvez recevoir ou non un message de votre système d'exploitation ou logiciel de sécurité qui vous décourage d'exécuter cette application. <\/P>Cette application est signée numériquement par Esri avec une chaîne d'autorité provenant d'une Autorité de Certification publique. Donc, il est peu probable que le message mentionne la confiance du certificat. Mais, si c'est le cas, vous pouvez envisager d'importer la chaîne de confiance dans votre référentiel de confiance. Pour initier le flux "installation" du certificat, suivez les étapes montrées dans la capture d'écran ci-dessous :<\/P>
<\/span><\/P> <\/P>Sélectionner "Current User" et "Automatically select the certificate store based on the type of certificate" sont les options appropriées dans les panneaux de l'assistant "Install Certificate". Cela peut vous soulager de l'avertissement.<\/P>Ou, si vous êtes administrateur machine, vous pouvez avoir des options pour exécuter l'application. Pour ce faire, vous devrez peut-être cliquer sur des boutons disant des choses comme "More Options", "Run Anyway", etc. ... selon ce qui émet l'avertissement et vos droits. Par exemple:<\/P> <\/DIV>
<\/span><\/P>
<\/span><\/P>Ces méthodes techniques ne sont pas proposées pour contourner les directives de votre organisation concernant les exécutables tiers. Veuillez utiliser les privilèges qui vous sont accordés par votre organisation de manière responsable. <\/P>L'application Reporter ne fonctionne que sous Windows. Cependant, vous pouvez l'utiliser pour faire un rapport sur un ArcGIS Enterprise sous Windows ou Linux. Dans le cas où votre Enterprise est sous Linux, exécuter Reporter en tant qu'administrateur local ne produit aucune information supplémentaire dans les documents du rapport. La seule raison d'exécuter Reporter en tant qu'administrateur local dans ce cas est de vous donner plus d'options en réponse à un avertissement d'application non signée si vous en recevez un.<\/P>Quelle est la bonne valeur pour "Target" ?<\/STRONG><\/U><\/P>Il y a trois options basiques:<\/P>Le FQDN ('portalmachine.domain.com') de la machine<\/LI>Le point de terminaison 7443 pour Portal ('https:\/\/portalmachine.domain.com:7443\/<\A>')<\/LI>L'URL WebContext pour Portal ('https:\/\/proxy.domain.com\portalcontext<\A>')<\/LI><\OL>Prenez note que les deux premières options reviennent au même résultat. Si vous entrez le FQDN de votre machine Portal (soit une machine dans le cas d'un Portal "high-availability" à deux machines), Reporter le convertira en option #2 pour vous. En plus d'être relativement simple, c'est généralement aussi la meilleure option pour la valeur "Target." Il est donc recommandé d'utiliser le FQDN (nom de domaine pleinement qualifié) d'une machine Portal (l'enregistrement "A RECORD" de la machine).<\p>P>Cela implique bien sûr que votre réseau vous permettra d'accéder au port 7443 de Portal depuis l'endroit où vous exécutez Reporter. C'est pourquoi le premier conseil encourage à exécuter Reporter sur votre réseau serveur car c'est sur ce réseau que ce chemin réseau sera autorisé.<\p>P>L'option troisième est de fournir l'URL WebContext (ou adresse style Web Adaptor) comme cible. Cela fonctionne généralement. Cependant, Reporter ne connaît que "Portal tier authentication." Donc, si ce chemin (WebContextUrl) implique une "web tier authentication" ou nécessite SAML, OIDC, etc., Reporter ne pourra pas s'authentifier.<\p>P>Comme vous pouvez le déduire, les valeurs pour "Admin user" et "password" doivent être un utilisateur ayant des droits administratifs sur votre Portal et authentifié au niveau Portal tier. Cela inclut certainement le "Initial Administrator Account" du Portal. Mais, vous pouvez aussi utiliser tout autre compte qui est administrateur Portal et peut obtenir un token directement depuis les points REST 7443 du Portal.<\p>P>Problèmes courants et solutions<\STRONG>
P>L'application est fournie avec un document Microsoft Word qui inclut une section sur le dépannage. Si vous avez un problème, consultez-le en premier lieu. <\p>P>Les problèmes les plus courants concernent généralement l'accès au point REST token endpoint. Ces problèmes sont mieux évités en exécutant l'application depuis le réseau serveur et en utilisant le FQDN machine comme adresse cible. Le message dans l'application ressemblera à ceci:<\p>P font face = "courier new,courier">Exception lors de l'acquisition du token. Veuillez utiliser un navigateur pour vérifier l'url : https:\/\/:7443/arcgis/sharing/rest/generateToken et les identifiants.<\p>P>Comme vous pouvez voir, il vous demande de valider que l'URL cible pour obtenir un token est accessible depuis la machine où vous exécutez Reporter. Si vous pouvez atteindre ce point final, essayez alors de générer un token. Si vous pouvez faire ces deux choses, Reporter fonctionnera.<\p>P
Que signifient les options des cases à cocher ?P>A un niveau élevé, les cases ont les implications suivantes:<\p>P>« Admin + Services Inventory » : Cela touche tous les points REST dans les API Admin pour votre Portal et vos Servers fédérés. Il enregistre toutes les informations de configuration de votre Enterprise, liste tous ses services et leurs propriétés, etc. Les informations sont assez larges et profondes. Cela rend cela très précieux. Mais cela peut être difficile d'obtenir une vue globale. Le contenu spécifique de ce fichier sera exploré dans des articles futurs.<\p>P>« Diagram » : Le diagramme fournit une image globale de la structure logique de votre Enterprise. Voici un exemple issu d'un système très simple (environnement développement) :<\p>P span class = « lia-inline-image-display-wrapper lia-image-align-center » image-alt = « DannyKrouk_0-1651623887240.png » style = « width: 400px ; » >< img src = «
https://us.v-cdn.net/6038851/uploads/images/40512i3D13E935EF406DC4/DannyKrouk_0-1651623887240.png » role = « button » title = « DannyKrouk_0-1651623887240.png » alt = « DannyKrouk_0-1651623887240.png » / >< / span >< / p > < p > « Certificate Analysis » : Reporter fait il est préférable de se connecter à chacun des points de terminaison HTTPS de votre Enterprise (c'est-à-dire Reverse proxies, Web Adaptors, Portal's sur 7443, Server's sur 6443, etc.), en découvrant les certificats et en rapportant divers faits tels que les sujets des certificats, les expirations et les chaînes de confiance. Il y a plusieurs feuilles dans l'Excel, chaque feuille correspondant à un chemin d'accès HTTPS différent. Par exemple:<\/P>
<\/span><\/P>"Portal Content Inventory" : Cette sortie est créée en parcourant l'API Sharing de Portal's. Elle liste tout le contenu dans le Portal, ainsi que ses "metadata" (type de contenu, propriétaire, etc.). Et, elle peut fournir des listes d'utilisateurs, de groupes, etc. Cette sortie sera également explorée plus en détail dans de futurs articles.<\/P>"Migrator Artifacts (advanced)" : C'est, comme son nom l'indique, une option avancée. La plupart des utilisateurs n'en auront jamais besoin. Cette option fait deux choses. La première est qu'elle écrit le json des points de terminaison REST dans un sous-répertoire. Donc, si vous êtes quelqu'un qui aime travailler avec json, vous pouvez tout y trouver. Deuxièmement, lorsqu'elle trouve suffisamment d'informations dans Portal pour exporter des "service definitions", elle le fera. Cela peut être utile si vous souhaitez republier des services. Si vous avez publié votre service via ArcGIS Pro, il était très probable que les service definitions y soient stockées de manière à ce que Reporter puisse y accéder. <\/P>Conclusion<\/STRONG><\/U><\/P>Espérons que cet article ait fourni une orientation utile sur la façon d'exécuter l'outil GIS Enterprise Reporter. Comme mentionné, il est accompagné d'un document Microsoft Word qui fournit des informations supplémentaires. Si vous rencontrez des difficultés ou avez des questions qui ne sont pas clairement abordées, veuillez prendre contact via les informations dans ce document. Vous pouvez également poster des commentaires ou questions ici, si vous le souhaitez.<\/P>Article précédent de la série : Introducing the GIS Enterprise Reporter<\/A><\/P>Article suivant de la série : GIS Enterprise Reporter: Making the Most of Services Outputs<\/A> <\/P> <\/P>
<\/P>
