15.05.27.00 - Apigee 개발자 서비스 포털 출시 노트

Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동하세요.
info

2015년 6월 2일 화요일에 Apigee Developer Services Portal의 새로운 클라우드 버전이 출시되었습니다.

궁금한 점이 있으면 Apigee Edge 지원팀에 문의하세요.

모든 Apigee Edge 출시 노트 목록은 Apigee 출시 노트를 참고하세요.

새로운 기능

SmartDocs 정식 버전

SmartDocs가 베타에서 정식 버전으로 전환됩니다. 업데이트 및 새로운 기능은 다음과 같습니다.

  • 파일 또는 URL로 가져오기를 포함한 Swagger 2.0 지원(맞춤 이름이 지정된 보안 객체 지원 포함)
  • SmartDocs를 생성하는 템플릿의 시각적 디자인이 개선되었습니다.
  • Drupal의 콘텐츠 > SmartDocs 메뉴를 통해 사용할 수 있는 개발자 포털의 사용성 및 워크플로 개선사항
  • '맞춤 토큰' 인증이 이제 'API 키'로 불립니다.
  • 수정 버전 수준에서 정의된 인증 '보안' 객체입니다.
  • 템플릿 수준에서 클라이언트 인증 구성입니다. 새 버전에서는 더 이상 사전 구성된 SmartDocs 클라이언트 사용자 인증 정보가 재설정되지 않습니다.

기능에 대한 자세한 설명은 이 블로그 게시물을 참고하세요.

SmartDocs 문서의 경우 SmartDocs를 사용하여 API 문서화를 참고하세요.

SmartDocs 업그레이드 프로세스

베타 기간에 이미 SmartDocs를 사용한 경우 정식 버전의 새로운 기능과 기능을 사용하려면 개발자 포털에서 SmartDocs를 업그레이드해야 합니다.

개발자 포털에 이미 게시된 SmartDocs 페이지는 계속 작동하지만 기존 페이지 또는 새 페이지를 수정하거나 변경사항을 게시하기 전에 업데이트 프로세스를 따라야 합니다.

개발자 포털 내에서 SmartDocs를 렌더링하고 게시할 수 있지만 SmartDocs는 Apigee의 Edge API 관리 서비스 내에 있는 API 모델에서 생성됩니다. Edge에서 API 모델을 변경하면 모든 Pantheon 환경에서 동일하게 적용됩니다 (개발자가 Pantheon 환경에 걸쳐 존재하는 방식과 유사).

SmartDocs 베타에서 정식 버전으로 업그레이드하려면 다음 단계를 따르세요.

  1. Pantheon의 dev 또는 test 환경에서 15.05.27 버전을 업데이트하고 테스트합니다.
  2. 사용 중인 기존 API 모델을 대체할 새 모델을 만듭니다.
    • Swagger 또는 WADL 문서를 가져온 경우 새 버전으로 다시 가져옵니다.
    • SmartDocs 모듈을 통해 API 모델을 유지관리해 온 경우 SmartDocs JSON으로 내보내고 파일 첨부를 사용하여 새 모델로 가져옵니다.
  3. 모델 수정 버전의 보안 속성을 설정합니다. 콘텐츠 > SmartDocs > 모델 페이지에서 보안 설정을 선택합니다.
  4. 작업 열에서 설정을 클릭하여 모델 설정 페이지 (콘텐츠 > SmartDocs)에서 사전 구성된 인증을 확인합니다.
  5. CSS 및 JS 애셋의 v6을 사용하도록 맞춤 템플릿을 업데이트하고 authSchemes 및 apiSchema와 같은 새 객체 이름을 반영하도록 변경합니다. SmartDocs 템플릿 업데이트에 관한 자세한 내용은 SmartDocs를 사용하여 API 문서화를 참고하세요.
  6. 모델 수정사항을 다시 렌더링하고 게시합니다.
  7. 새 문서를 검증한 후 프로덕션 포털을 15.05.27 버전으로 업데이트합니다.

Edge 엔터프라이즈 고객이고 업그레이드 프로세스에 관해 궁금한 점이나 우려사항이 있는 경우 marsh@apigee.com 및 cnovak@apigee.com으로 이메일을 보내세요. 그 외의 경우에는 Apigee 커뮤니티를 사용하여 최상의 답변을 받으세요.

수정된 버그

다음은 이번 출시 버전에서 수정된 버그입니다.

문제 ID 설명
DEVSOL-487 수익 창출의 날짜 형식은 관리자가 구성할 수 있어야 함
이제 유럽 및 미국 날짜 형식의 수익 창출 설정에서 수익 창출의 날짜 형식을 구성할 수 있습니다.
DEVSOL-603 충돌 요금제 페이지의 형식이 잘못됨
기존 요금제와 중복되는 요금제를 구매할 때 표시되는 페이지의 형식이 사용자에게 적합하게 지정됩니다.
DEVSOL-642 보안 설정에서 템플릿 설정으로 클라이언트 수준 구성 이동
DEVSOL-709 SmartDocs: 빈 값으로 요청을 보낸 후 URL 템플릿 매개변수를 수정할 수 없음
메서드 문서에서 템플릿 매개변수를 삭제한 후 SmartDocs에서 요청을 보내면 템플릿 매개변수를 수정할 수 없는 문제를 수정합니다.
DEVSOL-1013 개발자 포털 사용자 이메일 주소 수정 가능
프로필 수정 페이지의 이메일 주소 필드가 더 이상 사용 중지되지 않으며 개발자가 이메일 주소를 변경할 수 있습니다.
DEVSOL-1273 모듈 목록에 'DevConnect Mint'가 두 번 표시됨
모듈 아래에 'Dev Connect Mint'가 두 번 표시되었습니다. 이제 이 문제가 해결되었습니다.
DEVSOL-1313 Swagger 및 WADL 모두에 JSON/YAML 파일 또는 URL 가져오기 지원
이제 URL을 통해 WADL 파일을 가져올 수 있으며 Swagger 파일을 업로드할 수 있습니다.
DEVSOL-1339 SmartDocs 관리 메뉴 위치 변경
이제 SmartDocs가 콘텐츠 메뉴 아래에 있으며 smartdocs 설정은 설정 관리 메뉴 아래에 있습니다.
DEVSOL-1340 GA로 전환할 때 베타 삭제
이제 SmartDocs가 콘텐츠 메뉴 아래에 있으며 SmartDocs 설정은 설정 관리 메뉴 아래에 있습니다.
DEVSOL-1390 PHP SDK Edge 라이브러리가 __toString() 호출 문제를 해결하도록 업데이트됨
PHP SDK Edge 라이브러리가 DeveloperRatePlan 객체에서 __toString()을 호출하는 문제를 해결하도록 업데이트되었습니다. 이 문제로 인해 {quote} Fatal error: Call to a member function format() on a non-object in /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php on line 221 {quote} 오류가 발생합니다. 이는 toString() 메서드를 호출하는 맞춤 코드가 있는 수익 창출 고객에게만 영향을 미치는 버그입니다.
DEVSOL-1398 사용자에게 메시지를 표시하지 않고 설치 시 가져온 SmartDocs Petstore 모델
이제 SmartDocs는 SmartDocs 사용에 관한 더 포괄적인 예를 제공하기 위해 사이트 설치 중에 날씨 모델 대신 petstore swagger 예(http://petstore.swagger.io/v2/swagger.json)를 가져옵니다.
DEVSOL-1407 개발자가 많으면 Cron이 실패함
Drupal cron을 실행할 때 개발자가 많으면 타임아웃 문제가 발생했습니다. 이제 조직에 200명이 넘는 사용자가 있는 경우 배치 프로세스가 사용됩니다.
DEVSOL-1470 'API' 메뉴 링크 및 해당 뷰 만들기
이제 개발자 포털 SmartDocs는 게시된 메서드가 있는 모델에 연결되는 'API'라는 기본 메뉴에 SmartDocs 렌더링 문서 링크가 기본으로 제공됩니다.

알려진 문제

이 출시에는 다음과 같은 알려진 문제가 있습니다.

문제 ID 설명
DEVSOL-1558
새 설치에서 Petstore 예시 SmartDocs 메서드 페이지가 올바르게 렌더링되지 않음
SmartDocs의 Petstore 메서드 페이지가 새로 설치된 환경에서 올바르게 렌더링되지 않습니다. 문제 해결 방법
  1. Drupal 메뉴에서 Content > SmartDocs를 선택합니다.
  2. 'Petstore Example' 모델을 선택합니다.
  3. 업데이트 옵션에서 노드 렌더링 및 게시를 선택합니다.
  4. 체크박스 모두 선택 / 선택 해제를 클릭하여 모든 노드를 선택합니다.
  5. 업데이트를 클릭합니다.

이제 노드가 올바르게 렌더링됩니다.